.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" 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" ''
.    ds C`
.    ds C'
'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 >0, 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.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Chemistry::Isotope 3pm"
.TH Chemistry::Isotope 3pm "2021-05-25" "perl v5.32.1" "User Contributed Perl Documentation"
.\" 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"
Chemistry::Isotope \- Table of the isotopes exact mass data
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&    use Chemistry::Isotope \*(Aq:all\*(Aq;
\&
\&    # get the exact atomic mass for an isotope
\&    my $m  = isotope_mass(235, 92); # 235.043923094753
\&
\&    my $ab_table = isotope_abundance(\*(AqC\*(Aq);
\&    while (my ($A, $percent_ab) = each %$ab_table) {
\&        print "$A\et$percent_ab\en";
\&    }
\&    # this should print (the order may vary):
\&    # 12    98.93
\&    # 13    1.07
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This module contains the exact mass data from the table of the isotopes.
It has an exportable function, isotope_mass, which returns the mass
of an atom in mass units given its mass number (A) and atomic number (Z); and
a function isotope_abundance which returns a table with the natural abundance
of the isotopes given an element symbol.
.PP
The table of the masses includes 2931 nuclides and is taken from
<http://ie.lbl.gov/txt/awm95.txt> (G. Audi and A.H. Wapstra, Nucl. Phys. A595,
409, 1995)
.PP
The table of natural abundances includes 288 nuclides and is taken from
the Commission on Atomic Weights and Isotopic Abundances report for the
International Union of Pure and Applied Chemistry in Isotopic Compositions of
the Elements 1989, Pure and Applied Chemistry, 1998, 70, 217.
<http://www.iupac.org/publications/pac/1998/pdf/7001x0217.pdf>
.SH "FUNCTIONS"
.IX Header "FUNCTIONS"
.ie n .SS "isotope_mass($A, $Z)"
.el .SS "isotope_mass($A, \f(CW$Z\fP)"
.IX Subsection "isotope_mass($A, $Z)"
Return the mass for the atom with the given mass number and atomic number, 
or undef if the nuclide is not in the data table.
.SS "isotope_abundance($symbol)"
.IX Subsection "isotope_abundance($symbol)"
Returns a hash reference with the natural abundance information for the
isotopes of a given element. The hash keys are the mass numbers, and the
values are the abundance percentages. For example, isotope_abundance('C')
returns the following structure:
.PP
.Vb 4
\&    {
\&        \*(Aq13\*(Aq => \*(Aq1.07\*(Aq,
\&        \*(Aq12\*(Aq => \*(Aq98.93\*(Aq
\&    };
.Ve
.SH "VERSION"
.IX Header "VERSION"
0.11
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Chemistry::Atom
.PP
The PerlMol website <http://www.perlmol.org/>
.SH "AUTHOR"
.IX Header "AUTHOR"
Ivan Tubert-Brohman <itub@cpan.org>
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (c) 2005 Ivan Tubert-Brohman. All rights reserved. This program is
free software; you can redistribute it and/or modify it under the same terms as
Perl itself.