comparison mayachemtools/docs/modules/man3/MolecularDescriptors.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 "MOLECULARDESCRIPTORS 1"
127 .TH MOLECULARDESCRIPTORS 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 MolecularDescriptors \- MolecularDescriptors class
134 .SH "SYNOPSIS"
135 .IX Header "SYNOPSIS"
136 use MolecularDescriptors::MolecularDescriptors;
137 .PP
138 use MolecularDescriptors::MolecularDescriptors qw(:all);
139 .SH "DESCRIPTION"
140 .IX Header "DESCRIPTION"
141 \&\fBMolecularDescriptors\fR base class used to derive all other molecular descriptors classes provides the following methods:
142 .PP
143 new, AddDescriptorNames, AddDescriptorValues, GetDescriptorNames,
144 GetDescriptorNamesAndValues, GetDescriptorValueByName, GetDescriptorValues,
145 IsDescriptorsGenerationSuccessful, SetDescriptorNames, SetDescriptorValues,
146 SetMolecule, SetType
147 .PP
148 \&\fBMolecularDescriptors\fR class is derived from \fBObjectProperty\fR base class which provides methods not
149 explicitly defined in \fBFingerprints\fR or \fBObjectProperty\fR classes using Perl's \s-1AUTOLOAD\s0 functionality.
150 These methods are generated on-the-fly for a specified object property:
151 .PP
152 .Vb 3
153 \& Set<PropertyName>(<PropertyValue>);
154 \& $PropertyValue = Get<PropertyName>();
155 \& Delete<PropertyName>();
156 .Ve
157 .SS "\s-1METHODS\s0"
158 .IX Subsection "METHODS"
159 .IP "\fBnew\fR" 4
160 .IX Item "new"
161 .Vb 2
162 \& $NewMolecularDescriptors = new MolecularDescriptors::
163 \& MolecularDescriptors(%NamesAndValues);
164 .Ve
165 .Sp
166 Using specified \fIMolecularDescriptors\fR property names and values hash, \fBnew\fR method creates a new object
167 and returns a reference to newly created \fBMolecularDescriptors\fR object. By default, following properties are
168 initialized:
169 .Sp
170 .Vb 2
171 \& Molecule = \*(Aq\*(Aq;
172 \& Type = \*(Aq\*(Aq;
173 .Ve
174 .IP "\fBAddDescriptorNames\fR" 4
175 .IX Item "AddDescriptorNames"
176 .Vb 1
177 \& $MolecularDescriptors\->AddDescriptorNames(@Name);
178 .Ve
179 .Sp
180 Adds specified descriptor \fINames\fR to the list of available descriptor names and returns
181 \&\fIMolecularDescriptors\fR.
182 .IP "\fBAddDescriptorValues\fR" 4
183 .IX Item "AddDescriptorValues"
184 .Vb 1
185 \& $MolecularDescriptors\->AddDescriptorValues(@Values);
186 .Ve
187 .Sp
188 Adds specified descriptor \fIValues\fR to the list of calculated descriptor values and returns
189 \&\fIMolecularDescriptors\fR.
190 .IP "\fBGetDescriptorNames\fR" 4
191 .IX Item "GetDescriptorNames"
192 .Vb 1
193 \& @Names = $MolecularDescriptors\->GetDescriptorNames();
194 .Ve
195 .Sp
196 Returns an array containing all available descriptor names.
197 .IP "\fBGetDescriptorNamesAndValues\fR" 4
198 .IX Item "GetDescriptorNamesAndValues"
199 .Vb 2
200 \& %NamesAndValuesReturn = $MolecularDescriptors\->
201 \& GetDescriptorNamesAndValues();
202 .Ve
203 .Sp
204 Returns a hash containing all available descriptor names and calculated values.
205 .IP "\fBGetDescriptorValueByName\fR" 4
206 .IX Item "GetDescriptorValueByName"
207 .Vb 2
208 \& $Value = $MolecularDescriptors\->
209 \& GetDescriptorValueByName($Name);
210 .Ve
211 .Sp
212 Returns calculated value for a specified descriptor name. A string \fBNone\fR is returned for
213 unknown descriptor names or for those descriptors whose values haven't been calculated.
214 .IP "\fBGetDescriptorValues\fR" 4
215 .IX Item "GetDescriptorValues"
216 .Vb 1
217 \& @Values = $MolecularDescriptors\->GetDescriptorValues();
218 .Ve
219 .Sp
220 Returns an array containing calculated descriptor values for all available descriptors.
221 Unless \fBCalculateDescriptorsValues\fR method has been successfully invoked on a
222 \&\fIMolecularDescriptors\fR object, value of each descriptor corresponds to string \fBNone\fR.
223 .IP "\fBIsDescriptorsGenerationSuccessful\fR" 4
224 .IX Item "IsDescriptorsGenerationSuccessful"
225 .Vb 2
226 \& $Status = $MolecularDescriptors\->
227 \& IsDescriptorsGenerationSuccessful();
228 .Ve
229 .Sp
230 Returns 1 or 0 based on whether molecular descriptors generation was successful.
231 For a successful molecular descriptors calculation, all available descriptors must have
232 a values other than a string \fINone\fR which are set by \fBCalculateDescriptorsValues\fR
233 method after successful completion of descriptors calculation.
234 .IP "\fBSetDescriptorNames\fR" 4
235 .IX Item "SetDescriptorNames"
236 .Vb 1
237 \& $MolecularDescriptors\->SetDescriptorNames(@Names);
238 .Ve
239 .Sp
240 Sets names of available descriptors to specified names and returns \fIMolecularDescriptors\fR.
241 .IP "\fBSetDescriptorValues\fR" 4
242 .IX Item "SetDescriptorValues"
243 .Vb 1
244 \& $MolecularDescriptors\->SetDescriptorValues(@Values);
245 .Ve
246 .Sp
247 Sets values of available descriptors to specified values and returns \fIMolecularDescriptors\fR.
248 .IP "\fBSetMolecule\fR" 4
249 .IX Item "SetMolecule"
250 .Vb 1
251 \& $MolecularDescriptors\->SetMolecule($Molecule);
252 .Ve
253 .Sp
254 Sets molecule to use during calculation of molecular descriptors and returns \fIMolecularDescriptors\fR.
255 .IP "\fBSetType\fR" 4
256 .IX Item "SetType"
257 .Vb 1
258 \& $MolecularDescriptors\->SetType($Type);
259 .Ve
260 .Sp
261 Sets \fIType\fR for \fIMolecularDescriptors\fR object and returns \fIMolecularDescriptors\fR.
262 .SH "AUTHOR"
263 .IX Header "AUTHOR"
264 Manish Sud <msud@san.rr.com>
265 .SH "SEE ALSO"
266 .IX Header "SEE ALSO"
267 MolecularDescriptorsGenerator.pm
268 .SH "COPYRIGHT"
269 .IX Header "COPYRIGHT"
270 Copyright (C) 2015 Manish Sud. All rights reserved.
271 .PP
272 This file is part of MayaChemTools.
273 .PP
274 MayaChemTools is free software; you can redistribute it and/or modify it under
275 the terms of the \s-1GNU\s0 Lesser General Public License as published by the Free
276 Software Foundation; either version 3 of the License, or (at your option)
277 any later version.