pe_vertcs_from_string

Creates a vertical coordinate system from its string representation.

Usage syntax

PE_VERTCS pe_vertcs_from_string (const char *buffer);
 

Parameters
buffer The string representation of the object
Description

Creates a vertical coordinate systemobject from its string representation.

A gravity-related vertical coordinate system will look like:
VERTCS["National_Geodetic_Vertical_Datum_1929",VDATUM["NGVD_1929"],PARAMETER["Vertical_Shift",0.0],PARAMETER["Direction",1.0],UNIT["Meter",1.0]]

A spheroid- or ellipsoid-based vertical coordinate system will look like:
VERTCS["WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137.0,298.257223563]],PARAMETER["Vertical_Shift",0.0],PARAMETER["Direction",1.0],UNIT["Meter",1.0]]

Returns

On success, a vertical coordinate system object. Otherwise, a null pointer.

Examples

PE_VERTCS ngvd29;

char *vertcs_metadata = "VERTCS[\"National_Geodetic_Vertical_Datum_1929\",VDATUM[\"NGVD_1929\"],PARAMETER[\"Vertical_Shift\",0.0],PARAMETER[\"Direction\",1.0],UNIT[\"Meter\",1.0]]";

ngvd29 = pe_vertcs_from_string(vertcs_metadata);