diff options
Diffstat (limited to 'man/man1/proj.1')
| -rw-r--r-- | man/man1/proj.1 | 121 |
1 files changed, 63 insertions, 58 deletions
diff --git a/man/man1/proj.1 b/man/man1/proj.1 index 6faab758..8190b452 100644 --- a/man/man1/proj.1 +++ b/man/man1/proj.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "PROJ" "1" "Mar 18, 2018" "5.0.0" "PROJ.4" +.TH "PROJ" "1" "May 24, 2018" "5.1.0" "PROJ.4" .SH NAME proj \- Cartographic projection filter . @@ -33,27 +33,27 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .SH SYNOPSIS .INDENT 0.0 .INDENT 3.5 -\fBproj\fP [ \fB\-bceEfiIlmorsStTvVwW\fP ] [ args ] ] [ \fI+args\fP ] file[s] +\fBproj\fP [ \fB\-beEfiIlmorsStTvVwW\fP ] [ args ] ] [ \fI+args\fP ] file[s] .sp -\fBinvproj\fP [ \fB\-bceEfiIlmorsStTwW\fP ] [ args ] ] [ \fI+args\fP ] file[s] +\fBinvproj\fP [ \fB\-beEfiIlmorsStTvVwW\fP ] [ args ] ] [ \fI+args\fP ] file[s] .UNINDENT .UNINDENT .SH DESCRIPTION .sp -\fBproj\fP and \fBinvproj\fP perform respective forward and inverse -transformation of cartographic data to or from cartesian data with a wide -range of selectable projection functions. +\fBproj\fP and \fBinvproj\fP perform respective forward and inverse +transformation of cartographic data to or from cartesian data with a wide +range of selectable projection functions. .sp -\fBinvproj\fP may not be available on all platforms; in this case +\fBinvproj\fP may not be available on all platforms; in this case use \fI\%proj \-I\fP instead. .sp -The following control parameters can appear in any order +The following control parameters can appear in any order .INDENT 0.0 .TP .B \-b Special option for binary coordinate data input and output through standard input and standard output. Data is assumed to be in system type double -floating point words. This option is to be used when proj is a son process +floating point words. This option is to be used when \fBproj\fP is a child process and allows bypassing formatting operations. .UNINDENT .INDENT 0.0 @@ -64,8 +64,8 @@ Selects binary input only (see \fI\%\-b\fP). .INDENT 0.0 .TP .B \-I -alternate method to specify inverse projection. Redundant when used with -invproj. +Alternate method to specify inverse projection. Redundant when used with +\fBinvproj\fP\&. .UNINDENT .INDENT 0.0 .TP @@ -75,29 +75,29 @@ Selects binary output only (see \fI\%\-b\fP). .INDENT 0.0 .TP .B \-t<a> -\fIa\fP 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). +Where \fIa\fP 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). .UNINDENT .INDENT 0.0 .TP .B \-e <string> -String is an arbitrary string to be output if an error is detected during -data transformations. The default value is: \fIt\fP\&. Note that if the -\fI\%\-b\fP, \fI\%\-i\fP or \fI\%\-o\fP options are employed, an error +Where \fIstring\fP is an arbitrary string to be output if an error is detected during +data transformations. The default value is a three character string: \fB*\et*\fP\&. +Note that if the \fI\%\-b\fP, \fI\%\-i\fP or \fI\%\-o\fP options are employed, an error is returned as HUGE_VAL value for both return values. .UNINDENT .INDENT 0.0 .TP .B \-E -causes the input coordinates to be copied to the output line prior to +Causes the input coordinates to be copied to the output line prior to printing the converted values. .UNINDENT .INDENT 0.0 .TP .B \-l<[=id]> List projection identifiers that can be selected with \fI+proj\fP\&. \fBproj \-l=id\fP -gives expanded description of projection id, e.g. \fBproj \-l=merc\fP\&. +gives expanded description of projection \fIid\fP, e.g. \fBproj \-l=merc\fP\&. .UNINDENT .INDENT 0.0 .TP @@ -150,31 +150,37 @@ area projections will have an area factor of 1. .INDENT 0.0 .TP .B \-m <mult> -The cartesian data may be scaled by the mult parameter. When processing data +The cartesian data may be scaled by the \fImult\fP parameter. When processing data in a forward projection mode the cartesian output values are multiplied by -mult otherwise the input cartesian values are divided by mult before inverse -projection. If the first two characters of mult are 1/ or 1: then the -reciprocal value of mult is employed. +\fImult\fP otherwise the input cartesian values are divided by \fImult\fP before inverse +projection. If the first two characters of \fImult\fP are 1/ or 1: then the +reciprocal value of \fImult\fP is employed. .UNINDENT .INDENT 0.0 .TP .B \-f <format> -Format is a printf format string to control the form of the output values. +Where \fIformat\fP 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. The default format is â%.2fâ for forward projection and DMS for +employed. The default format is \fB"%.2f"\fP for forward projection and DMS for inverse. .UNINDENT .INDENT 0.0 .TP -.B \-[w|W]<n> -N is the number of significant fractional digits to employ for seconds -output (when the option is not specified, \fB\-w3\fP is assumed). When \fB\-W\fP -is employed the fields will be constant width and with leading zeroes. +.B \-w<n> +Where \fIn\fP is the number of significant fractional digits to employ for seconds +output (when the option is not specified, \fB\-w3\fP is assumed). +.UNINDENT +.INDENT 0.0 +.TP +.B \-W<n> +Where \fIn\fP is the number of significant fractional digits to employ for seconds +output. When \fB\-W\fP is employed the fields will be constant width +with leading zeroes. .UNINDENT .INDENT 0.0 .TP .B \-v -causes a listing of cartographic control parameters tested for and used by +Causes a listing of cartographic control parameters tested for and used by the program to be printed prior to input data. Should not be used with the \fI\%\-T\fP option. .UNINDENT @@ -188,35 +194,35 @@ the projected point. \fI\%\-v\fP is implied with this option. .TP .B \-T <ulow,uhi,vlow,vhi,res[,umax,vmax]> This option creates a set of bivariate Chebyshev polynomial coefficients -that approximate the selected cartographic projection on stdout. The values -low and hi denote the range of the input where the u or v prefixes apply to +that approximate the selected cartographic projection on stdout. The values +\fIlow\fP and \fIhi\fP denote the range of the input where the \fIu\fP or \fIv\fP prefixes apply to respective longitude\-x or latitude\-y depending upon whether a forward or -inverse projection is selected. Res is an integer number specifying the -power of 10 precision of the approximation. For example, a res of \-3 -specifies an approximation with an accuracy better than .001. Umax, and vmax +inverse projection is selected. The integer \fIres\fP is a number specifying the +power of 10 precision of the approximation. For example, a \fIres\fP of \-3 +specifies an approximation with an accuracy better than 0.001. Optional \fIumax\fP, and \fIvmax\fP specify maximum degree of the polynomials (default: 15). .UNINDENT .sp The \fI+args\fP run\-line arguments are associated with cartographic parameters. -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 \fI+init=file:id\fP 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 \fBPROJ_LIB\fP establishes the -default directory for a file reference without an absolute path. This is -also used for supporting files like datum shift files. ++init file. The environment parameter \fBPROJ_LIB\fP establishes the +default directory for a file reference without an absolute path. This is +also used for supporting files like datum shift files. .sp -One or more files (processed in left to right order) specify the source of -data to be transformed. A \fB\-\fP will specify the location of processing standard -input. If no files are specified, the input is assumed to be from stdin. -For ASCII 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 +One or more files (processed in left to right order) specify the source of +data to be transformed. A \fB\-\fP will specify the location of processing standard +input. If no files are specified, the input is assumed to be from stdin. +For ASCII 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. .sp -Input geographic data (longitude and latitude) must be in DMS format and input -cartesian data must be in units consistent with the ellipsoid major axis or -sphere radius units. Output geographic coordinates will be in DMS (if the -\fB\-w\fP switch is not employed) and precise to 0.001â with trailing, zero\-valued +Input geographic data (longitude and latitude) must be in DMS format and input +cartesian data must be in units consistent with the ellipsoid major axis or +sphere radius units. Output geographic coordinates will be in DMS (if the +\fB\-w\fP switch is not employed) and precise to 0.001" with trailing, zero\-valued minute\-second fields deleted. .SH EXAMPLE .sp @@ -226,20 +232,19 @@ The following script .sp .nf .ft C -proj +proj=utm +lon_0=112w +ellps=clrk66 -\-r <<EOF -45d15\(aq33.1" 111.5W -45d15.551666667N \-111d30 -+45.25919444444 111d30\(aq000w +proj +proj=utm +lon_0=112w +ellps=clrk66 \-r <<EOF +45d15\(aq33.1" 111.5W +45d15.551666667N \-111d30 ++45.25919444444 111d30\(aq000w EOF .ft P .fi .UNINDENT .UNINDENT .sp -will perform UTM forward projection with a standard UTM central meridian -nearest longitude 112W. The geographic values of this example are equivalent -and meant as examples of various forms of DMS input. The x\-y output +will perform UTM forward projection with a standard UTM central meridian +nearest longitude 112W. 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: .INDENT 0.0 .INDENT 3.5 @@ -257,7 +262,7 @@ The \fBproj\fP program is limited to converting between geographic and projected coordinates within one datum. .sp The \fBcs2cs\fP program operates similarly, but allows translation -between any paor of definable coordinate reference systems, including +between any pair of definable coordinate reference systems, including support for datum translation. .SH SEE ALSO .sp |