This is the Python implementation of the cMonkey algorithm based on the original R implementation by David J. Reiss, Institute for Systems Biology.
A complete set of documentation for installation and running of cMonkey is on the project's Github Pages.
There are also developer and user discussion groups.
Please report all bugs or other issues using the issue tracker. Please direct any and all questions to either the developer or user discussion groups.
The recommended way is to install cmonkey2 through pip
pip install cmonkey2
This will install the tools cmonkey2 and cm2view into your python environment. Please note that you will have to install MEME manually from http://meme-suite.org/
The simplest way to run the tool (if all data available in RSAT and STRING):
$ cmonkey2 --organism <organism-code> <tab separated file of gene expressions>
To display available options:
bin/cmonkey2.sh --help
To run the example organism:
bin/cmonkey2.sh --organism hal --rsat_base_url http://networks.systemsbiology.net/rsat example_data/hal/halo_ratios5.tsv
Below are the instructions to use cmonkey2 directly in the source repository
PreCyte made a Docker image based on cmonkey2 available on their github account
https://github.com/PreCyte/cMonkey2-docker/
cMonkey2 has been tested and runs on all tested recent versions of Linux (including debian-based [Ubuntu, Mint, Debian] and RPM-based [CentOS, Fedora]) and recent versions of Mac OS X. Additional dependencies include:
for the human setup, Weeder 1.4.2 is needed
for running the unit tests (optional):
for running the interactive monitoring and visualization web application (optional):
bin/run_tests.sh
In general, you should be able to run cmonkey2 on microbial gene expression ratios with
bin/cmonkey2.sh --organism <organism-code> <tab separated file of gene expressions>
The file can be either in your file system or a web URL.
After the program was started, a log file will be written in cmonkey.log. You can see all available options with
bin/cmonkey2.sh --help
There is a startup script for cMonkey to run the current integrated system
bin/cmonkey2.sh --organism hal example_data/hal/halo_ratios5.tsv
bin/cm2view.sh [--out [output directory]]
bin/cmonkey2.sh --organism hal --rsat_organism Halobacterium_NRC_1_uid57769 --rsat_base_url http://pedagogix-tagc.univ-mrs.fr/rsat --rsat_features gene --nooperons --use_BSCM example_data/hal/halo_ratios5.tsv
To run cMonkey on human data, run the following code with your own <ratios.tsv>
file
bin/cmonkey2.sh --organism hsa --string <stringFile> --rsat_organism Homo_sapiens_GRCh37 --rsat_URL http://rsat.sb-roscoff.fr/ --rsat_features protein_coding --nooperons <ratios.tsv>
Running cMonkey on Human data is somewhat difficult because neither the string database nor the RSAT database has human data cleanly entered. Here are the steps for a sucessful python cMonkey run on human
The distribution is built using setuptools and wheel format
python3 setup.py sdist bdist_wheel
twine upload -r pypi dist/cmonkey2-