Skip to content

LabKey/labkey-api-r

Repository files navigation

Rlabkey is an interface between the R language and LabKey Server that has been designed to combine the strengths of LabKey Server and the R language platform.

Contents

/labkey-api-r

  • build/ - Directory where packages are built, created by 'build' task.
    • Rlabkey.Rcheck/ - Folder created by "check" task, contains intermediate files for validation checks
  • test/ - Scripts for testing Rlabkey and for installing test dependencies.
    • vignette.R - R test script designed to connect to a LabKey instance on localhost with a project named "apisamples"
    • listArchive.zip - List archive used by vignette.R and Selenium tests

/labkey-api-r/Rlabkey

Contains all source code for Rlabkey and its documentation.

  • DESCRIPTION - Text manifest file specifying version number, dependencies, and other properties. Developer maintained.
  • NAMESPACE - Specifies the public function names. Developer maintained.
  • NEWS - Document of change history for this project, developer maintaind.
  • inst/doc/ - Folder for documents
  • man/ - Source files for function-by-function reference documentation. After a successful build, a final pdf of the function reference documentation can be found in Rlabkey.Rcheck/Rlabkey-manual.pdf.
  • R/ - R Source files for package functions
  • src/ - Source files for a faster implementation of Json parsing for retrieved data. Written in C, built at package install time.
  • src-*/ - generated by C build

Building

Install tools needed for building R packages. Build tools are available on CRAN.
####OS specific instructions:

After all tools are installed, run ./gradlew build.

If you encounter any LaTex related errors during the build or check steps, try the following:

  • See installation docs from https://yihui.name/tinytex/.
    • curl -sL "https://yihui.name/gh/tinytex/tools/install-unx.sh" | sh
  • For an error like ! LaTeX Error: File 'longtable.sty' not found.
    • tlmgr search --global --file "/longtable.sty"
    • tlmgr install latex-tools

Installing

./gradlew installRLabkey will install Rlabkey and its dependencies into your user's package library (R_LIBS_USER)

R package validation (./gradlew check) also requires these dependencies.