diff options
Diffstat (limited to 'docs/source/apps/cs2cs.rst')
| -rw-r--r-- | docs/source/apps/cs2cs.rst | 82 |
1 files changed, 41 insertions, 41 deletions
diff --git a/docs/source/apps/cs2cs.rst b/docs/source/apps/cs2cs.rst index ba77aadf..45d004bf 100644 --- a/docs/source/apps/cs2cs.rst +++ b/docs/source/apps/cs2cs.rst @@ -11,17 +11,17 @@ cs2cs Synopsis ******** - **cs2cs** [ **-eEfIlrstvwW** [ args ] ] [ *+opts[=arg]* ] [ +to [*+opts[=arg]*] ] file[s] + **cs2cs** [ **-eEfIlrstvwW** [ args ] ] [ *+opts[=arg]* ] [ +to [*+opts[=arg]*] ] file[s] Description *********** :program:`cs2cs` performs transformation between the source and destination -cartographic coordinate system on a set of input points. The coordinate -system transformation can include translation between projected and +cartographic coordinate system on a set of input points. The coordinate +system transformation can include translation between projected and geographic coordinates as well as the application of datum shifts. -The following control parameters can appear in any order: +The following control parameters can appear in any order: .. program:: cs2cs @@ -33,20 +33,20 @@ The following control parameters can appear in any order: .. option:: -t<a> A specifies a character employed as the first character to denote a control - line to be passed through without processing. This option applicable to - ascii input only. (# is the default value). + line to be passed through without processing. This option applicable to + ascii input only. (# is the default value). .. option:: -e <string> - String is an arbitrary string to be output if an error is detected during - data transformations. The default value is: *\t*. Note that if the -b, -i + String is an arbitrary string to be output if an error is detected during + data transformations. The default value is: *\t*. Note that if the -b, -i or -o options are employed, an error is returned as HUGE_VAL value for both return values. .. option:: -E causes the input coordinates to be copied to the output line prior to - printing the converted values. + printing the converted values. .. option:: -l<[=id]> @@ -89,8 +89,8 @@ The following control parameters can appear in any order: Format is a printf format string to control the form of the output values. For inverse projections, the output will be in degrees when this option is - employed. If a format is specified for inverse projection the output data - will be in deci- mal degrees. The default format is "%.2f" for forward + employed. If a format is specified for inverse projection the output data + will be in decimal degrees. The default format is "%.2f" for forward projection and DMS for inverse. .. option:: -[w|W]<n> @@ -113,38 +113,38 @@ The following control parameters can appear in any order: .. only:: html The *+args* run-line arguments are associated with cartographic - parameters. Usage varies with projection and for a complete description + parameters. Usage varies with projection and for a complete description consult the :ref:`projection pages <projections>`. -The :program:`cs2cs` program requires two coordinate system definitions. The first (or -primary is defined based on all projection parameters not appearing after the -*+to* argument. All projection parameters appearing after the *+to* argument -are considered the definition of the second coordinate system. If there is no +The :program:`cs2cs` program requires two coordinate system definitions. The first (or +primary is defined based on all projection parameters not appearing after the +*+to* argument. All projection parameters appearing after the *+to* argument +are considered the definition of the second coordinate system. If there is no second coordinate system defined, a geographic coordinate system based on the -datum and ellipsoid of the source coordinate system is assumed. Note that the -source and destination coordinate system can both be projections, both be +datum and ellipsoid of the source coordinate system is assumed. Note that the +source and destination coordinate system can both be projections, both be geographic, or one of each and may have the same or different datums. -Additional projection control parameters may be contained in two auxiliary -control files: the first is optionally referenced with the +Additional projection control parameters may be contained in two auxiliary +control files: the first is optionally referenced with the *+init=file:id* and the second is always processed after the name of the -projection has been established from either the run-line or the contents of -*+init* file. The environment parameter PROJ_LIB establishes the default -directory for a file reference without an absolute path. This is also used -for supporting files like datum shift files. - -One or more files (processed in left to right order) specify the source of -data to be transformed. A ``-`` will specify the location of processing standard -input. If no files are specified, the input is assumed to be from stdin. -For input data the two data values must be in the first two white space -separated fields and when both input and output are ASCII all trailing portions +projection has been established from either the run-line or the contents of +*+init* file. The environment parameter PROJ_LIB establishes the default +directory for a file reference without an absolute path. This is also used +for supporting files like datum shift files. + +One or more files (processed in left to right order) specify the source of +data to be transformed. A ``-`` will specify the location of processing standard +input. If no files are specified, the input is assumed to be from stdin. +For input data the two data values must be in the first two white space +separated fields and when both input and output are ASCII all trailing portions of the input line are appended to the output line. -Input geographic data (longitude and latitude) must be in DMS or decimal -degrees format and input cartesian data must be in units consistent with the -ellipsoid major axis or sphere radius units. Output geographic coordinates will +Input geographic data (longitude and latitude) must be in DMS or decimal +degrees format and input cartesian data must be in units consistent with the +ellipsoid major axis or sphere radius units. Output geographic coordinates will normally be in DMS format (use ``-f %.12f`` for decimal degrees with 12 decimal -places), while projected (cartesian) coordinates will be in linear +places), while projected (cartesian) coordinates will be in linear (meter, feet) units. @@ -155,18 +155,18 @@ The following script :: - cs2cs +proj=latlong +datum=NAD83 +to +proj=utm +zone=10 +datum=NAD27 -r - <<EOF 45d15'33.1" 111.5W 45d15.551666667N -111d30 +45.25919444444 - 111d30'000w EOF + cs2cs +proj=latlong +datum=NAD83 +to +proj=utm +zone=10 +datum=NAD27 -r + <<EOF 45d15'33.1" 111.5W 45d15.551666667N -111d30 +45.25919444444 + 111d30'000w EOF -will transform the input NAD83 geographic coordinates into NAD27 coordinates in -the UTM projection with zone 10 selected. The geographic values of this -example are equivalent and meant as examples of various forms of DMS input. +will transform the input NAD83 geographic coordinates into NAD27 coordinates in +the UTM projection with zone 10 selected. The geographic values of this +example are equivalent and meant as examples of various forms of DMS input. The x-y output data will appear as three lines of: :: - 1402285.99 5076292.42 0.000 + 1402285.99 5076292.42 0.000 .. only:: man |