annotate mayachemtool/mayachemtools/docs/modules/txt/EStateValuesDescriptors.txt @ 0:a4a2ad5a214e draft default tip

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