Rel. 9.9.0 (1df2be6), September 15th, 2026
<cs2cs>:
invalid option: --
program abnormally terminated
Options (24)
| Option | Description | Source |
|---|
-I | Perform the inverse transformation, that is from target CRS to source CRS. | man |
-t a | Where a specifies a character employed as the first character to denote a control line to be passed through without processing. | man |
-d n | Added in version 5.2.0. | man |
-e string | Where string is an arbitrary string to be output if an error is detected during data transformations. | man |
-E | Causes the input coordinates to be copied to the output line prior to printing the converted values. | man |
-lp | List of all projection id that can be used with the +proj parameter. | man |
-lP | Expanded description of all projections that can be used with the +proj parameter. | man |
-le | List of all ellipsoids that can be selected with the +ellps parameters. | man |
-lm | List of hard-coded prime meridians that can be selected with the +pm parameter. | man |
-lu | List of all distance units that can be selected with the +units parameter. | man |
-r | This options reverses the order of the first two expected inputs from that specified by the CRS to the opposite order. | man |
-s | This options reverses the order of the first two expected outputs from that specified by the CRS to the opposite order. | man |
-f format | Where format is a printf format string to control the form of the output values. | man |
-w n | Where n is the number of significant fractional digits to employ for seconds output (when the option is not specified, -w3 is assumed). | man |
-W n | Where n is the number of significant fractional digits to employ for seconds output. | man |
-v | Causes a listing of cartographic control parameters tested for and used by the program to be printed prior to input data. | man |
--area name_or_code | Added in version 8.0.0. | man |
--bbox west_long | Added in version 8.0.0. | man |
--no-ballpark | Added in version 8.0.0. | man |
--accuracy accuracy | Added in version 8.0.0. | man |
--authority name | Added in version 8.0.0. | man |
--3d | Added in version 9.1. | man |
--s_epoch | Added in version 9.4. | man |
--t_epoch | Added in version 9.4. | man |
Examples (10) from the manual page, untested
cs2cs EPSG:4326 EPSG:32631 <<EOF
Transforming from WGS 84 latitude/longitude (in that order) to UTM Zone 31N/WGS 84421184.70 4983436.77 0.00
outputsecho 45 2 0 | cs2cs "WGS 84 + EGM96 height" "WGS 84 / UTM zone 31N" --3d
Transforming from WGS 84 latitude/longitude (in that order) with EGM96 height to UTM Zone 31N/WGS 84 with WGS84 ellipsoidal height421184.70 4983436.77 50.69
outputscs2cs +proj=latlong +datum=NAD83 +to +proj=utm +zone=10 +datum=NAD27 -r <<EOF
The following script1402285.93 5076292.58 0.00
will transform the input NAD83 geographic coordinates into NAD27 coordinates in the UTM projection with zone 10 selected.echo -111.5 45.25919444444 | cs2cs --only-best +proj=latlong +datum=NAD83 +to +proj=utm +zone=10 +datum=NAD27
To make sure you will get the optimal result, you may add --only-best.Attempt to use coordinate operation axis order change (2D) + Inverse of NAD27 to NAD83 (7) + axis order change (2D) + UTM zone 10N failed. Grid us_noaa_nadcon5_nad27_nad83_1986_conus.tif is not available. Consult https://proj.org/resource_files.html for guidance.
would return:echo -111.5 45.25919444444 | cs2cs --only-best +proj=latlong +datum=NAD83 +to +proj=utm +zone=10 +datum=NAD27
Otherwise, if you don't have the grid available and you don't specify --only-best:1402224.57 5076275.42 0.00
would return:
Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.