pe_vert_to_vert

Transforms between vertical coordinate systems

Usage syntax

int pe_vert_to_vert (PE_VERTTRAN verttran, int n, double coord[ ][2], double h[ ], int transform_direction);

Parameters
verttran Vertical transformation object
n Number of points
coord[ ][2] Two-dimensional array of points
h Array of heights or depths
transform_direction Direction of transformation
Description

Pe_vert_to_vert applies a vertical transformation to the specified array of points. The transform_direction parameter indicates whether to apply the transformation in the direction in which it is defined or to reverse it. The parameter values are as follows:

   PE_TRANSFORM_1_TO_2 0
PE_TRANSFORM_2_TO_1 1

The first vertical coordinate system in a transformation is the "from", or "source", coordinate system. The "target" coordinate system is the second vertical coordinate system. If a transformation is defined from NGVD 1929 to to NAVD 1988 but the input data is defined on NAVD 1988, specify PE_TRANSFORM_2_TO_1. The values of the coord array are not changed, and depending on the transformation method, can be null.
Returns

Number of points successfully transformed

Examples

double pnt[2][2] = {{10,20},{10,30}};
double z[2] = {{200},{189}};
int out = pe_vert_to_vert(vt,2,pnt,z,PE_TRANSFORM_1_TO_2);