geography/fGIS/man/eheader.1.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>EHEADER(1) manual page</TITLE>
   7 </HEAD>
   8 <BODY>
   9 <A HREF="#toc">Table of Contents</A><P>
  10
  11 <H2><A NAME="sect0" HREF="#toc0">NAME </A></H2>
  12 eheader - display and modify headers of EPPL7 data files
  13 <H2><A NAME="sect1" HREF="#toc1">SYNOPSIS
  14 </A></H2>
  15 <B>eheader </B> options files <P>
  16 <B>maplist</B> files <P>
  17 <B>mapalign</B> base_file  <B>[-v]</B> files
  18 <H2><A NAME="sect2" HREF="#toc2">DESCRIPTION
  19 </A></H2>
  20 Applies given editing commands to list of <B>epp</B> or <B>dgt</B>  files. <P>
  21 Several commands
  22 are applicable to both file types and several to  <B>epp</B> (raster) files only.
  23 No warning is issued when  <B>dgt</B> file is processed during section when epp-specific
  24 commands used, becouse several epp-files can be processed at same time.
  25 <P>
  26 No warning is issued also when no editing commands given, therefore  this
  27 utility can be used just for viewing header information. <P>
  28 When invoked as
  29 <B>maplist,</B> simply dumps headers of given files.  <P>
  30 when invoked as <B>mapalign</B>
  31 performs same operations as with <B>-A </B> key, but only other option accepted
  32 is  <B>-v.</B> This option may be given as before, as after base file. <P>
  33  <P>
  34
  35 <H2><A NAME="sect3" HREF="#toc3">UNIVERSAL
  36 OPTIONS </A></H2>
  37 This commands can be applied to both  <B>dgt </B> (vector) and <B>epp</B> (raster)
  38 files.
  39 <DL>
  40
  41 <DT><B>-v</B>  </DT>
  42 <DD>- dumps file header information <B>after</B> applying any edit options
  43 to <I>stdout.</I> </DD>
  44 </DL>
  45 <P>
  46
  47 <DL>
  48
  49 <DT><B>-x increment</B>  </DT>
  50 <DD>  - shifts alternative x by  <B>increment.</B> Increment
  51 can be any real number, both positive and negative. </DD>
  52
  53 <DT><B>-y increment</B>  </DT>
  54 <DD>  - same
  55 with alternative y </DD>
  56
  57 <DT><B>-s factor </B>  </DT>
  58 <DD>- multiplies all coordinates by factor </DD>
  59 </DL>
  60 <P>
  61 This
  62 commands cannot be used together with explicit settings of some alternative
  63 coordinate limit.
  64 <DL>
  65
  66 <DT><B>-Xl value</B> or  <B>-XL value</B>  </DT>
  67 <DD>- sets alternative x of left border
  68 to specified value </DD>
  69
  70 <DT><B>-Xr value</B> or <B>-XR value</B>  </DT>
  71 <DD>- same with right border </DD>
  72
  73 <DT><B>-Yb value</B>
  74 or <B>-YB value</B>,<B>-Yt value</B> or <B>-YT</B>  </DT>
  75 <DD>- same with bottom and top y </DD>
  76
  77 <DT><B>-p name</B>  </DT>
  78 <DD>  - set
  79 projection type to name. Available projection types ( <B>EPPL7 version 3.0</B>
  80 ) are:  <blockquote></DD>
  81
  82 <DT><B>none</B>  </DT>
  83 <DD>- cause EPPL ver 3 to say "No alternate coordinates" </DD>
  84
  85 <DT><B>utm</B>
  86 or <B>UTM</B>  </DT>
  87 <DD>- UTM projection </DD>
  88
  89 <DT><B>stplate </B>  </DT>
  90 <DD>- state plane (projection for US state
  91 maps) </DD>
  92
  93 <DT><B>ll </B>  </DT>
  94 <DD>- latitude and longitude (geographic coordinates) </DD>
  95 </DL>
  96  </blockquote>
  97
  98 <H2><A NAME="sect4" HREF="#toc4">EPP SPECIFIC
  99 COMMANDS </A></H2>
 100 Following is applicable to EPP files only:
 101 <DL>
 102
 103 <DT><B>-o n</B>  </DT>
 104 <DD> - set offsite
 105 value to n. Value can be in range -32768 65535. Negative values are equivalent
 106 to 65536-abs(n). Values above 255, applied to  <I>8-bit</I>  data files are silently
 107 translated into -1 (no offsite) </DD>
 108
 109 <DT><B>-fr n </B>  </DT>
 110 <DD>- set first row to n and updates
 111 last row field respectively. </DD>
 112
 113 <DT><B>-fc n</B>  </DT>
 114 <DD> - set first column to n and updates
 115 last column field. </DD>
 116
 117 <DT><B>-A filename </B>  </DT>
 118 <DD>- align to specified file, i.e updates row/column
 119 coordinates so row and column with same number have same alternative coordinates.
 120 </DD>
 121
 122 <DT><B>-a  value</B>  </DT>
 123 <DD>- set cell area to value. </DD>
 124
 125 <DT><B>-c "string"</B>  </DT>
 126 <DD> - fills description field
 127 of the header. String must be single command line argument, but not nessecary
 128 need quotes. </DD>
 129
 130 <DT><B>-u name </B>  </DT>
 131 <DD>- set area unit type, where unit type may be:  <blockquote></DD>
 132
 133 <DT><B>none
 134 </B>  </DT>
 135 <DD>- cause EPPL ver 3 to say "No alternate coordinates" </DD>
 136
 137 <DT><B>ft</B>  </DT>
 138 <DD>  - square feet
 139 </DD>
 140
 141 <DT><B>m </B>  </DT>
 142 <DD>- square meters </DD>
 143
 144 <DT><B>km</B>  </DT>
 145 <DD> - square kilometers </DD>
 146
 147 <DT><B>mile - square miles</B>  </DT>
 148 <DD></DD>
 149
 150 <DT><B>ha</B>  </DT>
 151 <DD> - hectares
 152 </DD>
 153
 154 <DT><B>acre </B>  </DT>
 155 <DD>- acres </DD>
 156 </DL>
 157 <P>
 158 This command does not perform any recalculation, it just
 159 update  unit name field. Use  <B>-a</B> command for change cell area value respectively.
 160  </blockquote>
 161
 162 <H2><A NAME="sect5" HREF="#toc5">OPTION COMPATIBILYTY </A></H2>
 163 Some options of  <B>eheader</B> cannot coexist together
 164 in same command line. there are two groups of options with incompatibilities
 165 between subgroup of each group. <P>
 166  First, options dealing with alternative
 167 coordinates. There are options <B>-Xl -Xr -Yt -Yb,</B> which set alternative coordinates
 168 explicitely, and options <B>-x -y -s,</B> which change coordinates by arithmetic
 169 calculations. Explicit and arithmetic changes of coordinates are not allowed
 170 simulateneously, becouse it is to hard to understand, which kind user
 171 want to apply first. <P>
 172  Second, options dealing with row/column coordinates
 173 of  <B>epp</B> files. Here there are options  <B>-A</B> and <B>-fr -fc</B> which performs directly
 174 opposite task. (usially  <B>-fr -lr</B> are used to set first row and column to
 175 one, to process file cutted from large   file separately and  <B>-A</B> to change
 176 it back to <B><A HREF="mosaic.1.html">mosaic</B>(1)</A>
 177  file into larger one.  <P>
 178
 179 <H2><A NAME="sect6" HREF="#toc6">SEE ALSO </A></H2>
 180 <B><A HREF="lessa.1.html">lessa</B>(1)</A>
 181 , <B><A HREF="mappaint.1.html">mappaint</B>(1)</A>
 182 ,
 183 <B><A HREF="mapcopy.1.html">mapcopy</B>(1)</A>
 184  <B><A HREF="epp.5.html">epp</B>(5)</A>
 185 , <B><A HREF="dgt.5.html">dgt</B>(5)</A>
 186
 187 <H2><A NAME="sect7" HREF="#toc7">BUGS </A></H2>
 188 No check is performed by  <B>-fr</B> and <B>-lr</B> command
 189 to ensure that row/column values are in valid range. <P>
 190 <B>-A</B> command sometimes
 191 miscalculates one cell. (but EPPL ver 2.1 does the same).
 192 <H2><A NAME="sect8" HREF="#toc8">AUTHOR </A></H2>
 193 Vitus Wagner,
 194 <B>SoftWeyr.</B> <P>
 195
 196 <HR><P>
 197 <A NAME="toc"><B>Table of Contents</B></A><P>
 198 <UL>
 199 <LI><A NAME="toc0" HREF="#sect0">NAME</A></LI>
 200 <LI><A NAME="toc1" HREF="#sect1">SYNOPSIS</A></LI>
 201 <LI><A NAME="toc2" HREF="#sect2">DESCRIPTION</A></LI>
 202 <LI><A NAME="toc3" HREF="#sect3">UNIVERSAL OPTIONS</A></LI>
 203 <LI><A NAME="toc4" HREF="#sect4">EPP SPECIFIC COMMANDS</A></LI>
 204 <LI><A NAME="toc5" HREF="#sect5">OPTION COMPATIBILYTY</A></LI>
 205 <LI><A NAME="toc6" HREF="#sect6">SEE ALSO</A></LI>
 206 <LI><A NAME="toc7" HREF="#sect7">BUGS</A></LI>
 207 <LI><A NAME="toc8" HREF="#sect8">AUTHOR</A></LI>
 208 </UL>
 209 </BODY></HTML>