| 0 | 1 <html> | 
|  | 2 <head> | 
|  | 3 <title>MayaChemTools:Documentation:PeriodicTable.pm</title> | 
|  | 4 <meta http-equiv="content-type" content="text/html;charset=utf-8"> | 
|  | 5 <link rel="stylesheet" type="text/css" href="../../css/MayaChemTools.css"> | 
|  | 6 </head> | 
|  | 7 <body leftmargin="20" rightmargin="20" topmargin="10" bottommargin="10"> | 
|  | 8 <br/> | 
|  | 9 <center> | 
|  | 10 <a href="http://www.mayachemtools.org" title="MayaChemTools Home"><img src="../../images/MayaChemToolsLogo.gif" border="0" alt="MayaChemTools"></a> | 
|  | 11 </center> | 
|  | 12 <br/> | 
|  | 13 <div class="DocNav"> | 
|  | 14 <table width="100%" border=0 cellpadding=0 cellspacing=2> | 
|  | 15 <tr align="left" valign="top"><td width="33%" align="left"><a href="./PDBFileUtil.html" title="PDBFileUtil.html">Previous</a>  <a href="./index.html" title="Table of Contents">TOC</a>  <a href="./PseudoHeap.html" title="PseudoHeap.html">Next</a></td><td width="34%" align="middle"><strong>PeriodicTable.pm</strong></td><td width="33%" align="right"><a href="././code/PeriodicTable.html" title="View source code">Code</a> | <a href="./../pdf/PeriodicTable.pdf" title="PDF US Letter Size">PDF</a> | <a href="./../pdfgreen/PeriodicTable.pdf" title="PDF US Letter Size with narrow margins: www.changethemargins.com">PDFGreen</a> | <a href="./../pdfa4/PeriodicTable.pdf" title="PDF A4 Size">PDFA4</a> | <a href="./../pdfa4green/PeriodicTable.pdf" title="PDF A4 Size with narrow margins: www.changethemargins.com">PDFA4Green</a></td></tr> | 
|  | 16 </table> | 
|  | 17 </div> | 
|  | 18 <p> | 
|  | 19 </p> | 
|  | 20 <h2>NAME</h2> | 
|  | 21 <p>PeriodicTable</p> | 
|  | 22 <p> | 
|  | 23 </p> | 
|  | 24 <h2>SYNOPSIS</h2> | 
|  | 25 <p>use PeriodicTable;</p> | 
|  | 26 <p>use PeriodicTable qw(:all);</p> | 
|  | 27 <p> | 
|  | 28 </p> | 
|  | 29 <h2>DESCRIPTION</h2> | 
|  | 30 <p><strong>PeriodicTable</strong> module provides the following functions:</p> | 
|  | 31 <p> <a href="#getelementmostabundantnaturalisotopedata">GetElementMostAbundantNaturalIsotopeData</a> | 
|  | 32 , <a href="#getelementmostabundantnaturalisotopemass">GetElementMostAbundantNaturalIsotopeMass</a> | 
|  | 33 , <a href="#getelementmostabundantnaturalisotopemassnumber">GetElementMostAbundantNaturalIsotopeMassNumber</a>, <a href="#getelementnaturalisotopeabundance">GetElementNaturalIsotopeAbundance</a> | 
|  | 34 , <a href="#getelementnaturalisotopecount">GetElementNaturalIsotopeCount</a>, <a href="#getelementnaturalisotopemass">GetElementNaturalIsotopeMass</a> | 
|  | 35 , <a href="#getelementnaturalisotopesdata">GetElementNaturalIsotopesData</a>, <a href="#getelementpropertiesdata">GetElementPropertiesData</a> | 
|  | 36 , <a href="#getelementpropertiesnames">GetElementPropertiesNames</a>, <a href="#getelementpropertiesnamesandunits">GetElementPropertiesNamesAndUnits</a> | 
|  | 37 , <a href="#getelementpropertyunits">GetElementPropertyUnits</a>, <a href="#getelements">GetElements</a>, <a href="#getelementsbyamericanstylegrouplabel">GetElementsByAmericanStyleGroupLabel</a> | 
|  | 38 , <a href="#getelementsbyeuropeanstylegrouplabel">GetElementsByEuropeanStyleGroupLabel</a>, <a href="#getelementsbygroupname">GetElementsByGroupName</a> | 
|  | 39 , <a href="#getelementsbygroupnumber">GetElementsByGroupNumber</a>, <a href="#getelementsbyperiodnumber">GetElementsByPeriodNumber</a> | 
|  | 40 , <a href="#getiupacgroupnumberfromamericanstylegrouplabel">GetIUPACGroupNumberFromAmericanStyleGroupLabel</a> | 
|  | 41 , <a href="#getiupacgroupnumberfromeuropeanstylegrouplabel">GetIUPACGroupNumberFromEuropeanStyleGroupLabel</a>, <a href="#iselement">IsElement</a> | 
|  | 42 , <a href="#iselementnaturalisotopemassnumber">IsElementNaturalIsotopeMassNumber</a>, <a href="#iselementproperty">IsElementProperty</a> | 
|  | 43 </p><p> | 
|  | 44 </p> | 
|  | 45 <h2>METHODS</h2> | 
|  | 46 <dl> | 
|  | 47 <dt><strong><a name="getelements" class="item"><strong>GetElements</strong></a></strong></dt> | 
|  | 48 <dd> | 
|  | 49 <div class="OptionsBox"> | 
|  | 50     @ElementSymbols = GetElements(); | 
|  | 51 <br/>    $ElementSymbolsRef = GetElements();</div> | 
|  | 52 <p>Returns an array or a reference to an array of known element symbols</p> | 
|  | 53 </dd> | 
|  | 54 <dt><strong><a name="getelementsbygroupname" class="item"><strong>GetElementsByGroupName</strong></a></strong></dt> | 
|  | 55 <dd> | 
|  | 56 <div class="OptionsBox"> | 
|  | 57     @ElementSymbols = GetElementsByGroupName($GroupName); | 
|  | 58 <br/>    $ElementSymbolsRef = GetElementsByGroupName($GroupName);</div> | 
|  | 59 <p>Returns an array or a reference to an array of element symbols for a specified <em>GroupName</em>. | 
|  | 60 Supported <em>GroupName</em> values are: <em>Alkali metals, Alkaline earth metals, Coinage metals, Pnictogens, | 
|  | 61 Chalcogens, Halogens, Noble gases</em>; Additionally, usage of <em>Lanthanides</em> (Lanthanoids) | 
|  | 62 and <em>Actinides</em> (Actinoids) is also supported.</p> | 
|  | 63 </dd> | 
|  | 64 <dt><strong><a name="getelementsbygroupnumber" class="item"><strong>GetElementsByGroupNumber</strong></a></strong></dt> | 
|  | 65 <dd> | 
|  | 66 <div class="OptionsBox"> | 
|  | 67     @ElementSymbols = GetElementsByGroupNumber($GroupNumber); | 
|  | 68 <br/>    $ElementSymbolsRef = GetElementsByGroupNumber($GroupNumber);</div> | 
|  | 69 <p>Returns an array or a reference to an array of element symbols for a specified <em>GroupNumber</em></p> | 
|  | 70 </dd> | 
|  | 71 <dt><strong><a name="getelementsbyamericanstylegrouplabel" class="item"><strong>GetElementsByAmericanStyleGroupLabel</strong></a></strong></dt> | 
|  | 72 <dd> | 
|  | 73 <div class="OptionsBox"> | 
|  | 74     @ElementSymbols = GetElementsByAmericanStyleGroupLabel($GroupLabel); | 
|  | 75 <br/>    $ElementSymbolsRef = GetElementsByAmericanStyleGroupLabel($GroupLabel);</div> | 
|  | 76 <p>Returns an array or a reference to an array of element symbols for a specified American | 
|  | 77 style <em>GroupLabel</em>. Valid values for Amercian style group labels: <em>IA to VIIIA, IB to VIIIB, VIII</em>.</p> | 
|  | 78 </dd> | 
|  | 79 <dt><strong><a name="getelementsbyeuropeanstylegrouplabel" class="item"><strong>GetElementsByEuropeanStyleGroupLabel</strong></a></strong></dt> | 
|  | 80 <dd> | 
|  | 81 <div class="OptionsBox"> | 
|  | 82     @ElementSymbols = GetElementsByEuropeanStyleGroupLabel($GroupLabel); | 
|  | 83 <br/>    $ElementSymbolsRef = GetElementsByEuropeanStyleGroupLabel($GroupLabel);</div> | 
|  | 84 <p>Returns an array or a reference to an array of element symbols for a specified European | 
|  | 85 style <em>GroupLabel</em>. Valid values for European style group labels: <em>IA to VIIIA, IB to VIIIB, VIII</em>.</p> | 
|  | 86 </dd> | 
|  | 87 <dt><strong><a name="getelementsbyperiodnumber" class="item"><strong>GetElementsByPeriodNumber</strong></a></strong></dt> | 
|  | 88 <dd> | 
|  | 89 <div class="OptionsBox"> | 
|  | 90     @ElementSymbols = GetElementsByPeriodNumber($PeriodNumber); | 
|  | 91 <br/>    $ElementSymbolsRef = GetElementsByPeriodNumber($PeriodNumber);</div> | 
|  | 92 <p>Returns an array or a reference to an array of element symbols for a specified <em>PeriodNumber</em>.</p> | 
|  | 93 </dd> | 
|  | 94 <dt><strong><a name="getelementmostabundantnaturalisotopedata" class="item"><strong>GetElementMostAbundantNaturalIsotopeData</strong></a></strong></dt> | 
|  | 95 <dd> | 
|  | 96 <div class="OptionsBox"> | 
|  | 97     @IsotopeData = GetElementMostAbundantNaturalIsotopeData( | 
|  | 98                    $ElementID); | 
|  | 99 <br/>    $IsotopeDataRef = GetElementMostAbundantNaturalIsotopeData( | 
|  | 100                    $ElementID);</div> | 
|  | 101 <p>Returns an array or reference to an array containing data for most abundant isotope of | 
|  | 102 an element specfied by element symbol or atomic number. Isotope data arrays contain these | 
|  | 103 values: <em>AtomicNumber, IsotopeSymbol, MassNumber, RelativeAtomicMass, and NaturalAbundance</em>.</p> | 
|  | 104 </dd> | 
|  | 105 <dt><strong><a name="getelementmostabundantnaturalisotopemassnumber" class="item"><strong>GetElementMostAbundantNaturalIsotopeMassNumber</strong></a></strong></dt> | 
|  | 106 <dd> | 
|  | 107 <div class="OptionsBox"> | 
|  | 108     $MassNumber = GetElementMostAbundantNaturalIsotopeMassNumber($ElementID);</div> | 
|  | 109 <p>Returns mass number of most abundant natural isotope of an element specfied by element | 
|  | 110 symbol or atomic number</p> | 
|  | 111 </dd> | 
|  | 112 <dt><strong><a name="getelementnaturalisotopecount" class="item"><strong>GetElementNaturalIsotopeCount</strong></a></strong></dt> | 
|  | 113 <dd> | 
|  | 114 <div class="OptionsBox"> | 
|  | 115     $IsotopeCount = GetElementNaturalIsotopeCount($ElementID);</div> | 
|  | 116 <p>Returns natural isotope count for an element specfied by element symbol or | 
|  | 117 atomic number</p> | 
|  | 118 </dd> | 
|  | 119 <dt><strong><a name="getelementnaturalisotopesdata" class="item"><strong>GetElementNaturalIsotopesData</strong></a></strong></dt> | 
|  | 120 <dd> | 
|  | 121 <div class="OptionsBox"> | 
|  | 122     $DataHashRef = GetElementNaturalIsotopesData($ElementID, | 
|  | 123                    [$MassNumber]);</div> | 
|  | 124 <p>Reurns a reference to a hash containingall available isotope data for an element specified | 
|  | 125 using element symbol or aromic number; an optional mass number indicates retrieve data | 
|  | 126 for a specific isotope</p> | 
|  | 127 </dd> | 
|  | 128 <dt><strong><a name="getelementnaturalisotopeabundance" class="item"><strong>GetElementNaturalIsotopeAbundance</strong></a></strong></dt> | 
|  | 129 <dd> | 
|  | 130 <div class="OptionsBox"> | 
|  | 131     $Abundance = GetElementNaturalIsotopeAbundance($ElementID, | 
|  | 132                  $MassNumber);</div> | 
|  | 133 <p>Returns percent abundance of natural isotope for an element with specfic mass | 
|  | 134 number.</p> | 
|  | 135 </dd> | 
|  | 136 <dt><strong><a name="getelementmostabundantnaturalisotopemass" class="item"><strong>GetElementMostAbundantNaturalIsotopeMass</strong></a></strong></dt> | 
|  | 137 <dd> | 
|  | 138 <div class="OptionsBox"> | 
|  | 139     $RelativeAtomicMass = GetElementMostAbundantNaturalIsotopeMass( | 
|  | 140                           $ElementID);</div> | 
|  | 141 <p>Returns relative atomic mass of most abundant isotope for an element specified using | 
|  | 142 element symbol or aromic number.</p> | 
|  | 143 </dd> | 
|  | 144 <dt><strong><a name="getelementnaturalisotopemass" class="item"><strong>GetElementNaturalIsotopeMass</strong></a></strong></dt> | 
|  | 145 <dd> | 
|  | 146 <div class="OptionsBox"> | 
|  | 147     $RelativeAtomicMass = GetElementNaturalIsotopeMass($ElementID, | 
|  | 148                           $MassNumber);</div> | 
|  | 149 <p>Returns relative atomic mass of an element with specfic mass number.</p> | 
|  | 150 </dd> | 
|  | 151 <dt><strong><a name="getelementpropertiesdata" class="item"><strong>GetElementPropertiesData</strong></a></strong></dt> | 
|  | 152 <dd> | 
|  | 153 <div class="OptionsBox"> | 
|  | 154     $PropertyDataHashRef = GetElementPropertiesData($ElementID);</div> | 
|  | 155 <p>Returns a reference to a hash containing all available properties data for an element | 
|  | 156 specified using element symbol or atomic number.</p> | 
|  | 157 </dd> | 
|  | 158 <dt><strong><a name="getelementpropertyname" class="item"><strong>GetElementPropertyName</strong></a></strong></dt> | 
|  | 159 <dd> | 
|  | 160 <div class="OptionsBox"> | 
|  | 161     $PropertyValue = GetElement<PropertyName>($ElementID);</div> | 
|  | 162 <p>Returns value of an element for a element specified using element symbol or atomic number.</p> | 
|  | 163 <p>These functions are not defined in this modules; these are implemented on-the-fly using | 
|  | 164 Perl's AUTOLOAD funcionality.</p> | 
|  | 165 <p>Here is the list of known element <em>property names</em>: AllenElectronegativity, | 
|  | 166 AllredRochowElectronegativity, AtomicNumber, AtomicRadiusCalculated, | 
|  | 167 AtomicRadiusEmpirical, AtomicWeight, Block, BoilingPoint, BondLength, | 
|  | 168 BrinellHardness, BulkModulus, Classification, CoefficientOfLinearExpansion, Color, | 
|  | 169 CommonValences, LowestCommonValence, HighestCommonValence, | 
|  | 170 CommonOxidationNumbers, LowestCommonOxidationNumber, HighestCommonOxidationNumber, | 
|  | 171 CovalentRadiusEmpirical, CriticalTemperature, DensityOfSolid, DiscoveredAt, DiscoveredBy, | 
|  | 172 DiscoveredWhen, ElectricalResistivity, ElectronAffinity, ElementName, ElementSymbol, EnthalpyOfAtmization, | 
|  | 173 EnthalpyOfFusion, EnthalpyOfVaporization, FirstIonizationEnergy, GroundStateConfiguration, GroundStateLevel, | 
|  | 174 GroupName, GroupNumber, NaturalIsotopeData, MeltingPoint, MineralHardness, MolarVolume, | 
|  | 175 MullikenJaffeElectronegativity, OriginOfName, PaulingElectronegativity, PeriodNumber, PoissonsRatio, | 
|  | 176 Reflectivity, RefractiveIndex, RigidityModulus, SandersonElectronegativity, StandardState, | 
|  | 177 SuperconductionTemperature, ThermalConductivity, VanderWaalsRadius, VelocityOfSound, VickersHardness, | 
|  | 178 YoungsModulus.</p> | 
|  | 179 </dd> | 
|  | 180 <dt><strong><a name="getelementpropertiesnames" class="item"><strong>GetElementPropertiesNames</strong></a></strong></dt> | 
|  | 181 <dd> | 
|  | 182 <div class="OptionsBox"> | 
|  | 183     @PropertyNames = GetElementPropertiesNames([$Mode]); | 
|  | 184 <br/>    $PropertyNamesRef = GetElementPropertiesNames([$Mode]);</div> | 
|  | 185 <p>Returns names of all available element properties. Optional mode parameter controls | 
|  | 186 grouping of property names; Possible values: <em>ByGroup or Alphabetical</em>. Default: | 
|  | 187 <em>ByGroup</em>.</p> | 
|  | 188 </dd> | 
|  | 189 <dt><strong><a name="getelementpropertiesnamesandunits" class="item"><strong>GetElementPropertiesNamesAndUnits</strong></a></strong></dt> | 
|  | 190 <dd> | 
|  | 191 <div class="OptionsBox"> | 
|  | 192     $NameUnitsHashRef = GetElementPropertiesNamesAndUnits();</div> | 
|  | 193 <p>Returns a reference to a hash of property names and units of all available element | 
|  | 194 properties. Names with no units contains empty strings.</p> | 
|  | 195 </dd> | 
|  | 196 <dt><strong><a name="getelementpropertyunits" class="item"><strong>GetElementPropertyUnits</strong></a></strong></dt> | 
|  | 197 <dd> | 
|  | 198 <div class="OptionsBox"> | 
|  | 199     $Units = GetElementPropertyUnits($PropertyName);</div> | 
|  | 200 <p>Returns units for a specific element property name. An empty string is returned for | 
|  | 201 a property with no units.</p> | 
|  | 202 </dd> | 
|  | 203 <dt><strong><a name="getiupacgroupnumberfromamericanstylegrouplabel" class="item"><strong>GetIUPACGroupNumberFromAmericanStyleGroupLabel</strong></a></strong></dt> | 
|  | 204 <dd> | 
|  | 205 <div class="OptionsBox"> | 
|  | 206     $GroupNumber = GetIUPACGroupNumberFromAmericanStyleGroupLabel( | 
|  | 207                    $GroupLabel);</div> | 
|  | 208 <p>Returns IUPAC group numbers of a specific American style group label. A comma delimited | 
|  | 209 string is returned for group VIII or VIIIB.</p> | 
|  | 210 </dd> | 
|  | 211 <dt><strong><a name="getiupacgroupnumberfromeuropeanstylegrouplabel" class="item"><strong>GetIUPACGroupNumberFromEuropeanStyleGroupLabel</strong></a></strong></dt> | 
|  | 212 <dd> | 
|  | 213 <div class="OptionsBox"> | 
|  | 214     $GroupNumber = GetIUPACGroupNumberFromEuropeanStyleGroupLabel( | 
|  | 215                    $GroupLabel);</div> | 
|  | 216 <p>Returns IUPAC group numbers of a specific European style group label. A comma delimited | 
|  | 217 string is returned for group VIII or VIIIA.</p> | 
|  | 218 </dd> | 
|  | 219 <dt><strong><a name="iselement" class="item"><strong>IsElement</strong></a></strong></dt> | 
|  | 220 <dd> | 
|  | 221 <div class="OptionsBox"> | 
|  | 222     $Status = IsElement($ElementID);</div> | 
|  | 223 <p>Returns 1 or 0 based on whether it's a known element symbol or atomic number.</p> | 
|  | 224 </dd> | 
|  | 225 <dt><strong><a name="iselementnaturalisotopemassnumber" class="item"><strong>IsElementNaturalIsotopeMassNumber</strong></a></strong></dt> | 
|  | 226 <dd> | 
|  | 227 <div class="OptionsBox"> | 
|  | 228     $Status = IsElementNaturalIsotopeMassNumber($ElementID, $MassNumber);</div> | 
|  | 229 <p>Returns 1 or 0 based on whether it's a valid mass number for an element symbol | 
|  | 230 or atomic number.</p> | 
|  | 231 </dd> | 
|  | 232 <dt><strong><a name="iselementproperty" class="item"><strong>IsElementProperty</strong></a></strong></dt> | 
|  | 233 <dd> | 
|  | 234 <div class="OptionsBox"> | 
|  | 235     $Status = IsElementProperty($PropertyName);</div> | 
|  | 236 <p>Returns 1 or 0 based on whether it's a valid property name.</p> | 
|  | 237 </dd> | 
|  | 238 </dl> | 
|  | 239 <p> | 
|  | 240 </p> | 
|  | 241 <h2>AUTHOR</h2> | 
|  | 242 <p><a href="mailto:msud@san.rr.com">Manish Sud</a></p> | 
|  | 243 <p> | 
|  | 244 </p> | 
|  | 245 <h2>SEE ALSO</h2> | 
|  | 246 <p><a href="./AminoAcids.html">AminoAcids.pm</a>, <a href="./NucleicAcids.html">NucleicAcids.pm</a> | 
|  | 247 </p> | 
|  | 248 <p> | 
|  | 249 </p> | 
|  | 250 <h2>COPYRIGHT</h2> | 
|  | 251 <p>Copyright (C) 2015 Manish Sud. All rights reserved.</p> | 
|  | 252 <p>This file is part of MayaChemTools.</p> | 
|  | 253 <p>MayaChemTools is free software; you can redistribute it and/or modify it under | 
|  | 254 the terms of the GNU Lesser General Public License as published by the Free | 
|  | 255 Software Foundation; either version 3 of the License, or (at your option) | 
|  | 256 any later version.</p> | 
|  | 257 <p> </p><p> </p><div class="DocNav"> | 
|  | 258 <table width="100%" border=0 cellpadding=0 cellspacing=2> | 
|  | 259 <tr align="left" valign="top"><td width="33%" align="left"><a href="./PDBFileUtil.html" title="PDBFileUtil.html">Previous</a>  <a href="./index.html" title="Table of Contents">TOC</a>  <a href="./PseudoHeap.html" title="PseudoHeap.html">Next</a></td><td width="34%" align="middle"><strong>March 29, 2015</strong></td><td width="33%" align="right"><strong>PeriodicTable.pm</strong></td></tr> | 
|  | 260 </table> | 
|  | 261 </div> | 
|  | 262 <br /> | 
|  | 263 <center> | 
|  | 264 <img src="../../images/h2o2.png"> | 
|  | 265 </center> | 
|  | 266 </body> | 
|  | 267 </html> |