annotate mayachemtools/docs/modules/txt/TPSADescriptors.txt @ 9:ab29fa5c8c1f draft default tip

Uploaded
author deepakjadmin
date Thu, 15 Dec 2016 14:18:03 -0500
parents 73ae111cf86f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
1 NAME
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
2 TPSADescriptors
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
3
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
4 SYNOPSIS
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
5 use MolecularDescriptors::TPSADescriptors;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
6
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
7 use MolecularDescriptors::TPSADescriptors qw(:all);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
8
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
9 DESCRIPTION
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
10 TPSADescriptors class provides the following methods:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
11
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
12 new, GenerateDescriptors, GetDescriptorNames, StringifyTPSADescriptors
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
13
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
14 TPSADescriptors is derived from MolecularDescriptors class which in turn
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
15 is derived from ObjectProperty base class that provides methods not
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
16 explicitly defined in TPSADescriptors, MolecularDescriptors or
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
17 ObjectProperty classes using Perl's AUTOLOAD functionality. These
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
18 methods are generated on-the-fly for a specified object property:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
19
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
20 Set<PropertyName>(<PropertyValue>);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
21 $PropertyValue = Get<PropertyName>();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
22 Delete<PropertyName>();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
23
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
24 After Topological Polar Surface Area (TPSA) atom types [ Ref 90-91 ] has
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
25 been assigned to appropriate atoms in a molecule using
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
26 AtomTypes::TPSAAtomTypes.pm module, TPSA value is calculated by adding
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
27 up contributions of each appropriate atom type.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
28
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
29 By default, MayaChemTools only uses nitrogen and oxygen atoms during
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
30 calculation of TPSA and ignores phosphorous and sulfur atoms. [ Ref 90 -
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
31 91 ]
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
32
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
33 METHODS
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
34 new
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
35 $NewTPSADescriptors = new MolecularDescriptors::TPSADescriptors(
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
36 %NamesAndValues);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
37
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
38 Using specified *TPSADescriptors* property names and values hash,
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
39 new method creates a new object and returns a reference to newly
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
40 created TPSADescriptors object. By default, the following properties
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
41 are initialized:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
42
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
43 Molecule = ''
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
44 Type = 'TPSA'
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
45 IgnorePhosphorus = 1
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
46 IgnoreSulfur = 1
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
47 @DescriptorNames = ('TPSA')
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
48 @DescriptorValues = ('None')
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
49
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
50 Examples:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
51
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
52 $TPSADescriptors = new MolecularDescriptors::TPSADescriptors(
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
53 'Molecule' => $Molecule);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
54
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
55 $TPSADescriptors = new MolecularDescriptors::TPSADescriptors();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
56
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
57 $TPSADescriptors = new MolecularDescriptors::TPSADescriptors(
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
58 'IgnorePhosphorus' => 0,
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
59 'IgnoreSulfur' => 0);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
60
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
61 $TPSADescriptors->SetMolecule($Molecule);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
62 $TPSADescriptors->GenerateDescriptors();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
63 print "TPSADescriptors: $TPSADescriptors\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
64
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
65 GenerateDescriptors
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
66 $TPSADescriptors->GenerateDescriptors();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
67
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
68 Calculate TPSA value for a molecule and returns *TPSADescriptors*.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
69
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
70 GetDescriptorNames
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
71 @DescriptorNames = $TPSADescriptors->GetDescriptorNames();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
72 @DescriptorNames = MolecularDescriptors::TPSADescriptors::
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
73 GetDescriptorNames();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
74
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
75 Returns all available descriptor names as an array.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
76
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
77 StringifyTPSADescriptors
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
78 $String = $TPSADescriptors->StringifyTPSADescriptors();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
79
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
80 Returns a string containing information about *TPSADescriptors*
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
81 object.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
82
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
83 AUTHOR
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
84 Manish Sud <msud@san.rr.com>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
85
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
86 SEE ALSO
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
87 MolecularDescriptors.pm, MolecularDescriptorsGenerator.pm
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
88
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
89 COPYRIGHT
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
90 Copyright (C) 2015 Manish Sud. All rights reserved.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
91
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
92 This file is part of MayaChemTools.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
93
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
94 MayaChemTools is free software; you can redistribute it and/or modify it
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
95 under the terms of the GNU Lesser General Public License as published by
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
96 the Free Software Foundation; either version 3 of the License, or (at
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
97 your option) any later version.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
98