pe_parameter_new

Creates a new parameter.

Usage syntax

PE_PARAMETER pe_parameter_new (const char *name, double value);

Parameters
name Name of the new parameter
value Value of the new parameter
Description

Defines a new parameter with the specified attributes.

Name Domain of Value Macro
Projection parameters
Central Meridian (Longitude of Origin) [-180,+180] PE_PARM_LAM0 or PE_PARM_LON0
Longitude of Center [-180,+180] PE_PARM_LAMC or PE_PARM_LONC
Standard Parallel 1 or Latitude of 1st point [-90,+90] PE_PARM_PHI1 or PE_PARM_LAT1
Standard Parallel 2 or Latitude of 2nd point [-90,+90] PE_PARM_PHI2 or PE_PARM_LAT2
Latitude of Origin [-90,+90] PE_PARM_PHI0 or PE_PARM_LAT0
Latitude of Center [-90,+90] PE_PARM_PHIC or PE_PARM_LATC
Longitude of 1st point [-180,+180] PE_PARM_LAM1 or PE_PARM_LON1
Longitude of 2nd point [-180,+180] PE_PARM_LAM2 or PE_PARM_LON2
Scale Factor > 0 PE_PARM_K0
Azimuth [0,360] PE_PARM_ALPHA
Height   PE_PARM_HEIGHT
X scale   PE_PARM_XS
Y scale   PE_PARM_YS
XY plane rotation   PE_PARM_XYR
Option   PE_PARM_OPTION
Auxiliary sphere type [0,3] PE_PARM_AUXS
False Easting   PE_PARM_X0
False Northing   PE_PARM_Y0
Geographic transformation parameters
X-axis translation   PE_PARM_DX
Y-axis translation   PE_PARM_DY
Z-axis translation   PE_PARM_DZ
X-axis rotation   PE_PARM_RX
Y-axis rotation   PE_PARM_RY
Z-axis rotation   PE_PARM_RZ
Difference in scale   PE_PARM_DS
X Coordinate of rotation origin   PE_PARM_XCR
Y Coordinate of rotation origin   PE_PARM_YCR
Z Coordinate of rotation origin   PE_PARM_ZCR
Dataset Name for file-based transformations   PE_PARM_ND
Vertical coordinate system parameters
Vertical shift   PE_PARM_Z0
Direction   PE_PARM_DIR
Vertical transformation parameters
Vertical offset   PE_PARM_VO
Inclination North   PE_PARM_INCN
Inclination East   PE_PARM_INCE
Longitude of evaluation point   PE_PARM_LAM0
Latitude of evaluation point   PE_PARM_PHI0
Dataset Name for file-based transformations   PE_PARM_ND
Returns

On success, the new parameter with the attributes equal to the corresponding arguments. On failure, a null pointer.

Examples

The elements of the parameter array should always be initialized.

PE_PARAMETER p[PE_PARM_MAX];

for (i=0; i<PE_PARM_MAX; i++)
{
   p[i] = (PE_PARAMETER)0;
}

PE_PARAMETER lam0 = pe_parameter_new("central_meridian", -100);
PE_PARAMETER dz = pe_parameter_new("local_to_wgs84_dz", -138.52);