.TH CD-LEARN 1 "5 September 1991" "Demeter" "Demeter Software"

.SH NAME
cd-learn \- an incremental learning tool from object descriptions to 
class dictionary graph

.SH SYNOPSIS
.B
1. 
.I cd-learn 
obj-input
.br
2. 
.I cd-learn
obj-input cd-input
.br
3. 
.I cd-learn
-or obj-input rename-input
.br
4. 
.I cd-learn
-cr cd-input rename-input
.br
5. 
.I cd-learn
-r obj-input cd-input rename-input


.SH DESCRIPTION 
.I cd-learn
is an incremental learning tool for Demeter System/C++. 
.I cd-learn
takes object descriptions and/or an exist class dictionary
as inputs, and outputs the learned class dictionary graph. 
.I cd-learn 
allows users to rename the classes in the learned class dictionary graph.

.RS 5.0
If only  
.I obj-input 
is specified, 
.I cd-learn 
learns objects to an empty class dictionary.
.RE

.RS 5.0
If both
.I obj-input
and
.I cd-input
are specified, 
.I cd-learn
will learn object from 
.I obj-input
incrementally on the base of
.I cd-input.
.RE

.RS 2.0
-or
.RE
.RS 5.0
If
.I obj-input
and
.I rename-input
are specified,
.I cd-learn
will learn objects from
.I obj-input
to an empty class dictionary and rename the classes according to the rules 
in the
.I rename-input.
.RE

.RS 2.0
-cr
.RE
.RS 5.0
If
.I cd-input
and
.I rename-input
are specified,
.I cd-learn
will only rename the classes in 
.I cd-input
according to the rules in the
.I rename-input.
.RE

.RS 2.0
-r
.RE
.RS 5.0
If
.I obj-input
,
.I cd-input
and
.I rename-input
are all specified,
.I cd-learn
will learn objects from 
.I obj-input
incrementally on the base of
.I cd-input
, and rename the classes according to the rules in the
.I rename-input.
.RE

.SH EXAMPLES

1. If you have following object description:

.RS 5.0
:Simple(
.br
  <numvalue> :Number )
.RE


the learned  class dictionary graph can be as the following:


.RS 5.0
;; Here Is Learned Class Dictionary Graph:
.br
Simple = <numvalue> Number.
.RE

.br


2. If  you want learn the more objects to previous cd,

.RE 5.0

:Compound(
.br
  <op>: Mulsym()
.br
  <arg1> :Simple
.br
  <arg2> :Simple)
.br
,
.br
:Compound(
.br
  <op>: Addsym()
.br
  <arg1> :Simple
.br
  <arg2> :Simple)

.br
.br
.TP
Please notice that object descriptions are seperated by a COMMA.

.br

.br
;; Here Is Learned Class Dictionary Graph:
.br
Simple = < numvalue > Number .
.br
Compound = < op > Compound_op < arg1 > Simple < arg2 > Simple .
.br
Mulsym = .
.br
Compound_op : Addsym | Mulsym .
.br
Addsym = .
.RE



3. Add one more new object to previous cd:

.RS 5.0
:Compound(
.br
  <op> :Mulsym()
.br
  <arg1> :Compound
.br
  <arg2> :Compound)
.RE



The learned cd is:

.RS 5.0
;; Here Is Learned Class Dictionary Graph:
.br
Simple = < numvalue > Number .
.br
Compound = < op > Compound_op < arg1 > Compound_arg1 < arg2 > Compound_arg2 .
.br
Mulsym = .
.br
Compound_op : Addsym | Mulsym .
.br
Addsym = .
.br
Compound_arg1 : Compound | Simple .
.br
Compound_arg2 : Compound | Simple .
.RE


By providing the rename file:

.RS 5.0

*rename*
.br
Compound_op => Op,
.br
Compound_arg1 => Exp,
.br
Compound_arg2 => Exp
.RE


The learned cd will be:

.RS 5.0

;; Here Is Learned Class Dictionary Graph:
.br
Simple = < numvalue > Number .
.br
Compound = < op > Op < arg1 > Exp < arg2 > Exp .
.br
Mulsym = .
.br
Op : Addsym | Mulsym .
.br
Addsym = .
.br
Exp : Compound | Simple .
.RE