Class PoseLibrary

Parameters:

• file_name (string) - Path to the file upon with to operate. The 'file_name' pose file may contain multiple poses for each ligand. Default is "".
• file_type (string) - Should be 'pv' or 'lib'; used to determine the position of the first ligand pose. If not specified, determined from ext.
• sort_property_1 (string) - An m2io dataname or a space-separated list of m2io datanames that identify the values for single best pose per ligand-title sorting. The input string is broken into fields by split(). Default is "r_i_glide_gscore".
• sort_property_2 (string) - An m2io dataname or a space-separated list of m2io datanames that identify the values for ligand-title group sorting. The input string is broken into fields by split(). Default is "r_i_glide_emodel".

  SP and HTVS poses should use 'r_i_glide_emodel' to pick the best pose of the same ligand-title. XP poses should use 'i_glide_XP_PoseRank' to determine the best pose order within a ligand-title group.

• block_sort (bool) - Boolean for the initial sorting operation. The pose library can always be resorted at a later point, this attribute just sets the default sorting operation for the instance. If True, poses are organized into ligand-title grouping as normal. If False, the poses are organized by a straight multi-key sort of sort_property_1. If there are multiple poses per ligand title this option should be used with care. Default is True.

Helper method that calls sortIntraTitle(), then sortInterTitle(). No return value.

Creates tuples of poses with the same title, then sorts within each title-tuple by self.sort_property_2. No return value.

Ligands are not 'ranked' between titles by this function.

Raises an Exception if a pose without a title is encountered.

Orders the title_tuple families (see sortIntraTitle) by self.sort_property_2. No return value.

Orders the pose library in a Title agnostic manner, considering only sort_property_1; a simple (multi-key) sort of the docking results. The instance attribute 'pose_lib_order' is reassigned to the new ordered tuple, but since the block ordering is lost the attributes 'best_pose_lib_order' and 'title_tuples' are redefined as empty tuples, and 'title_blocks' is redefined to an empty dictionary.

Calculate simple statistics on the glide scores. Sets the self.statistic dictionary and adds the standard score (glide gscore) to the self.dock_results dict.

Returns None.

Outputs an ordered pose lib file. The pose order is the same as indexes' sequence of original file positions.

This method loads all pose structure.Structure objects into memory only if there are fewer than 'block_size' structures. Otherwise, it reads the input file multiple times, sorting structures in 'block_size' chunks until the entire library is sorted.

Returns None.

Writes a pose library with multiple poses per active but a single pose per 'decoy'. Returns None.

Writes a pose library with the top N poses per ligand. Returns None.

Assumes self.title_tuples is sorted in the desired order.