annotate lib/Fingerprints/EStateIndiciesFingerprints.pm @ 2:17fef9d80c97 draft

Deleted selected files
author deepakjadmin
date Wed, 20 Jan 2016 09:11:43 -0500
parents 2abf0d43254d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
1 package Fingerprints::EStateIndiciesFingerprints;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
2 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
3 # $RCSfile: EStateIndiciesFingerprints.pm,v $
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
4 # $Date: 2015/02/28 20:48:54 $
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
5 # $Revision: 1.19 $
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
6 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
7 # Author: Manish Sud <msud@san.rr.com>
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
8 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
9 # Copyright (C) 2015 Manish Sud. All rights reserved.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
10 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
11 # This file is part of MayaChemTools.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
12 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
13 # MayaChemTools is free software; you can redistribute it and/or modify it under
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
14 # the terms of the GNU Lesser General Public License as published by the Free
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
15 # Software Foundation; either version 3 of the License, or (at your option) any
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
16 # later version.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
17 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
18 # MayaChemTools is distributed in the hope that it will be useful, but without
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
19 # any warranty; without even the implied warranty of merchantability of fitness
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
20 # for a particular purpose. See the GNU Lesser General Public License for more
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
21 # details.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
22 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
23 # You should have received a copy of the GNU Lesser General Public License
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
24 # along with MayaChemTools; if not, see <http://www.gnu.org/licenses/> or
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
25 # write to the Free Software Foundation Inc., 59 Temple Place, Suite 330,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
26 # Boston, MA, 02111-1307, USA.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
27 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
28
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
29 use strict;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
30 use Carp;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
31 use Exporter;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
32 use Text::ParseWords;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
33 use TextUtil ();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
34 use FileUtil ();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
35 use MathUtil ();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
36 use Fingerprints::Fingerprints;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
37 use Molecule;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
38 use AtomTypes::EStateAtomTypes;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
39 use AtomicDescriptors::EStateValuesDescriptors;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
40
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
41 use vars qw(@ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
42
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
43 @ISA = qw(Fingerprints::Fingerprints Exporter);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
44 @EXPORT = qw();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
45 @EXPORT_OK = qw();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
46
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
47 %EXPORT_TAGS = (all => [@EXPORT, @EXPORT_OK]);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
48
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
49 # Setup class variables...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
50 my($ClassName);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
51 _InitializeClass();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
52
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
53 # Overload Perl functions...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
54 use overload '""' => 'StringifyEStateIndiciesFingerprints';
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
55
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
56 # Class constructor...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
57 sub new {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
58 my($Class, %NamesAndValues) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
59
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
60 # Initialize object...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
61 my $This = $Class->SUPER::new();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
62 bless $This, ref($Class) || $Class;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
63 $This->_InitializeEStateIndiciesFingerprints();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
64
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
65 $This->_InitializeEStateIndiciesFingerprintsProperties(%NamesAndValues);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
66
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
67 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
68 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
69
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
70 # Initialize object data...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
71 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
72 sub _InitializeEStateIndiciesFingerprints {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
73 my($This) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
74
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
75 # EStateIndicies is a vector containing sum of E-state values for E-state atom types
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
76 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
77 $This->{Type} = 'EStateIndicies';
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
78
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
79 # EStateAtomTypesSetToUse for EStateIndicies:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
80 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
81 # ArbitrarySize - Corrresponds to only E-state atom types detected in molecule
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
82 # FixedSize - Corresponds to fixed number of E-state atom types previously defined [ Ref 77 ]
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
83 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
84 # The default EStateAtomTypesSetToUse value for EStateIndicies fingerprints type: ArbitrarySize.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
85 # Possible values: ArbitrarySize or FixedSize.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
86 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
87 $This->{EStateAtomTypesSetToUse} = '';
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
88
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
89 # Assigned E-state atom types...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
90 %{$This->{EStateAtomTypes}} = ();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
91
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
92 # Vector values precision for real values during E-state indicies...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
93 $This->{ValuesPrecision} = 3;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
94
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
95 # Calculated E-state values and indicies for generating E-state indicies fingerprints...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
96 %{$This->{EStateValues}} = ();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
97 %{$This->{EStateIndicies}} = ();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
98 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
99
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
100 # Initialize class ...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
101 sub _InitializeClass {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
102 #Class name...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
103 $ClassName = __PACKAGE__;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
104
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
105 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
106
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
107 # Initialize object properties....
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
108 sub _InitializeEStateIndiciesFingerprintsProperties {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
109 my($This, %NamesAndValues) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
110
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
111 my($Name, $Value, $MethodName);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
112 while (($Name, $Value) = each %NamesAndValues) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
113 $MethodName = "Set${Name}";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
114 $This->$MethodName($Value);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
115 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
116
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
117 # Make sure molecule object was specified...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
118 if (!exists $NamesAndValues{Molecule}) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
119 croak "Error: ${ClassName}->New: Object can't be instantiated without specifying molecule...";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
120 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
121
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
122 $This->_InitializeEstateIndicies();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
123
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
124 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
125 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
126
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
127 # Initialize E-state indicies...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
128 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
129 sub _InitializeEstateIndicies {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
130 my($This) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
131
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
132 # Set default EStateAtomTypesSetToUse...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
133 if (!$This->{EStateAtomTypesSetToUse}) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
134 $This->{EStateAtomTypesSetToUse} = 'ArbitrarySize';
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
135 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
136
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
137 # Vector type...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
138 $This->{VectorType} = 'FingerprintsVector';
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
139
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
140 if ($This->{EStateAtomTypesSetToUse} =~ /^FixedSize$/i) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
141 $This->{FingerprintsVectorType} = 'OrderedNumericalValues';
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
142 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
143 else {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
144 $This->{FingerprintsVectorType} = 'NumericalValues';
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
145 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
146
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
147 $This->_InitializeFingerprintsVector();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
148
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
149 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
150 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
151
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
152 # Disable set size method...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
153 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
154 sub SetSize {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
155 my($This, $Type) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
156
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
157 croak "Error: ${ClassName}->SetSize: Can't change size: It's not allowed...";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
158 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
159
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
160 # Set E-state atom types set to use...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
161 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
162 sub SetEStateAtomTypesSetToUse {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
163 my($This, $Value) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
164
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
165 if ($This->{EStateAtomTypesSetToUse}) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
166 croak "Error: ${ClassName}->SetEStateAtomTypesSetToUse: Can't change size: It's already set...";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
167 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
168
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
169 if ($Value !~ /^(ArbitrarySize|FixedSize)/i) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
170 croak "Error: ${ClassName}->SetEStateAtomTypesSetToUse: Unknown EStateAtomTypesSetToUse value: $Value; Supported values: ArbitrarySize or FixedSize";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
171 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
172
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
173 $This->{EStateAtomTypesSetToUse} = $Value;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
174
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
175 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
176 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
177
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
178 # Set vector values precision for real values for E-state indicies...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
179 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
180 sub SetValuesPrecision {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
181 my($This, $Value) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
182
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
183 if (!TextUtil::IsPositiveInteger($Value)) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
184 croak "Error: ${ClassName}->SetValuesPrecision: ValuesPrecision value, $Value, is not valid: It must be a positive integer...";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
185 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
186 $This->{ValuesPrecision} = $Value;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
187
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
188 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
189 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
190
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
191 # Generate fingerprints description...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
192 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
193 sub GetDescription {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
194 my($This) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
195
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
196 # Is description explicity set?
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
197 if (exists $This->{Description}) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
198 return $This->{Description};
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
199 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
200
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
201 # Generate fingerprints description...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
202
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
203 return "$This->{Type}:$This->{EStateAtomTypesSetToUse}";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
204 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
205
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
206 # Generate electrotopological state indicies (E-state) [ Ref 75-78 ] fingerprints for
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
207 # non-hydrogen atoms in a molecule...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
208 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
209 # EStateIndicies fingerprints constitute a vector containing sum of E-state values
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
210 # for E-state atom types. Two types of E-state atom types set size are allowed:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
211 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
212 # ArbitrarySize - Corrresponds to only E-state atom types detected in molecule
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
213 # FixedSize - Corresponds to fixed number of E-state atom types previously defined
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
214 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
215 # Module AtomTypes::EStateAtomTypes.pm is used to assign E-state atom types to
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
216 # non-hydrogen atoms in the molecule which is able to assign atom types to any valid
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
217 # atom group. However, for FixedSize value of EStateAtomTypesSetToUse, only a fixed
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
218 # set of E-state atom types corresponding to specific atom groups [ Appendix III in
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
219 # Ref 77 ] are used for fingerprints.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
220 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
221 # The fixed size E-state atom type set size used during generation of fingerprints corresponding
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
222 # FixedSize value of EStateAtomTypesSetToUse contains 87 E-state non-hydrogen atom types
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
223 # in EStateAtomTypes.csv data file distributed with MayaChemTools.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
224 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
225 # Combination of Type and EStateAtomTypesSetToUse allow generation of 2 different types of
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
226 # E-state indicies fingerprints:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
227 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
228 # Type EStateAtomTypesSetToUse
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
229 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
230 # EStateIndicies ArbitrarySize [ default fingerprints ]
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
231 # EStateIndicies FixedSize
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
232 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
233 # The default is generate EStateIndicies type fingeprints corresponding to ArbitrarySize as
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
234 # EStateAtomTypesSetToUse value.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
235 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
236 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
237 sub GenerateFingerprints {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
238 my($This) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
239
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
240 # Cache appropriate molecule data...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
241 $This->_SetupMoleculeDataCache();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
242
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
243 # Assign E-state atom types...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
244 if (!$This->_AssignEStateAtomTypes()) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
245 carp "Warning: ${ClassName}->GenerateFingerprints: $This->{Type} fingerprints generation didn't succeed: Couldn't assign valid E-state atom types to all atoms...";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
246 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
247 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
248
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
249 # Calculate E-state indicies...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
250 if (!$This->_CalculateEStateIndicies()) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
251 carp "Warning: ${ClassName}->GenerateFingerprints: $This->{Type} fingerprints generation didn't succeed: Couldn't calculate E-state values for all atoms...";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
252 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
253 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
254
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
255 # Set final fingerprints...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
256 $This->_SetFinalFingerprints();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
257
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
258 # Clear cached molecule data...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
259 $This->_ClearMoleculeDataCache();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
260
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
261 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
262 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
263
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
264 # Assign E-state atom types...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
265 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
266 sub _AssignEStateAtomTypes {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
267 my($This) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
268 my($EStateAtomTypes, $Atom, $AtomID, $AtomType);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
269
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
270 %{$This->{EStateAtomTypes}} = ();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
271
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
272 # Assign E-state atom types...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
273 $EStateAtomTypes = new AtomTypes::EStateAtomTypes('Molecule' => $This->{Molecule}, 'IgnoreHydrogens' => 1);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
274 $EStateAtomTypes->AssignAtomTypes();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
275
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
276 # Make sure atom types assignment is successful...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
277 if (!$EStateAtomTypes->IsAtomTypesAssignmentSuccessful()) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
278 return undef;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
279 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
280
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
281 # Collect assigned atom types...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
282 for $Atom (@{$This->{Atoms}}) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
283 $AtomID = $Atom->GetID();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
284
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
285 $AtomType = $EStateAtomTypes->GetAtomType($Atom);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
286 $This->{EStateAtomTypes}{$AtomID} = $AtomType;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
287 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
288 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
289 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
290
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
291 # Calculate E-state indicies by summing up E-state values for specific
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
292 # E-state atom types...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
293 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
294 sub _CalculateEStateIndicies {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
295 my($This) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
296 my($Atom, $AtomID, $AtomType, $EStateValue);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
297
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
298 # Calculate E-state values to generate E-state indicies...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
299 if (!$This->_CalculateEStateValuesDescriptors()) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
300 return undef;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
301 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
302
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
303 # Calculate E-state indicies...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
304 for $Atom (@{$This->{Atoms}}) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
305 $AtomID = $Atom->GetID();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
306
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
307 $AtomType = $This->{EStateAtomTypes}{$AtomID};
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
308 $EStateValue = $This->{EStateValues}{$AtomID};
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
309
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
310 if (!exists $This->{EStateIndicies}{$AtomType}) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
311 $This->{EStateIndicies}{$AtomType} = 0;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
312 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
313
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
314 $This->{EStateIndicies}{$AtomType} += $EStateValue;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
315 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
316 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
317 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
318
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
319 # Calculate E-state values for E-state indicies...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
320 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
321 sub _CalculateEStateValuesDescriptors {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
322 my($This) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
323 my($EStateValuesDescriptors, $Atom, $AtomID, $EStateValue);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
324
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
325 %{$This->{EStateValues}} = ();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
326
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
327 # Calculate and assign E-state values...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
328 $EStateValuesDescriptors = new AtomicDescriptors::EStateValuesDescriptors('Molecule' => $This->{Molecule});
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
329 $EStateValuesDescriptors->GenerateDescriptors();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
330
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
331 # Make sure E-state values calculation is successful...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
332 if (!$EStateValuesDescriptors->IsDescriptorsGenerationSuccessful()) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
333 return undef;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
334 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
335
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
336 # Collect assigned E-state values...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
337 for $Atom (@{$This->{Atoms}}) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
338 $AtomID = $Atom->GetID();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
339 $EStateValue = $EStateValuesDescriptors->GetDescriptorValue($Atom);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
340 $This->{EStateValues}{$AtomID} = $EStateValue;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
341 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
342 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
343 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
344
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
345 # Set final final fingerpritns for E-state indicies...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
346 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
347 sub _SetFinalFingerprints {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
348 my($This) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
349 my($AtomType, $ValuesPrecision, $EStateAtomTypesDataRef, @Values, @IDs);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
350
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
351 # Mark successful generation of fingerprints...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
352 $This->{FingerprintsGenerated} = 1;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
353
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
354 @Values = ();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
355 @IDs = ();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
356
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
357 $ValuesPrecision = $This->{ValuesPrecision};
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
358
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
359 if ($This->{EStateAtomTypesSetToUse} =~ /^FixedSize$/i) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
360 # Use fixed size E-state atom types set for non-hydrogen atoms...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
361 for $AtomType (@{AtomTypes::EStateAtomTypes::GetAllPossibleEStateNonHydrogenAtomTypes()}) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
362 push @IDs, "S${AtomType}";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
363 push @Values, exists($This->{EStateIndicies}{$AtomType}) ? MathUtil::round($This->{EStateIndicies}{$AtomType}, $ValuesPrecision) : 0;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
364 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
365 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
366 else {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
367 for $AtomType (sort keys %{$This->{EStateIndicies}}) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
368 push @IDs, "S${AtomType}";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
369 push @Values, MathUtil::round($This->{EStateIndicies}{$AtomType}, $ValuesPrecision);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
370 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
371 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
372
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
373 # Add IDs and values to fingerprint vector...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
374 if (@IDs) {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
375 $This->{FingerprintsVector}->AddValueIDs(\@IDs);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
376 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
377 $This->{FingerprintsVector}->AddValues(\@Values);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
378
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
379 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
380 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
381
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
382 # Cache appropriate molecule data...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
383 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
384 sub _SetupMoleculeDataCache {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
385 my($This) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
386
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
387 # Get all non-hydrogen atoms...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
388 my($NegateAtomCheckMethod);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
389 $NegateAtomCheckMethod = 1;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
390 @{$This->{Atoms}} = $This->GetMolecule()->GetAtoms("IsHydrogen", $NegateAtomCheckMethod);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
391
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
392 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
393 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
394
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
395 # Clear cached molecule data...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
396 #
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
397 sub _ClearMoleculeDataCache {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
398 my($This) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
399
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
400 @{$This->{Atoms}} = ();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
401
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
402 return $This;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
403 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
404
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
405 # Return a string containg data for EStateIndiciesFingerprints object...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
406 sub StringifyEStateIndiciesFingerprints {
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
407 my($This) = @_;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
408 my($EStateIndiciesFingerprintsString);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
409
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
410 # Type of Keys...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
411 $EStateIndiciesFingerprintsString = "Type: $This->{Type}; EStateAtomTypesSetToUse: $This->{EStateAtomTypesSetToUse}";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
412
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
413 # Fingerprint vector...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
414 $EStateIndiciesFingerprintsString .= "; FingerprintsVector: < $This->{FingerprintsVector} >";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
415
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
416 return $EStateIndiciesFingerprintsString;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
417 }
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
418
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
419 1;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
420
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
421 __END__
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
422
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
423 =head1 NAME
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
424
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
425 EStateIndiciesFingerprints
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
426
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
427 =head1 SYNOPSIS
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
428
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
429 use Fingerprints::EStateIndiciesFingerprints;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
430
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
431 use Fingerprints::EStateIndiciesFingerprints qw(:all);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
432
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
433 =head1 DESCRIPTION
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
434
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
435 B<EStateIndiciesFingerprints> [ Ref 75-78 ] class provides the following methods:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
436
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
437 new, GenerateFingerprints, GetDescription, SetEStateAtomTypesSetToUse,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
438 SetValuesPrecision, StringifyEStateIndiciesFingerprints
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
439
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
440 B<EStateIndiciesFingerprints> is derived from B<Fingerprints> class which in turn
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
441 is derived from B<ObjectProperty> base class that provides methods not explicitly defined
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
442 in B<AtomNeighborhoodsFingerprints>, B<Fingerprints> or B<ObjectProperty> classes using Perl's
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
443 AUTOLOAD functionality. These methods are generated on-the-fly for a specified object property:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
444
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
445 Set<PropertyName>(<PropertyValue>);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
446 $PropertyValue = Get<PropertyName>();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
447 Delete<PropertyName>();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
448
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
449 E-state atom types are assigned to all non-hydrogen atoms in a molecule using module
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
450 AtomTypes::EStateAtomTypes.pm and E-state values are calculated using module
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
451 AtomicDescriptors::EStateValues.pm. Using E-state atom types and E-state values,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
452 B<EStateIndiciesFingerprints> constituting sum of E-state values for E-sate atom types
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
453 are generated.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
454
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
455 Two types of E-state atom types set size are allowed:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
456
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
457 ArbitrarySize - Corresponds to only E-state atom types detected
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
458 in molecule
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
459 FixedSize - Corresponds to fixed number of E-state atom types previously
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
460 defined
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
461
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
462 Module AtomTypes::EStateAtomTypes.pm, used to assign E-state atom types to
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
463 non-hydrogen atoms in the molecule, is able to assign atom types to any valid
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
464 atom group. However, for I<FixedSize> value of B<EStateAtomTypesSetToUse>, only a
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
465 fixed set of E-state atom types corresponding to specific atom groups [ Appendix III in
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
466 Ref 77 ] are used for fingerprints.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
467
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
468 The fixed size E-state atom type set size used during generation of fingerprints contains
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
469 87 E-state non-hydrogen atom types in EStateAtomTypes.csv data file distributed with
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
470 MayaChemTools.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
471
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
472 Combination of Type and EStateAtomTypesSetToUse allow generation of 2 different types of
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
473 E-state indicies fingerprints:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
474
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
475 Type EStateAtomTypesSetToUse
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
476
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
477 EStateIndicies ArbitrarySize [ default fingerprints ]
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
478 EStateIndicies FixedSize
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
479
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
480 The current release of MayaChemTools generates the following types of E-state
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
481 fingerprints vector strings:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
482
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
483 FingerprintsVector;EStateIndicies:ArbitrarySize;11;NumericalValues;IDs
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
484 AndValuesString;SaaCH SaasC SaasN SdO SdssC SsCH3 SsF SsOH SssCH2 SssN
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
485 H SsssCH;24.778 4.387 1.993 25.023 -1.435 3.975 14.006 29.759 -0.073 3
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
486 .024 -2.270
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
487
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
488 FingerprintsVector;EStateIndicies:FixedSize;87;OrderedNumericalValues;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
489 ValuesString;0 0 0 0 0 0 0 3.975 0 -0.073 0 0 24.778 -2.270 0 0 -1.435
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
490 4.387 0 0 0 0 0 0 3.024 0 0 0 0 0 0 0 1.993 0 29.759 25.023 0 0 0 0 1
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
491 4.006 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
492 0 0 0 0 0 0 0 0 0 0 0 0 0 0
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
493
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
494 FingerprintsVector;EStateIndicies:FixedSize;87;OrderedNumericalValues;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
495 IDsAndValuesString;SsLi SssBe SssssBem SsBH2 SssBH SsssB SssssBm SsCH3
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
496 SdCH2 SssCH2 StCH SdsCH SaaCH SsssCH SddC StsC SdssC SaasC SaaaC Sssss
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
497 C SsNH3p SsNH2 SssNH2p SdNH SssNH SaaNH StN SsssNHp SdsN SaaN SsssN Sd
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
498 0 0 0 0 0 0 0 3.975 0 -0.073 0 0 24.778 -2.270 0 0 -1.435 4.387 0 0 0
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
499 0 0 0 3.024 0 0 0 0 0 0 0 1.993 0 29.759 25.023 0 0 0 0 14.006 0 0 0 0
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
500 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0...
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
501
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
502 =head2 METHODS
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
503
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
504 =over 4
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
505
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
506 =item B<new>
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
507
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
508 $EStateIndiciesFingerprints = new EStateIndiciesFingerprints(%NamesAndValues);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
509
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
510 Using specified I<EStateIndiciesFingerprints> property names and values hash, B<new> method creates a new object
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
511 and returns a reference to newly created B<PathLengthFingerprints> object. By default, the
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
512 following properties are initialized:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
513
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
514 Molecule = '';
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
515 Type = 'EStateIndicies'
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
516 EStateAtomTypesSetToUse = 'ArbitrarySize'
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
517 ValuesPrecision = 3
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
518
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
519 Examples:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
520
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
521 $EStateIndiciesFingerprints = new AtomTypesFingerprints(
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
522 'Molecule' => $Molecule,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
523 'EStateAtomTypesSetToUse' =>
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
524 'ArbitrarySize');
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
525
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
526 $EStateIndiciesFingerprints = new AtomTypesFingerprints(
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
527 'Molecule' => $Molecule,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
528 'EStateAtomTypesSetToUse' =>
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
529 'FixedSize');
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
530
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
531 $EStateIndiciesFingerprints->GenerateFingerprints();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
532 print "$EStateIndiciesFingerprints\n";
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
533
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
534 =item B<GenerateFingerprints>
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
535
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
536 $EStateIndiciesFingerprints = $EStateIndiciesFingerprints->
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
537 GenerateEStateIndiciesFingerprints();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
538
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
539 Generates EState keys fingerprints and returns I<EStateIndiciesFingerprints>.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
540
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
541 =item B<GetDescription>
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
542
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
543 $Description = $EStateIndiciesFingerprints->GetDescription();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
544
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
545 Returns a string containing description of EState keys fingerprints.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
546
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
547 =item B<SetEStateAtomTypesSetToUse>
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
548
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
549 $EStateIndiciesFingerprints->SetEStateAtomTypesSetToUse($Value);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
550
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
551 Sets I<Value> of I<EStateAtomTypesSetToUse> and returns I<EStateIndiciesFingerprints>.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
552 Possible values: I<ArbitrarySize or FixedSize>. Default value: I<ArbitrarySize>.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
553
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
554 =item B<SetValuesPrecision>
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
555
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
556 $EStateIndiciesFingerprints->SetValuesPrecision($Precision);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
557
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
558 Sets precesion of E-state values to use during generation of E-state indices fingerprints
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
559 and returns I<EStateIndiciesFingerprints>. Possible values: I<Positive integers>.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
560 Default value: I<3>.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
561
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
562 =item B<StringifyEStateIndiciesFingerprints>
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
563
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
564 $String = $EStateIndiciesFingerprints->StringifyEStateIndiciesFingerprints();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
565
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
566 Returns a string containing information about I<EStateIndiciesFingerprints> object.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
567
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
568 =back
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
569
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
570 =head1 AUTHOR
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
571
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
572 Manish Sud <msud@san.rr.com>
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
573
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
574 =head1 SEE ALSO
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
575
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
576 Fingerprints.pm, FingerprintsStringUtil.pm, AtomNeighborhoodsFingerprints.pm, AtomTypesFingerprints.pm,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
577 ExtendedConnectivityFingerprints.pm, MACCSKeys.pm, PathLengthFingerprints.pm,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
578 TopologicalAtomPairsFingerprints.pm, TopologicalAtomTripletsFingerprints.pm,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
579 TopologicalAtomTorsionsFingerprints.pm, TopologicalPharmacophoreAtomPairsFingerprints.pm,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
580 TopologicalPharmacophoreAtomTripletsFingerprints.pm
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
581
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
582 =head1 COPYRIGHT
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
583
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
584 Copyright (C) 2015 Manish Sud. All rights reserved.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
585
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
586 This file is part of MayaChemTools.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
587
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
588 MayaChemTools is free software; you can redistribute it and/or modify it under
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
589 the terms of the GNU Lesser General Public License as published by the Free
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
590 Software Foundation; either version 3 of the License, or (at your option)
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
591 any later version.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
592
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
593 =cut