annotate docs/modules/txt/EStateValuesDescriptors.txt @ 0:4816e4a8ae95 draft default tip

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