.TH EHEADER 1 "Version 1.0" "Environmental planning utilities" "EPU user manual"
.SH NAME
eheader \- display and modify headers of EPPL7 data files
.SH SYNOPSIS
.B eheader 
options files
.PP
.B maplist
files
.PP
.B mapalign
base_file 
.B [-v]
files
.SH DESCRIPTION
Applies given editing commands to list of
.B epp
or
.B dgt
 files.
.PP
Several commands are applicable to both file types and several
to 
.B epp
(raster) files only.
No warning is issued when 
.B dgt
file is processed during section when epp\-specific commands used,
becouse several epp\-files can be processed at same time.
.PP
No warning is issued also when no editing commands given, therefore 
this utility can be used just for viewing header information.
.PP
When invoked as
.B maplist,
simply dumps headers of given files. 
.PP
when invoked as
.B mapalign
performs same operations as with
.B \-A 
key, but only other option accepted is 
.B -v.
This option may be given as before, as after base file.


.SH UNIVERSAL OPTIONS
This commands can be applied to both 
.B dgt 
(vector)
and
.B epp
(raster)
files.
.TP 8
.B \-v
\- dumps file header information
.B after
applying any edit options to
.I stdout.

.TP 8
.B \-x increment
  \- shifts alternative x by 
.B increment.
Increment can be any real number, both positive and negative.
.TP 8
.B \-y increment
  \- same with alternative y
.TP 8
.B \-s factor 
\- multiplies all coordinates by factor
.PP
This commands cannot be used together with explicit settings of some
alternative coordinate limit.
.TP 8
.BR "\-Xl value" " or  " "\-XL value"
\- sets alternative x of left border to specified value
.TP 8
.BR "\-Xr value" " or " "\-XR value"
\- same with right border
.TP 8
.BR "\-Yb value" " or " "\-YB value" , "\-Yt value" " or " "\-YT" 
\- same with bottom and top y
.TP 8 
.B \-p name
  \- set projection type to name. Available projection types (
.B EPPL7 version 3.0
) are:
.RS
.TP 8 
.B none
\- cause EPPL ver 3 to say "No alternate coordinates"
.TP 8 
.BR utm " or " UTM 
\- UTM projection
.TP 8 
.B stplate 
\- state plane (projection for US state maps)
.TP 8
.B ll 
\- latitude and longitude (geographic coordinates)
.RE
.SH "EPP SPECIFIC COMMANDS"
Following is applicable to EPP files only:
.TP 8
.B \-o n
 \- set offsite value to n. Value can be in range \-32768 65535.
Negative values are equivalent to 65536\-abs(n). Values above 255, applied
to 
.I 8\-bit 
data files are silently translated into \-1 (no offsite)
.TP 8
.B \-fr n 
\- set first row to n and updates last row field respectively.
.TP 8
.B \-fc n
 \- set first column to n and updates last column field.
.TP 8
.B \-A filename 
\- align to specified file, i.e updates row/column coordinates
so row and column with same number have same alternative coordinates.
.TP 8
.B \-a  value
\- set cell area to value.
.TP 8
.B \-c "string"
 \- fills description field of the header. String must be single command line
argument, but not nessecary need quotes.
.TP 8
.B \-u name 
\- set area unit type, where unit type may be:
.RS
.TP 8
.B none 
\- cause EPPL ver 3 to say "No alternate coordinates"
.TP 8
.B ft
  \- square feet
.TP 8
.B m 
\- square meters
.TP 8
.B km
 \- square kilometers
.TP 8
.B mile \- square miles
.TP 8
.B ha
 \- hectares
.TP 8
.B acre 
\- acres
.PP 
This command does not perform any recalculation, it just update 
unit name field. Use 
.B \-a
command for change cell area value respectively.
.RE
.SH "OPTION COMPATIBILYTY"
Some options of 
.B eheader
cannot coexist together in same command line.
there are two groups of options with incompatibilities between subgroup
of each group.

First, options dealing with alternative coordinates. There are options
.B "-Xl -Xr -Yt -Yb,"
which set alternative coordinates explicitely, and options
.B "-x -y -s",
which change coordinates by arithmetic calculations.
Explicit and arithmetic changes of coordinates are not allowed simulateneously,
becouse it is to hard to understand, which kind user want to apply first.

Second, options dealing with row/column coordinates of 
.B epp
files. Here there are options 
.BR "-A" " and " "-fr -fc"
which performs directly opposite task.
(usially 
.B -fr -lr
are used to set first row and column to one, to process file cutted from
large 
.epp
file separately
and 
.B -A
to change it back to
.BR mosaic (1)
file into larger one. 

.SH "SEE ALSO"
.BR lessa (1),
.BR mappaint (1),
.BR mapcopy (1)
.BR epp (5),
.BR dgt (5)
.SH BUGS
No check is performed by 
.B \-fr
and
.B \-lr
command to ensure that row/column values are in valid range.
.PP
.B \-A
command sometimes miscalculates one cell. (but EPPL ver 2.1 does the same).
.SH AUTHOR
Vitus Wagner,
.B SoftWeyr.