-
Notifications
You must be signed in to change notification settings - Fork 106
/
plegendre_d1.1
63 lines (63 loc) · 2.1 KB
/
plegendre_d1.1
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
.\" Automatically generated by Pandoc 2.0.5
.\"
.TH "plegendre_d1" "1" "2017\-12\-24" "Fortran 95" "SHTOOLS 4.1.2"
.hy
.SH PLegendre_d1
.PP
Compute all the unnormalized Legendre polynomials and first derivatives.
.SH Usage
.PP
call PLegendre_d1 (\f[C]p\f[], \f[C]dp\f[], \f[C]lmax\f[], \f[C]z\f[],
\f[C]exitstatus\f[])
.SH Parameters
.TP
.B \f[C]p\f[] : output, real*8, dimension (\f[C]lmax\f[]+1)
An array of unnormalized Legendre polynomials up to degree
\f[C]lmax\f[].
Degree \f[C]l\f[] corresponds to array index \f[C]l\f[]+1.
.RS
.RE
.TP
.B \f[C]dp\f[] : output, real*8, dimension (\f[C]lmax\f[]+1)
An array of the first derivatives of the unnormalized Legendre
polynomials up to degree \f[C]lmax\f[].
Degree \f[C]l\f[] corresponds to array index \f[C]l\f[]+1.
.RS
.RE
.TP
.B \f[C]lmax\f[] : input, integer
The maximum degree of the Legendre polynomials to be computed.
.RS
.RE
.TP
.B \f[C]z\f[] : input, real*8
The argument of the Legendre polynomial.
.RS
.RE
.TP
.B \f[C]exitstatus\f[] : output, optional, integer
If present, instead of executing a STOP when an error is encountered,
the variable exitstatus will be returned describing the error.
0 = No errors; 1 = Improper dimensions of input array; 2 = Improper
bounds for input variable; 3 = Error allocating memory; 4 = File IO
error.
.RS
.RE
.SH Description
.PP
\f[C]PLegendre_d1\f[] will calculate all of the unnormalized Legendre
polynomials and first derivatives up to degree \f[C]lmax\f[] for a given
argument.
These are calculated using a standard three\-term recursion formula, and
the integral of the Legendre polynomials over the interval [\-1, 1] is
\f[C]2/(2l+1)\f[].
Note that the derivative of the Legendre polynomials is calculated with
respect to its arguement \f[C]z\f[], and not latitude or colatitude.
If \f[C]z=cos(theta)\f[], where \f[C]theta\f[] is the colatitude, then
it is only necessary to multiply \f[C]dp\f[] by \f[C]\-sin(theta)\f[] to
obtain the derivative with respect to \f[C]theta\f[].
.SH See also
.PP
plbar, plbar_d1, plmbar, plmbar_d1, plon, plon_d1, plmon, plmon_d1,
plschmidt, plschmidt_d1, plmschmidt, plmschmidt_d1, plegendre,
plegendrea, plegendrea_d1