Skip to main content

MedBook Platform for Cancer Data Capture, Analysis and Sharing

Project description

MedBookLib provides a python interface to MedBook (R version should come next).


MedBookConnection(<name optional>, <password optional>)
You begin the conversation by creating a MedBook Connection object which will be used

MedBookConnection("", "test1234");

or using the MedBook environment variables: MEDBOOKUSER, MEDBOOKPASSWORD

medbook = MedBookConnection();

This will throw an exception object if it does not make authenticated connection to the MedBook server.

MedBookConnection.find(<collection required>, <mongo query optional>, <keyword querys optional>)

The simplest find command will return all of the data objects in a collection. For example

data = medbook.find("Clinical_Info");

Some tables such as Expression2 are very large and if just need one gene from one study, you can do this by simply doing:

data = medbook.find("Expression2", { "Study_ID": "prad_wcdt", "gene": "BRCA1" });

This can be more easily expressed using the python keyword idiom:

data = medbook.find("Expression2", Study_ID="prad_wcdt", gene="BRCA1");

But use the mongo syntax to express complicated queriess,

data = medbook.find("Expression2", { "Study_ID": {"$in": [ "prad_tcga", "prad_wcdt"] }, "gene": { "$in": ["EGFR","BRCA1"]}});

You cannot combine keyword queries and mongo queries.

You must provide credentials to MedBook in the form of a name and password. There are two ways
to do this:

Preferred way: Set the MEDBOOKUSER and MEDBOOKPASSWORD environment variables. For exmaple:
export MEDBOOKPASSWORD=test1234

There is also a MEDBOOKSERVER environment variable. If no server is specificed
The default server is But you can also set the server to be your laptop.

Common ones are:



export MEDBOOKSERVER=http://localhost:20012/

Alternatively, you can provide the name and password in the parameters of the MedBookConnection object (see above).

Project details

Release history Release notifications

This version
History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
medbooklib-1.0.tar.gz (3.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page