home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / NEOCOG10.ZIP / MAP.DOC < prev    next >
Text File  |  1994-07-15  |  6KB  |  185 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.           ────────────────────────────────────────────────────────────
  7.  
  8.                                  USER'S  GUIDE
  9.  
  10.                             Make Pattern Version 1.0
  11.  
  12.                     Copyright 1994 (C), Szabolcs Szakacsits
  13.  
  14.                    Jozsef Attila University, Szeged, Hungary
  15.  
  16.                                  July 22, 1994
  17.  
  18.           ────────────────────────────────────────────────────────────
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.    1. INTRODUCTION
  29.    ────────────────
  30.  
  31.           The MAP (Make Pattern) software is a  tool  that  can  be  used
  32.        quickly and easily to construct and manage image patterns. It  was
  33.        created to generate patterns for testing neural  nets.  It  has  a
  34.        graphic user interface and mouse support.
  35.  
  36.           One can edit binary and N x N sized patterns with it, and  then
  37.        these patterns can be saved in a binary or text file.
  38.  
  39.           It is possible, among others things,  to  produce  salt  and/or
  40.        pepper random noises, pattern shifting in the four main directions
  41.        and output values can be set for text file saving.
  42.  
  43.           If one already has one's own text pattern file then  that  file
  44.        can be reconstructed or converted into a binary file which can  be
  45.        used  to   compare   the   performance   of   other   neural   net
  46.        implementations and the NeoC Explorer.
  47.  
  48.  
  49.    2. INSTALLATION
  50.    ────────────────
  51.  
  52.       The minimum system  requirements  to  run  MAP  are  a  286  AT
  53.        compatible computer, VGA video  card,  and  a  mouse.  If  only  a
  54.        monochrome monitor is available, then run MAP with the -m option.
  55.  
  56.  
  57.  
  58.  
  59.                     -  1  -
  60.  
  61.  
  62.  
  63.  
  64.    3. FILE TYPES
  65.    ──────────────
  66.  
  67.       The MAP handles two kind of file types,  one  of  them  is  the
  68.        binary file with extension .ptt, and the other is a text file with
  69.        extension .dat. The NeoC Explorer uses the former while  the  text
  70.        file can be interfaced with the user's own software.
  71.  
  72.           The structure of a  .dat  file  is  very  simple,  and  when  I
  73.        specified it I tried to use the most common structure.  The  first
  74.        line contains the number of patterns and the dimension of the  net
  75.        input (N x N). The other lines include a pattern in every line  as
  76.        a row vector. For example,
  77.  
  78.                                2 9
  79.                                1 0 0 0 1 0 0 0 1
  80.                                0 0 1 0 1 0 1 0 0
  81.  
  82.           The above illustration isn't an isomorphic graphic description,
  83.        however, it can be displayed with the  DIP.EXE  (Display  Pattern)
  84.        program on the standard output just  like  a  file  consisting  of
  85.        two-dimensional patterns.
  86.  
  87.           The active and non active numerical output values  can  be  set
  88.        with the 'Option/Set output values' menu.
  89.  
  90.  
  91.    4. USAGE OF MAP
  92.    ────────────────
  93.  
  94.           The  top  window  (Pattern  Designer)  contains  the   elements
  95.        relevant to pattern-editing, while the bottom one (Pattern  Table)
  96.        collects the set of edited patterns. They  are  connected  in  the
  97.        following way:
  98.  
  99.           The edited pattern which appears  in  the  top  window  may  be
  100.        inserted into the bottom window by using the 'SAVE' button  is  on
  101.        the top window. Using the 'SAVE' button will put the pattern  into
  102.        the current cursor position (red square frame), while the  pattern
  103.        can also be overwritten in that position  by  using  the  'CHANGE'
  104.        button.
  105.  
  106.           If editing a pattern from the Pattern Table  is  desired,  move
  107.        the mouse cursor to the desired pattern and click the  left  mouse
  108.        button. By using the right mouse button one can change the current
  109.        cursor location in the Pattern Table.
  110.  
  111.           The white texts are static and the red ones are dynamic in  the
  112.        Pattern Designer window. The red texts can be given a new value by
  113.        pointing on them and clicking with the left,  or  right,  or  both
  114.        buttons. The left button on the mouse will increase the  value  by
  115.        one, the right button will decrease the value by one, and  pushing
  116.        both at the same time will cause a small window to appear  on  the
  117.        screen. The new value may be written into it.
  118.  
  119.  
  120.  
  121.                     -  2  -
  122.  
  123.  
  124.  
  125.  
  126.       Designing a pattern can also be carried out by using the  mouse
  127.        buttons.
  128.  
  129.       The  other  possibilities  are  self-explanatory  or   can   be
  130.        discovered easily because of the simplicity of the program.
  131.  
  132.  
  133.    5. EPILOG
  134.    ──────────
  135.  
  136.       Please keep in mind that my intention was not to write a  multi
  137.        purpose and many-sided pattern maker  and  handler  program.  This
  138.        program  has  been  written  primarily  for  supporting  the  NeoC
  139.        Explorer, and I later extended it in order to enable  everyone  to
  140.        compare and test the performance of his or her own net and NeoC.
  141.  
  142.           This software is FREEWARE. It  may  be  freely  duplicated  and
  143.        distributed. It was created for education and research purposes.
  144.  
  145.           A few words about the new versions:
  146.  
  147.              ■   running under Windows 3.1 operation system
  148.              ■   pattern categories
  149.              ■   additional pattern and  pattern  file  transformation
  150.                  functions
  151.              ■   new text file outputs
  152.              ■   patterns with size M x N
  153.              ■   cutting out samples from a graphic file ....
  154.  
  155.           If you find MAP useful and  you  are  interested  in  the  next
  156.        versions, then please register it. Your registration will  contain
  157.        MAP and also NeoC. You can do so by sending a small donation to my
  158.        address, and in this way you will support updates  of  production,
  159.        and will receive  the  next  upgrades.  See  the  details  in  the
  160.        REGISTER.TXT file.
  161.  
  162.           If you have any questions, comments or suggestions please  feel
  163.        free to write to me.
  164.  
  165.           ADDRESS:   Szakacsits Szabolcs
  166.                      Kodaly 2. 2. lph.
  167.                      H-8800  Nagykanizsa  
  168.                      HUNGARY
  169.  
  170.           E-MAIL:    jzp0119@huszeg11.bitnet
  171.                      jzp0119@vm.cc.u-szeged.hu
  172.              jzp0119@alfa.cab.jate.u-szeged.hu
  173.  
  174.           FAX:       +36-93-310-311
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.                     -  3  -
  184.  
  185.