view mayachemtools/docs/modules/man3/EStateValuesDescriptors.3 @ 3:e420415a1799 draft

Uploaded

.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.22)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "ESTATEVALUESDESCRIPTORS 1"
.TH ESTATEVALUESDESCRIPTORS 1 "2015-03-29" "perl v5.14.2" "MayaChemTools"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
EStateValuesDescriptors
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
use AtomicDescriptors::EStateValuesDescriptors;
.PP
use AtomicDescriptors::EStateValuesDescriptors qw(:all);
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBEStateValuesDescriptors\fR class provides the following methods:
.PP
new, GenerateDescriptors, StringifyEStateValuesDescriptors
.PP
\&\fBEStateValuesDescriptors\fR is derived from \fBAtomicValues\fR class which in turn
is  derived from \fBObjectProperty\fR base class that provides methods not explicitly defined
in \fBEStateValuesDescriptors\fR, \fBAtomicValues\fR or \fBObjectProperty\fR classes using Perl's
\&\s-1AUTOLOAD\s0 functionality. These methods are generated on-the-fly for a specified object property:
.PP
.Vb 3
\&    Set<PropertyName>(<PropertyValue>);
\&    $PropertyValue = Get<PropertyName>();
\&    Delete<PropertyName>();
.Ve
.PP
For calculation of electrotopological state (E\-state) values for non-hydrogen atoms:
.PP
Let:
.PP
.Vb 2
\&    N = Principal quantum number or period number corresponding to
\&        element symbol
\&
\&    Sigma = Number of sigma electrons involves in bonds to hydrogen and
\&            non\-hydrogen atoms attached to atom
\&          = Number of sigma bonds to hydrogen and non\-hydrogen atoms
\&            attached to atom
\&    PI = Number of PI electrons involved in bonds to non\-hydrogen atoms
\&         attached to atom
\&       = Number of PI bonds to non\-hydrogen atoms attached to atom
\&
\&    LP = Number of lone pair electrons on atom
\&
\&    Zv = Number of electrons in valence shell of atom
\&
\&    X = Number of non\-hydrogen atom neighbors or heavy atoms attached
\&        to atom
\&    H = Number of implicit and explicit hydrogens for atom
\&
\&    Delta = Number of sigma electrons involved to bonds to non\-hydrogen
\&            atoms
\&    DeltaV = ValenceDelta = Number of valence shell electrons not involved
\&             in bonding to hydrogen atoms
\&
\&    Ii = Intrinsic state value for atom i
\&
\&    DeltaIi = Sum of perturbations to intrinsic state value Ii of atom i
\&              by all other atoms besides atom i
\&
\&    DeltaIij = Perturbation to intrinsic state value Ii of atom i by atom j
\&
\&    Dij = Graph/bond distance between atom i and j
\&    Rij = Dij + 1
\&
\&    Si = E\-state value for atom i
.Ve
.PP
Then:
.PP
.Vb 1
\&    Delta = Sigma \- H = X
\&
\&    DeltaV = Zv \- H
\&           = Sigma + PI + LP \- H
\&
\&    Ii = ( ( ( 2 / N ) ** 2 ) * DeltaV + 1 ) / Delta
\&
\&    DeltaIi = SUM ( (Ii \- Ij) / (Rij ** 2) ) for j = 1 to num of atoms skipping atom i
\&
\&    Si = Ii + DeltaIi
.Ve
.PP
The current release of MayaChemTools doesn't support calculation of E\-state
values [ Ref 75\-78 ] for hydrogens.
.SS "\s-1METHODS\s0"
.IX Subsection "METHODS"
.IP "\fBnew\fR" 4
.IX Item "new"
.Vb 2
\&    $NewEStateValuesDescriptors = new AtomicDescriptors::
\&                                  EStateValuesDescriptors(%NamesAndValues);
.Ve
.Sp
Using specified \fIEStateValuesDescriptors\fR property names and values hash, \fBnew\fR
method creates a new object and returns a reference to newly created \fBEStateValuesDescriptors\fR
object. By default, the following properties are initialized:
.Sp
.Vb 3
\&    Molecule = \*(Aq\*(Aq
\&    Type = \*(AqEState\*(Aq
\&    IgnoreHydrogens = 1
.Ve
.Sp
Examples:
.Sp
.Vb 3
\&    $EStateValuesDescriptors = new AtomicDescriptors::EStateValuesDescriptors(
\&                              \*(AqMolecule\*(Aq => $Molecule,
\&                              \*(AqIgnoreHydrogens\*(Aq => 1);
.Ve
.IP "\fBGenerateDescriptors\fR" 4
.IX Item "GenerateDescriptors"
.Vb 1
\&    $EStateValuesDescriptors\->GenerateDescriptors();
.Ve
.Sp
Calculates E\-state atomic descriptors for all the atoms in a molecule and returns
\&\fIEStateValuesDescriptors\fR.
.IP "\fBStringifyEStateValuesDescriptors\fR" 4
.IX Item "StringifyEStateValuesDescriptors"
.Vb 1
\&    $String = $EStateValuesDescriptors\->StringifyEStateValuesDescriptors();
.Ve
.Sp
Returns a string containing information about \fIEStateValuesDescriptors\fR object.
.SH "AUTHOR"
.IX Header "AUTHOR"
Manish Sud <[e-mail]>
.SH "SEE ALSO"
.IX Header "SEE ALSO"
AtomicDescriptors.pm
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2015 Manish Sud. All rights reserved.
.PP
This file is part of MayaChemTools.
.PP
MayaChemTools is free software; you can redistribute it and/or modify it under
the terms of the \s-1GNU\s0 Lesser General Public License as published by the Free
Software Foundation; either version 3 of the License, or (at your option)
any later version.