Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PROJINFO(1)			     PROJ			   PROJINFO(1)

NAME
       projinfo	- Geodetic object and coordinate operation queries

SYNOPSIS
	  projinfo
	    [-o	formats] [-k crs|operation|ellipsoid] [--summary] [-q]
	    [[--area name_or_code] | [--bbox west_long,south_lat,east_long,north_lat]]
	    [--spatial-test contains|intersects]
	    [--crs-extent-use none|both|intersection|smallest]
	    [--grid-check none|discard_missing|sort] [--show-superseded]
	    [--pivot-crs always|if_no_direct_transformation|never|{auth:code[,auth:code]*}]
	    [--boundcrs-to-wgs84]
	    [--main-db-path path] [--aux-db-path path]*
	    [--identify] [--3d]
	    [--c-ify] [--single-line]
	    {object_definition}	| {object_reference} | (-s {srs_def} -t	{srs_def})

	  where	{object_definition} or {srs_def} is

	  o a proj-string,

	  o a WKT string,

	  o an	object	code  (like "EPSG:4326", "urn:ogc:def:crs:EPSG::4326",
	    "urn:ogc:def:coordinateOperation:EPSG::1671"),

	  o a OGC URN combining	references for compound	 coordinate  reference
	    systems  (e.g  "urn:ogc:def:crs,crs:EPSG::2393,crs:EPSG::5717"  or
	    custom abbreviated syntax "EPSG:2393+5717"),

	  o a OGC URN combining	references for references for projected	or de-
	    rived CRSs e.g. for	Projected 3D CRS "UTM zone 31N / WGS 84	(3D)":
	    "-
	    urn:ogc:def:crs,crs:EPSG::4979,cs:PROJ::ENh,coordinateOpera-
	    tion:EPSG::16031" (added in	6.2)

	  o a OGC URN combining	references for concatenated  operations	 (e.g.
	    "-
	    urn:ogc:def:coordinateOperation,coordinateOperation:EPSG::3895,co-
	    ordinateOperation:EPSG::1618")

	  o a	   PROJJSON	 string.      The     jsonschema     is	    at
	    https://proj.org/schemas/v0.1/projjson.schema.json (added in 6.2)

	  {object_reference} is	a filename preceded by the '@' character.  The
	  file	referenced by the {object_reference} must contain a valid {ob-
	  ject_definition}.

DESCRIPTION
       projinfo	is a program that can query information	on a geodetic  object,
       coordinate  reference system (CRS) or coordinate	operation, when	the -s
       and -t options are specified, and display it  under  different  formats
       (PROJ string, WKT string	or PROJJSON string).

       It  can	also  be used to query coordinate operations available between
       two CRS.

       The program is named with some reference	to the GDAL  gdalsrsinfo  that
       offers partly similar services.

       The following control parameters	can appear in any order:

       -o formats
	      formats is a comma separated combination of: all,	default, PROJ,
	      WKT_ALL, WKT2:2015, WKT2:2019, WKT1:GDAL,	WKT1:ESRI, PROJJSON.

	      Except all and default, other formats can	be preceded  by	 -  to
	      disable them.

	      NOTE:
		 WKT2_2019 was previously called WKT2_2018.

	      NOTE:
		 Before	 PROJ 6.3.0, WKT1:GDAL was implicitly calling --bound-
		 crs-to-wgs84.	This is	no longer the case.

       -k crs|operation|ellipsoid
	      When used	to query a single object with a	AUTHORITY:CODE,	deter-
	      mines the	(k)ind of the object in	case there are CRS, coordinate
	      operations or ellipsoids with the	same  CODE.   The  default  is
	      crs.

       --summary
	      When  listing coordinate operations available between 2 CRS, re-
	      turn the result in a summary format, mentioning only the name of
	      the coordinate operation,	its accuracy and its area of use.

	      NOTE:
		 only used for coordinate operation computation

       -q     Turn  on quiet mode. Quiet mode is only available	for queries on
	      single objects, and only one output format is selected. In  that
	      mode,  only the PROJ, WKT	or PROJJSON string is displayed, with-
	      out other	introduction output. The output	 is  then  potentially
	      compatible of being piped	in other utilities.

       --area name_or_code
	      Specify  an  area	 of  interest to restrict the results when re-
	      searching	coordinate operations between 2	CRS. The area  of  in-
	      terest  can  be  specified  either as a name (e.g	"Denmark - on-
	      shore") or a AUTHORITY:CODE (EPSG:3237) This option is exclusive
	      of --bbox.

	      NOTE:
		 only used for coordinate operation computation

       --bbox west_long,south_lat,east_long,north_lat
	      Specify  an  area	 of  interest to restrict the results when re-
	      searching	coordinate operations between 2	CRS. The area  of  in-
	      terest  is  specified  as	a bounding box with geographic coordi-
	      nates, expressed in degrees in  a	 unspecified  geographic  CRS.
	      west_long	 and  east_long	should be in the [-180,180] range, and
	      south_lat	and north_lat in the [-90,90]. west_long is  generally
	      lower  than  east_long, except in	the case where the area	of in-
	      terest crosses the antimeridian.

	      NOTE:
		 only used for coordinate operation computation

       --spatial-test contains|intersects
	      Specify how the area of use of coordinate	 operations  found  in
	      the  database  are compared to the area of use specified explic-
	      itly with	--area or --bbox, or derived implicitly	from the  area
	      of  use of the source and	target CRS.  By	default, projinfo will
	      only keep	coordinate operations whose are	 of  use  is  strictly
	      within  the  area	of interest (contains strategy).  If using the
	      intersects strategy, the spatial test is relaxed,	and any	 coor-
	      dinate  operation	 whose	area of	use at least partly intersects
	      the area of interest is listed.

	      NOTE:
		 only used for coordinate operation computation

       --crs-extent-use	none|both|intersection|smallest
	      Specify which area of interest to	consider when no explicit  one
	      is  specified with --area	or --bbox options.  By default (small-
	      est strategy), the area of use of	the source or target CRS  will
	      be looked, and the one that is the smallest one in terms of area
	      will be used as the area of interest.  If	using none, no area of
	      interest	is  used.   If	using both, only coordinate operations
	      that   relate   (contain	 or   intersect	  depending   of   the
	      --spatial-test  strategy)	to the area of use of both CRS are se-
	      lected.  If using	intersection, the area of interest is the  in-
	      tersection  of the bounding box of the area of use of the	source
	      and target CRS

	      NOTE:
		 only used for coordinate operation computation

       --grid-check none|discard_missing|sort
	      Specify how the presence or absence of a horizontal or  vertical
	      shift  grid  required for	a coordinate operation affects the re-
	      sults returned when researching coordinate operations between  2
	      CRS.   The default strategy is sort: in that case, all candidate
	      operations are returned, but  the	 actual	 availability  of  the
	      grids  is	used to	determine the sorting order. That is, if a co-
	      ordinate operation involves using	a grid that is	not  available
	      in the PROJ resource directories (determined by the PROJ_LIB en-
	      vironment	variable, it will be listed in the bottom of  the  re-
	      sults.   The  none  strategy  completely	disables the checks of
	      presence of grids	and this returns the results  as  if  all  the
	      grids  where  available.	 The discard_missing strategy discards
	      results that involve grids not present in	the PROJ resource  di-
	      rectories.

	      NOTE:
		 only used for coordinate operation computation

       -show-superseded
	      When  enabled, coordinate	operations that	are superseded by oth-
	      ers will be listed. Note that supersession is not	equivalent  to
	      deprecation:  superseded	operations  are	still considered valid
	      although they have a better equivalent, whereas deprecated oper-
	      ations  have been	determined to be erroneous and are not consid-
	      ered at all.

	      NOTE:
		 only used for coordinate operation computation

       --pivot-crs			       always|if_no_direct_transforma-
       tion|never|{auth:code[,auth:code]*}
	      Determine	if intermediate	(pivot)	CRS can	be used	when research-
	      ing coordinate operation between 2 CRS. A	typical	example	is the
	      WGS84  pivot.  By	 default, projinfo will	consider any potential
	      pivot if there is	no direct transformation ( if_no_direct_trans-
	      formation). If using the never strategy, only direct transforma-
	      tions between the	source and target CRS will be used.  If	 using
	      the always strategy, intermediate	CRS will be considered even if
	      there are	direct transformations.	 It is also  possible  to  re-
	      strict  the  pivot  CRS to consider by specifying	one or several
	      CRS by their AUTHORITY:CODE.

	      NOTE:
		 only used for coordinate operation computation

       --boundcrs-to-wgs84
	      When specified, this option researches  a	 coordinate  operation
	      from the base geographic CRS of the single CRS, source or	target
	      CRS to the WGS84 geographic CRS, and if found, wraps  those  CRS
	      into  a  BoundCRS	 object.   This	 is  mostly  to	 be  used  for
	      early-binding approaches.

       --main-db-path path
	      Specify the name and path	of the database	to  be	used  by  pro-
	      jinfo. The default is proj.db in the PROJ	resource directories.

       --aux-db-path path
	      Specify the name and path	of auxiliary databases,	that are to be
	      combined with the	main database. Those auxiliary databases  must
	      have  a  table structure that is identical to the	main database,
	      but can be partly	filled and their entries can refer to  entries
	      of  the  main  database.	 The option may	be repeated to specify
	      several auxiliary	databases.

       --identify
	      When used	with an	object definition, this	queries	the PROJ data-
	      base  to	find  known  objects, typically	CRS, that are close or
	      identical	to the object.	Each candidate	object	is  associated
	      with  an approximate likelihood percentage.  This	is useful when
	      used with	a WKT string that lacks	a  EPSG	 identifier,  such  as
	      ESRI WKT1. This might also be used with PROJ strings.  For exam-
	      ple, +proj=utm +zone=31 +datum=WGS84 +type=crs will  be  identi-
	      fied with	a likelihood of	70% to EPSG:32631

       --3d   New in version 6.3.

	      "Promote"	 the CRS(s) to their 3D	version. In the	context	of re-
	      searching	available coordinate transformations, explicitly spec-
	      ifying  this  option  is	not necessary, because when one	of the
	      source or	target CRS has a vertical component but	not the	 other
	      one,  the	 one  that  has	no vertical component is automatically
	      promoted to a 3D version,	where its vertical axis	is the	ellip-
	      soidal  height  in  metres, using	the ellipsoid of the base geo-
	      detic CRS.

       --c-ify
	      For developers only. Modify the string output of the utility  so
	      that it is easy to put those strings in C/C++ code

       --single-line
	      Output WKT or PROJJSON strings on	a single line, instead of mul-
	      tiple intended lines by default.

EXAMPLES
       1. Query	the CRS	object corresponding to	EPSG:4326

	  projinfo EPSG:4326

       Output:

	  PROJ.4 string:
	  +proj=longlat	+datum=WGS84 +no_defs +type=crs

	  WKT2:2019 string:
	  GEOGCRS["WGS 84",
	      DATUM["World Geodetic System 1984",
		  ELLIPSOID["WGS 84",6378137,298.257223563,
		      LENGTHUNIT["metre",1]]],
	      PRIMEM["Greenwich",0,
		  ANGLEUNIT["degree",0.0174532925199433]],
	      CS[ellipsoidal,2],
		  AXIS["geodetic latitude (Lat)",north,
		      ORDER[1],
		      ANGLEUNIT["degree",0.0174532925199433]],
		  AXIS["geodetic longitude (Lon)",east,
		      ORDER[2],
		      ANGLEUNIT["degree",0.0174532925199433]],
	      USAGE[
		  SCOPE["unknown"],
		  AREA["World"],
		  BBOX[-90,-180,90,180]],
	      ID["EPSG",4326]]

       2. List the coordinate operations between NAD27 (designed with its  CRS
	  name)	and NAD83 (designed with its EPSG code 4269) within an area of
	  interest

	  projinfo -s NAD27 -t EPSG:4269 --area	"USA - Missouri"

       Output:

	  DERIVED_FROM(EPSG):1241, NAD27 to NAD83 (1), 0.15 m, USA - CONUS including EEZ

	  PROJ string:
	  +proj=pipeline +step +proj=axisswap +order=2,1 +step +proj=unitconvert \
	  +xy_in=deg +xy_out=rad +step +proj=hgridshift	+grids=conus \
	  +step	+proj=unitconvert +xy_in=rad +xy_out=deg +step +proj=axisswap +order=2,1

	  WKT2:2019 string:
	  COORDINATEOPERATION["NAD27 to	NAD83 (1)",
	      SOURCECRS[
		  GEOGCRS["NAD27",
		      DATUM["North American Datum 1927",
			  ELLIPSOID["Clarke 1866",6378206.4,294.978698213898,
			      LENGTHUNIT["metre",1]]],
		      PRIMEM["Greenwich",0,
			  ANGLEUNIT["degree",0.0174532925199433]],
		      CS[ellipsoidal,2],
			  AXIS["geodetic latitude (Lat)",north,
			      ORDER[1],
			      ANGLEUNIT["degree",0.0174532925199433]],
			  AXIS["geodetic longitude (Lon)",east,
			      ORDER[2],
			      ANGLEUNIT["degree",0.0174532925199433]]]],
	      TARGETCRS[
		  GEOGCRS["NAD83",
		      DATUM["North American Datum 1983",
			  ELLIPSOID["GRS 1980",6378137,298.257222101,
			      LENGTHUNIT["metre",1]]],
		      PRIMEM["Greenwich",0,
			  ANGLEUNIT["degree",0.0174532925199433]],
		      CS[ellipsoidal,2],
			  AXIS["geodetic latitude (Lat)",north,
			      ORDER[1],
			      ANGLEUNIT["degree",0.0174532925199433]],
			  AXIS["geodetic longitude (Lon)",east,
			      ORDER[2],
			      ANGLEUNIT["degree",0.0174532925199433]]]],
	      METHOD["CTABLE2"],
	      PARAMETERFILE["Latitude and longitude difference file","conus"],
	      OPERATIONACCURACY[0.15],
	      USAGE[
		  SCOPE["unknown"],
		  AREA["USA - CONUS including EEZ"],
		  BBOX[23.81,-129.17,49.38,-65.69]],
	      ID["DERIVED_FROM(EPSG)",1241]]

       3. Export an object as a	PROJJSON string

	  projinfo GDA94 -o PROJJSON -q

       Output:

	  {
	      "type": "GeographicCRS",
	      "name": "GDA94",
	      "datum": {
		  "type": "GeodeticReferenceFrame",
		  "name": "Geocentric Datum of Australia 1994",
		  "ellipsoid": {
		      "name": "GRS 1980",
		      "semi_major_axis": 6378137,
		      "inverse_flattening": 298.257222101
		  }
	      },
	      "coordinate_system": {
		  "subtype": "ellipsoidal",
		  "axis": [
		  {
		      "name": "Geodetic	latitude",
		      "abbreviation": "Lat",
		      "direction": "north",
		      "unit": "degree"
		  },
		  {
		      "name": "Geodetic	longitude",
		      "abbreviation": "Lon",
		      "direction": "east",
		      "unit": "degree"
		  }
		  ]
	      },
	      "area": "Australia - GDA",
	      "bbox": {
		  "south_latitude": -60.56,
		  "west_longitude": 93.41,
		  "north_latitude": -8.47,
		  "east_longitude": 173.35
	      },
	      "id": {
		  "authority": "EPSG",
		  "code": 4283
	      }
	  }

SEE ALSO
       cs2cs(1), cct(1), geod(1), gie(1), proj(1)

BUGS
       A     list     of     know     bugs	can	 be	 found	    at
       https://github.com/OSGeo/PROJ/issues  where new bug reports can be sub-
       mitted to.

HOME PAGE
       https://proj.org/

AUTHOR
       Even Rouault

COPYRIGHT
       1983-2020

6.3.1				 Feb 10, 2020			   PROJINFO(1)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | BUGS | HOME PAGE | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=projinfo&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help