1 | .EN |
---|
2 | .TH C4.5 1 |
---|
3 | .SH NAME |
---|
4 | .PP |
---|
5 | consultr \- classify items using a rule set |
---|
6 | .SH SYNOPSIS |
---|
7 | .PP |
---|
8 | .B consultr |
---|
9 | [ \fB-f\fR FNS ] |
---|
10 | [ \fB-t\fR ] |
---|
11 | .SH DESCRIPTION |
---|
12 | .PP |
---|
13 | .I Consultr |
---|
14 | reads a rule set produced by c4.5rules and |
---|
15 | uses this to classify items whose description |
---|
16 | is provided by the user. |
---|
17 | The rule set read is |
---|
18 | .I filestem.rules, |
---|
19 | where |
---|
20 | .I filestem |
---|
21 | is the file name stem (see manual entry for c4.5). |
---|
22 | .PP |
---|
23 | Consultr prompts for the value of an attribute when needed. |
---|
24 | Unknown attribute values are specified as '?'. |
---|
25 | .PP |
---|
26 | If the attribute has discrete values, its value |
---|
27 | can be specified either as |
---|
28 | .ti 8 |
---|
29 | .I v |
---|
30 | .br |
---|
31 | where v is one of the permissible values of the attribute, or as |
---|
32 | .ti 8 |
---|
33 | .I "v1:p1, v2:p2, ... , vn:pn" |
---|
34 | .br |
---|
35 | where the vi's are some or all of the permissible values of the |
---|
36 | attribute and the pi's are corresponding probabilities. |
---|
37 | If the sum of the pi's is less than 1, the remaining probability |
---|
38 | is distributed equally among the unspecified values of the |
---|
39 | attribute. For example, if attribute A has possible values |
---|
40 | X, Y and Z, the reply |
---|
41 | .ti 8 |
---|
42 | X:0.5 |
---|
43 | .br |
---|
44 | is the same as |
---|
45 | .ti 8 |
---|
46 | X:0.5, Y:0.25, Z:0.25 |
---|
47 | .PP |
---|
48 | If the attribute has real values, its value can be |
---|
49 | specified either as |
---|
50 | .ti 8 |
---|
51 | .I r |
---|
52 | .br |
---|
53 | where r is a real number, or as |
---|
54 | .ti 8 |
---|
55 | .I r1 - r2 |
---|
56 | .br |
---|
57 | where r1 and r2 are real numbers. The latter form is |
---|
58 | taken to mean "somewhere in the interval [r1,r2]". |
---|
59 | .PP |
---|
60 | When all relevant attributes have been determined, |
---|
61 | consultr will give a class that the item might |
---|
62 | belong to. The likelihood of the class may be |
---|
63 | indicated by a probability. For example, |
---|
64 | .ti 8 |
---|
65 | .I "C1 CF = 0.9" |
---|
66 | .br |
---|
67 | means "class C1 with probability 0.9". |
---|
68 | .PP |
---|
69 | At the end of each item, consultr will prompt for |
---|
70 | retrial of the same item, a new item, or end of session. |
---|
71 | When retrying an item, the previous values of queried |
---|
72 | attributes are displayed in square brackets. If the |
---|
73 | value is unchanged, reply with a carriage return; |
---|
74 | otherwise, specify the changed value. |
---|
75 | .PP |
---|
76 | Options and their meanings are: |
---|
77 | .PP |
---|
78 | .TP 12 |
---|
79 | .BI \-f filestem\^ |
---|
80 | Specify the filename stem (default |
---|
81 | .B DF) |
---|
82 | .TP |
---|
83 | .B \-t |
---|
84 | Display the rule set at the start of the consulting |
---|
85 | session. |
---|
86 | .SH FILES |
---|
87 | .PP |
---|
88 | .in 8 |
---|
89 | consultr |
---|
90 | .br |
---|
91 | filestem.names |
---|
92 | .br |
---|
93 | filestem.rules |
---|
94 | .in 0 |
---|
95 | .PP |
---|
96 | .SH SEE ALSO |
---|
97 | .PP |
---|
98 | c4.5(1), c4.5rules(1) |
---|
99 | .PP |
---|
100 | .SH BUGS |
---|