1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75
|
=pod
=begin html
<link rel="stylesheet" href="../podstyle.css" type="text/css" />
=end html
=head1 NAME
voigt - Voigt's function, convolution of Gaussian and Lorentzian
=head1 SYNOPSIS
B<#include <cerf.h>>
B<double voigt ( double x, double sigma, double gamma );>
=head1 DESCRIPTION
The function B<voigt> returns Voigt's convolution
voigt(x,sigma,gamma) = integral G(t,sigma) L(x-t,gamma) dt
of a Gaussian
G(x,sigma) = 1/sqrt(2*pi)/|sigma| * exp(-x^2/2/sigma^2)
and a Lorentzian
L(x,gamma) = |gamma| / pi / ( x^2 + gamma^2 ),
with the integral extending from -infinity to +infinity.
If sigma=0, L(x,gamma) is returned. Conversely, if gamma=0, G(x,sigma) is returned.
If sigma=gamma=0, the return value is Inf for x=0, and 0 for all other x. It is advisable to test input arguments to exclude this irregular case.
=head1 RESOURCES
Project web site: http://apps.jcns.fz-juelich.de/libcerf
=head1 REFERENCES
Formula (7.4.13) in Abramowitz & Stegun (1964) relates Voigt's convolution integral to Faddeeva's function B<w_of_z>, upon which this implementation is based:
voigt(x,sigma,gamma) = Re[w(z)] / sqrt(2*pi) / |sigma|
with
z = (x+i*|gamma|) / sqrt(2) / |sigma|.
=head1 BUG REPORTS
Please report bugs to the authors.
=head1 AUTHORS
Joachim Wuttke <j.wuttke@fz-juelich.de>, Forschungszentrum Juelich,
based on the w_of_z implementation by Steven G. Johnson [http://math.mit.edu/~stevenj], Massachusetts Institute of Technology.
=head1 SEE ALSO
Related complex error functions in liberfc:
B<w_of_z(3)>, B<dawson(3)>, B<cerf(3)>, B<erfcx(3)>, B<erfi(3)>.
=head1 COPYING
Copyright (c) 2013 Forschungszentrum Juelich GmbH
Software: MIT License.
This documentation: Creative Commons Attribution Share Alike.
|