home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD5.iso / workbench / tools / czesc_4 / tclass / docs / tclass.doc < prev   
Encoding:
Text File  |  1992-12-18  |  4.6 KB  |  123 lines
  1.                               DOCUMENT: TCLASS
  2.  
  3. This is the main document for TClass.  Other documents in this directory:
  4.  
  5. AI.doc
  6. Programmer.doc
  7. Installation.doc
  8. showbytes.doc
  9.  
  10.                                   Contents
  11.  
  12.           0.A - What's IN here?
  13.  
  14.           1.A - What is TClass?
  15.           1.B - How is it used?
  16.           1.C - Bugs?
  17.  
  18.           2.A - What kind of software is this?
  19.  
  20. ================================================================================
  21.  
  22. 0.A - What's IN here?
  23.  
  24. This archive should've included:
  25.  
  26. TClass                       The program itself.
  27. TClass.brain                 The brain file.  To be placed in S:.
  28. TClass.changes               List of changes from version to version.
  29. showbytes                    See showbytes.doc.
  30. WARNING.DisplayMe            TOO important to ignore.
  31. Docs/TClass.doc              Documentation for TClass.
  32. Docs/Programmer.doc          Doc for TClass programming and brain structure.
  33. Docs/AI.doc                  Doc on artificial intelligence method used.
  34. Docs/Installation.doc        Installation instructions.
  35. Docs/showbytes.doc           Not too important, but take a look anyway. :)
  36.  
  37. If you didn't get one or more of these files, look around for a better
  38. archive.  If you still can't find all the files, CONTACT ME at the e-mail
  39. address at the bottom of this file.
  40.  
  41. ================================================================================
  42.  
  43. 1.A - What is TClass?
  44.  
  45. TClass is, to put it very generally, is a file identifier.  You can specify a
  46. number of files on the command line, and it will tell you what types of files
  47. they are.  TClass also gives you the option of making it learn new file
  48. types, and storing them in a "brainfile."  Read on for more.  Also, see
  49. Installation.doc for installation instructions.
  50.  
  51. 1.B - How is it used?
  52.  
  53. Usage: TClass <file1> [file2] .... [filen]
  54.  
  55. This usage will take specified files and identify them.  Basic AmigaDOS
  56. wildcards are accepted:
  57.  
  58.   TClass fonts:#?.font scratch:#?
  59.  
  60. Usage: TClass [I=Ignore] [L=Learn] <basefile> <file1> [file2] .... [filen]
  61.  
  62. This usage is for learning new file types.  Note, [] = optional, and
  63. <> = required.  Also note that the 'I(gnore)' and 'L(earn)' switches can be
  64. ANYWHERE on the command line.
  65.  
  66. I=Ignore: "Ignore" switch, activated by either "I" or "Ignore" (case
  67. insensitive).  Usually, while learning, TClass expects files to be at least
  68. 20 bytes, since most identifying bytes are in the first 20.  However, if
  69. you're dealing with files that can be smaller than 20 bytes (*.font files,
  70. for instance), then specify the ignore option and TClass will disregard file
  71. size.
  72.  
  73. L=Learn: "Learn" switch, activated by either "L" or "Learn" on the command
  74. line (again, case-insensitive).  This tells TClass to go into learn mode.  In
  75. learn mode, TClass requires a base file, which is the model, and at least one
  76. other file of the SAME TYPE.  Note, the more files you specify, the more
  77. accurate the learning is.  IT IS UP TO YOU AS THE USER TO MAKE SURE THE
  78. SPECIFIED FILES ARE --OF THE SAME TYPE--!!!  Some examples:
  79.  
  80. Fig1.1  TClass learn fonts:#?.font idiot.info
  81.  
  82. This will definitely make the result incorrect.  You may get a message like
  83. "Files do not match at all" and the results won't be recorded.  But in most
  84. cases, after learning, you'll see this:
  85.  
  86. Filetype learned!  80% accuracy.
  87.  
  88. Of course, the percentage varies, and it is NOT based on the number of files
  89. you specify.  See AI.doc if you'd like to know how TClass compares files.
  90. At any rate, if you mix files as shown in Fig1.1, you'll most likely get a
  91. very low accuracy percentage like 5% or so.
  92.  
  93. After the new file type is learned, its name and bytelist are stored in
  94. S:TClass.brain.  See Programmer.doc for more info on the brainfile structure.
  95.  
  96. 1.C - Bugs?
  97.  
  98. Not that I know of.  There's one misleading thing that I pointed out above,
  99. though.  When you see this:
  100.  
  101. Filetype learned!  95% accuracy.
  102.  
  103. It doesn't mean a whole lot.  You can give TClass 2 files to learn from and
  104. you might get 95% accuracy.  Or you could give it 20 files and get 78%
  105. accuracy.  PLEASE see AI.doc for clarification on this!
  106.  
  107. ================================================================================
  108.  
  109. 2.A - What kind of software is this?
  110.  
  111. Passive ShareWare.  Give this program to anyone at all, BUT YOU MUST
  112. DISTRIBUTE THIS ENTIRE ARCHIVE IN ITS ENTIRETY.  If you use this program,
  113. great!  If you like it, that's great, too.  You don't have to send money, but
  114. I would appreciate it.  $1, $5, $20, it doesn't matter.  The main thing is
  115. that you distribute the complete archive, not just pieces of it.  Thanks.
  116.  
  117.  
  118. TClass 2.9 is Copyright (C) 1992 by Vallen Software.  All rights reserved.
  119.  
  120.   - Sam Hulick
  121.   - shulick@indiana.edu
  122.  
  123.