makegridpoint.1

.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "makegridpoint" "1" "2021-02-15" "Fortran 95" "SHTOOLS 4.10"
.hy
.SH MakeGridPoint
.PP
Evaluate a real function expressed in real spherical harmonics at a
single point.
.SH Usage
.PP
\f[V]value\f[R] = MakeGridPoint (\f[V]cilm\f[R], \f[V]lmax\f[R],
\f[V]lat\f[R], \f[V]lon\f[R], \f[V]norm\f[R], \f[V]csphase\f[R],
\f[V]dealloc\f[R])
.SH Parameters
.TP
\f[V]value\f[R] : output, real(dp)
Value of the function at (\f[V]lat\f[R], \f[V]lon\f[R]).
.TP
\f[V]cilm\f[R] : input, real(dp), dimension (2, \f[V]lmax\f[R]+1, \f[V]lmax\f[R]+1)
The real spherical harmonic coefficients of the function.
The coefficients \f[V]C1lm\f[R] and \f[V]C2lm\f[R] refer to the cosine
(\f[V]Clm\f[R]) and sine (\f[V]Slm\f[R]) coefficients, respectively,
with \f[V]Clm=cilm(1,l+1,m+1)\f[R] and \f[V]Slm=cilm(2,l+1,m+1)\f[R].
.TP
\f[V]lmax\f[R] : input, integer(int32)
The maximum spherical harmonic degree used in evaluating the function.
.TP
\f[V]lat\f[R] : input, real(dp)
The latitude of the point in DEGREES.
.TP
\f[V]lon\f[R] : input, real(dp)
The longitude of the point in DEGREES.
.TP
\f[V]norm\f[R] : input, optional, integer(int32), default = 1
1 (default) = Geodesy 4-pi normalized harmonics; 2 = Schmidt
semi-normalized harmonics; 3 = unnormalized harmonics; 4 = orthonormal
harmonics.
.TP
\f[V]csphase\f[R] : input, optional, integer(int32), default = 1
1 (default) = do not apply the Condon-Shortley phase factor to the
associated Legendre functions; -1 = append the Condon-Shortley phase
factor of (-1)\[ha]m to the associated Legendre functions.
.TP
\f[V]dealloc\f[R] : input, optional, integer(int32), default = 0
0 (default) = Save variables used in the external Legendre function
calls.
(1) Deallocate this memory at the end of the funcion call.
.SH Description
.PP
\f[V]MakeGridPoint\f[R] will expand a function expressed in spherical
harmonics at a single point.
The input latitude and longitude are in degrees.
The employed spherical harmonic normalization and Condon-Shortley phase
convention can be set by the optional arguments \f[V]norm\f[R] and
\f[V]csphase\f[R]; if not set, the default is to use geodesy 4-pi
normalized harmonics that exclude the Condon-Shortley phase of
(-1)\[ha]m.
.SH See also
.PP
makegridpointc, makegriddh, makegriddhc, makegridglq, makegridglqc