Skip to content

Latest commit

 

History

History
32 lines (19 loc) · 2.05 KB

plbar_d1.md

File metadata and controls

32 lines (19 loc) · 2.05 KB

PlBar_d1

Compute all the 4-pi (geodesy) normalized Legendre polynomials and first derivatives.

Usage

call PlBar_d1 (p, dp, lmax, z, exitstatus)

Parameters

p : output, real(dp), dimension (lmax+1) : An array of 4-pi (geodesy) normalized Legendre polynomials up to degree lmax. Degree l corresponds to array index l+1.

dp : output, real(dp), dimension (lmax+1) : An array of the first derivatives of the 4-pi (geodesy) normalized Legendre polynomials up to degree lmax. Degree l corresponds to array index l+1.

lmax : input, integer : The maximum degree of the Legendre polynomials to be computed.

z : input, real(dp) : The argument of the Legendre polynomial.

exitstatus : 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.

Description

PlBar_d1 will calculate all of the 4-pi (geodesy) normalized Legendre polynomials and first derivatives up to degree lmax for a given argument. These are calculated using a standard three-term recursion formula, and the integral of the geodesy-normalized Legendre polynomials over the interval [-1, 1] is 2. Note that the derivative of the Legendre polynomials is calculated with respect to its arguement z, and not latitude or colatitude. If z=cos(theta), where theta is the colatitude, then it is only necessary to multiply dp by -sin(theta) to obtain the derivative with respect to theta.

See also

plbar, plmbar, plmbar_d1, plon, plon_d1, plmon, plmon_d1, plschmidt, plschmidt_d1, plmschmidt, plmschmidt_d1, plegendre, plegendre_d1, plegendrea, plegendrea_d1