comparison mayachemtools/docs/modules/man3/Fingerprints.3 @ 0:73ae111cf86f draft

Uploaded
author deepakjadmin
date Wed, 20 Jan 2016 11:55:01 -0500
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:73ae111cf86f
1 .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.22)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .de Vb \" Begin verbatim text
10 .ft CW
11 .nf
12 .ne \\$1
13 ..
14 .de Ve \" End verbatim text
15 .ft R
16 .fi
17 ..
18 .\" Set up some character translations and predefined strings. \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
21 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
24 .tr \(*W-
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26 .ie n \{\
27 . ds -- \(*W-
28 . ds PI pi
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
31 . ds L" ""
32 . ds R" ""
33 . ds C` ""
34 . ds C' ""
35 'br\}
36 .el\{\
37 . ds -- \|\(em\|
38 . ds PI \(*p
39 . ds L" ``
40 . ds R" ''
41 'br\}
42 .\"
43 .\" Escape single quotes in literal strings from groff's Unicode transform.
44 .ie \n(.g .ds Aq \(aq
45 .el .ds Aq '
46 .\"
47 .\" If the F register is turned on, we'll generate index entries on stderr for
48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
49 .\" entries marked with X<> in POD. Of course, you'll have to process the
50 .\" output yourself in some meaningful fashion.
51 .ie \nF \{\
52 . de IX
53 . tm Index:\\$1\t\\n%\t"\\$2"
54 ..
55 . nr % 0
56 . rr F
57 .\}
58 .el \{\
59 . de IX
60 ..
61 .\}
62 .\"
63 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
64 .\" Fear. Run. Save yourself. No user-serviceable parts.
65 . \" fudge factors for nroff and troff
66 .if n \{\
67 . ds #H 0
68 . ds #V .8m
69 . ds #F .3m
70 . ds #[ \f1
71 . ds #] \fP
72 .\}
73 .if t \{\
74 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
75 . ds #V .6m
76 . ds #F 0
77 . ds #[ \&
78 . ds #] \&
79 .\}
80 . \" simple accents for nroff and troff
81 .if n \{\
82 . ds ' \&
83 . ds ` \&
84 . ds ^ \&
85 . ds , \&
86 . ds ~ ~
87 . ds /
88 .\}
89 .if t \{\
90 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
91 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
92 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
93 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
94 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
95 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
96 .\}
97 . \" troff and (daisy-wheel) nroff accents
98 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
99 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
100 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
101 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
102 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
103 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
104 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
105 .ds ae a\h'-(\w'a'u*4/10)'e
106 .ds Ae A\h'-(\w'A'u*4/10)'E
107 . \" corrections for vroff
108 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
109 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
110 . \" for low resolution devices (crt and lpr)
111 .if \n(.H>23 .if \n(.V>19 \
112 \{\
113 . ds : e
114 . ds 8 ss
115 . ds o a
116 . ds d- d\h'-1'\(ga
117 . ds D- D\h'-1'\(hy
118 . ds th \o'bp'
119 . ds Th \o'LP'
120 . ds ae ae
121 . ds Ae AE
122 .\}
123 .rm #[ #] #H #V #F C
124 .\" ========================================================================
125 .\"
126 .IX Title "FINGERPRINTS 1"
127 .TH FINGERPRINTS 1 "2015-03-29" "perl v5.14.2" "MayaChemTools"
128 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
129 .\" way too many mistakes in technical documents.
130 .if n .ad l
131 .nh
132 .SH "NAME"
133 Fingerprints \- Fingerprints class
134 .SH "SYNOPSIS"
135 .IX Header "SYNOPSIS"
136 use Fingerprints::Fingerprints;
137 .PP
138 use Fingerprints::Fingerprints qw(:all);
139 .SH "DESCRIPTION"
140 .IX Header "DESCRIPTION"
141 \&\fBFingerprints\fR class provides the following methods:
142 .PP
143 new, FoldFingerprintsByBitDensity, FoldFingerprintsBySize,
144 GetFingerprintBitsAsBinaryString, GetFingerprintBitsAsHexadecimalString,
145 GetFingerprintBitsAsRawBinaryString, GetFingerprintsVectorValueIDs,
146 GetFingerprintsVectorValues, IsFingerprintsGenerationSuccessful,
147 SetFingerprintsBitVector, SetFingerprintsVector, SetFingerprintsVectorType,
148 SetMolecule, SetSize, SetType, SetVectorType
149 .PP
150 \&\fBFingerprints\fR class is used as a base class for various specific fingerprint classes such as
151 \&\fBAtomNeighborhoodsFingerprints\fR, \fBAtomTypesFingerprints\fR, \fBEStateIndiciesFingerprints\fR,
152 \&\fBPathLengthFingerprints\fR, \fBExtendedConnectivityFingerprints\fR, \fBMACCSKeys\fR and so on.
153 It implements functionality common to fingerprint classes.
154 .PP
155 \&\fBFingerprints\fR class is derived from \fBObjectProperty\fR base class which provides methods not
156 explicitly defined in \fBFingerprints\fR or \fBObjectProperty\fR classes using Perl's \s-1AUTOLOAD\s0 functionality.
157 These methods are generated on-the-fly for a specified object property:
158 .PP
159 .Vb 3
160 \& Set<PropertyName>(<PropertyValue>);
161 \& $PropertyValue = Get<PropertyName>();
162 \& Delete<PropertyName>();
163 .Ve
164 .PP
165 \&\fBFingerprints\fR class uses \fBFingerprintsBitVector\fR class to provide bits manipulation functionality.
166 .SS "\s-1METHODS\s0"
167 .IX Subsection "METHODS"
168 .IP "\fBnew\fR" 4
169 .IX Item "new"
170 .Vb 1
171 \& $NewFingerprints = new Fingerprints(%NamesAndValues);
172 .Ve
173 .Sp
174 Using specified \fIFingerprints\fR property names and values hash, \fBnew\fR method creates a new object
175 and returns a reference to newly created \fBFingerprints\fR object. By default, following properties are
176 initialized:
177 .Sp
178 .Vb 9
179 \& Molecule = \*(Aq\*(Aq;
180 \& Type = \*(Aq\*(Aq;
181 \& VectorType = \*(Aq\*(Aq;
182 \& Size = \*(Aq\*(Aq;
183 \& MinSize = \*(Aq\*(Aq;
184 \& MaxSize = \*(Aq\*(Aq;
185 \& FingerprintsBitVector = \*(Aq\*(Aq;
186 \& FingerprintsVectorType = \*(Aq\*(Aq;
187 \& FingerprintsVector = \*(Aq\*(Aq;
188 .Ve
189 .IP "\fBFoldFingerprintsByBitDensity\fR" 4
190 .IX Item "FoldFingerprintsByBitDensity"
191 .Vb 1
192 \& $Fingerprints\->FoldFingerprintsByBitDensity($BitDensity);
193 .Ve
194 .Sp
195 Folds fingerprints by recursively reducing its size by half until bit density is greater than or equal to
196 specified \fIBitDensity\fR and returns \fIFingerprints\fR.
197 .IP "\fBFoldFingerprintsBySize\fR" 4
198 .IX Item "FoldFingerprintsBySize"
199 .Vb 1
200 \& $Fingerprints\->FoldFingerprintsBySize($Size, [$CheckSizeValue]);
201 .Ve
202 .Sp
203 Fold fingerprints by recursively reducing its size by half until size is less than or equal to specified
204 \&\fISize\fR and returns \fIFingerprints\fR. By default, value \fISize\fR is checked to make sure it's:
205 .Sp
206 .Vb 1
207 \& >= MinSize and < Size and IsPowerOfTwo
208 .Ve
209 .IP "\fBGetFingerprintBitsAsBinaryString\fR" 4
210 .IX Item "GetFingerprintBitsAsBinaryString"
211 .Vb 2
212 \& $BinaryASCIIString =
213 \& $Fingerprints\->GetFingerprintBitsAsBinaryString();
214 .Ve
215 .Sp
216 Returns fingerprints as a binary \s-1ASCII\s0 string containing 0s and 1s.
217 .IP "\fBGetFingerprintBitsAsHexadecimalString\fR" 4
218 .IX Item "GetFingerprintBitsAsHexadecimalString"
219 .Vb 2
220 \& $HexadecimalString =
221 \& $Fingerprints\->GetFingerprintBitsAsHexadecimalString();
222 .Ve
223 .Sp
224 Returns fingerprints as a hexadecimal string
225 .IP "\fBGetFingerprintBitsAsRawBinaryString\fR" 4
226 .IX Item "GetFingerprintBitsAsRawBinaryString"
227 .Vb 2
228 \& $RawBinaryString =
229 \& $Fingerprints\->GetFingerprintBitsAsRawBinaryString();
230 .Ve
231 .Sp
232 Returns fingerprints as a raw binary string containing packed bit values for each byte.
233 .IP "\fBGetFingerprintsVectorValueIDs\fR" 4
234 .IX Item "GetFingerprintsVectorValueIDs"
235 .Vb 2
236 \& $ValueIDsRef = $Fingerprints\->GetFingerprintsVectorValueIDs();
237 \& @ValueIDs = $Fingerprints\->GetFingerprintsVectorValueIDs();
238 .Ve
239 .Sp
240 Returns fingerprints vector value IDs as an array or reference to an array.
241 .IP "\fBGetFingerprintsVectorValues\fR" 4
242 .IX Item "GetFingerprintsVectorValues"
243 .Vb 2
244 \& $ValuesRef = $Fingerprints\->GetFingerprintsVectorValues();
245 \& @Values = $Fingerprints\->GetFingerprintsVectorValues();
246 .Ve
247 .Sp
248 Returns fingerprints vector values as an array or reference to an array.
249 .IP "\fBIsFingerprintsGenerationSuccessful\fR" 4
250 .IX Item "IsFingerprintsGenerationSuccessful"
251 .Vb 1
252 \& $Return = $Fingerprints\->IsFingerprintsGenerationSuccessful();
253 .Ve
254 .Sp
255 Returns 1 or 0 based on whether fingerprints were successfully generated.
256 .IP "\fBSetFingerprintsBitVector\fR" 4
257 .IX Item "SetFingerprintsBitVector"
258 .Vb 1
259 \& $Fingerprints\->SetFingerprintsBitVector($FingerprintsBitVector);
260 .Ve
261 .Sp
262 Sets \fIFingerprintsBitVector\fR object for \fIFingerprints\fR and returns \fIFingerprints\fR.
263 .IP "\fBSetFingerprintsVector\fR" 4
264 .IX Item "SetFingerprintsVector"
265 .Vb 1
266 \& $Fingerprints\->SetFingerprintsVector();
267 .Ve
268 .Sp
269 Sets \fIFingerprintsVector\fR object for \fIFingerprints\fR and returns \fIFingerprints\fR.
270 .IP "\fBSetFingerprintsVectorType\fR" 4
271 .IX Item "SetFingerprintsVectorType"
272 .Vb 1
273 \& $Fingerprints\->SetFingerprintsVectorType($VectorType);
274 .Ve
275 .Sp
276 Sets \fIFingerprintsVector\fR type for \fIFingerprints\fR and returns \fIFingerprints\fR. Possible
277 \&\fIVectorType\fR values: \fIOrderedNumericalValues, NumericalValues or AlphaNumericalValues\fR.
278 .IP "\fBSetMolecule\fR" 4
279 .IX Item "SetMolecule"
280 .Vb 1
281 \& $Fingerprints\->SetMolecule($Molecule);
282 .Ve
283 .Sp
284 Sets \fIMolecule\fR object for \fIFingerprints\fR and returns \fIFingerprints\fR.
285 .IP "\fBSetSize\fR" 4
286 .IX Item "SetSize"
287 .Vb 1
288 \& $Fingerprints\->SetSize($Size);
289 .Ve
290 .Sp
291 Sets \fISize\fR of fingerprints and returns \fIFingerprints\fR.
292 .IP "\fBSetType\fR" 4
293 .IX Item "SetType"
294 .Vb 1
295 \& $Fingerprints\->SetType($Type);
296 .Ve
297 .Sp
298 Sets \fIType\fR of fingerprints and returns \fIFingerprints\fR.
299 .IP "\fBSetVectorType\fR" 4
300 .IX Item "SetVectorType"
301 .Vb 1
302 \& $Fingerprints\->SetVectorType($Type);
303 .Ve
304 .Sp
305 Sets \fIType\fR of fingerprints vector and returns \fIFingerprints\fR. Possible \fIType\fR values:
306 \&\fIFingerprintsBitVector or FingerprintsVector\fR.
307 .SH "AUTHOR"
308 .IX Header "AUTHOR"
309 Manish Sud <msud@san.rr.com>
310 .SH "SEE ALSO"
311 .IX Header "SEE ALSO"
312 FingerprintsStringUtil.pm, AtomNeighborhoodsFingerprints.pm, AtomTypesFingerprints.pm,
313 EStateIndiciesFingerprints.pm, ExtendedConnectivityFingerprints.pm, MACCSKeys.pm,
314 PathLengthFingerprints.pm, TopologicalAtomPairsFingerprints.pm, TopologicalAtomTripletsFingerprints.pm,
315 TopologicalAtomTorsionsFingerprints.pm, TopologicalPharmacophoreAtomPairsFingerprints.pm,
316 TopologicalPharmacophoreAtomTripletsFingerprints.pm
317 .SH "COPYRIGHT"
318 .IX Header "COPYRIGHT"
319 Copyright (C) 2015 Manish Sud. All rights reserved.
320 .PP
321 This file is part of MayaChemTools.
322 .PP
323 MayaChemTools is free software; you can redistribute it and/or modify it under
324 the terms of the \s-1GNU\s0 Lesser General Public License as published by the Free
325 Software Foundation; either version 3 of the License, or (at your option)
326 any later version.