# Optional Parameters¶

-in <filename>

Input molecules to pose-predict. If 3D molecules are input, the original conformations are retained for optimization as well as the expanded conformational ensemble.

Note

This option also aliases to -lig. For more alias details, please use the command:

> posit --help in


POSIT uses an internal conformation sampling to generate high-quality conformations. However, input ring structures (chair/boat) may not be reproduced as POSIT may choose a lower energy ring template during the sampling process.

Supported input file formats are:

File type Extension
OEBinary .oeb .oeb.gz
SDF .sdf .mol .sdf.gz .mol.gz
MOL2 .mol2 .mol2.gz
PDB .pdb .ent .pdb.gz .ent.gz
MacroModel .mmod .mmod.gz
Smiles .smi .smi.gz .ism.gz
-dbase <filename>

Input molecules to pose-predict. 3D molecules must be input as conformational expansion is not performed prior to fitting.

Note

For more alias details, please use the command:

> posit --help dbase


Note

-dbase is the fastest way to run POSIT on large datasets. The expected input is a pre-generated database of OMEGA generated conformers. It is recommended, above two rotatable bonds, to generate 100 conformers per rotatable bond when running OMEGA:

> omega2 -in renin/all.smi -out all.oeb.gz -rangeIncrement 1 \
-maxConfRange 200,200,300,400,500,600,700,800,900,1000,1100,1200,1300,1400,1500,1600


Supported input file formats are:

File type Extension
OEBinary .oeb .oeb.gz
SDF .sdf .mol .sdf.gz .mol.gz
MOL2 .mol2 .mol2.gz
PDB .pdb .ent .pdb.gz .ent.gz
-conftest <test type> [Default: isomeric]

Note

This flag has no effect when the database format is OEBinary

When non-OEBinary database file(s) (see parameter -dbase) are read a test is applied to determine if subsequent molecules in the database file(s) are conformers of the same molecule. This flag controls how that conformer test is applied.

The following test types are recognized

Test Type Subsequent molecules are conformers if they
isomeric Have the same numbers of atoms and bonds in the same order. Each atom and bond has identical properties with its order correspondent in the subsequent connection table. Have the same atom and bond stereochemistry.
absolute Have the same numbers of atoms and bonds in the same order. Each atom and bond has identical properties with its order correspondent in the subsequent connection table.
canonical Have the same absolute (non-isomeric) graph.
none Subsequent molecules never treated as a conformer. Database is effectively single conformer.
-molnames

This flag specifies a text file with the names of one or more molecules in supplied to the -dbase flag. If specified, only molecules with matching names will be read by the -dbase flag. If this flag is not specified all molecules will be read normally. Molecules names should be listed one per line.

The general purpose of this flag is to provide an easy mechanism for reading a few specific molecules that are contained in a large database, without having to extract those molecules by hand from the database.

## Multiprocessing Parameters¶

### Execute Options¶

-param

The argument for this flag is the name of a file containing control parameters. The control parameter file acts to either replace or augment the command line interface. All parameters necessary for program execution may be provided in the control parameter file, although any command given explicitly on the command line will supersede options found in the parameter file. The application generates a new parameter file containing the full set of execution parameters upon every execution. The name of the parameter file is created by combining the prefix base name with the ‘.param’ extension.

-mpi_np <n>

Specifies the number of processors n when the application is run in MPI mode.

-mpi_hostfile <filename>

Specifies the name of the file containing processors configuration. For every host this file should contain a line host_name slots=n where n is the number of processors on the host.

## Dock Options¶

-ignore_nitrogen_stereo

When examining the ligands to pose predict for stereo, ignore any missing nitrogen chirality. (This is normally caused by time averaging of crystal structures).

When expanding stereo, nitrogen stereo centers will not be assigned.

Note

POSIT may complain about stereo centers being changed by the optimization, this is more likely when ignoring nitrogen stereo centers since the optimization may decide a different stereo configuration is optimal.

This command is aliased to -ignoreNitrogenStereo.

POSIT now always expands missing stereo.

## Output Files¶

POSIT writes docked structure results to a single file, -docked_molecule_file – Ligand only output in one file.

By default, not all poses may be written to the output, to see where ligands were placed, consult the log file for more details. To control this behavior use the -outputall flag, which writes all output to the file specified by -out in order of input molecule.

-docked_molecule_file <filename>

If specified, this flag overrides the default name of the docked molecule output file. Only .oeb, .oeb.gz, .sdf and .sdf.gz formats are allowed as the poses best fit receptor and various other optimization results are tagged to the SD data of the molecule.

Note

The default file is posit_docked.oeb.gz, or <-prefix>_docked.oeb.gz if the -prefix flag is specified.

Ligands are written to the output file based on the desired sort order (see the -sortby flag).

Note

This command is aliased to -out.

-undocked_molecule_file

If specified this flag overrides the default name for the undocked molecule file.

Note

The default filename is posit_undocked.oeb.gz, or <-prefix>_undocked.oeb.gz if -prefix is specified.

-score_file

If specified overrides the default name of the output text file containing the scores of the docked molecules.

Note

The default filename is posit_score.txt or <-prefix>_score.txt if the -prefix flag is specified.

-report_file

If specified overrides the default output filename for the report file.

Note

The default filename for the report file is posit_report.txt or <-prefix>_report.txt if the -prefix flag is specified.

-status_file

If specified overrides the default filename for the status file.

Note

The default status file name is posit_status.txt or <-prefix>_status.txt if the -prefix flag is specified.

-rejected_file

If specified overrides the default filename for the reject file.

The reject file is a tab separated file containing the input ligand number, the ligand title and the reason for the ligand being undocked.

Example output:

Ligand #        Title#Status
0       lig1    No conformers above minimum probability
1       lig2    No conformers above minimum probability
2       lig3    No conformers above minimum probability
3       lig4    No conformers above minimum probability


Note

The default status file name is posit_rejected.txt or <-prefix>_rejected.txt if the -prefix flag is specified.

-settings_file

If specified overrides the default output filename for the setting file.

Note

The default settings filename is posit_settings.param or <-prefix>_settings.param if the -prefix flag is specified.

-clashed_molecule_file <filename>

Occasionally POSIT rejects ligands that probably have the correct binding mode but also display uncorrectable clashes. If this flag is set, clashed molecules will be written to this file in no specific output order.

It is important to be aware that because these are likely binding modes there is a chance that the clashed poses are still correct but the protein has reconfigured to accept the clashed pose.

Note

This command is aliased to -clash.

## Output Options¶

-hitlist_size

The hit size controls the number of molecules output by POSIT. If the hit list size is 0, a temporary file is created in order to sort the results for output.

In all cases, the output file is sorted by the current value of the -sortby command line argument.

-sortby

-sortby specifies the order in which to sort the output results. The two available sort orders are:

Allowed Clash Description
probability Sort results in order from highest pose probability to lowest.
asinput Sort the results in input order

[default = asinput]

-minimum_probability

By default POSIT only outputs relatively probable poses. To output all poses, set -minimum_probability to 0.

[default = 0.33]

-allowed_clashes

Clashes allowed at the end of optimization. There are three levels:

Allowed Clash Description
noclashes No clashes are allowed. Actually there is a little wiggle room here less than 0.2 Å penetration is not considered a clash.
mildclashes Mild clashes are allowed (>= 0.2 Ångström < 0.65 Ångström interpenetration)
allclashes All clashes are allowed.

The clash ranges have been tuned to account for average coordinate error in a sampling of PDB files, they are intended to be used as guidelines and may not be indicative of some clash states.

Note

If any of the receptors themselves have clashing ligands, a warning will be generated but posit will automatically be set to accept the receptor ligand by adjusting the clash setting appropriately.

All poses that are accepted by the probability calculation yet clash with the protein are written to the fail file (if specified).

[default = mildclashes]

-num_poses

Number of alternative poses to retain for each docked molecule. The default is to only output the most probable pose.

[default = 1]

-score_tag

Overrides the default tag used to attach the score to the output molecules

-no_extra_output_files

Suppress the default output of the score, status, settings, report and undocked files.

-no_dots

Suppress writing a dot (.) to standard error for each docking molecule (or x in the case of a failure).

-prefix

The text passed to this parameter will be preappended to all default output filenames (it does not affect output filenames explicitly set by the users).

-outputall

Shorthand to write all output including clashed or non probable molecules.