.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" 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
.\"
.\" 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 "Xray::Absorption::McMaster 3pm"
.TH Xray::Absorption::McMaster 3pm "2022-06-28" "perl v5.34.0" "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
.ie n .IP """cross_section""" 4
.el .IP "\f(CWcross_section\fR" 4
.IX Item "cross_section"
Example:
.Sp
.Vb 1
\&   $xsec = Xray::Absorption \-> cross_section($elem, $energy, $mode);
\&
\&   @xsec = Xray::Absorption \-> cross_section($elem, \e@energy, $mode);
.Ve
.Sp
The \f(CW$mode\fR argument is different here than for the other resources.
The options are \*(L"xsec\*(R", \*(L"photo\*(R", \*(L"coherent\*(R" and \*(L"incoherent\*(R", telling
this method to return the full cross-section or just the
photoelectric, coherent, or incoherent portions.
.Sp
The values for all cross-sections are computed as log-log polynomials
as described in the original paper by McMaster et al.
.SH "NAME"
Xray::Absorption::McMaster \- Perl interface to the McMaster tables
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 2
\&   use Xray::Absorption;
\&   Xray::Absorption \-> load("mcmaster");
.Ve
.PP
See the documentation for Xray::Absorption for details.
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This module is inherited by the Xray::Absorption module and provides
access to the data contained in the 1969 McMaster tables.
.PP
The data in this module, commonly referred to as \*(L"The McMaster Tables\*(R",
was originally published as
.PP
.Vb 7
\&  Compilation of X\-Ray Cross Sections
\&  W.H. McMster, N. Kerr Del Grande, J.H. Mallett, J.H. Hubbell
\&  National Bureau of Standards
\&  UCRL\-50174 Section II Revision 1
\&  (1969)
\&  Available from National Technical Information Services L\-3
\&  United States Department of Commerce
.Ve
.PP
This can be a bit difficult to find.  \s-1IIT\s0's Galvin library has kindly
made a scan of it available: http://www.gl.iit.edu/govdocs/resources/xray.html
.PP
The data is contained in a database file called \fImcmaster.db\fR which
is generated at install time from a flat text database of the McMster
data.  The data originally comes from \fImucal.f\fR, a Fortran subroutine
originally written by Dr. Pathikrit Bandhyapodhyay.
.PP
The required Chemistry::Elements module is available from \s-1CPAN\s0 in the
miscellaneous modules section.
.SH "EDGE AND LINE ENERGIES"
.IX Header "EDGE AND LINE ENERGIES"
The McMaster data resource only includes K and L 1\-3 edges.  For light
elements, it provides only a single L edge energy \*(-- that for the L1
edge.  For heavier elements it provides a single M energy, the energy
of the M1 edge.  It only supplies four generic fluorescence line
energies, Kalpha, Kbeta, Lalpha, and Lbeta.  In each case the energy
provided is the energy of the brightest line of that sort.
.SH "BUGS AND THINGS TO DO"
.IX Header "BUGS AND THINGS TO DO"
.IP "\(bu" 4
Make sure this handles fluorescence lines which are in other
resources, but not in this resource in a sensible manner.
.IP "\(bu" 4
What happens if you call \f(CW\*(C`line_toggle\*(C'\fR when this is loaded?  How
about when elam was loaded but then you switch to this one?
.SH "AUTHOR"
.IX Header "AUTHOR"
.Vb 2
\&  Bruce Ravel, bruce@phys.washington.edu
\&  http://feff.phys.washington.edu/~ravel/software/Absorption/
.Ve