annotate docs/modules/txt/MolecularDescriptors.txt @ 3:90ea638ce878 draft default tip

Uploaded
author deepakjadmin
date Wed, 20 Jan 2016 09:11:59 -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 NAME
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
2 MolecularDescriptors - MolecularDescriptors class
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
3
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
4 SYNOPSIS
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
5 use MolecularDescriptors::MolecularDescriptors;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
6
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
7 use MolecularDescriptors::MolecularDescriptors qw(:all);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
8
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
9 DESCRIPTION
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
10 MolecularDescriptors base class used to derive all other molecular
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
11 descriptors classes provides the following methods:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
12
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
13 new, AddDescriptorNames, AddDescriptorValues, GetDescriptorNames,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
14 GetDescriptorNamesAndValues, GetDescriptorValueByName,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
15 GetDescriptorValues, IsDescriptorsGenerationSuccessful,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
16 SetDescriptorNames, SetDescriptorValues, SetMolecule, SetType
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
17
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
18 MolecularDescriptors class is derived from ObjectProperty base class
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
19 which provides methods not explicitly defined in Fingerprints or
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
20 ObjectProperty classes using Perl's AUTOLOAD functionality. These
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
21 methods are generated on-the-fly for a specified object property:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
22
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
23 Set<PropertyName>(<PropertyValue>);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
24 $PropertyValue = Get<PropertyName>();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
25 Delete<PropertyName>();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
26
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
27 METHODS
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
28 new
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
29 $NewMolecularDescriptors = new MolecularDescriptors::
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
30 MolecularDescriptors(%NamesAndValues);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
31
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
32 Using specified *MolecularDescriptors* property names and values
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
33 hash, new method creates a new object and returns a reference to
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
34 newly created MolecularDescriptors object. By default, following
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
35 properties are initialized:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
36
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
37 Molecule = '';
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
38 Type = '';
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
39
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
40 AddDescriptorNames
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
41 $MolecularDescriptors->AddDescriptorNames(@Name);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
42
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
43 Adds specified descriptor *Names* to the list of available
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
44 descriptor names and returns *MolecularDescriptors*.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
45
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
46 AddDescriptorValues
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
47 $MolecularDescriptors->AddDescriptorValues(@Values);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
48
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
49 Adds specified descriptor *Values* to the list of calculated
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
50 descriptor values and returns *MolecularDescriptors*.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
51
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
52 GetDescriptorNames
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
53 @Names = $MolecularDescriptors->GetDescriptorNames();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
54
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
55 Returns an array containing all available descriptor names.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
56
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
57 GetDescriptorNamesAndValues
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
58 %NamesAndValuesReturn = $MolecularDescriptors->
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
59 GetDescriptorNamesAndValues();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
60
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
61 Returns a hash containing all available descriptor names and
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
62 calculated values.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
63
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
64 GetDescriptorValueByName
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
65 $Value = $MolecularDescriptors->
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
66 GetDescriptorValueByName($Name);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
67
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
68 Returns calculated value for a specified descriptor name. A string
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
69 None is returned for unknown descriptor names or for those
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
70 descriptors whose values haven't been calculated.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
71
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
72 GetDescriptorValues
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
73 @Values = $MolecularDescriptors->GetDescriptorValues();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
74
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
75 Returns an array containing calculated descriptor values for all
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
76 available descriptors. Unless CalculateDescriptorsValues method has
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
77 been successfully invoked on a *MolecularDescriptors* object, value
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
78 of each descriptor corresponds to string None.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
79
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
80 IsDescriptorsGenerationSuccessful
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
81 $Status = $MolecularDescriptors->
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
82 IsDescriptorsGenerationSuccessful();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
83
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
84 Returns 1 or 0 based on whether molecular descriptors generation was
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
85 successful. For a successful molecular descriptors calculation, all
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
86 available descriptors must have a values other than a string *None*
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
87 which are set by CalculateDescriptorsValues method after successful
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
88 completion of descriptors calculation.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
89
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
90 SetDescriptorNames
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
91 $MolecularDescriptors->SetDescriptorNames(@Names);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
92
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
93 Sets names of available descriptors to specified names and returns
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
94 *MolecularDescriptors*.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
95
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
96 SetDescriptorValues
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
97 $MolecularDescriptors->SetDescriptorValues(@Values);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
98
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
99 Sets values of available descriptors to specified values and returns
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
100 *MolecularDescriptors*.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
101
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
102 SetMolecule
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
103 $MolecularDescriptors->SetMolecule($Molecule);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
104
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
105 Sets molecule to use during calculation of molecular descriptors and
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
106 returns *MolecularDescriptors*.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
107
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
108 SetType
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
109 $MolecularDescriptors->SetType($Type);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
110
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
111 Sets *Type* for *MolecularDescriptors* object and returns
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
112 *MolecularDescriptors*.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
113
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
114 AUTHOR
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
115 Manish Sud <msud@san.rr.com>
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
116
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
117 SEE ALSO
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
118 MolecularDescriptorsGenerator.pm
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
119
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
120 COPYRIGHT
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
121 Copyright (C) 2015 Manish Sud. All rights reserved.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
122
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
123 This file is part of MayaChemTools.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
124
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
125 MayaChemTools is free software; you can redistribute it and/or modify it
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
126 under the terms of the GNU Lesser General Public License as published by
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
127 the Free Software Foundation; either version 3 of the License, or (at
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
128 your option) any later version.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
129