geography/fGIS/man/projection.n.html

   1 <!-- manual page source format generated by PolyglotMan v3.0.4, -->
   2 <!-- available via anonymous ftp from ftp.cs.berkeley.edu:/ucb/people/phelps/tcltk/rman.tar.Z -->
   3
   4 <HTML>
   5 <HEAD>
   6 <TITLE>projection(n) manual page</TITLE>
   7 </HEAD>
   8 <BODY>
   9 <A HREF="#toc">Table of Contents</A><P>
  10 .SH NAME<BR>
  11
  12 projection \- Create and manipulate projection objects
  13 <P>
  14 .SH SYNOPSIS<BR>
  15
  16 \fB projection \fItype\fR ?\fIparameters\fR?<BR>
  17
  18 .PP
  19 <P>
  20 .SH DESCRIPTION<BR>
  21
  22 .PP
  23
  24 <H2><A NAME="sect0" HREF="#toc0">This command creates projection object, used to recalculate geographic</A></H2>
  25
  26 <P>
  27 coordinates (latitude and longitude) into map projection coodrinates.
  28 .PP<BR>
  29
  30 \fBprojection\fR command takes list of options and
  31 returns name of newly created projection object.
  32
  33 <H2><A NAME="sect1" HREF="#toc1">Name of object can be used as Tcl command which have several subcommands</A></H2>
  34
  35 <P>
  36 (see \fBPROJECTION SUBCOMMANDS\fR below) used for manipulation
  37 of projections.
  38 <P>
  39 .SH PROJECTION TYPES
  40
  41 <H2><A NAME="sect2" HREF="#toc2">Most important property of projection is projection type. fGIS supports</A></H2>
  42
  43 <P>
  44 following types of projections:
  45 <P>
  46 \&raquo; list should be here
  47 <P>
  48 .SH PROJECTION OPTIONS
  49 <P>
  50 \&raquo; list should be here
  51 <P>
  52 .SH PROJECTION SUBCOMMANDS<BR>
  53
  54 .TP 8<BR>
  55
  56 \fIprojName \fBforward\fI long lat\fR<BR>
  57
  58 recieves two arguments - geographic longitude and latitude as degrees in
  59 decimal format and returs list of two double values representing map
  60 coordinates in meters.
  61 <P>
  62 .TP 8<BR>
  63
  64 \fIprojName \fBbackward\fI X Y \fR<BR>
  65
  66 performs backword transformation - given map coordinates in meters
  67 returns longitude and latitude in decimal degrees,
  68 .TP 8<BR>
  69
  70 \fIprojName \fBformat\fI X Y\fR ?\fB-format\fI formatString\fR
  71
  72 <H2><A NAME="sect3" HREF="#toc3">Returns formatted representation of latitude and longitude. String</A></H2>
  73
  74 <P>
  75 can contain following escapes sequences:<BR>
  76
  77 .RS<BR>
  78
  79 .TP<BR>
  80
  81 \fB%lt\fR<BR>
  82
  83 unsigned latitude in DDMMSS format<BR>
  84
  85 .TP<BR>
  86
  87 \fB%lg\fR<BR>
  88
  89 unsigned longitude in DDMMSS format<BR>
  90
  91 .TP<BR>
  92
  93 \fB%-t\fR \fB%-g\fR<BR>
  94
  95 optionally signed latitude and longitude in DDMMSS format
  96 .TP<BR>
  97
  98 \fB%+t\fR \fB%+g\fR<BR>
  99
 100 explicitely signed latitude and longitude in DDMMSS format
 101 .TP<BR>
 102
 103 \fB%lG %lT %-G %-T %+G %+T\fR<BR>
 104
 105 same as above, but in decimal fractions of degree
 106 .TP<BR>
 107
 108 \fB%dl %dg\fR<BR>
 109
 110 direction indicator - letters N and S for latitude and E and W for
 111 longitude (or some other national language values as defined in fgis.rc
 112 file).<BR>
 113
 114 .RE<BR>
 115
 116
 117 <H2><A NAME="sect4" HREF="#toc4">If \fIformatString\fR omitted, default &laquo;%lt%dt %lg%dg&raquo; is used.</A></H2>
 118
 119 <P>
 120 .TP 8<BR>
 121
 122 \fIprojName\fB dump\fR<BR>
 123
 124 returns argumets for projection command used to create this projection
 125 object.<BR>
 126
 127 .TP 8<BR>
 128
 129 \fIprojName\fB delete\fR<BR>
 130
 131 destroys projection object.
 132 <P>
 133 .SH &laquo;SEE ALSO"
 134 <P>
 135 .BR proj &laquo;(1), &laquo; pj_init &laquo;(3), &laquo; transform (1)
 136 <P>
 137
 138 <HR><P>
 139 <A NAME="toc"><B>Table of Contents</B></A><P>
 140 <UL>
 141 <LI><A NAME="toc0" HREF="#sect0">This command creates projection object, used to recalculate geographic</A></LI>
 142 <LI><A NAME="toc1" HREF="#sect1">Name of object can be used as Tcl command which have several subcommands</A></LI>
 143 <LI><A NAME="toc2" HREF="#sect2">Most important property of projection is projection type. fGIS supports</A></LI>
 144 <LI><A NAME="toc3" HREF="#sect3">Returns formatted representation of latitude and longitude. String</A></LI>
 145 <LI><A NAME="toc4" HREF="#sect4">If \fIformatString\fR omitted, default "%lt%dt %lg%dg" is used.</A></LI>
 146 </UL>
 147 </BODY></HTML>