From 87f150f1d9e634f83cb8945abce2577a46bd7ed7 Mon Sep 17 00:00:00 2001 From: Frank Warmerdam Date: Fri, 14 Oct 2005 13:15:08 +0000 Subject: New git-svn-id: http://svn.osgeo.org/metacrs/proj/trunk@1305 4e78687f-474d-0410-85f9-8d5e500ac6b2 --- html/man_cs2cs.html | 301 +++++++++++++++++++++++++++++++++++++++++++++++++ html/man_geod.html | 307 ++++++++++++++++++++++++++++++++++++++++++++++++++ html/man_pj_init.html | 159 ++++++++++++++++++++++++++ 3 files changed, 767 insertions(+) create mode 100644 html/man_cs2cs.html create mode 100644 html/man_geod.html create mode 100644 html/man_pj_init.html (limited to 'html') diff --git a/html/man_cs2cs.html b/html/man_cs2cs.html new file mode 100644 index 00000000..edc34d7a --- /dev/null +++ b/html/man_cs2cs.html @@ -0,0 +1,301 @@ +Content-type: text/html + +Manpage of PROJ + +

PROJ

+Section: User Commands (1)
Updated: 2000/03/21 Rel. 4.4
Index +Return to Main Contents

+ + +

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 +auxilliary 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 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 +-w + +switch is not employed) and precise to 0.001" +with trailing, zero-valued minute-second fields deleted. + +

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 +

+ + +

HOME PAGE

+ +http://www.remotesensing.org/proj +

+ +

+This document was created by +man2html, +using the manual pages.
+Time: 13:14:44 GMT, October 14, 2005 + + diff --git a/html/man_geod.html b/html/man_geod.html new file mode 100644 index 00000000..e9622c5c --- /dev/null +++ b/html/man_geod.html @@ -0,0 +1,307 @@ +Content-type: text/html + +Manpage of GEOD + +

GEOD

+Section: User Commands (1)
Updated: 2000/03/21 Rel. 4.4
Index +Return to Main Contents

+ + +

NAME

+ +geod - direct geodesic computations +
+ +invgeod - inverse geodesic computations + +

SYNOPSIS

+ +geod + ++ellps=<ellipse> + +[ +-afFIlptwW + +[ +args + +] ] [ ++args + +] +file[s] +
+ +invgeod + ++ellps=<ellipse> + +[ +-afFIlptwW + +[ +args + +] ] [ ++args + +] +file[s] + +

DESCRIPTION

+ +Geod + +(direct) and +invgeod + +(inverse) +perform geodesic (``Great Circle'') computations for determining +latitude, longitude and back azimuth of a terminus point +given a initial point latitude, longitude, azimuth and distance (direct) or +the forward and back azimuths and distance between an initial and +terminus point latitudes and longitudes (inverse). +

+ +The following runline control parameters can appear in any order: +

-I + +: +Specifies that the inverse geodesic computation is to be performed. +May be used with execution of +goed + +as an alternative to +invgeod + +execution. +
-a + +: +Latitude and longitudes of the initial and terminal points, +forward and back azimuths and distance are output. +
-ta + +: +A + +specifies a character employed as the first character to denote +a control line to be passed through without processing. +
-le + +: +Gives a listing of all the ellipsoids that may be selected with the ++ellps= + +option. +
-lu + +: +Gives a listing of all the units that may be selected with the ++units= + +option. +
-[f|F] format + +: +Format + +is a +printf + +format string to control the output form of the geographic coordinate values +(f) or distance value (F). +The default mode is DMS for geographic coordinates and "%.3f" for distance. +
-[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 with leading zeroes. +
-p + +: +This option causes the azimuthal values to be output as unsigned +DMS numbers between 0 and 360 degrees. Also note -f. +

+ +The ++args + +run-line arguments are associated with geodetic parameters +for specifying the ellipsoidal or sphere to use. +See +proj + +documentation for full list of these parameters and contrl. +The options are processed in left to right order +from the run line. +Reentry of an option is ignored with the first occurance assumed to +be the desired value. +

+ +For direct determinations input data must be in latitude, +longitude, azimuth and distance order and output will be +latitude, longitude and back azimuth of the terminus point. +Latitude, longitude of the initial and terminus point are +input for the inverse mode and respective forward and back +azimuth from the initial and terminus points are output along +with the distance between the points. +

+ +Input geographic coordinates +(latitude and longitude) and azimuthal data must be in DMS format and input +distance data must be in units consistent with the ellipsoid +major axis or sphere radius units. +Output geographic coordinates will be in DMS +(if the +-f + +switch is not employed) to 0.001" +with trailing, zero-valued minute-second fields deleted. +Output distance data will be in the same units as the ellipsoid or +sphere radius. +

+ +The Earth's ellipsoidal figure may be selected in the same +manner as program +proj + +by using ++ellps=, +a=, +es=, + +etc. +

+ +Geod + +may also be used to determine intermediate points along either +a geodesic line between two points or along an arc of specified distance +from a geographic point. +In both cases an initial point must be specified with ++lat_1=lat + +and ++lon_1=lon + +parameters and either a terminus point ++lat_2=lat + +and ++lon_2=lon + +or a distance and azimuth from the initial point with ++S=distance + +and ++A=azimuth + +must be specified. +

+ +If points along a geodesic are to be determined then either ++n_S=integer + +specifying the number of intermediate points and/or ++del_S=distance + +specifying the incremental distance between points must be specified. +

+ +To determine points along an arc equidistant from the initial point both ++del_A=angle + +and ++n_A=integer + +must be specified which determine the respective angular increments +and number of points to be determined. + + +

EXAMPLE

+ +The following script determines the geodesic azimuths and distance in +U.S. stature miles from Boston, MA, to Portland, OR: +

: +
geod +ellps=clrk66 <<EOF -I +units=us-mi + 42d15'N 71d07'W 45d31'N 123d41'W + EOF +

+ +which gives the results: +

: +
-66d31'50.141" 75d39'13.083" 2587.504 +

+ +where the first two values are the +azimuth from Boston to Portland, the back azimuth from Portland to +Boston followed by the distance. + + +An example of forward geodesic use is to use the Boston location and determine +Portland's location by azimuth and distance: +

: + geod +ellps=clrk66 <<EOF +units=us-mi + 42d15'N 71d07'W -66d31'50.141" 2587.504 + EOF +

+ +which gives: +

: +
45d31'0.003"N 123d40'59.985"W 75d39'13.094" +

+ +Note: lack of precision in the distance value compromises +the precision of the Portland location. + +

HOME PAGE

+ +http://www.remotesensing.org/proj +

+ +

Index

NAME: +
SYNOPSIS: +
DESCRIPTION: +
EXAMPLE: +
SEE ALSO: +
HOME PAGE: +

+This document was created by +man2html, +using the manual pages.
+Time: 13:14:56 GMT, October 14, 2005 + + diff --git a/html/man_pj_init.html b/html/man_pj_init.html new file mode 100644 index 00000000..e46a5a03 --- /dev/null +++ b/html/man_pj_init.html @@ -0,0 +1,159 @@ +Content-type: text/html + +Manpage of PJ_INIT + +

PJ_INIT

+Section: Misc. Reference Manual Pages (3U)
Updated: 2001/04/05 Rel. 4.4
Index +Return to Main Contents

+ + + + +

NAME

+ +pj_init - initialize cartographic projection +
+ +pj_init_plus - initialize cartographic projection +
+ +pj_fwd - forward cartographic projection +
+ +pj_inv - inverse cartographic projection +
+ +pj_transform - transform between coordinate systems +
+ +pj_free - de-initialize projection + +

SYNOPSIS

+ +

+#include <proj_api.h>
+
+projPJ pj_init(int argc, char **argv)
+
+projPJ pj_init_plus(const char *defn)
+
+projUV pj_fwd(projUV val, projPJ proj)
+
+projUV pj_inv(projUV val, projPJ proj)
+
+int pj_transform(projPJ src_cs, projPJ dst_cs, long point_count, 
+                 double *x, double *y, double *z)
+               
+void pj_free(projPJ proj)
+
+

DESCRIPTION

+ +Procedure pj_init selects and initializes a cartographic projection +with its argument control parameters. +Argc is the number of elements in the array of control strings +argv that each contain individual cartographic control keyword +assignments (+ proj arguments). +The list must contain at least the proj=projection and +Earth's radius or elliptical parameters. +If the initialization of the projection is successful a valid +address is returned otherwise a NULL value. +

+The pj_init_plus function operates similarly to pj_init but +takes a single string containing the definition, with each parameter +prefixed with a plus sign. For example "+proj=utm +zone=11 +ellps=WGS84". +

+Once initialization is performed either forward or inverse +projections can be performed with the returned value of pj_init +used as the argument proj. +The argument structure projUV values u and v contain +respective longitude and latitude or x and y. +Latitude and longitude are in radians. +If a projection operation fails, both elements of projUV are +set to HUGE_VAL (defined in math.h). +

+Note: all projections have a forward mode, but some do not have +an inverse projection. +If the projection does not have an inverse the projPJ structure element +inv will be NULL. +

+The pj_transform function may be used to transform points between +the two provided coordinate systems. In addition to converting between +cartographic projection coordinates and geographic coordinates, this function +also takes care of datum shifts if possible between the source and destination +coordinate system. Unlike pj_fwd and pj_inv it is also allowable +for the coordinate system definitions (PJ *) to be geographic coordinate +systems (defined as +proj=latlong). The x, y and z arrays +contain the input values of the points, and are replaced with the output +values. The function returns zero on success, or the error number (also in +pj_errno) on failure. +

+Memory associated with the projection may be freed with pj_free. + +

EXAMPLE

+ +The following program reads latitude and longitude values in decimal +degress, performs Mercator projection with a Clarke 1866 ellipsoid and +a 33° latitude of true scale and prints the projected +cartesian values in meters: +

+
+#include <proj_api.h>
+
+main(int argc, char **argv) {
+        char *args[] = { "proj=merc", "ellps=clrk66", "lat_ts=33" };
+        projUV p;
+        projPJ pj;
+
+        if (!(pj = pj_init(3, args)))
+           exit(1);
+        while (scanf("%lf %lf", &p.v, &p.u) == 2) {
+           p.u *= DEG_TO_RAD;
+           p.v *= DEG_TO_RAD;
+           p = pj_fwd(p, pj);
+           printf("%.2f\t%.2f\n", p.u, p.v);
+        }
+        exit(0);
+} 
+

+

+ + +

LIBRARY

+ +libproj.a - library of projections and support procedures + +

HOME PAGE

+ +http://www.remotesensing.org/proj +

+ +

Index

NAME: +
SYNOPSIS: +
DESCRIPTION: +
EXAMPLE: +
LIBRARY: +
SEE ALSO: +
HOME PAGE: +

+This document was created by +man2html, +using the manual pages.
+Time: 13:14:22 GMT, October 14, 2005 + + -- cgit v1.2.3

PROJ

NAME

SYNOPSIS

DESCRIPTION

EXAMPLE

SEE ALSO

HOME PAGE

Index

GEOD

NAME

SYNOPSIS

DESCRIPTION

EXAMPLE

SEE ALSO

HOME PAGE

Index

PJ_INIT

NAME

SYNOPSIS

DESCRIPTION

EXAMPLE

LIBRARY

SEE ALSO

HOME PAGE

Index