Filter Collection
Description
Creates a new collection from an existing Giga Docking or FastROCS collection that is filtered by molecular property (or randomly).
Filtering can be done at random, with SMARTS patterns, with OEFilter, or by many basic molecular properties. All filters of this floe are turned off by default, and thus the input collection will be a copy of the output collection unless one or more of the filters is enabled.
Promoted Parameters
Title in user interface (promoted name)
Inputs
Input Collection (input_collection): An input collection to filter.
Required
Type: collection_source
Outputs
Filtered Collection Name (output_collection_name): Name of the collection to create.
Required
Type: collection_sink
Default: Filtered Collection
Temporary Filtered Collection Name (temporary_filtered_collection_name): This collection will be created by this floe for internal use during the run and will be automatically deleted when the run finishes.
Type: collection_sink
Default: Temporary Filtered Collection (Filter Collection)
Options
Dry Run (switch): If ‘On’, molecules will be read and passed through the filtering cubes normally but will not be passed to the collection creation cubes. This makes the Floe inexpensive and fast to run, however no output collection will be generated. With this switch on you can see how many molecules will be read from your input file(s)/collection(s) and how many will pass the filters (examine the filtering Cube port counts) that have been configured, and make adjustments quickly. Once the best filtering settings are determined you can run the Floe with those settings and this option turned off.
Required
Type: boolean
Default: False
Choices: [True, False]
Keep this fraction (random_retain_probability): This parameter is the fraction of the input molecules that will be retained using a random selection criterion. Set this value to less than one to create output collection with a random subset of the from the input collection.
Required
Type: decimal
Default: 1.0
Filtering : Basic Properties
Max molecular weight (mw_max): Molecules with molecular weight greater than this value will be filtered out. If unspecified this cube will not filter out molecules with high molecular weight.
Type: decimal
Min molecular weight (mw_min): Molecules with molecular weight less than this value will be filtered out. If unspecified this cube will not filter out molecules with low molecular weight.
Type: decimal
Max rotatable bond count (rot_bond_max): Molecules with rotatable bond count greater than this value will be filtered out. If unspecified this cube will not filter out molecules with high rotatable bond count.
Type: integer
Min rotatable bond count (rot_bond_min): Molecules with rotatable bond count less than this value will be filtered out. If unspecified this cube will not filter out molecules with low rotatable bond count.
Type: integer
Max count undefined atom stereo (atom_stereo_max): Molecules with count undefined atom stereo greater than this value will be filtered out. If unspecified this cube will not filter out molecules with high count undefined atom stereo.
Type: integer
Max count undefined bond stereo (bond_stereo_max): Molecules with count undefined bond stereo greater than this value will be filtered out. If unspecified this cube will not filter out molecules with high count undefined bond stereo.
Type: integer
Max acceptor count (acc_max): Molecules with acceptor count greater than this value will be filtered out. If unspecified this cube will not filter out molecules with high acceptor count.
Type: integer
Min acceptor count (acc_min): Molecules with acceptor count less than this value will be filtered out. If unspecified this cube will not filter out molecules with low acceptor count.
Type: integer
Max donor count (don_max): Molecules with donor count greater than this value will be filtered out. If unspecified this cube will not filter out molecules with high donor count.
Type: integer
Min donor count (don_min): Molecules with donor count less than this value will be filtered out. If unspecified this cube will not filter out molecules with low donor count.
Type: integer
Max topological polar surface area (tpsa_max): Molecules with topological polar surface area greater than this value will be filtered out. If unspecified this cube will not filter out molecules with high topological polar surface area.
Type: decimal
Min topological polar surface area (tpsa_min): Molecules with topological polar surface area less than this value will be filtered out. If unspecified this cube will not filter out molecules with low topological polar surface area.
Type: decimal
Max xlogp (xlogp_max): Molecules with xlogp greater than this value will be filtered out. If unspecified this cube will not filter out molecules with high xlogp.
Type: decimal
Min xlogp (xlogp_min): Molecules with xlogp less than this value will be filtered out. If unspecified this cube will not filter out molecules with low xlogp.
Type: decimal
Max formal charge (charge_max): Molecules with formal charge greater than this value will be filtered out. If unspecified this cube will not filter out molecules with high formal charge.
Type: integer
Min formal charge (charge_min): Molecules with formal charge less than this value will be filtered out. If unspecified this cube will not filter out molecules with low formal charge.
Type: integer
Max aromatic ring count (aro_max): Molecules with aromatic ring count greater than this value will be filtered out. If unspecified this cube will not filter out molecules with high aromatic ring count.
Type: integer
Min aromatic ring count (aro_min): Molecules with aromatic ring count less than this value will be filtered out. If unspecified this cube will not filter out molecules with low aromatic ring count.
Type: integer
Filtering: SMARTS
Required SMARTS (required_smarts): If one or more SMARTS patterns are supplied to this parameter then every molecule passed to this cube must match one of these smarts patterns of it will be filtered. This check is skipped if no SMARTS patterns are supplied to this cube.
Type: string
Excluded SMARTS (excluded_smarts): Every molecule that matched any of the SMARTS patterns supplied to this parameter will be filtered.
Type: string
Filtering: OEFilter
OEFilter Type (oefilter_type):
Required
Type: string
Default: None
Choices: [‘BlockBuster’, ‘Lead’, ‘Drug’, ‘PAINS’, ‘None’]
Filter Rules (filter_in): Optional rules for OEFilter (see https://docs.eyesopen.com/toolkits/python/molproptk/filter_files.html). These rules will be added to the OEFilter rules. Select None for ‘OEFilter Type’ if you want to replace rather than add rules.
Type: file_in
Filtering: 2D Similarity to Known Molecules
Known Molecules (known_molecules): If this parameter is specified each molecule being prepared will be assigned a single 2D Tanimoto value equal highest 2D Tanimoto to any molecule in this dataset(s). The prepared molecule will then be filtered by comparing this value to the setting of the ‘Filter Out Tanimotos Higher Than’ and/or ‘Filter Out Tanimotos Lower Than’ parameters. WARNING: A significant filtering compute cost can be incurred, even in ‘Dry Run’ mode, if a large number of molecule are passed to this parameter (For a 1 Billion molecule collection and 10K known molecules the filtering portion of the cost will typically be about ~$20).
Type: data_source
Filter Out Tanimotos Higher Than (filter_out_tanimotos_higher_than): If specified molecules with a 2D Tanimoto higher that this value will be filtered out. Use this parameter if you want to remove molecules that are similar in 2D space to any of the known molecules.
Type: decimal
Filter Out Tanimotos Lower Than (filter_out_tanimotos_lower_than): If specified molecules with a 2D Tanimoto lower than this value will be filtered out. Use this parameter if you want to remove molecules are different in 2D space to any of the known molecules.
Type: decimal
Known Molecules 2D Fingerprint Method (known_molecules_2d_fingerprint_method): The 2D Fingerprint method used to compute the Tanimotos for the known molecules filter.
Type: string
Default: Circular
Choices: [‘Circular’, ‘Path’, ‘Tree’]
Use Virtual Screening 2D Fingerprint Variant (use_virtual_screening_2d_fingerprint_variant): If ‘On’ the virtual screening variant of the selected 2D fingerprint will be used for the knownmolecules filter. The virtual screening variant treats certain functional group identically regardless of there pKa state. E.g. protonated and unprotonated carboxylic acids.
Type: boolean
Default: True
Choices: [True, False]
Known Molecule Tanimoto Field (known_molecule_tanimoto_field): If this parameter is specified the 2D Tanimoto used for known molecule filtering for each processed molecule will be placed in the output collection in a field of this name. If unspecified the Tanimoto value will not be stored in the output collection.
Type: field_parameter::float
Maximum Number of Filtering Cubes (maximum_number_of_filtering_cubes): Maximum number of cubes to use for filtering. Increasing this value can improved the runtime in cases where a large number of known molecules are supplied. This value can only be set above the default value of 250 if the number of molecules passed to ‘Filtering: 2D Similarity To Known Molecules -> Known Molecules’ time the setting of ‘Options->Keep This Fraction’ is greater than 10000.
Type: integer
Default: 500
Input Fields
Known Molecule Field (known_molecule_field): Field on the known molecules dataset holding the known molecules. If unspecified the default Primary molecule on the record will be used.
Type: field_parameter::mol