Skip to main content

Library for submitting and downloading job data from ClusPro.

Project description

Python library and associated scripts for submiting jobs and downloading results from ClusPro.


Ensure you have pip, then run:

pip install --user cluspro_api


[sudo] pip install cluspro_api

sudo is only needed if you are installing globally. If --user option is used, binaries will be in $HOME/.local/bin. We recommend use of Anaconda (


Submitting Jobs

To submit a docking job to ClusPro:

cluspro_submit --receptor <path to receptor pdb file> --ligand <path to ligand pdb file>

This will prompt you for your username and API secret, which can be found on the API tab after logging into ClusPro. These will be stored in a .clusprorc file in your home directory.


$ cluspro_submit --help

Usage: cluspro_submit [OPTIONS]

 Jobs are expected to be in one of four "modes": docking with a provided
 ligand PDB ID or PDB file, docking in multimer mode (using --multimer), or
 peptide docking (using --pepmot and --pepseq). If using multimer mode add
 --multimer and specify dimer or trimer (ex. --multimer dimer or --multimer
 trimer). If using peptide mode supply both the peptide motif and sequence
 (ex. --pepmot KXRRL --pepseq KGRRL). If using dimer classification mode add
 --dcmode and provide the chain(s) that define the potential dimer interface
 (ex. --rec-chains and --lig-chains). Mixing options from these four modes
 is not supported and will result in an error message.

  --username TEXT
  --secret TEXT
  --coeffs PATH               Coefficients file [Advanced]
  --rotations PATH            Rotations file [Advanced]
  -j, --jobname TEXT          Will default to job number
  -a, --antibodymode          Use Antibody mode [Advanced]
  -o, --othersmode            Use Others mode [Advanced]
  --receptor PATH             Upload a PDB file
  --ligand PATH               Upload a PDB file
  --recpdb TEXT               4-letter PDB code
  --ligpdb TEXT               4-letter PDB code
  --pepmot TEXT               Peptide motif
  --pepseq TEXT               Peptide sequence
  --pepexclusion TEXT         List of PDB ids to exclude from motif
  --rec-chains TEXT           Chains to use, for example "A B" (in double
  --lig-chains TEXT           Chains to use, for example "A B" (in double
  --rec-mask PATH             Receptor mask [Advanced]
  --lig-mask PATH             Ligand mask [Advanced]
  --rec-attraction PATH       Receptor attraction [Advanced]
  --lig-attraction PATH       Ligand attraction [Advanced]
  --rec-dssp                  Remove unstructured terminal residues in
                              receptor [Advanced]
  --lig-dssp                  Remove unstructured terminal residues in ligand [Advanced]
  --restraints PATH           Upload restraints file [Advanced]
  --saxs-file PATH            Upload SAXS profile [Advanced]
  --masknoncdr                Automatically mask non-CDR region, Antibody mode only [Advanced]
  --multimers [dimer|trimer]  Multimer mode [Advanced]
  --dcmode                    Use Dimer Classification mode
  --help                      Show this message and exit

If you write a script which submits the jobs in a loop, please submit no more than 50 jobs per batch (and then wait until these jobs finish before submitting more). Please pause for 5-10 seconds between job submissions within each batch.

Running cluspro_submit will print out the cluspro job id, which you should record and use later to download your job results.

Downloading Results

To download results from a finished job:

cluspro_download <jobid>

You can download multiple jobs at once:

cluspro_download <jobid1> <jobid2> <jobid3> ...

The results will be saved in the directory from which you ran the command.

Project details

Download files

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

Source Distribution

cluspro_api-1.1.0.tar.gz (9.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page