]> www.wagner.pp.ru Git - oss/fgis.git/blob - man/reclass.1
First checked in version
[oss/fgis.git] / man / reclass.1
1 .TH RECLASS 1 "Version 1.0" "Environmental planning utilities" "EPU User manual".SH NAME
2 reclass1 \- Change classes of given EPPL7 data file
3 .SH SYNOPSIS
4 .B reclass1 [
5 .I-v
6 ] [
7 .I-f 
8 reclass_file] [
9 .I -o
10 output_file] file
11 .SH DESCRIPTION
12 Applies given set of reclass statements to 
13 .B epp
14 file. Reclass statements have simular syntax to DOS version of EPPL7 and
15 may be read from 
16 .I stdin
17 (both from terminal or pipe) and from file.
18 .PP
19 By default, creates file named
20 .I reclass.out.epp
21 in current directory, but this behavoir can be overriden by 
22 .I -o
23 option.
24 .PP
25 This version can perform only
26 .B one-way
27 reclass.
28 For multy-file reclass use
29 .BR intable (1)
30 instead.
31 .PP
32 Output file is created as 16-bit and if after reclass it would contain
33 only classes less than 255, it would be converted into 8-bit.
34 .PP
35 If offsite value of old file appears in right side of any reclass statement,
36 offsite value of new file would be from left side of this statement.
37
38
39
40 .SH OPTIONS
41 .TP 8
42 .B --help
43 \- display brief usage message and exit successifully
44 .TP 8
45 .B --version
46 \- display version information and exit successifully
47 .TP 8
48 .B -v
49 \- verbose. Display number of rows processed during reclass.
50 .TP 8
51 .BR -f " reclass_file"
52 \- read reclass statements from given file, instead of 
53 .B stdin
54 .TP 8
55 .BR -o " output_file"
56 \- write result into given file, instead of 
57 .B reclass.out.epp.
58 Suffix .epp would be substituted, if absent.
59
60 .SH RECLASS STATEMENT SYNTAX
61
62 Set of reclass statements consists of zero or more lines,
63 each of which has following structure:
64 .PP
65 new_class
66 .B =
67 list of old classes
68 .PP
69
70 New class is number in range 0-65535.
71 List of old classes is space separated list of classes (numbers)
72 and ranges. Range is two numbers, separated by colon. First of them
73 must be less then second, or this range would have no effect.
74 .PP
75 If one old class occurs in several statements, only last occurence
76 would take effect, so it is possible to write:
77 .PP
78 1=1:255
79 .PP
80 2=2
81 .PP
82 3=12
83 .PP
84 to reclass all classes between 1 and 255, exept 2 and 12 to 1 and reclass
85 12 to 3.
86
87 .SH "SEE ALSO"
88 .BR eheader (1), cluster (1), rescale (1), outtab (1), intable (1)
89
90 .SH "AUTHOR"
91
92 Victor B. Wagner, SoftWeyr.