xenial (1) cs2cs.1.gz

Provided by: proj-bin_4.9.2-2_amd64 bug

NAME

       cs2cs - cartographic coordinate system filter

SYNOPSIS

       cs2cs [ -eEfIlrstvwW [ args ] ] [ +opts[=arg] ]
             [ +to [+opts[=arg]] ] file[s]

DESCRIPTION

       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
       geographic coordinates as well as the application of datum shifts.

       The following control parameters can appear in any order:

       -I     method  to  specify  inverse  translation,  convert  from  +to  coordinate  system  to the primary
              coordinate system defined.

       -ta    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).

       -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 or -o options are employed, an error is
              returned as HUGE_VAL value for both return values.

       -E     causes the input coordinates to be copied to the output  line  prior  to  printing  the  converted
              values.

       -l[p|P|=|e|u|d]id
              List projection identifiers with -l, -lp or -lP (expanded) that can be selected with +proj.  -l=id
              gives expanded description of projection id.  List ellipsoid identifiers with  -le,  that  can  be
              selected  with +ellps, -lu list of cartesian to meter conversion factors that can be selected with
              +units or -ld list of datums that can be selected with +datum.

       -r     This options reverses the order of the expected input from longitude-latitude or x-y to  latitude-
              longitude or y-x.

       -s     This  options  reverses the order of the output from x-y or longitude-latitude to y-x or latitude-
              longitude.

       -f format
              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 decimal degrees.  The default format  is  "%.2f"
              for forward projection and DMS for inverse.

       -[w|W]n
              N  is the number of significant fractional digits to employ for seconds output (when the option is
              not specified, -w3 is assumed).  When -W is employed the fields will be constant  width  and  with
              leading zeroes.

       -v     causes  a  listing  of  cartographic  control  parameters tested for and used by the program to be
              printed prior to input data.

       The +args run-line arguments are associated with cartographic parameters and usage varies with projection
       and  for  a complete description see Cartographic Projection Procedures for the UNIX Environment—A User's
       Manual and supplementary documentation for Release 4.

       The 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 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 +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 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 normally be in DMS format (use -f %.12f for decimal degrees with 12 decimal
       places), while projected (cartesian) coordinates will be in linear (meter, feet) units.

EXAMPLE

       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
       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

SEE ALSO

       proj(1),
       Cartographic Projection Procedures for the UNIX Environment—A User's Manual,  (Evenden,  1990,  Open-file
       report 90-284).
       Map Projections Used by the U. S. Geological Survey (Snyder, 1984, USGS Bulletin 1532).
       Map Projections—A Working Manual (Snyder, 1988, USGS Prof. Paper 1395).
       An Album of Map Projections (Snyder & Voxland, 1989, USGS Prof. Paper 1453).

HOME PAGE

       http://www.remotesensing.org/proj

                                               2000/03/21 Rel. 4.4                                       PROJ(1)