For any help with the package usage and installation please chat with us.
Analysis algorithms extracted from the original 'campari' software package. They consists in a kinetic annotation of the trajectory based on the minimum spanning tree constructed on the distances between snapshots. The fast algorithm is implemented on the basis of a modified version of the birch algorithm, while the slow one is based on a simple leader clustering. For more information please visit the original website
This code is available on this GitHub repository and therefore it can be downloaded directly and locally installed or, using the handy "devtools". As we recently tested the folowing code on a fresh Ubuntu 16.04 we advise the following installations.
Firstly from terminal we install the most modern versions of the following packages using apt:
# ubuntu 16.04 (remember to have R installed -> sudo apt install r-base*)
sudo apt update
sudo apt install libnetcdff-dev # xenial: needed for light data handling
sudo apt install libarpack2-dev # xenial: needed for alternative to lapack spectral decomposition of matrices
sudo apt install libssl-dev # for devtools
sudo apt install libcurl4-gnutls-dev # for devtools
sudo apt install libtiff5-dev # for ClusterR
sudo apt install libgmp-dev # for ClusterR
# in the case of installation of original campari software: install_campari()
sudo apt install libfftw3-dev # for install_campari()
# some peculiarity for trusty as it had a different netcdf version and installation procedure
sudo apt-get install libnetcdff5 # trusty
sudo apt-get install libnetcdf-dev # trusty
sudo apt-get install libarpack2-dev # trusty
# osx # to-update
brew update
brew install netcdf --with-fortran
brew install arpack
Secondly install extra-cran-packages using biocLite():
source("http://bioconductor.org/biocLite.R")
biocLite(c("AnnotationDbi", "impute", "GO.db", "preprocessCore", "PairViz"))
Note: the installation of biocgenerics is ultimately failing on ubuntu 17.10 and only R > 3.4.3 can patch it up. We advise to stick with the LTS version 16.04 of ubuntu.
Finally install CampaRi package from github using devtools (note ggfortify just moved away from cran and must be installed from github). It is not needed anymore.
library(devtools)
# install_github("sinhrks/ggfortify") # no more needed
# Final step:
install_github("Melkiades/CampaRi")
Please note that to unlock some fundamental analysis functions you need to install netcdf 4.1 or later library for backend fast data-handling. This library must be installed --with-fortran bindings (it is possible to check this using the nc-config or nf-config commands (with --all option)).
The arpack library is needed at this moment. It will be made optional in the future.
We are currently writing how-to-use guides with examples and datasets. These vignettes are available internally in the package and can be browsed as following (please note that some external library is needed - e.g. pandoc).
library(knitr)
library(rmarkdown)
install_github("Melkiades/CampaRi", build_vignettes= TRUE)
# TO BROWSE THEM after the installation
browseVignettes("CampaRi")
For more details, please refer to the main documentation of the original CAMPARI documentation.
Please cite the SAPPHIRE algorithm paper:
- Bloechliger, N., Vitalis, A. & Caflisch, A. A scalable algorithm to order and annotate continuous observations reveals the metastable states visited by dynamical systems. Comput. Phys. Commun. 184, 2446โ2453 (2013).