*************************************************************************
*                                                                       *
*                 M A T R I X G E N E R A T O R                         *
*                                                                       *
*                            WRITTEN BY                                 *
*                                                                       *
*                         Thomas Reinhardt                              *
*                                                                       *
*                                                                       *
*************************************************************************

Introduction
------------
MatrixGenerator is a program to create a matrixsystem for Shadowrun II.
The rules are taken of Shadowrun V2.01D. Some new rules are taken of
`Germany in the Shadows (?)'. All options could be excluded or
included.

                  ShadowRun - Cyberpunk-Roleplay V2.01D

                         FANTASY  PRODUCTIONS
                               Licence 
                           FASA Corporation

Programoptions
--------------
You can specify options, which influences the program.

possible options are:

-a <Nodes>     Number of nodes in the system, between 5 and 100. if you
               want to get larger systems, you have to create 2 systems
               and connect it by SAN.
-b             Option to include blue nodes. in a blue node you canīt
               find information, datavalue or IC.
-c             Rules of Virtual Reality, the lowest securelevel is the have
               of the maximum and the securecode is two levels below
               the highest, z.B. red-8 -> the lowest ist green-4.
-d             save the internal datastructure. The size is about 6K,
               its the whole info of the system.
-f             put the status into a file
-g             option for `Germany in the Shadows' (?)
               purple and black nodes!
-h             Shadow undes the nodes, looks good!
-i             Maximal number of the information
-l <Sprache>   Other output-language. standard is english.
               implemented : g (german)
-m <Anzahl>    Maximal number of SAN
-n             no money into datastore
-r <Level>     standardlevel for all nodes. they can be one higher
               or one lower.
               Values:    2 - blue            3 - green
                          4 - orange          5 - red
               With option -g :
                          6 - purple          7 - black
-s <Name>      standardpath for all files. 
-t             outputfiles (Text) in LaTeX
-u             special information in datastore always with Scramble-IC
-v             datavalues in datastore protected by an IC
-x             no IC in nodes
-z             randomfunction, values in datastores +/- 10 percent,
               size +/- 5Mp.
-p             use prefsfile MatrixGen.pre
-o <Filename>  load a with option -d save structure of a matrix

The PrefsFile
-------------
NODES          5..100                      option -a
BLUENODES      YES or NO                   YES = option -b
STATUSFILE     YES or NO                   YES = option -f
GERMAN         YES or NO                   YES = option -g
SHADOW         YES or NO                   YES = option -h
IMPORTANT      0..NODES                    option -i
LANGUAGE       ENGLISH or DEUTSCH          option -l
MAXSAN         1..10                       option -m
NOMONEY        YES or NO                   YES = option -n
STANDARDUSE    YES or NO                   YES = option -r
STANDARDLEVEL  2..5(7)                     Parameter of option -r
STANDARDFILE   RAM:Matrix                  option -s
OUTPUT         ASCII or TeX                option -t (TeX)
RANDOM         YES or NO                   YES = option -z
DATAFIELD      YES or NO                   YES = option -d
NOIC           YES or NO                   YES = option -x
ALWAYSIC       YES or NO                   YES = option -u
ALWAYSDS       YES or NO                   YES = option -v
The last entry must be [END], or the program donīt terminate.

Output-Files
------------
*.TeX      Textdescription LaTeX-Format
*.DOC      Textdescription ASCII-Format
*.IFF      Graphic-Format, the number is the number of the special
           types of node, the figure stands for an IC.
*.STAT     StatusFile
*.SRC      Internal datastructure to save a matrixsytem in compressed form

Import-Files
------------
The programm will create a standard file, it is used to create a
description file of the matrixsystem. The standard files
are grouped into:
ASC-*.e    Files Textdescription ASCII-Format, Language English
ASC-*.g    Files Textdescription LaTeX-Format, Language German
TeX-*.e    Files Textdescription ASCII-Format, Language English
TeX-*.g    Files Textdescription LaTeX-Format, Language German
The structure of the files are simply. Codewords are included in [],
end of line are charcterized by \n.

Specialities of the program
---------------------------
While creating the matrixsystem, this option are automatically used:
 - at least one I/O-Port
 - Randomly inserted connections between nodes
 - nodes with rating one didnīt exists (target number >= 2)
 - In blue nodes neither datavalues nor information
 - nodes connected over `big' distance

Requirements
------------
MatrixGen should work on all Amiga machines with all Workbench
and Kickstarts.

tested on Amiga 2000 (GVP 68040) mit HD und 1MB Chip und 8MB Fast
          Amiga 2000 (68000) mit Floppy und 1MB Chip
          Amiga 2000 (68030) mit Floppy und 1MB Chip
          Amiga 500 (68000) mit HD und 512MB Chip, 1MB Chip
          Amiga 500 (68030) mit Floppy, 1MB Chip, 4MB Fast
          Amiga 500 (68030) mit HD, 1MB Chip, 2MB Fast

History
-------
The program was written in C, compiled with GnuC++.

v1.0  Only a graphik was created. Every node has its ratings.

v1.1  Including datastores (informationen and value)

v2.0  new options
      Options: -a, -b, -g, -i, -m, -s, -r, -n, -z

V2.01 more new options
      Options: -h

v2.1  option Prefs-File
      Options: -p, -f

v2.2  Output LaTeX-Format, IC-functs
      Options: -t, -l, -x

v2.3  new dataoptions
      Options: -d, -o, -u, -v

v2.4  correcting small mistakes

Author
------
Thomas Reinhardt
Lehnerzer Str. 31
36039 Fulda-Lehnerz
Tel. (0661)-63945
oder (noch)
LengfelderStr. 29
97078 Wprzburg
Tel. (0931)-28862

Internet : cyber@aruba.informatik.uni-wuerzburg.de
