Welcome to RCy3: 2.0 and Beyond

Building upon the phenominal success of RCytoscape and RCy3, Cytoscape is adopting this project to provide a robust R package for the rapidly evolving Cytoscape ecosystem. We are beginning with a major refactor of RCy3 that includes:

independence from the graphNEL object model
harmonized function and argument names
support for Cytoscape commands
better support for Cytoscape apps
see NEWS for the complete release notes
coordinated development with CyREST and the Cytoscape service model
- New API
coordinated development with other scripting libraries, e.g.,
- py2cytoscape
- RCyjs

How to install

Official bioconductor releases (recommended)

install.packages("BiocManager")
BiocManager::install("RCy3")

Development version from this repo (at your own risk)

install.packages("devtools")
library(devtools)
install_github('cytoscape/RCy3', build_vignettes=TRUE)
#If installation fails due to package 'XXX' not found,
# then run install.packages("XXX") and then try install_github('cytoscape/RCy3') again
library(RCy3)

Troubleshooting

If you see this error on a Mac: make: gfortran-4.8: No such file or directory, then try reinstalling R via homebrew: brew update && brew reinstall r
- warning: this make take ~30 minutes
If you see this error in RStudio: ERROR: dependency ‘XML’ is not available for package, then try this command: install.packages("XML") and then try installing RCy3 again.

How to contribute

This is a public, open source project. Come on in! You can contribute at multiple levels:

Report an issue or feature request
Fork and make pull requests
Contact current Cytoscape developers and inquire about joining the team

Development

install.packages("devtools")

install.packages("roxygen2") 
library(devtools,roxygen2)
devtools::install_github("AlexanderPico/docthis")
library(docthis)
BiocManager::install("BiocStyle")
library(BiocStyle)
BiocManager::install("BiocCheck")
library(BiocCheck)
install.packages("RUnit")
library(RUnit)
devtools::document()
devtools::check()
BiocCheck::BiocCheck('./')

Testing

Unit tests are a crucial tool in software development. In order to run them 'offline' (not on the Bioconductor build system), take these steps from within a running R session (requires RUnit):

source(system.file("unitTests", "test_RCy3.R", package="RCy3"))
run.tests()

They take about 4 minutes to run.

Bioconductor

While this is the primary development repository for the RCy3 project, we also make regular pushes to official bioconductor repository (devel & release) from which the official releases are generated. This is the correct repo for all coding and bug reporting interests. The tagged releases here correspond to the bioconductor releases via a manual syncing process. The master branch here corresponds to the latest code in development and not yet released.

git commit -m "informative commit message"
git push origin master
git push upstream master

http://bioconductor.org/developers/how-to/git/push-to-github-bioc/

Following each bioconductor release, a RELEASE_#_# branch is created here:

git checkout -b RELEASE_3_7 upstream/RELEASE_3_7

Only bug fixes and documentation updates can be pushed to the official bioconductor release branch. After committing and pushing fixes to master, then:

git checkout RELEASE_3_7
git cherry-pick master #for lastest commit
# or git cherry-pick <commit number> #for specific commit
# bump version in DESCRIPTION
git add DESCRIPTION
git commit -m 'version bump'
git push origin RELEASE_3_7
# double check changes, and then...
git push upstream RELEASE_3_7
git checkout master

https://bioconductor.org/developers/how-to/git/bug-fix-in-release-and-devel/

Vignettes

When adding or updating vignettes, consider the following tips for consistency:

Copy/paste the header from an existing RCy3 vignette, including the global knitr options
Number the VignetteIndexEntry names w.r.t. other vignettes (this determines their presentation order)
Avoid spaces in Rmd filenames; causes CHECK errors
When ready, run Knit to html_document and review the generated html (requires BiocStyle)
Note: you don't need to save the html version; it will be generated anew at Bioconductor.
In the end, you should just have an Rmd version of each vignette in the repo.

Former Repo

The entire commit history has been preserved during this transition, but you can find the repo for RCy3 v1.5.3 and earlier at https://github.com/tmuetze/Bioconductor_RCy3_the_new_RCytoscape and you can find the Bioconductor page for v1.8.0, including archives at https://www.bioconductor.org/packages/3.6/bioc/html/RCy3.html.

biodavidjm / RCy3