File: voigt.pod

package info (click to toggle)
libcerf 1.3-2
  • links: PTS, VCS
  • area: main
  • in suites: buster, jessie, jessie-kfreebsd, stretch
  • size: 1,784 kB
  • ctags: 307
  • sloc: sh: 11,065; ansic: 2,189; f90: 252; makefile: 58
file content (75 lines) | stat: -rw-r--r-- 1,753 bytes parent folder | download | duplicates (2)
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.