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

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