Detailed description of the procedures
DSGRID2S - primary 2D gridding function
DSGRID2S is the Fortran single precision subroutine that
does an interpolation from 2D random data to an output
grid. DSGRID2S is called after all of the desired values for
control
parameters have been set using the subroutines
DSSETI,
DSSETR,
DSSETC.
--------------------------------------------------------------
Argument | Type | Mode | Dimension
--------------------------------------------------------------
CALL DSGRID2S (NPNTS, | Integer | Input |
X, | Real | Input | NPNTS
Y, | Real | Input | NPNTS
Z, | Real | Input | NPNTS
NUMXOUT, | Integer | Input |
NUMYOUT, | Integer | Input |
XO, | Real | Input | NUMXOUT
YO, | Real | Input | NUMYOUT
ZO, | Real | Output | NUMXOUT x NUMYOUT
IER) | Integer | Output |
--------------------------------------------------------------
- NPNTS
- The number of input data points.
- X
- An array containing the X coordinates of the input data points.
- Y
- An array containing the Y coordinates of the input data points.
- Z
- An array containing the functional values
of the input data points. That is, Z(L) is the value of the
input function at coordinate (X(L),Y(L)), for L=1,NPNTS.
- NUMXOUT
- The number of X values in the output grid.
- NUMYOUT
- The number of Y values in the output grid.
- XO
- An array of dimension NUMXOUT containing the X coordinates
of the output data grid. The values in XO must be increasing,
but need not be equally spaced.
- YO
- An array of dimension NUMYOUT containing the Y coordinates
of the output data grid. The values in YO must be increasing,
but need not be equally spaced.
- ZO
- A two-dimensional array of dimension NUMXOUT x NUMYOUT
containing the interpolated functional values. ZO(I,J) is
the interpolated value at grid point (XO(I),YO(J)).
- IER
- An error return value. If IER is returned as 0, then no
errors were detected. If IER is non-zero, then refer to the
error list in
the error table for details.
DSGRID3S - primary 3D gridding function
DSGRID3S is the Fortran single precision subroutine that
does an interpolation from 3D random data to an output
grid. DSGRID3S is called after all of the desired values for
control
parameters have been set using the subroutines
DSSETI,
DSSETR,
DSSETC.
-------------------------------------------------------------------------
Argument | Type | Mode | Dimension
-------------------------------------------------------------------------
CALL DSGRID3S (NPNTS, | Integer | Input |
X, | Real | Input | NPNTS
Y, | Real | Input | NPNTS
Z, | Real | Input | NPNTS
U, | Real | Input | NPNTS
NUMXOUT, | Integer | Input |
NUMYOUT, | Integer | Input |
NUMZOUT, | Integer | Input |
XO, | Real | Input | NUMXOUT
YO, | Real | Input | NUMYOUT
ZO, | Real | Input | NUMZOUT
UO, | Real | Output | NUMXOUT x NUMYOUT x NUMZOUT
IER) | Integer | Output |
-------------------------------------------------------------------------
- NPNTS
- The number of input data points.
- X
- An array containing the X coordinates of the input data points.
- Y
- An array containing the Y coordinates of the input data points.
- Z
- An array containing the Z coordinates of the input data points.
- U
- An array containing the functional values
of the input data points. That is, U(L) is the value of the
input function at coordinate (X(L),Y(L),Z(L)), for L=1,NPNTS.
- NUMXOUT
- The number of X values in the output grid.
- NUMYOUT
- The number of Y values in the output grid.
- NUMZOUT
- The number of Z values in the output grid.
- XO
- An array of dimension NUMXOUT containing the X coordinates
of the output data grid. The values in XO must be increasing,
but need not be equally spaced.
- YO
- An array of dimension NUMYOUT containing the Y coordinates
of the output data grid. The values in YO must be increasing,
but need not be equally spaced.
- ZO
- An array of dimension NUMZOUT containing the Z coordinates
of the output data grid. The values in ZO must be increasing,
but need not be equally spaced.
- UO
- A three-dimensional array of dimension NUMXOUT x NUMYOUT x NUMZOUT
containing the interpolated functional values. UO(I,J,K) is
the interpolated value at grid point (XO(I),YO(J),ZO(K)).
- IER
- An error return value. If IER is returned as 0, then no
errors were detected. If IER is non-zero, then refer to the
error list in
the error table for details.
DSSETI - set INTEGER parameter values
DSSETI is used to set values for any of the
control parameters
that take integer values. The values set by DSSETI remain in effect
until changed by subsequent calls to DSSETI.
-----------------------------------------------------
Argument | Type | Mode | Dimension
-----------------------------------------------------
CALL DSSETI (PNAM, | Character | Input |
IVAL) | Integer | Input |
-----------------------------------------------------
- PNAM
- The name of the
control parameter
to be set.
- IVAL
- The value to be assigned to the parameter.
DSGETI - retrieve values for INTEGER parameters
DSGETI is a called to obtain current values for any of the INTEGER
valued
control parameters.
-----------------------------------------------------
Argument | Type | Mode | Dimension
-----------------------------------------------------
CALL DSGETI (PNAM, | Character | Input |
IVAL) | Integer | Output |
-----------------------------------------------------
- PNAM
- The name of the
control parameter
whose value is to be retrieved.
- IVAL
- The current value assigned to the control parameter.
DSSETR - set REAL parameter values
DSSETR is used to set values for any of the
control
parameters that take REAL values. The values set by DSSETR remain
in effect until changed by subsequent calls to DSSETR.
-----------------------------------------------------
Argument | Type | Mode | Dimension
-----------------------------------------------------
CALL DSSETR (PNAM, | Character | Input |
RVAL) | Real | Input |
-----------------------------------------------------
- PNAM
- The name of the control parameter to be set.
- RVAL
- The value to be assigned to the parameter.
DSGETR - retrieve values for REAL parameters
DSGETR is a called to obtain current values for any of the REAL valued
control parameters.
-----------------------------------------------------
Argument | Type | Mode | Dimension
-----------------------------------------------------
CALL DSGETR (PNAM, | Character | Input |
RVAL) | Real | Output |
-----------------------------------------------------
- PNAM
- The name of the control parameter whose value is to be retrieved.
- RVAL
- The current value assigned to the control parameter.
DSSETC - set CHARACTER valued parameters.
-----------------------------------------------------
Argument | Type | Mode | Dimension
-----------------------------------------------------
CALL DSSETC (PNAM, | Character | Input |
CVAL) | Character | Input |
-----------------------------------------------------
DSSETC is used to set values for any of the
control parameters
that take CHARACTER values. The values set by DSSETC remain in effect
until changed by subsequent calls to DSSETC.
- PNAM
- The name of the control parameter to be set.
- CVAL
- The value to be assigned to the parameter.
DSGETC - retrieve values for CHARACTER parameters
DSGETC is a called to obtain current values for any of the CHARACTER valued
control parameters.
-----------------------------------------------------
Argument | Type | Mode | Dimension
-----------------------------------------------------
CALL DSGETC (PNAM, | Character | Input |
CVAL) | Character | Output |
-----------------------------------------------------
- PNAM
- The name of the control parameter whose value is to be retrieved.
- CVAL
- The current value assigned to the control parameter.
Be sure to provide enough space in the character variable to
receive the value.
DSPNT2S - interpolate 2D data at specified points
This subroutine is called to interpolate 2D data at specified points.
--------------------------------------------------------
Argument | Type | Mode | Dimension
--------------------------------------------------------
CALL DSPNT2S (N, | Integer | Input |
X, | Real | Input | N
Y, | Real | Input | N
Z, | Real | Input | N
M, | Integer | Input |
XO, | Real | Input | M
YO, | Real | Input | M
ZO, | Real | Output | M
IER) | Integer | Output |
--------------------------------------------------------
- N
- The number of input data points.
- X
- An array containing the X coordinates of the input data points.
- Y
- An array containing the Y coordinates of the input data points.
- Z
- An array containing the functional values
of the input data points. That is, Z(L) is the value of the
input function at coordinate (X(L),Y(L)), for L=1,N.
- M
- The number of output data points (this may be "1").
- XO
- An array of dimension M containing the X coordinates
of the output data. The values in XO may be in any order.
- YO
- An array of dimension M containing the Y coordinates
of the output data. The values in YO may be in any order.
- ZO
- An array of dimension M containing the interpolated values.
ZO(I) is the interpolated value at point (XO(I),YO(I))
for I=1,M.
- IER
- An error return value. If IER is returned as 0, then no
errors were detected. If IER is non-zero, then refer to the
error list in
the error table for details.
DSPNT3S - interpolate 3D data at
specified points
This subroutine is called to interpolate 3D data at specified points.
--------------------------------------------------------
Argument | Type | Mode | Dimension
--------------------------------------------------------
CALL DSPNT3S (N, | Integer | Input |
X, | Real | Input | N
Y, | Real | Input | N
Z, | Real | Input | N
U, | Real | Input | N
M, | Integer | Input |
XO, | Real | Input | M
YO, | Real | Input | M
ZO, | Real | Input | M
UO, | Real | Output | M
IER) | Integer | Output |
--------------------------------------------------------
- N
- The number of input data points.
- X
- An array containing the X coordinates of the input data points.
- Y
- An array containing the Y coordinates of the input data points.
- Z
- An array containing the Z coordinates of the input data points.
- U
- An array containing the functional values
of the input data points. That is, U(L) is the value of the
input function at coordinate (X(L),Y(L),Z(L)), for L=1,N.
- M
- The number of output data points (this may be "1").
- XO
- An array of dimension M containing the X coordinates
of the output data. The values in XO may be in any order.
- YO
- An array of dimension M containing the Y coordinates
of the output data. The values in YO may be in any order.
- ZO
- An array of dimension M containing the Z coordinates
of the output data. The values in ZO may be in any order.
- UO
- An array of dimension M containing the interpolated values.
UO(I) is the interpolated value at point (XO(I),YO(I),ZO(I))
for I=1,M.
- IER
- An error return value. If IER is returned as 0, then no
errors were detected. If IER is non-zero, then refer to the
error list in
the error table for details.
DSGRID2D - primary 2D gridding function
DSGRID2D is the Fortran double precision subroutine that
does an interpolation from 2D random data to an output
grid. DSGRID2D is called after all of the desired values for
control
parameters have been set using the subroutines
DSSETI,
DSSETRD,
DSSETC.
-------------------------------------------------------------------------
Argument | Type | Mode | Dimension
-------------------------------------------------------------------------
CALL DSGRID2D (NPNTS, | Integer | Input |
X, | Double precision | Input | NPNTS
Y, | Double precision | Input | NPNTS
Z, | Double precision | Input | NPNTS
NUMXOUT, | Integer | Input |
NUMYOUT, | Integer | Input |
XO, | Double precision | Input | NUMXOUT
YO, | Double precision | Input | NUMYOUT
ZO, | Double precision | Output | NUMXOUT x NUMYOUT
IER) | Integer | Output |
-------------------------------------------------------------------------
- NPNTS
- The number of input data points.
- X
- An array containing the X coordinates of the input data points.
- Y
- An array containing the Y coordinates of the input data points.
- Z
- An array containing the functional values
of the input data points. That is, Z(L) is the value of the
input function at coordinate (X(L),Y(L)), for L=1,NPNTS.
- NUMXOUT
- The number of X values in the output grid.
- NUMYOUT
- The number of Y values in the output grid.
- XO
- An array of dimension NUMXOUT containing the X coordinates
of the output data grid. The values in XO must be increasing,
but need not be equally spaced.
- YO
- An array of dimension NUMYOUT containing the Y coordinates
of the output data grid. The values in YO must be increasing,
but need not be equally spaced.
- ZO
- A two-dimensional array of dimension NUMXOUT x NUMYOUT
containing the interpolated functional values. ZO(I,J) is
the interpolated value at grid point (XO(I),YO(J)).
- IER
- An error return value. If IER is returned as 0, then no
errors were detected. If IER is non-zero, then refer to the
error list in
the error table for details.
DSGRID3D - primary 3D gridding function
DSGRID3D is the Fortran double precision subroutine that
does an interpolation from 3D random data to an output
grid. DSGRID3D is called after all of the desired values for
control
parameters have been set using the subroutines
DSSETI,
DSSETRD,
DSSETC.
--------------------------------------------------------------------------------
Argument | Type | Mode | Dimension
--------------------------------------------------------------------------------
CALL DSGRID3D (NPNTS, | Integer | Input |
X, | Double precision | Input | NPNTS
Y, | Double precision | Input | NPNTS
Z, | Double precision | Input | NPNTS
U, | Double precision | Input | NPNTS
NUMXOUT, | Integer | Input |
NUMYOUT, | Integer | Input |
NUMZOUT, | Integer | Input |
XO, | Double precision | Input | NUMXOUT
YO, | Double precision | Input | NUMYOUT
ZO, | Double precision | Input | NUMZOUT
UO, | Double precision | Output| NUMXOUT x NUMYOUT x NUMZOUT
IER) | Integer | Output|
--------------------------------------------------------------------------------
- NPNTS
- The number of input data points.
- X
- An array containing the X coordinates of the input data points.
- Y
- An array containing the Y coordinates of the input data points.
- Z
- An array containing the Z coordinates of the input data points.
- U
- An array containing the functional values
of the input data points. That is, U(L) is the value of the
input function at coordinate (X(L),Y(L),Z(L)), for L=1,NPNTS.
- NUMXOUT
- The number of X values in the output grid.
- NUMYOUT
- The number of Y values in the output grid.
- NUMZOUT
- The number of Z values in the output grid.
- XO
- An array of dimension NUMXOUT containing the X coordinates
of the output data grid. The values in XO must be increasing,
but need not be equally spaced.
- YO
- An array of dimension NUMYOUT containing the Y coordinates
of the output data grid. The values in YO must be increasing,
but need not be equally spaced.
- ZO
- An array of dimension NUMZOUT containing the Z coordinates
of the output data grid. The values in ZO must be increasing,
but need not be equally spaced.
- UO
- A three-dimensional array of dimension NUMXOUT x NUMYOUT x NUMZOUT
containing the interpolated functional values. UO(I,J,K) is
the interpolated value at grid point (XO(I),YO(J),ZO(K)).
- IER
- An error return value. If IER is returned as 0, then no
errors were detected. If IER is non-zero, then refer to the
error list in
the error table for details.
DSSETRD - set DOUBLE PRECISION parameter values
DSSETRD is used to set values for any of the
control
parameters that take DOUBLE PRECISION values. The values set by
DSSETRD remain in effect until changed by subsequent calls to DSSETRD.
------------------------------------------------------
Argument | Type | Mode | Dimension
------------------------------------------------------
CALL DSSETRD (PNAM, | Character | Input |
RVAL) | Real | Input |
------------------------------------------------------
- PNAM
- The name of the control parameter to be set.
- RVAL
- The value to be assigned to the parameter.
DSGETRD - retrieve values
for DOUBLE PRECISION parameters
DSGETRD is a called to obtain current values for any of the DOUBLE
PRECISION valued
control parameters.
-------------------------------------------------------------
Argument | Type | Mode | Dimension
-------------------------------------------------------------
CALL DSGETRD (PNAM, | Character | Input |
RVAL) | DOUBLE precision | Output |
-------------------------------------------------------------
- PNAM
- The name of the control parameter whose value is to be retrieved.
- RVAL
- The current value assigned to the control parameter.
DSPNT2D - interpolate 2D double precision data
at specified points
This subroutine is called to interpolate 2D double precision data
at specified points.
-------------------------------------------------------------
Argument | Type | Mode | Dimension
-------------------------------------------------------------
CALL DSPNT2D (N, | Integer | Input |
X, | Double precision | Input | N
Y, | Double precision | Input | N
Z, | Double precision | Input | N
M, | Integer | Input |
XO, | Double precision | Input | M
YO, | Double precision | Input | M
ZO, | Double precision | Output | M
IER) | Integer | Output |
-------------------------------------------------------------
- N
- The number of input data points.
- X
- An array containing the X coordinates of the input data points.
- Y
- An array containing the Y coordinates of the input data points.
- Z
- An array containing the functional values
of the input data points. That is, Z(L) is the value of the
input function at coordinate (X(L),Y(L)), for L=1,N.
- M
- The number of output data points (this may be "1").
- XO
- An array of dimension M containing the X coordinates
of the output data. The values in XO may be in any order.
- YO
- An array of dimension M containing the Y coordinates
of the output data. The values in YO may be in any order.
- ZO
- An array of dimension M containing the interpolated values.
ZO(I) is the interpolated value at point (XO(I),YO(I))
for I=1,M.
- IER
- An error return value. If IER is returned as 0, then no
errors were detected. If IER is non-zero, then refer to the
error list in
the error table for details.
DSPNT3D - interpolate 3D double precision data
at specified points
This subroutine is called to interpolate 3D
double precision data at specified points.
---------------------------------------------------------------
Argument | Type | Mode | Dimension
---------------------------------------------------------------
CALL DSPNT3D (N, | Integer | Input |
X, | Double precision | Input | N
Y, | Double precision | Input | N
Z, | Double precision | Input | N
U, | Double precision | Input | N
M, | Integer | Input |
XO, | Double precision | Input | M
YO, | Double precision | Input | M
ZO, | Double precision | Input | M
UO, | Double precision | Output | M
IER) | Integer | Output |
---------------------------------------------------------------
- N
- The number of input data points.
- X
- An array containing the X coordinates of the input data points.
- Y
- An array containing the Y coordinates of the input data points.
- Z
- An array containing the Z coordinates of the input data points.
- U
- An array containing the functional values
of the input data points. That is, U(L) is the value of the
input function at coordinate (X(L),Y(L),Z(L)), for L=1,N.
- M
- The number of output data points (this may be "1").
- XO
- An array of dimension M containing the X coordinates
of the output data. The values in XO may be in any order.
- YO
- An array of dimension M containing the Y coordinates
of the output data. The values in YO may be in any order.
- ZO
- An array of dimension M containing the Z coordinates
of the output data. The values in ZO may be in any order.
- UO
- An array of dimension M containing the interpolated values.
UO(I) is the interpolated value at point (XO(I),YO(I),ZO(I))
for I=1,M.
- IER
- An error return value. If IER is returned as 0, then no
errors were detected. If IER is non-zero, then refer to the
error list in
the error table for details.
c_dsgrid2s - Primary gridding function
c_dsgrid2s is the C single precision function that
does an interpolation from 2D random data to an output
grid. c_dsgrid2s is called after all of the desired values for
control
parameters have been set using the function
c_dsseti,
c_dssetr,
c_dssetc.
Function prototype:
float *c_dsgrid2s(int, float [], float [], float [],
int, int, float [], float [], int *);
Return value:
c_dsgrid2s returns a pointer to a linear array of data
that is the interpolated grid stored in row-major order.
That is, if out is declared as
float *out;
and we set:
out = c_dsgrid2s(npnts, x, y, z, numxout, numyout, xo, yo, &ier);
then out[i*numyout+j] is the interpolated function value at
coordinate point (xo[i],yo[j]) for 0 <= i < numxout and 0 <= j < numyout.
The space for
out is allocated internal to c_dsgrid2s and is
numxout*numyout floats in size.
Argument description:
-------------------------------------------------
Argument | Type | Size
-------------------------------------------------
float *c_dsgrid2s (npnts, | int |
x, | float [] | npnts
y, | float [] | npnts
z, | float [] | npnts
numxout, | int |
numyout, | int |
xi, | float [] | numxout
yi, | float [] | numyout
ier | int * |
);
-------------------------------------------------
- npnts
- The number of input data points.
- x
- An array of size npnts containing the X coordinates of the input data
points.
- y
- An array of size npnts containing the Y coordinates of the input data
points.
- z
- An array of size npnts containing the functional values of the input
data points. That is, z[n] is the value of the input function at
coordinate (x[n],y[n]), for 0 <= n < npnts.
- numxout
- The number of X values in the output grid.
- numyout
- The number of Y values in the output grid.
- xi
- An array of size numxout containing the X coordinates of the output
data grid. The values in xi must be increasing, but need not be equally
spaced.
- yi
- An array of size numyout containing the Y coordinates of the output
data grid. The values in yi must be increasing, but need not be equally
spaced.
- ier
- An error return value. If *ier is returned as 0, then no errors were
detected. If *ier is non-zero, then refer to the error list in
the error table
for details.
c_dsgrid3s - Primary gridding function
c_dsgrid3s is the C single precision function that
does an interpolation from 3D random data to an output
grid. c_dsgrid3s is called after all of the desired values for
control parameters have
been set using the function
c_dsseti,
c_dssetr,
c_dssetc.
Function prototype:
float *c_dsgrid3s(int, float [], float [], float [], float [],
int, int, int, float [], float [], float [], int *);
Return value:
c_dsgrid3s returns a pointer to a linear array of data
that is the interpolated grid stored in row-major order.
That is, if out is declared as
float *out;
and we set:
out = c_dsgrid3s(n, x, y, z, u, nx, ny, nz, xo, yo, zo, &ier);
then out[nz*ny*i + nz*j + k] is the interpolated function value at
coordinate point (xo[i],yo[j],zo[k]) for 0 <= i < nx, 0 <= j < ny,
and 0 <= k < nz.
The space for
out is allocated internal to c_dsgrid3s and is
nx*ny*nz floats in size.
Argument description:
-------------------------------------------------
Argument | Type | Size
-------------------------------------------------
float *c_dsgrid3s (npnts, | int |
x, | float [] | npnts
y, | float [] | npnts
z, | float [] | npnts
u, | float [] | npnts
numxout, | int |
numyout, | int |
numzout, | int |
xo, | float [] | numxout
yo, | float [] | numyout
zo, | float [] | numzout
ier | int * |
);
-------------------------------------------------
- npnts
- The number of input data points.
- x
- An array of size npnts containing the X coordinates of the input data
points.
- y
- An array of size npnts containing the Y coordinates of the input data
points.
- z
- An array of size npnts containing the Z coordinates of the input data
points.
- u
- An array of size npnts containing the functional values of the input
data points. That is, z[n] is the value of the input function at
coordinate (x[n],y[n],z[n]), for 0 <= n < npnts.
- numxout
- The number of X values in the output grid.
- numyout
- The number of Y values in the output grid.
- numzout
- The number of Z values in the output grid.
- xo
- An array of size numxout containing the X coordinates of the output
data grid. The values in xo must be increasing, but need not be equally
spaced.
- yo
- An array of size numyout containing the Y coordinates of the output
data grid. The values in yo must be increasing, but need not be equally
spaced.
- zo
- An array of size numyout containing the Z coordinates of the output
data grid. The values in zo must be increasing, but need not be equally
spaced.
- ier
- An error return value. If *ier is returned as 0, then no errors were
detected. If *ier is non-zero, then refer to the error list in
the error table
for details.
c_dsseti - Set int valued parameters
c_dsseti is used to set values for any of the
control parameters
that take int values. The values set by c_dsseti remain in effect
until changed by subsequent calls to c_dsseti.
Function prototype:
void c_dsseti(char *, int);
Argument description:
-------------------------------------------
Argument | Type | Size
-------------------------------------------
void c_dsseti (pnam, | char * |
ival); | int |
-------------------------------------------
- pnam
- The name of the control parameter to be assigned an int value.
- ival
- The value to be assigned to the control parameter whose name is
pointed to by pnam.
c_dsgeti is a called to obtain current values for any of the int valued
control parameters.
Function prototype:
void c_dsgeti(char *, int);
Argument description:
-------------------------------------------
Argument | Type | Size
-------------------------------------------
void c_dsgeti (pnam, | char * |
ival); | int * |
-------------------------------------------
- pnam
- The name of the control parameter whose value is to be retrieved.
- ival
- *ival will be the value currently assigned to the control parameter
whose name is pointed to by pnam.
c_dssetr - Set float valued parameters
c_dssetr is used to set values for any of the
control parameters
that take float values. The values set by c_dssetr remain in effect
until changed by subsequent calls to c_dssetr.
Function prototype:
void c_dssetr(char *, float);
Argument description:
-------------------------------------------
Argument | Type | Size
-------------------------------------------
void c_dssetr (pnam, | char * |
fval); | float |
-------------------------------------------
- pnam
- The name of the control parameter to be assigned a float value.
- fval
- The value to be assigned to the control parameter whose name is
pointed to by pnam.
c_dsgetr - Retrieve a float valued parameter
c_dsgetr is a called to obtain current values for any of the float valued
control parameters.
Function prototype:
void c_dsgetr(char *, float *);
Argument description:
-------------------------------------------
Argument | Type | Size
-------------------------------------------
void c_dsgetr (pnam, | char * |
fval); | float * |
-------------------------------------------
- pnam
- The name of the control parameter whose value is to be retrieved.
- fval
- *fval will be the value currently assigned to the control parameter
whose name is pointed to by pnam.
c_dssetrd - Set double precision valued
parameters
c_dssetrd is used to set values for any of the
control parameters
that take double precision values. The values set by c_dssetrd remain in
effect until changed by subsequent calls to c_dssetrd.
Function prototype:
void c_dssetrd(char *, double);
Argument description:
-------------------------------------------
Argument | Type | Size
-------------------------------------------
void c_dssetrd (pnam, | char * |
dval); | double |
-------------------------------------------
- pnam
- The name of the control parameter to be assigned a double
precision value.
- dval
- The value to be assigned to the control parameter whose name is
pointed to by pnam.
c_dsgetrd - Retrieve a double precision valued
parameter
c_dsgetrd is a called to obtain current values for any of the double
precision valued
control parameters.
Function prototype:
void c_dsgetrd(char *, double *);
Argument description:
--------------------------------------------
Argument | Type | Size
--------------------------------------------
void c_dsgetrd (pnam, | char * |
dval); | double * |
--------------------------------------------
- pnam
- The name of the control parameter whose value is to be retrieved.
- dval
- *dval will be the value currently assigned to the control parameter
whose name is pointed to by pnam.
c_dssetc - Set char valued parameters
c_dssetc is used to set values for any of the
control parameters
that take string values. The values set by c_dssetc remain in effect
until changed by subsequent calls to c_dssetc.
Function prototype:
void c_dssetc(char *, char *);
Argument description:
-------------------------------------------
Argument | Type | Size
-------------------------------------------
void c_dssetc (pnam, | char * |
cval); | char * |
-------------------------------------------
- pnam
- The name of the control parameter to be assigned a char value.
- cval
- The value to be assigned to the control parameter whose name is
pointed to by pnam.
c_dsgetc is a called to obtain current values for any of the string valued
control parameters.
Function prototype:
void c_dsgetc(char *, char *);
Argument description:
-------------------------------------------
Argument | Type | Size
-------------------------------------------
void c_dsgetc (pnam, | char * |
cval); | char * |
-------------------------------------------
- pnam
- The name of the control parameter whose value is to be retrieved.
- cval
- cval will point to a string containing the returned value.
The user is required to reserve enough space to store the string.
c_dspnt2s - Interpolate at specified points
This function is called to interpolate single precision 2D data at
specified points.
Function prototype:
void c_dspnt2s(int, float [], float [], float [],
int, float [], float [], float *, int *);
Argument description:
-----------------------------------------------
Argument | Type | Size
-----------------------------------------------
void c_dspnt2s (n, | int |
x, | float [] | n
y, | float [] | n
z, | float [] | n
m, | int |
xo, | float [] | m
yo, | float [] | m
zo, | float * |
ier | int * |
); | |
-----------------------------------------------
- n
- The number of input data points.
- x
- An array containing the X coordinates of the input data points.
- y
- An array containing the Y coordinates of the input data points.
- z
- An array containing the functional values
of the input data points. That is, z[l] is the value of the
input function at coordinate (x[l],y[l]), for l=1,n.
- m
- The number of output data points (this may be "1").
- xo
- An array of dimension m containing the X coordinates
of the output data. The values in xo may be in any order.
- yo
- An array of dimension m containing the Y coordinates
of the output data. The values in yo may be in any order.
- zo
- A pointer to a float. Space for m floats is allocated for
zo by dspnt2s. zo[i] is the interpolated value at point
(xo[i],yo[i]) for i=1,m.
- ier
- An error return value. If *ier is returned as 0, then no errors were
detected. If *ier is non-zero, then refer to the error list in
the error table
for details.
c_dspnt3s - Interpolate at specified points
This function is called to interpolate single precision 3D data at
specified points.
Function prototype:
void c_dspnt3s(int, float [], float [], float [], float[]
int, float [], float [], float [], float *, int *);
Argument description:
-----------------------------------------------
Argument | Type | Size
-----------------------------------------------
void c_dspnt3s (n, | int |
x, | float [] | n
y, | float [] | n
z, | float [] | n
u, | float [] | n
m, | int |
xo, | float [] | m
yo, | float [] | m
zo, | float [] | m
uo, | float * |
ier | int * |
); | |
-----------------------------------------------
- n
- The number of input data points.
- x
- An array containing the X coordinates of the input data points.
- y
- An array containing the Y coordinates of the input data points.
- z
- An array containing the Z coordinates of the input data points.
- u
- An array containing the functional values
of the input data points. That is, u[l] is the value of the
input function at coordinate (x[l],y[l],z[l]), for l=1,n.
- m
- The number of output data points (this may be "1").
- xo
- An array of dimension m containing the X coordinates
of the output data. The values in xo may be in any order.
- yo
- An array of dimension m containing the Y coordinates
of the output data. The values in yo may be in any order.
- zo
- An array of dimension m containing the Z coordinates
of the output data. The values in yo may be in any order.
- uo
- A pointer to a float. Space for m floats is allocated for
uo by dspnt3s. zo[i] is the interpolated value at point
(xo[i],yo[i],zo[i]) for i=1,m.
- ier
- An error return value. If *ier is returned as 0, then no errors were
detected. If *ier is non-zero, then refer to the error list in
the error table
for details.
c_dsgrid2d - Primary 2D gridding function
c_dsgrid2d is the C double precision function that
does an interpolation from 2D random data to an output
grid. c_dsgrid2d is called after all of the desired values for
control
parameters have been set using the function
c_dsseti,
c_dssetrd,
c_dssetc.
Function prototype:
double *c_dsgrid2d(int, double [], double [], double [],
int, int, double [], double [], int *);
Return value:
c_dsgrid2d returns a pointer to a linear array of data
that is the interpolated grid stored in row-major order.
That is, if out is declared as
double *out;
and we set:
out = c_dsgrid2d(npnts, x, y, z, numxout, numyout, xo, yo, &ier);
then out[i*numyout+j] is the interpolated function value at
coordinate point (xo[i],yo[j]) for 0 <= i < numxout and 0 <= j < numyout.
The space for
out is allocated internal to c_dsgrid2d and is
numxout*numyout doubles in size.
Argument description:
-------------------------------------------------
Argument | Type | Size
-------------------------------------------------
double *c_dsgrid2d (npnts, | int |
x, | double [] | npnts
y, | double [] | npnts
z, | double [] | npnts
numxout,| int |
numyout,| int |
xi, | double [] | numxout
yi, | double [] | numyout
ier | int * |
); | |
-------------------------------------------------
- npnts
- The number of input data points.
- x
- An array of size npnts containing the X coordinates of the input data
points.
- y
- An array of size npnts containing the Y coordinates of the input data
points.
- z
- An array of size npnts containing the functional values of the input
data points. That is, z[n] is the value of the input function at
coordinate (x[n],y[n]), for 0 <= n < npnts.
- numxout
- The number of X values in the output grid.
- numyout
- The number of Y values in the output grid.
- xi
- An array of size numxout containing the X coordinates of the output
data grid. The values in xi must be increasing, but need not be equally
spaced.
- yi
- An array of size numyout containing the Y coordinates of the output
data grid. The values in yi must be increasing, but need not be equally
spaced.
- ier
- An error return value. If *ier is returned as 0, then no errors were
detected. If *ier is non-zero, then refer to the error list in
the error table
for details.
c_dsgrid3d - Primary 3D gridding function
c_dsgrid3d is the C double precision function that
does an interpolation from 3D random data to an output
grid. c_dsgrid3d is called after all of the desired values for
control
parameters have been set using the function
c_dsseti,
c_dssetrd,
c_dssetc.
Function prototype:
double *c_dsgrid3d(int, double [], double [], double [], double [],
int, int, int, double [], double [], double [], int *);
Return value:
c_dsgrid3d returns a pointer to a linear array of data
that is the interpolated grid stored in row-major order.
That is, if out is declared as
double *out;
and we set:
out = c_dsgrid3d(n, x, y, z, u, nx, ny, nz, xo, yo, zo, &ier);
then out[nz*ny*i + nz*j + k] is the interpolated function value at
coordinate point (xo[i],yo[j],zo[k]) for 0 <= i < nx, 0 <= j < ny,
and 0 <= k < nz.
The space for
out is allocated internal to c_dsgrid3d and is
nx*ny*nz doubles in size.
Argument description:
--------------------------------------------------
Argument | Type | Size
--------------------------------------------------
double *c_dsgrid3d (npnts, | int |
x, | double [] | npnts
y, | double [] | npnts
z, | double [] | npnts
u, | double [] | npnts
numxout, | int |
numyout, | int |
numzout, | int |
xo, | double [] | numxout
yo, | double [] | numyout
zo, | double [] | numzout
ier | int * |
); | |
--------------------------------------------------
- npnts
- The number of input data points.
- x
- An array of size npnts containing the X coordinates of the input data
points.
- y
- An array of size npnts containing the Y coordinates of the input data
points.
- z
- An array of size npnts containing the Z coordinates of the input data
points.
- u
- An array of size npnts containing the functional values of the input
data points. That is, z[n] is the value of the input function at
coordinate (x[n],y[n],z[n]), for 0 <= n < npnts.
- numxout
- The number of X values in the output grid.
- numyout
- The number of Y values in the output grid.
- numzout
- The number of Z values in the output grid.
- xo
- An array of size numxout containing the X coordinates of the output
data grid. The values in xo must be increasing, but need not be equally
spaced.
- yo
- An array of size numyout containing the Y coordinates of the output
data grid. The values in yo must be increasing, but need not be equally
spaced.
- zo
- An array of size numzout containing the Z coordinates of the output
data grid. The values in zo must be increasing, but need not be equally
spaced.
- ier
- An error return value. If *ier is returned as 0, then no errors were
detected. If *ier is non-zero, then refer to the error list in
the error table
for details.
c_dspnt2d - Interpolate at specified points
This function is called to interpolate double precision 2D data at
specified points.
Function prototype:
void c_dspnt2d(int, double [], double [], double [],
int, double [], double [], double *, int *);
Argument description:
-----------------------------------------------
Argument | Type | Size
-----------------------------------------------
void c_dspnt2d (n, | int |
x, | double [] | n
y, | double [] | n
z, | double [] | n
m, | int |
xo, | double [] | m
yo, | double [] | m
zo, | double * |
ier | int * |
); | |
-----------------------------------------------
- n
- The number of input data points.
- x
- An array containing the X coordinates of the input data points.
- y
- An array containing the Y coordinates of the input data points.
- z
- An array containing the functional values
of the input data points. That is, z[l] is the value of the
input function at coordinate (x[l],y[l]), for l=1,n.
- m
- The number of output data points (this may be "1").
- xo
- An array of dimension m containing the X coordinates
of the output data. The values in xo may be in any order.
- yo
- An array of dimension m containing the Y coordinates
of the output data. The values in yo may be in any order.
- zo
- A pointer to a float. Space for m floats is allocated for
zo by dspnt2s. zo[i] is the interpolated value at point
(xo[i],yo[i]) for i=1,m.
- ier
- An error return value. If *ier is returned as 0, then no errors were
detected. If *ier is non-zero, then refer to the error list in
the error table
for details.
c_dspnt3d - Interpolate at specified points
This function is called to interpolate double precision 3D data at
specified points.
Function prototype:
void c_dspnt3d(int, double [], double [], double [], double[]
int, double [], double [], double [], double *, int *);
Argument description:
-----------------------------------------------
Argument | Type | Size
-----------------------------------------------
void c_dspnt3d (n, | int |
x, | double [] | n
y, | double [] | n
z, | double [] | n
u, | double [] | n
m, | int |
xo, | double [] | m
yo, | double [] | m
zo, | double [] | m
uo, | double * |
ier | int * |
); | |
-----------------------------------------------
- n
- The number of input data points.
- x
- An array containing the X coordinates of the input data points.
- y
- An array containing the Y coordinates of the input data points.
- z
- An array containing the Z coordinates of the input data points.
- u
- An array containing the functional values
of the input data points. That is, u[l] is the value of the
input function at coordinate (x[l],y[l],z[l]), for l=1,n.
- m
- The number of output data points (this may be "1").
- xo
- An array of dimension m containing the X coordinates
of the output data. The values in xo may be in any order.
- yo
- An array of dimension m containing the Y coordinates
of the output data. The values in yo may be in any order.
- zo
- An array of dimension m containing the Z coordinates
of the output data. The values in zo may be in any order.
- uo
- A pointer to a float. Space for m floats is allocated for
uo by dspnt3s. uo[i] is the interpolated value at point
(xo[i],yo[i],zo[i]) for i=1,m.
- ier
- An error return value. If *ier is returned as 0, then no errors were
detected. If *ier is non-zero, then refer to the error list in
the error table
for details.
home |
contents |
defs |
params |
procedures |
exmpls |
index