man/eheader.1

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