RosettaScripts API

The RosettaScripts API runs RosettaScripts XML scripts. This API allows you to run almost any Rosetta protocol through the Engine API framework.

This is an advanced feature of the engine API framework and the documentation below assumes familiarity with the Rosetta molecular modeling suite in general and RosettaScripts in particular. If you want to run Rosetta XML scripts through this API and need help, contact support@levitate.bio.

Examples

The RosettaScripts API interface requires a Rosetta XML script, a Rosetta flags file, and at least one additional input file (typically a PDB file).

For example, given the following XML script which runs a simple Relax protocol on an input pdb:

<ROSETTASCRIPTS>
    <MOVERS>
        <Idealize name="idealize"/>
        <FastRelax name="relax"/>
    </MOVERS>
    <PROTOCOLS>
        <Add mover_name="idealize"/>
        <Add mover_name="relax"/>
    </PROTOCOLS>
</ROSETTASCRIPTS>

And the following flags file:

-s 1ubq.pdb

The RosettaScripts job would be submitted to the API framework with the following command:

lev engine submit rosetta-scripts --xml-file script.xml --flags-file flags.txt --repeats 100 1ubq.pdb

Which will generate 100 output PDB files.

There are a few rarely used Rosetta Movers which have special Rosetta compilation requirements or make internal use of MPI. Protocols using these Movers cannot currently be executed using the RosettaScripts API. If you want to use one of these movers please contact support@levtiate.bio

Inputs

  • --xml-file (str)
    • An input RosettaScripts XML file
  • --flags-file (str)
    • An input Rosetta flags file containing all flags necessary to run the XML file. DO NOT include -nstruct in this file
  • --repeats (int64)
    • The number of models to generate, this is equivalent to the -nstruct flag and should be used in its place. Each model will be generated in parallel.
  • --memory (int64)
    • The maximum amount of memory available per CPU, in whole number GB. The default is 1 GB per CPU. If jobs are failing to complete due to memory issues, this value can be increased.

Outputs

  • results/
    • All inputs and outputs from each individual model generation, split into individual directories by CPU
  • pdbs/
    • All PDBs generated by all CPUs

Updated: