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 -->
6 <TITLE>EHEADER(1) manual page</TITLE>
9 <A HREF="#toc">Table of Contents</A><P>
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
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
20 Applies given editing commands to list of <B>epp</B> or <B>dgt</B> files. <P>
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.
26 No warning is issued also when no editing commands given, therefore this
27 utility can be used just for viewing header information. <P>
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>
35 <H2><A NAME="sect3" HREF="#toc3">UNIVERSAL
37 This commands can be applied to both <B>dgt </B> (vector) and <B>epp</B> (raster)
42 <DD>- dumps file header information <B>after</B> applying any edit options
43 to <I>stdout.</I> </DD>
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>
53 <DT><B>-y increment</B> </DT>
55 with alternative y </DD>
57 <DT><B>-s factor </B> </DT>
58 <DD>- multiplies all coordinates by factor </DD>
62 commands cannot be used together with explicit settings of some alternative
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>
70 <DT><B>-Xr value</B> or <B>-XR value</B> </DT>
71 <DD>- same with right border </DD>
74 or <B>-YB value</B>,<B>-Yt value</B> or <B>-YT</B> </DT>
75 <DD>- same with bottom and top y </DD>
77 <DT><B>-p name</B> </DT>
79 projection type to name. Available projection types ( <B>EPPL7 version 3.0</B>
80 ) are: <blockquote></DD>
83 <DD>- cause EPPL ver 3 to say "No alternate coordinates" </DD>
87 <DD>- UTM projection </DD>
89 <DT><B>stplate </B> </DT>
90 <DD>- state plane (projection for US state
94 <DD>- latitude and longitude (geographic coordinates) </DD>
98 <H2><A NAME="sect4" HREF="#toc4">EPP SPECIFIC
100 Following is applicable to EPP files only:
103 <DT><B>-o n</B> </DT>
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>
109 <DT><B>-fr n </B> </DT>
110 <DD>- set first row to n and updates
111 last row field respectively. </DD>
113 <DT><B>-fc n</B> </DT>
114 <DD> - set first column to n and updates
115 last column field. </DD>
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.
122 <DT><B>-a value</B> </DT>
123 <DD>- set cell area to value. </DD>
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
130 <DT><B>-u name </B> </DT>
131 <DD>- set area unit type, where unit type may be: <blockquote></DD>
135 <DD>- cause EPPL ver 3 to say "No alternate coordinates" </DD>
142 <DD>- square meters </DD>
145 <DD> - square kilometers </DD>
147 <DT><B>mile - square miles</B> </DT>
154 <DT><B>acre </B> </DT>
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.
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>
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>
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>
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>
197 <A NAME="toc"><B>Table of Contents</B></A><P>
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>