                       ******************                 8.12.90
                       * SpiceGraph 0.1 *
                       ******************


                         Christoph Emde
                        Bonfelder Str. 28
                         7105 Leingarten




-----------------------------------------------------------------
Zur Weitergabe:
---------------

Allgemeines:

SpiceGraph,  in  der Version 0.1,  darf zusammen mit  dieser  An-
leitung beliebig kopiert und in unvernderter Form  weitergegeben 
werden.  Der Hinweis auf Author (Urheberechtsvermerk) darf  nicht 
gendert  oder gelscht werden !  Eine Weitergabe gegen ein  Dis-
ketten  und Kopierkosten bersteigendes Entgeld ist nur mit  aus-
drcklicher Genehmigung des Authors zulssig !
 
Auf  der eingelegten Diskette mu sich der Ordner 'SPGR_0_1'  mit 
den Files - SPGR_0_1.PRG  ;  Programm SpiceGraph Version 0.1
          - SPGR_0_1.RSC  ;  RSC-Datei
          - SPGR_0_1.TXT  ;  das File das Sie lesen
befinden.

-----------------------------------------------------------------

Wozu SpiceGraph ?

Fr den Atari ST steht die Version 2G5 des bekannten  Schaltungs-
simulationsprogramm SPICE [1] der Berkeley-University als  Public 
Domain [2] zur Verfgung.
Bei der vorliegenden  Version kann  Ausgabe  entweder  direkt auf 
dem Bildschirm  oder als File  (OUTPUT File-bei mir Endung *.OUT) 
erfolgen.  Da  SPICE sich  mehr auf  die  Rechnungen  als auf die  
Grafik  konzentriert  ist  das  Ergebnis ein  'Sternchenplot' aus 
dem  Terminal-Zeitalter d.h.  die  errechneten  Kurven werden als 
ASCII-File ausgegeben  und  knnen mit  einem  Editor  betrachtet 
werden.

Jedoch:

Mit  SpiceGraph  knnen  Sie nun diese  errechneten  Grafiken  in 
'hochauflsender'   Grafik  betrachten.   SpiceGraph  liest   das 
vorhandene  OUTPUT-File  aus und gibt es auf  dem  Bildschirm  in 
Fenstern aus.

             ! ! ! ! ! ! ! ! Wichtig ! ! ! ! ! ! ! !

Falls  jemand  eine  neue Version,  oder - sehr  wichtig  -  eine 
Version  von SPICE hat,  die den Koprozessor  68881  untersttzt, 
sollte sich an mich wenden.
-----------------------------------------------------------------

Forderungen:

- Das OUTPUT-File darf keine .PLOT Anweisung,  ERROR Meldung  und 
  keine WARNING Meldung beinhalten.
- Das OUTPUT-File darf maximal 2000 Zeilen haben
- Die   AC/DC/Transient-Analysen  drfen   in   x-Achsen-Richtung 
  maximal 1000 Werte haben

-----------------------------------------------------------------
      
Zur Hardware:

Ich   habe  SpiceGraph  mit  der  Konfiguration  Atari  520   STM 
(2.5MB/TOS  1.4),   SM  124,   Diskettenlaufwerk  und  Festplatte 
programmiert  und auf einem Atari 520 ST+ (1MB/TOS 1.0),  SM  124 
und Diskettenlaufwerk getestet und keine Probleme festgestellt.
Die   Bildschirmauflsung  mu  mindestens   640  x  400   Punkte 
betragen - kann aber beliebig gro sein (Ich habe dies zwar nicht 
mit   einem  Grobildschirm  getestet-jedoch  mit  OVERSCAN   [3] 
arbeitet das Programm ohne Probleme).

-----------------------------------------------------------------

Zur Bedienung:
--------------

Allgemeines:

SpiceGraph  kann  sowohl mit der Maus als auch mit  der  Tastatur 
bedient  werden (Innerhalb der Dialogboxen nur mit der  Maus  bis 
auf  'RETURN').  Die Tastaturkrzel stehen in den  entsprechenden 
Menuepunkten.  Ein '^' bedeutet,  da sowohl die  'CONTROL'-Taste 
als  auch  die  entsprechende Taste gedrckt  werden  mu  -  das 
'Schliefeld-Zeichen' (hier im Text:  Schliefeld = *) steht  fr 
'ALTERNATE'.   Fenster  knnen  mit  'CONTROL  ESC'   geschlossen 
werden.

-----------------------------------------------------------------

Nachfolgend werden alle einzelnen Menuepunkte kurz besprochen.

.................................................................
'Atari Zeichen'-'Info           ^I'

- ohne Kommentar -
.................................................................
'Datei'-'OUTPUT File laden      ^L'

Das  OUTPUT  File  wird in den Arbeitsspeicher  geladen  und  auf 
mgliche Fehler berprft.
.................................................................
'Datei'-'Wertepaare sichern     ^W'

Verschiedene  Tabellenkalkulationen mit grafischer  Ausgabe  oder 
Werteplotter knnen Files in der Form

               x1,y11,y12,y13,...,y1n
               x2,y21,y22,y23,...,y2n
                .   .   .   .   .   .
               xm,ym1,ym2,ym3,...,ymn

einlesen  und  weiterverarbeiten.  Um dieses File  abspeichern  zu 
knnen mu das OUTPUT File geladen und ein Fenster geffnet sein.
.................................................................-
'Datei'-'Fenster sichern        ^F'

- noch nicht implementiert -
.................................................................
'Datei'-'Ende                   ^Q'

- ohne Kommentar -
.................................................................
'Fenster'-'Diagramm (AC/DC/TR)  ^D'

Ein  Fenster  wird  geffnet  und  es  wird  die  erste   Analyse 
(AC/DC/Transient-Analyse)  mit maximal 5 Kurven  dargestellt.  Um 
zu  dem  nchsten  Kurvenpaket  zu  gelangen  mssen  die  Tasten 
'ALTERNATE +' bzw. 'ALTERNATE -' gedrckt werden.
.................................................................
'Fenster'-'Tabelle (AC/DC/TR)   *D'

- noch nicht implementiert -
.................................................................
'Fenster'-'Diagramm (Fourier)   ^D'

Ein  Fenster wird geffnet und es wird die erste  Fourier-Analyse 
dargestellt.  Mit  'ALTERNATE  +'  gehts  zur  nchten  bzw.  mit 
'ALTERNATE -' zur vorigen.
.................................................................
'Fenster'-'Tabelle (Fourier)    *D'

Ein   Fenster   wird   geffnet  und   eine   Wertetabelle   wird 
dargestellt.  Mit  'ALTERNATE  +'  gehts  zur  nchten  bzw.  mit 
'ALTERNATE -' zur vorigen.
.................................................................
'Fenster'-'Amp/Phase' und 'Amp/Phase normiert'

Hier  kann  gewhlt  werden,  ob die Werte  der  Fourier  Analyse 
normiert ausgegeben werden.
.................................................................
'Attribute'-'x-Achse            *X'

Raster und 10er Teilung in x-Richtung whlen
.................................................................
'Attribute'-'y-Achse            *Y'

Raster und 10er Teilung in y-Richtung whlen
.................................................................
'Attribute'-'linear             *L'

- noch nicht implementiert -
.................................................................
'Attribute'-'logarithmisch      *G'

- noch nicht implementiert -
.................................................................
'Attribute'-'Farben&Linienart   *?'

- noch nicht implementiert -
.................................................................
'Extras'-'OUTPUT-File Info      *I'

Informationen ber das OUTPUT-File
.................................................................
'Extras'-'Ausgabe Format        *O'

- noch nicht implementiert -
.................................................................
'Extras'-'Texthhe (Tabelle)    *T'

Die  Texthhe bei Tabellen-Darstellung kann zwischen 4,6  und  13 
Punkte Schrift gewhlt werden.
.................................................................
'Extras'-'Uhr/Datum stellen     *U'

- ohne Kommentar -
.................................................................
'Extras'-'Einstellungen sichern...'

- noch nicht implementiert -
.................................................................
'Hilfe'-'...'

- ohne Kommentar -

-----------------------------------------------------------------

Die  vorliegende  Version ist eigentlich nur  eine  Vorabversion. 
Bei  bestimmten  Wertebereichen bei der Ausgabe  der  (AC/DC/TR)-
Analysen  gibt es Probleme,  die schon bald behoben sein  werden. 
Einige Routinen die noch n i c h t implementiert  sind,  arbeiten 
nur  unter entsprechender Bedienung und sind zum Teil  noch  sehr 
Fehleranfllig.  Mit dieser Version (0.1) mchte ich prfen ob es  
berhaupt   genug  User  gibt  die  an  einem  solchen   Programm 
intressiert sind.
Also,  falls  Intresse besteht - einen Brief (mit Briefmarke  fr 
Rckumschlag) an mich senden.

Der Brief sollte enthalten:

- Die Hardware-Konfiguration, auf der SpiceGraph bei Dir arbeitet 
  (wie z.B. Blitter, Grobildschirm, Atari TT, ...)
- Falls Fehler auftraten, wo und wie
- Verbesserungsvorschlge
- Programmierhinweise bzw. Vorschlge
- Kritik
- Die Versionsummer der verwendeten Version

Falls entsprechend Intresse besteht, werde ich neue Versionen 
herausbringen, sowie eine ausfhrliche Anleitung.

Mgliche Erweiterungen:

- Zoom - Herausvergrern von bestimmten Bereichen

- Werte anzeigen - Mit der Maus auf der Kurve entlang fahren

- Export - z.B. als Metafile, HPGL-File, ...

- Farbdarstellung

- Untersttzung des GEM-Klemmbretts

- Anzeige von noch mehr Analysen - Temperatur, Arbeitspunkt, ...

- Ausdruck

-----------------------------------------------------------------

GfA Basic

SpiceGraph   ist  vollkommen  in  GfA-Basic   3.0   programmiert. 
Eigentlich hatte ich vor,  von Anfang an unter GDOS zu  arbeiten, 
um  eine Ausgabegertunabhnige-Ausgabe zu verwenden.  Doch  nach 
einigen Versuchen,  mit z.B.  den Beispielprogrammen aus dem  GfA 
Handbuch Kapitel 10,  verabschiedete sich der Rechner mit  ewigem 
Schweigen.
Darum:  Wer  sich mit der Programmierung unter  GDOS  (Metafiles, 
NC-Koordinatensystem,  ...) auskennt (aber mit GfA Basic), sollte 
sich mit mir in Verbindung setzen.

-----------------------------------------------------------------

[1]  SPICE stammt unter anderem von Professor Donald O. Pederson, 
     University of California, Berkley.

[2]  SPICE 2G5 erschien  beim Duffner PD  Sevice  (Ritterstr.  6, 
     7833  Endingen,  Tel.:  07642/3875 )  auf  der  Diskette Nr. 
     PGS 79

[3]  OVERSCAN  erschien unter dem Titel 'Auer Rand und Band  mit 
     Hyper-Screen'  in der Zeitschrift ST-Magazin  Ausgabe  5/Mai 
     1989   S.16-21  (Idee  von  Stefan  Hartmann   und   Karsten 
     Isakovic)

weiter Literaturhinweise:

     meine Programmierhilfen

     -Atari ST Profibuch / SYBEX Verlag
     -Zeitschriften aus der Reihe der ST-Computer / Heim Verlag
     -GfA Basic 'Frank Ostrowski' / GfA Systemtechnik

zu Spice:

     vom  Springer  Verlag gibt es ein  ausfhrliches  Buch  ber 
     SPICE 2G6

     In  der  ST  Computer 2/89 S.49-51  wird  eine  kommerzielle 
     Version von Spice getestet. 
-----------------------------------------------------------------
