Learn R Programming

adapr (version 2.0.0)

Implementation of an Accountable Data Analysis Process

Description

Tracks reading and writing within R scripts that are organized into a directed acyclic graph. Contains an interactive shiny application adaprApp(). Uses git2r package, Git and file hashes to track version histories of input and output. See package vignette for how to get started. V1.02 adds parallel execution of project scripts and function map in vignette. Makes project specification argument last in order. V2.0 adds project specific libraries, packrat option, and adaprSheet().

Copy Link

Version

Install

install.packages('adapr')

Monthly Downloads

14

Version

2.0.0

License

LGPL-2

Maintainer

Jonathan Gelfond

Last Published

November 30th, 2017

Functions in adapr (2.0.0)

Write.cap

Lower level function that writes data and captures the file information within dependency object
Write

Write object and capture file information
Read

Read data and capture the file information within dependency object
AppLoadFlex

Loads a single R object from file for a R Shiny app
ReadTrack

Tracks files that read by functions not in adapr and captures the file information within dependency object
Digest

Digest files from (digest package)
Graph

Write object and capture file information
Library

Installs and loads library specific to a project
Read.cap

Lower level function that reads data and capture the file information within dependency object
addPackage

Add R package to a project
arcRead

Loads R object from archivist repository within the results directory of another adapr Script
Load.branch

Loads a single R object from file
checkAdaprHashAlgo

Checks or changes the specified adapr hash algorithm (adaprHashAlgo option)
adaprSheet

Browse adapr cheat sheet
checkFileHash

Checks the consistency of the dependency directory with the files within the file system
dependency-class

Dependency class
adaprUpdate

Updates latest adapr from gitHub.
firstProject

Create first project
arcWrite

Saves R object to archivist repository in results directory of adapr Script
getAdaprOptions

Returns the primary hub file with project location and id information
browsePubFiles

Browses publication table for editing
WriteTrack

Tracks files written by functions not in adapr and captures the file information within dependency object
adapr-package

adapr
adaprApp

Launches Main app
commit2char

git2r commit class to character converter
adaprDependencies

Returns character string of adapr R package import dependencies
commitProject

Git commit of project.
fileInfoProjects

List project file information disk space, modification timespan, days inactive
checkRmdMode

Checks whether interactive R markdown session is ON
finalize_dependency

Writes dependency data to file in "Dependency" directory
checkVersion

Check install of package of specific version
getProject

Returns the adapr project in R option "adaprProject"
defaultAdaprSetup

Set up adapr 1st time
getProjectSwapPath

Retrieve project swap directory
adaprHomeDir

Identify adapr Home directory. Location of options file and project listing.
condenseFileInfo

Generate condensed information about files from dependency object
adaprInstall

Install adapr in a library adaprInstall.R
createFileInfo

Creates a list containing information about a file
checkFileHashSource

Checks the consistency of the dependency directory with the files within the file system. Reports the source scripts that need to be updated.
create_source_file_dir

Create source file directories
getDepSubgraph

Produces subgraph of dependencies of R script
dataDir

Returns project's data directory, allows relative directories. Used within an R script.
getFileInfo

Retrieve the file info for the file by name OR from the data subdirectory data
getProjectInfoSI

Given source_info object, retrieves project information
getProjectInfo

Acquire all dependencies related to a project, Generate graph of project dependencies, Get all file information related to project
gitCommit

git commit. Requires git installation.
gitConfigure

Configure user.name and email for git.
checkFileMtimeSource

Checks the consistency of the dependency directory with the files within the file system Reports the source scripts that need to be updated!
gitInit

Initiate git
gitProvenance

Identify git provenance of file within a project
createMarkdown

Creates an Rmarkdown file in specified directory
importData

Import selected file into the project data directory
createProgramGraph

Make plot of project programs only Summarize all programs. Sync status is assessed and indicated.
getPubResults

Read result filepaths to publish
gitIgnoreLibrary

Git ignore the library file
getFileSysTime

Retrun time of file system
gitInfo

Retrieves the information from git about a file
getLibrary

Get library for a project
initialize_dependency_info

Initializes dependency object source_info
install

Install package of specific version
getProjectPath

Given Project id, Return project directory
loadInstallLibraryFile

This function is no longer supported. Loads libraries within the file library.list.file
getProjectPublishPath

Given Project name, Return project publish directory
makeDependencyGraphObj

Creates an graph object from a dependency object
get_orchard

Returns the primary hub file with project location and id information
git_path

Find path for git executable
gitAdd

git add to stage the file
graphProject

Make plot of project programs only Summarize all programs. Sync status is assessed and indicated.
guess.read.fcn

Return function for reading common file types
getProjectLibrary

Given Project name, Return project library directory
guessWriteFcn

Return function for writing common file types
initProject

initialize project
getSourceInfo

Returns the information related to the adapr script
loadAdaprTest

Create adaprTest example project
getUpstream

Identifies dependencies in a DAG
loadFlex

Loads a single R object from file, more flexible than Load.branch or base::load
installLibrary

Install package of specific version
gitConfigureTest

Checks git configuration. Requires git installation
installProjectPackages

Installs all packages
gitHistorySearch

Performes git history search
makeScript

Generates the shell of a code that is project specific
listBranches

Lists the branches available for loading in the adapr project
makeSummaryGraph

Make.summary graph of projects based on files in dependency directory
monitorParallelSync

Experimental (use with caution) track parallelSync while in progress
listDatafiles

Lists the data files available for reading in the adapr project
openProjectList

Browses orchard in file system
makeFunction

Generates the shell of a R function that is project specific in support_functions folder
readLibrary

Read library file
idPackages

Lower level function that captures packages that are explicitly loaded, not loaded automatically
idSync

Returns the source files needed to repair synchrony
makeHyperlink

Makes HTML hyper link
openScript

Opens script from a project with default R program. Can open markdown files as well.
listProjects

List projects
parallelSync

Experimental (use with caution) parallel syncrhonization of project. Takes advantage of directed acyclic graph structure to run R script processes in parallel.
listScripts

Lists the R scripts in the adapr project
projectReportSend

Make plot of network within html documents. Summarize all programs. Make a readme file at top project directory copy to target.directory Uses pander and pandoc unlike project_report
plantTree

initialize project
programIOTable

Create program io table
relocateProject

changes project directory/publish directory/library locataion or identifies imported project
scriptLoader

Initializes dependency object source_info
removePackage

Remove R package to a project
project.directory.tree

Project directory tree structure contains the relative directory structure included analysis, data, texidr, dependency.dir, support functions, and library bank locations
scriptSubgraph

Produces script only subgraph
projectReportMarkdown

Make plot of network within html documents. Summarize all programs.
pullSourceInfo

Create source_info from project.id
sourceSyncSILoad

Synchronize project by IDENTIFYING necessary R scripts
updateAdaprConfig

Updates the project list file to include project specific libraries.
sproutProgram

Lower level function that generates the shell of a code that is project specific
path.expand.2

Location of options file and project listing. Swap / for \ in path expand.
plantOrchard

Create project hub files in root directory
syncTrunk

Partial project synchronization of dependencies to an Rscript. Runs only scripts needed for synchronization.
read.dependency

Lower level function that reads the script dependcy data from file
publishResults

Read in results to publish & Copies results to the project's publication directory
readDependency

Collect trees from dependency directory
renderRmd

Renders and Rmarkdown file
runScript

Run an R script within a project using devtools::clean_source
reportProject

Make plot of network within html documents. Summarize all programs.
runSourceDirectory

Runs all source files within the directory source.directory
searchScripts

Searches R scripts and R markdown files within a project.
sendBranch

Copy dependent programs to swap directory
showResults

Opens results directory of project or R script within a project
write.dependency

Lower level function that writes the dependency object to file
sourceSyncSI

Lower level function that synchronizes project by running necessary R scripts. Loads from source_info list.
redirectTree

Lower level function that that changes project directory/publish directory or identifies imported project
resultsDir

Returns project's results directory, allows relative directories. Only used within an R script, after create_source_file_dir.
syncTestProject

Tests the synchrony of files in dependency tree
reworkProjectPath

Lower level function that collects all trees in dependency.dir and changes the project path
syncTestSI

Tests the synchrony of files in dependency tree
setAdaprOptions

Returns Modifies the primary adapr option file
swapProjectPath

Lower level function that takes list of dependency file data and changes the project path
rapidPlot

Make project graph with sync status already computed.
syncProject

Checks the synchronization project and runs scripts needed for synchronization
removeProject

Removes project from orchard, but doesn't delete project from file system
syncTestPI

Lower level function that tests the synchrony of files in dependency tree given project information.
removeScript

Remove an R script from a project. Removes program, dependency, and results.
sendBranchSI

Copy dependent programs to swap directory
setProject

Checks or changes the specified adapr project in R option "adaprProject"
showProject

Opens project directory
syncTest

Lower level function that checks the synchrony of source files and their created objects