|
| Previous TOC Next | TopologicalPharmacophoreAtomTripletsFingerprints.pl | Code | PDF | PDFGreen | PDFA4 | PDFA4Green |
TopologicalPharmacophoreAtomTripletsFingerprints.pl - Generate topological pharmacophore atom triplets fingerprints for SD files
TopologicalPharmacophoreAtomTripletsFingerprints.pl SDFile(s)...
TopologicalPharmacophoreAtomTripletsFingerprints.pl --AtomTripletsSetSizeToUse ArbitrarySize | FixedSize] [-a, --AtomTypesToUse ''AtomType1, AtomType2...''] [--AtomTypesWeight ''AtomType1, Weight1, AtomType2, Weight2...''] [--CompoundID DataFieldName or LabelPrefixString] [--CompoundIDLabel text] [--CompoundIDMode] [--DataFields ''FieldLabel1, FieldLabel2,...''] [-d, --DataFieldsMode All | Common | Specify | CompoundID] [--DistanceBinSize number] [-f, --Filter Yes | No] [--FingerprintsLabelMode FingerprintsLabelOnly | FingerprintsLabelWithIDs] [--FingerprintsLabel text] [-h, --help] [-k, --KeepLargestComponent Yes | No] [--MinDistance number] [--MaxDistance number] [--OutDelim comma | tab | semicolon] [--output SD | FP | text | all] [-o, --overwrite] [-q, --quote Yes | No] [-r, --root RootName] [-u, --UseTriangleInequality Yes | No] [-v, --VectorStringFormat ValuesString, IDsAndValuesString | IDsAndValuesPairsString | ValuesAndIDsString | ValuesAndIDsPairsString] [-w, --WorkingDir dirname] SDFile(s)...
Generate topological pharmacophore atom triplets fingerprints [ Ref 66, Ref 68-71 ] for SDFile(s) and create appropriate SD, FP or CSV/TSV text file(s) containing fingerprints vector strings corresponding to molecular fingerprints.
Multiple SDFile names are separated by spaces. The valid file extensions are .sdf and .sd. All other file names are ignored. All the SD files in a current directory can be specified either by *.sdf or the current directory name.
Based on the values specified for --AtomTypesToUse, pharmacophore atom types are assigned to all non-hydrogen atoms in a molecule and a distance matrix is generated. Using --MinDistance, --MaxDistance, and --DistanceBinSize values, a binned distance matrix is generated with lower bound on the distance bin as the distance in distance matrix; the lower bound on the distance bin is also used as the distance between atom pairs for generation of atom triplet identifiers.
A pharmacophore atom triplets basis set is generated for all unique atom triplets constituting atom pairs binned distances between --MinDistance and --MaxDistance. The value of --UseTriangleInequality determines whether the triangle inequality test is applied during generation of atom triplets basis set. The lower distance bound, along with specified pharmacophore types, is used during generation of atom triplet IDs.
Using binned distance matrix and pharmacohore atom types, occurrence of unique pharmacohore atom triplets is counted.
The final pharmacophore atom triples count along with atom pair identifiers involving all non-hydrogen atoms constitute pharmacophore topological atom triplets fingerprints of the molecule.
For ArbitrarySize value of --AtomTripletsSetSizeToUse option, the fingerprint vector correspond to only those topological pharmacophore atom triplets which are present and have non-zero count. However, for FixedSize value of --AtomTripletsSetSizeToUse option, the fingerprint vector contains all possible valid topological pharmacophore atom triplets with both zero and non-zero count values.
Example of SD file containing topological pharmacophore atom triplets fingerprints string data:
Example of FP file containing topological pharmacophore atom triplets fingerprints string data:
Example of CSV Text file containing topological pharmacophore atom triplets fingerprints string data:
The current release of MayaChemTools generates the following types of topological pharmacophore atom triplets fingerprints vector strings:
Possible values: ArbitrarySize | FixedSize; Default value: ArbitrarySize.
For ArbitrarySize value of --AtomTripletsSetSizeToUse option, the fingerprint vector correspond to only those topological pharmacophore atom triplets which are present and have non-zero count. However, for FixedSize value of --AtomTripletsSetSizeToUse option, the fingerprint vector contains all possible valid topological pharmacophore atom triplets with both zero and non-zero count values.
Possible values for pharmacophore atom types are: Ar, CA, H, HBA, HBD, Hal, NI, PI, RA. Default value [ Ref 71 ] : HBD,HBA,PI,NI,H,Ar.
The pharmacophore atom types abbreviations correspond to:
AtomTypes::FunctionalClassAtomTypes module is used to assign pharmacophore atom types. It uses following definitions [ Ref 60-61, Ref 65-66 ]:
For DataField value of --CompoundIDMode option, it corresponds to datafield label name whose value is used as compound ID; otherwise, it's a prefix string used for generating compound IDs like LabelPrefixString<Number>. Default value, Cmpd, generates compound IDs which look like Cmpd<Number>.
Examples for DataField value of --CompoundIDMode:
Examples for LabelPrefix or MolNameOrLabelPrefix value of --CompoundIDMode:
The value specified above generates compound IDs which correspond to Compound<Number> instead of default value of Cmpd<Number>.
Possible values: DataField | MolName | LabelPrefix | MolNameOrLabelPrefix. Default value: LabelPrefix.
For MolNameAndLabelPrefix value of --CompoundIDMode, molname line in SDFile(s) takes precedence over sequential compound IDs generated using LabelPrefix and only empty molname values are replaced with sequential compound IDs.
This is only used for CompoundID value of --DataFieldsMode option.
This is only used for Specify value of --DataFieldsMode option.
Examples:
For default --MinDistance and --MaxDistance values of 1 and 10 with --DistanceBinSize of 2 [ Ref 70 ], the following 5 distance bins are generated:
The lower distance bound on the distance bin is uses to bin the distance between atom pairs in atom triplets. So in the previous example, atom pairs with distances 1 and 2 fall in first distance bin, atom pairs with distances 3 and 4 fall in second distance bin and so on.
In order to distribute distance bins of equal size, the last bin is allowed to go past --MaxDistance by up to distance bin size. For example, --MinDistance and --MaxDistance values of 2 and 10 with --DistanceBinSize of 2 generates the following 6 distance bins:
By default, compound data is checked before calculating fingerprints and compounds containing atom data corresponding to non-element symbols or no atom data are ignored.
Possible values: FingerprintsLabelOnly | FingerprintsLabelWithIDs. Default value: FingerprintsLabelOnly.
Topological atom pairs IDs appended to --FingerprintsLabel value during FingerprintsLabelWithIDs values of --FingerprintsLabelMode correspond to atom pair count values in fingerprint vector string.
FingerprintsLabelWithIDs value of --FingerprintsLabelMode is ignored during ArbitrarySize value of --AtomTripletsSetSizeToUse option and topological atom triplets IDs not appended to the label.
For molecules containing multiple connected components, fingerprints can be generated in two different ways: use all connected components or just the largest connected component. By default, all atoms except for the largest connected component are deleted before generation of fingerprints.
Triangle distance inequality test implies that distance or binned distance between any two atom pairs in an atom triplet must be less than the sum of distances or binned distances between other two atoms pairs and greater than the difference of their distances.
Default value during FixedSize value of --AtomTripletsSetSizeToUse option: ValuesString. Default value during ArbitrarySize value of --AtomTripletsSetSizeToUse option: IDsAndValuesString.
ValuesString option value is not allowed for ArbitrarySize value of --AtomTripletsSetSizeToUse option.
Examples:
To generate topological pharmacophore atom triplets fingerprints of arbitrary size corresponding to 5 distance bins spanning distances from 1 through 10 using default atoms with distances satisfying triangle inequality and create a SampleTPATFP.csv file containing sequential compound IDs along with fingerprints vector strings data in ValuesString format, type:
To generate topological pharmacophore atom triplets fingerprints of fixed size corresponding to 5 distance bins spanning distances from 1 through 10 using default atoms with distances satisfying triangle inequality and create a SampleTPATFP.csv file containing sequential compound IDs along with fingerprints vector strings data in ValuesString format, type:
To generate topological pharmacophore atom triplets fingerprints of arbitrary size corresponding to 5 distance bins spanning distances from 1 through 10 using default atoms with distances satisfying triangle inequality and create SampleTPATFP.sdf, SampleTPATFP.fpf and SampleTPATFP.csv files with CSV file containing sequential compound IDs along with fingerprints vector strings data in ValuesString format, type:
To generate topological pharmacophore atom triplets fingerprints of arbitrary size corresponding to 5 distance bins spanning distances from 1 through 10 using default atoms with distances satisfying triangle inequality and create a SampleTPATFP.csv file containing sequential compound IDs along with fingerprints vector strings data in ValuesString format and atom triplets IDs in the fingerprint data column label starting with Fingerprints, type:
To generate topological pharmacophore atom triplets fingerprints of arbitrary size corresponding to 5 distance bins spanning distances from 1 through 10 using default atoms with distances not satisfying triangle inequality and create a SampleTPATFP.csv file containing sequential compound IDs along with fingerprints vector strings data in ValuesString format, type:
To generate topological pharmacophore atom triplets fingerprints of arbitrary size corresponding to 6 distance bins spanning distances from 1 through 12 using default atoms with distances satisfying triangle inequality and create a SampleTPATFP.csv file containing sequential compound IDs along with fingerprints vector strings data in ValuesString format, type:
To generate topological pharmacophore atom triplets fingerprints of arbitrary size corresponding to 6 distance bins spanning distances from 1 through 12 using ''HBD,HBA,PI, NI, H, Ar'' atoms with distances satisfying triangle inequality and create a SampleTPATFP.csv file containing sequential compound IDs along with fingerprints vector strings data in ValuesString format, type:
To generate topological pharmacophore atom triplets fingerprints of arbitrary size corresponding to 5 distance bins spanning distances from 1 through 10 using default atoms with distances satisfying triangle inequality and create a SampleTPATFP.csv file containing sequential compound IDs from molecule name line along with fingerprints vector strings data in ValuesString format, type:
To generate topological pharmacophore atom triplets fingerprints of arbitrary size corresponding to 5 distance bins spanning distances from 1 through 10 using default atoms with distances satisfying triangle inequality and create a SampleTPATFP.csv file containing sequential compound IDs using specified data field along with fingerprints vector strings data in ValuesString format, type:
To generate topological pharmacophore atom triplets fingerprints of arbitrary size corresponding to 5 distance bins spanning distances from 1 through 10 using default atoms with distances satisfying triangle inequality and create a SampleTPATFP.csv file containing sequential compound IDs using combination of molecule name line and an explicit compound prefix along with fingerprints vector strings data, type:
To generate topological pharmacophore atom triplets fingerprints of arbitrary size corresponding to 5 distance bins spanning distances from 1 through 10 using default atoms with distances satisfying triangle inequality and create a SampleTPATFP.csv file containing specific data fields columns along with fingerprints vector strings data, type:
To generate topological pharmacophore atom triplets fingerprints of arbitrary size corresponding to 5 distance bins spanning distances from 1 through 10 using default atoms with distances satisfying triangle inequality and create a SampleTPATFP.csv file containing common data fields columns along with fingerprints vector strings data, type:
To generate topological pharmacophore atom triplets fingerprints of arbitrary size corresponding to 5 distance bins spanning distances from 1 through 10 using default atoms with distances satisfying triangle inequality and create SampleTPATFP.sdf, SampleTPATFP.fpf and SampleTPATFP.csv files containing all data fields columns in CSV file along with fingerprints data, type:
InfoFingerprintsFiles.pl, SimilarityMatricesFingerprints.pl, AtomNeighborhoodsFingerprints.pl, ExtendedConnectivityFingerprints.pl, MACCSKeysFingerprints.pl, PathLengthFingerprints.pl, TopologicalAtomPairsFingerprints.pl, TopologicalAtomTorsionsFingerprints.pl, TopologicalPharmacophoreAtomPairsFingerprints.pl
Copyright (C) 2004-2012 Manish Sud. All rights reserved.
This file is part of MayaChemTools.
MayaChemTools is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
