annotate mayachemtools/docs/modules/txt/EStateValuesDescriptors.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 EStateValuesDescriptors
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
3
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
4 SYNOPSIS
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
5 use AtomicDescriptors::EStateValuesDescriptors;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
6
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
7 use AtomicDescriptors::EStateValuesDescriptors qw(:all);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
8
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
9 DESCRIPTION
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
10 EStateValuesDescriptors class provides the following methods:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
11
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
12 new, GenerateDescriptors, StringifyEStateValuesDescriptors
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
13
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
14 EStateValuesDescriptors is derived from AtomicValues 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 EStateValuesDescriptors, AtomicValues 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 For calculation of electrotopological state (E-state) values for
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
25 non-hydrogen atoms:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
26
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
27 Let:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
28
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
29 N = Principal quantum number or period number corresponding to
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
30 element symbol
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
31
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
32 Sigma = Number of sigma electrons involves in bonds to hydrogen and
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
33 non-hydrogen atoms attached to atom
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
34 = Number of sigma bonds to hydrogen and non-hydrogen atoms
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
35 attached to atom
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
36 PI = Number of PI electrons involved in bonds to non-hydrogen atoms
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
37 attached to atom
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
38 = Number of PI bonds to non-hydrogen atoms attached to atom
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
39
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
40 LP = Number of lone pair electrons on atom
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
41
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
42 Zv = Number of electrons in valence shell of atom
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
43
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
44 X = Number of non-hydrogen atom neighbors or heavy atoms attached
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
45 to atom
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
46 H = Number of implicit and explicit hydrogens for atom
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
47
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
48 Delta = Number of sigma electrons involved to bonds to non-hydrogen
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
49 atoms
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
50 DeltaV = ValenceDelta = Number of valence shell electrons not involved
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
51 in bonding to hydrogen atoms
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
52
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
53 Ii = Intrinsic state value for atom i
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
54
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
55 DeltaIi = Sum of perturbations to intrinsic state value Ii of atom i
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
56 by all other atoms besides atom i
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
57
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
58 DeltaIij = Perturbation to intrinsic state value Ii of atom i by atom j
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
59
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
60 Dij = Graph/bond distance between atom i and j
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
61 Rij = Dij + 1
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
62
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
63 Si = E-state value for atom i
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
64
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
65 Then:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
66
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
67 Delta = Sigma - H = X
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
68
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
69 DeltaV = Zv - H
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
70 = Sigma + PI + LP - H
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
71
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
72 Ii = ( ( ( 2 / N ) ** 2 ) * DeltaV + 1 ) / Delta
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
73
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
74 DeltaIi = SUM ( (Ii - Ij) / (Rij ** 2) ) for j = 1 to num of atoms skipping atom i
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
75
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
76 Si = Ii + DeltaIi
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
77
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
78 The current release of MayaChemTools doesn't support calculation of
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
79 E-state values [ Ref 75-78 ] for hydrogens.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
80
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
81 METHODS
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
82 new
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
83 $NewEStateValuesDescriptors = new AtomicDescriptors::
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
84 EStateValuesDescriptors(%NamesAndValues);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
85
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
86 Using specified *EStateValuesDescriptors* property names and values
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
87 hash, new method creates a new object and returns a reference to
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
88 newly created EStateValuesDescriptors object. By default, the
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
89 following properties are initialized:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
90
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
91 Molecule = ''
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
92 Type = 'EState'
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
93 IgnoreHydrogens = 1
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
94
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
95 Examples:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
96
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
97 $EStateValuesDescriptors = new AtomicDescriptors::EStateValuesDescriptors(
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
98 'Molecule' => $Molecule,
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
99 'IgnoreHydrogens' => 1);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
100
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
101 GenerateDescriptors
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
102 $EStateValuesDescriptors->GenerateDescriptors();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
103
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
104 Calculates E-state atomic descriptors for all the atoms in a
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
105 molecule and returns *EStateValuesDescriptors*.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
106
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
107 StringifyEStateValuesDescriptors
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
108 $String = $EStateValuesDescriptors->StringifyEStateValuesDescriptors();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
109
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
110 Returns a string containing information about
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
111 *EStateValuesDescriptors* object.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
112
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
113 AUTHOR
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
114 Manish Sud <msud@san.rr.com>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
115
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
116 SEE ALSO
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
117 AtomicDescriptors.pm
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
118
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
119 COPYRIGHT
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
120 Copyright (C) 2015 Manish Sud. All rights reserved.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
121
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
122 This file is part of MayaChemTools.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
123
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
124 MayaChemTools is free software; you can redistribute it and/or modify it
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
125 under the terms of the GNU Lesser General Public License as published by
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
126 the Free Software Foundation; either version 3 of the License, or (at
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
127 your option) any later version.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
128