CF-1.6 <--> WKT/PROJ.4 translation

Parameter Table

Projection	Name	CF	OGC WKT	PROJ.4	EPSG	Note
GEN	Generic	-	-	-	-
		scale_factor_at_projection_origin	scale_factor	k_0		(1)
		scale_factor_at_central_meridian	scale_factor	k_0		(1)
		standard_parallel[1]	standard_parallel_1	lat_1
		standard_parallel[2]	standard_parallel_2	lat_2
		longitude_of_central_meridian	longitude_of_center	lon_0		(1)
		longitude_of_central_meridian	central_meridian	lon_0		(1)
		longitude_of_projection_origin	longitude_of_center	lon_0		(1)
		longitude_of_projection_origin	central_meridian	lon_0		(1)
		latitude_of_projection_origin	latitude_of_origin	lat_0		(1)
		latitude_of_projection_origin	latitude_of_center	lat_0		(1)
		straight_vertical_longitude_from_pole	central_meridian	lon_0		(1)
		false_easting	false_easting	x_0	(2)
		false_northing	false_northing	y_0	(2)
AEA	Albers Equal Area	albers_conical_equal_area	Albers_Conic_Equal_Area	aea	9822
		standard_parallel[1]	standard_parallel_1	lat_1
		standard_parallel[2]	standard_parallel_2	lat_2
		longitude_of_central_meridian	longitude_of_center	lon_0
		latitude_of_projection_origin	latitude_of_center	lat_0
AE	Azimuthal equidistant	azimuthal_equidistant	Azimuthal_Equidistant	aeqd	9832
		longitude_of_projection_origin	longitude_of_center	lon_0
		latitude_of_projection_origin	latitude_of_center	lat_0
LAEA	Lambert azimuthal equal area	lambert_azimuthal_equal_area	Lambert_Azimuthal_Equal_Area	laea	9820
		longitude_of_projection_origin	longitude_of_center	lon_0
		latitude_of_projection_origin	latitude_of_center	lat_0
LCC-1SP	Lambert conformal	lambert_conformal_conic	Lambert_Conformal_Conic_1SP	lcc	9801	(3) ​link
		standard_parallel	standard_parallel_1	lat_1
		longitude_of_central_meridian	central_meridian	lon_0
		latitude_of_projection_origin	latitude_of_origin	lat_0
		N/A	scale_factor	k_0		always 1 (3)
LCC-2SP	Lambert conformal	lambert_conformal_conic	Lambert_Conformal_Conic_2SP	lcc	9802	(3) ​link
		standard_parallel[1]	standard_parallel_1	lat_1
		standard_parallel[2]	standard_parallel_2	lat_2
		longitude_of_central_meridian	central_meridian	lon_0
		latitude_of_projection_origin	latitude_of_origin	lat_0
CEA	Lambert cylindrical equal area	lambert_cylindrical_equal_area	Cylindrical_Equal_Area	cea	9834/9835	(3)
		longitude_of_central_meridian	central_meridian	lon_0
		standard_parallel[1]	standard_parallel_1	lat_ts
M-1SP	Mercator (1SP)	mercator	Mercator_1SP	merc	9804	(3)
		longitude_of_projection_origin	central_meridian	lon_0
		scale_factor_at_projection_origin	scale_factor	k_0
M-2SP	Mercator (2SP)	mercator	Mercator_2SP	merc	9805	(3)
		longitude_of_projection_origin	central_meridian	lon_0
		standard_parallel[1]	standard_parallel_1	lat_1
Ortho	Orthographic	orthographic	Orthographic	ortho	9840
		longitude_of_projection_origin	central_meridian	lon_0
		latitude_of_projection_origin	latitude_of_origin	lat_0
PS	Polar stereographic	polar_stereographic	Polar_Stereographic	stere	9010/9829	(3)
		standard_parallel[1]	latitude_of_origin	lat_0
		straight_vertical_longitude_from_pole	central_meridian	lon_0
St	Stereographic	stereographic	Stereographic	stere	9809
		longitude_of_projection_origin	central_meridian	lon_0
		latitude_of_projection_origin	latitude_of_origin	lat_0
		scale_factor_at_projection_origin	scale_factor	k_0
TM	Transverse Mercator	transverse_mercator	Transverse_Mercator	tm/utm	9807	(3)
		scale_factor_at_central_meridian	scale_factor	k_0
		longitude_of_central_meridian	central_meridian	lon_0
		latitude_of_projection_origin	latitude_of_origin	lat_0

Notes:

(1) Multiple CF/WKT translations, see projection-specific translations. (2) Parameter used in every projection. (3) See projection-specific notes below.

Projection-specific notes

EPSG codes below correspond to "EPSG dataset coordinate operation method" codes.

Lambert conformal 1SP / 2SP

The 1SP variant corresponds to EPSG code 9801 - Lambert Conic Conformal (1SP), with CF latitude_of_projection_origin=standard_parallel and WKT scale_factor=1. A scale factor less than 1 means that there are 2 standard parallels (see ​http://www.remotesensing.org/geotiff/proj_list/lambert_conic_conformal_1sp.html), but it cannot be translated to the CF 1SP variant, therefore the 2SP variant should be used instead. The 2SP variant corresponds to EPSG code 9802 - Lambert Conic Conformal (2SP).

Lambert cylindrical equal area

The scale_factor_at_projection_origin variant is not recommended as it does not translate to and from WKT/PROJ.4. Snyder formulas 10-2b and 10-2 can be used to relate scale_factor_at_projection_origin, standard_parallel1 and latitude_of_projection_origin but the latter is not part of this projection's parameters. It has been proposed to deprecate or remove this variant from the CF spec (see CF trac ticket #75).

Mercator 1SP / 2SP

The scale_factor_at_projection_origin variant corresponds to EPSG code 9804 - Mercator (1SP) or Mercator (variant A), and the standard_parallel variant corresponds to EPSG code 9805 - Mercator (2SP) or Mercator (variant B).

Polar stereographic

The standard_parallel variant corresponds to EPSG code 9829 - Polar Stereographic (Variant B), while the scale_factor_at_projection_origin variant corresponds to EPSG code 9810 - Polar Stereographic (Variant A). As WKT/PROJ.4 require the standard parallel, [Snyder] formula 21-7 can be used to compute it from scale_factor_at_projection_origin if that variant is used.

Transverse Mercator

Transverse Mercator can be translated to PROJ.4 using either +proj=merc (Transverse Mercator) or +proj=utm (Universal Transverse Mercator) by computing zone number from longitude_of_central_meridian. For example, a TM projection with longitude_of_central_meridian=-117 would have the corresponding PROJ.4 string: '+proj=utm +zone=11 +datum=NAD27 +units=m +no_defs '

Status of NetCDF CF-1.5 projection handling capability in work-in-progress NetCDF driver upgrade

This page was created to list/track progress as a supplement to work in October 2011 on wiki:NetCDF_Improvements, specifically wiki:NetCDF_exportUpdateChanges.

The list of supported CF-1.5 projections is shown at ​http://cf-pcmdi.llnl.gov/documents/cf-conventions/1.5/apf.html .

The table below shows tested ability to export projections from a GDAL raster - originally in GeoTIFF - to NetCDF CF-1.5 in each supported projection.

The shorthand projection names listed below correspond to their names in the source files and hopefully are fairly self-explanatory - they've been listed in the same order as that shown on the CF-1.5 appendix page.

Note: the current import capability has been tested to be the inverse of the export capability. We would appreciate any help in obtaining valid test files for each of these projections. If and when we are able to test capability to import NetCDF CF-1.5 variants that don't have a direct OGC WKT equivalent, we should add a supplementary table.

Projection	Name	CF Export	CF Import	NetCDF Java	Updated	Note
AEA	Albers Equal Area	Yes	Yes	Yes	18/10/11	Tested regular 2SP version - see AEA note below.
AE	Azimuthal equidistant	Yes	Yes	No	18/10/11	See (1) below
LAEA	Lambert azimuthal equal area	Yes	Yes	Yes	18/10/11
LCC1SP	Lambert conformal	?	Yes*	?	18/10/11	See note below.
LCC2SP	Lambert conformal	Yes	Yes	Yes	18/10/11
CEA	Lambert Cylindrical Equal Area	Yes	Partial	No	18/10/11	Tested regular OGC WKT with std_parallel version (CF-1 has alternative scale_factor_at_projection_origin version, see notes below). See (1) below re NetCDF-Java loading.
M-1SP	Mercator	Yes	Yes	No	18/10/11	See (1) below
M-2SP	Mercator	Yes	Yes	Yes*	18/10/11	Parameters appear correct, loads in NetCDF Java and IDV, but appears translated slightly (a few arc-minutes) from expected position
Ortho	Orthographic	Yes	Yes	Yes	18/10/11
PS	Polar stereographic	Yes*	Yes	No*	21/12/11	Believe we can translate parameters correctly, but see comments below. Translated file opens in NetCDF-Java IDV, but doesn't display as correctly georeferenced.
Rot Pole	Rotated pole	No	No	No	18/10/11	See projection comments below
St	Stereographic	Yes	Yes	Yes	18/10/11
TM	Transverse Mercator	Yes	Yes	Yes	18/10/11

General notes:

(1) For projections that won't load correctly as referenced grids in NetCDF Java, we've contacted the developers to ask for clarification/testing support. In most cases, the CF-1 attributes seem appropriate.

• Update 20/10/2011: One of the NetCDF lead developers has acknowledged NetCDF Java hasn't handled these projections previously, and is going to upgrade: see ​http://www.unidata.ucar.edu/mailing_lists/archives/netcdf-java/2011/msg00159.html

Issues with CF-1 implementation of specific projections:

• AEA : The OGC WKT version has 2 Std parallels - whereas the CF-1.5 version says it can have either 1 or 2 std parallels. How should the CF 1SP version be converted to OGC WKT, and vice-versa?
  • Currently the driver, on import and finding an AEA with only 1 std parallel, will set the 2nd std parallel in the WKT as identical to the first.
• LCC : The OGC WKT 'Lambert_Conformal_Conic_2SP' maps clearly to LCC in CF-1 with 2 std parallels. The CF-1 spec claims that a 1SP version can be used, but it doesn't include a 'scale_factor' as does the OGC WKT 'Lambert_Conformal_Conic_1SP'.
  • For import: Given discussion and example on #3324, and also support from NARCCAP project: it seems the CF-1 LCC 1SP projection is a 'degenerate' LCC-2SP with both SP's at the same location. Thus seems we can read with both 'std_parallel' (1 value) and 'latitude_of_projection_origin' mapping to latitude_of_origin (WKT) and setting scale_factor=1? This is the code's current behaviour (though perhaps could do more error-checking).
  • For export: given the LCC-1SP can specifically include a scale_factor to control the projection (see ​http://www.remotesensing.org/geotiff/proj_list/lambert_conic_conformal_1sp.html), it seems this can't be directly exported to NetCDF without throwing away the scale factor.
    • Perhaps the reasonable thing for now is to export the scale_factor to NetCDF, so it can at least be read back in. Otherwise, we'd have to try to translate the LCC-1SP to a LCC-2SP on the fly.
• CEA : The CF-1 conventions claim this can be encoded with a 'scale_factor_at_projection_origin' alternative to standard parallel - how would this conversion be done from/to OGC WKT (which requires central_meridian and standard_parallel_1)?
• PS : This projection's parameters in CF-1 are significantly different from ​http://www.remotesensing.org/geotiff/proj_list/polar_stereographic.html. In particular the CF-1 equivalent for 'latitude of natural origin' seems to be 'standard_parallel'. CF-1 defines either standard_parallel or scale_factor_at_projection_origin, which is incompatible with OGC WKT (and OGR) that requires both. Snyder's eq. 22-7 allows to relate standard_parallel and scale_factor_at_projection_origin, given that the standard_parallel is defined as the latitude where scale_factor=1. Implementation as of Dec. 21:
  • WKT scale_factor maps to CF scale_factor_at_projection_origin
  • WKT central_meridian maps to CF straight_vertical_longitude_from_pole
  • WKT latitude_of_origin maps to WKT standard_parallel
  • WKT to CF: if WKT latitude_of_origin is positive then CF latitude_of_projection_origin is +90, else it is -90 (North vs. South Pole), scale factor is not exported
  • CF to WKT: is standard_parallel is not defined, compute it from scale_factor using Snyder 22-7
• Rot pole : Not able yet to test: as seems GDAL needs support of advanced proj4 strings that can handle rotated coord systems (see bug #4285).