annotate docs/modules/txt/EStateValuesDescriptors.txt @ 2:17fef9d80c97 draft

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