	     -*- mode: indented-text; fill-column: 72; -*-

Weltkarten Sammlung fuer German Atlantis
Copyright (C) 1997 by Alex Schroeder

email:	alex@zool.unizh.ch
WWW:	http://home.pages.de/~GA

Blurb

These programs are free software; you can redistribute them and/or
modify them under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.

These programs are distributed in the hope that they will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.


Einleitung

Die Programme in dieser Sammlung dienen dazu, Infos aus der normalen
Auswertung von German Atlantis heraus zu knobeln, welche ansonsten nur
mit viel Fleiss erhaeltlich sind.  Zudem sind die Programme gratis und
stehen damit in der loeblichen Tradition von ACHECK und ASUM, welche
beide auch nuetzlich und gratis fuer den German Atlantis Spieler sind.

Die Programme sind vor allem fuer all diejenigen gedacht, welche die
vorhandenen Clients nicht benutzen koennen oder wollen.  Die einzige
Voraussetzung hierzu ist Perl.  Ich selber habe die Programme nur mit
Perl 5.003 unter Linux getestet.  Perl gibt es auch fuer DOS und Windows
auf den Simtel.net mirrors.

Die meisten Programme wurden in zwei Teile aufgeteilt: Das eigentliche
Programm liest eine alte Liste und frischt die Daten anhand neuer
Auswertungen auf.  Die resultierende Liste wird wieder gespeichert.  Ein
zweites Programm liest nur die Liste der Daten und eventuell noetige
Zusatzdateien und produziert anschliessend eine formatierte Version der
Rohdaten.

Die Programme koennen alle mit der Option -h oder --help gestartet
werden, und zeigen dann einen kurzen Hilfstext an.


Kurzbeschreibungen

regionen.pl: 

  Produziert eine Liste aller Regionen, welche in Auswertungen
  aufgefuehrt werden.  Bestehende Listen koennen aufgefrischt werden.
  Die bestehende Regionen Liste muss *vor* den Auswertungen aufgefuehrt
  werden.

  cat regionen.40a 38.rep 42.rep | perl regionen.pl > regionen.41a

fregionen.pl: 

  Gruppiert die Regionen der Liste, welche mit regionen.pl produziert
  werden, nach Inseln und streicht alle Ozean Regionen.  Diese
  formatierte Liste laesst sich leichter lesen.  Die Liste der Inseln,
  welche gebraucht werden kann, besteht aus einzelnen Zeilen mit dem
  Name der Insel und den Koordinaten einer Region dieser Insel.

  Beispiel fuer eine Insel-Datei: 

    Kooat (4,4)
    Hyarmir (3,14)
    Erin (1,22)
    etc...

  cat inseln regionen.41a | perl fregionen.pl > fregionen.41a
		    
karte.pl: 

  Produziert eine ASCII Karte aus einer Liste von Regionen.  Hierfuer
  verwendet man die unformatierte Liste, welche mit regionen.pl erzeugt
  wird, da diese auch Ozean Regionen beinhaltet.

  perl karte.pl < regionen.41a > karte.41a

pskarte.pl:

  Produziert eine LaTeX Datei fuer eine Insel (9x9) aus einer Liste von
  Regionen, die mit regionen.pl erzeugt worden ist.  Hieraus lassen sich
  postscript Karten erzeugen.  Als Parameter muss man die Koordinaten
  der Region angeben, welche in der Ecke links oben liegen soll.
  Hierfuer verwendet man die unformatierte Liste, welche mit regionen.pl
  erzeugt wird, da diese auch Ozean Regionen beinhaltet.

  perl pskarte.pl -k "(0,0)" < regionen.41a > kooat.ltx
  latex kooat.ltx
  dvips kooat.ltx

psgkarte.pl ("PS-grosse-karte"):

  Produziert eine LaTeX Datei fuer vier Inseln (18x18) statt nur fuer
  eine.  Die Regionen werden nicht mehr mit ihrem Namen versehen, um
  Platz zu sparen.  Ansonsten ist psgkarte.pl genau dasselbe wie
  pskarte.pl.

acsas2weltkarte.pl:

  Produziert eine Liste aller Regionen, welche in einer ACSAS
  Exportdatei aufgefuehrt werden.  Diese kann fuer regionen.pl verwendet
  werden.

  perl acsas2weltkarte.pl < EX.TXT > 55.reg

weltkarte2acsas.pl:

  Formatiert ein Liste von Regionen ins ACSAS Export Format.  Die Liste
  der Regionen muss in dem Format vorliegen, welches regionen.pl
  erzeugt.

  perl weltkarte2acsas.pl < 55.reg > EX.TXT

verteilung.pl: 

  Produziert aus Auswertungen eine Liste aller Regionen und aller darin
  lebenden Personen, sowie die Anzahl Bewaffneter, nach Parteien
  geordnet.  Man kann im Moment keine alten Verteilung Listen mit
  einlesen.

  cat 38.rep 42.rep | perl verteilung.pl > verteilung.41a

fverteilung.pl:

  Hiermit kann man die Verteilung Liste, welche mit verteilung.pl
  produziert wird, nach Inseln gruppieren.  Die Liste der Inseln sieht
  so aus wie fuer fregionen.pl beschrieben.

  cat inseln verteilung.41a | perl fverteilung.pl > fverteilung.41a

handel.pl:

  Produziert aus einer Auswertung eine Liste aller Handelsdaten.
  Bestehende Listen koennen aufgefrischt werden; sie muessen *vor* den
  Auswertungen aufgefuehrt werden.

  cat handel.39c 38.rep 42.rep | perl handel.pl > handel.40a

fhandel.pl: 

  Gruppiert die Handelsdaten nach Inseln.  Hierzu wird die Liste
  verwendet, die mit handel.pl erzeugt wird.  Die Insel Liste sieht so
  aus wie fuer fregionen.pl beschrieben.

  cat inseln handel.40a | perl fhandel.pl > fhandel.40a

burgen.pl:

  Sammelt Informationen ueber alle Burgen in einer oder mehreren
  Auswertungen.  Bestehende Listen koennen aufgefrischt werden; sie
  muessen *vor* den Auswertungen aufgefuehrt werden.

  cat burgen.39c 1.nr 5.nr | perl burgen.pl > burgen.40a

fburgen.pl:

  Gruppiert die Burgendaten nach Inseln.  Hierzu wird die Liste
  verwendet, die mit burgen.pl erzeugt wird.  Die Liste der Inseln sieht
  so aus wie fuer fregionen.pl beschrieben.

  cat inseln burgen.40a | perl fburgen.pl > fburgen.40a

schiffe.pl:

  Sammelt Informationen ueber die vorhandenen Schiffe in einer oder
  mehreren Auswertungen.  Bestehende Listen koennen aufgefrischt werden;
  sie muessen *vor* den Auswertungen aufgefuehrt werden.

  cat schiffe-15c report.16 | perl schiffe.pl > schiffe-16a

fschiffe.pl:

  Gruppiert die Schiffsdaten nach Inseln.  Hierzu wird die Liste
  verwendet, die mit schiffe.pl erzeugt wird.  Die Liste der Inseln
  sieht so aus wie fuer fregionen.pl beschrieben.

  cat inseln schiffe.40a | perl fschiffe.pl > fschiffe.40a

gewichte.pl:

  Berechnet das Gewicht von Einheiten.  Alle Einheiten, welche gewaegt
  werden sollen, muessen in eine temporaere Datei kopiert werden.
  Berechnet freie Kapazitaeten von Schiffen oder einzelnen Einheiten.

  perl gewichte.pl < undine.tmp


Anmerkungen:

regionen.pl, handel.pl, burgen.pl und schiffe.pl erlauben es, bestehende
Listen aufzufrischen.  Sowohl die bestehende Liste als auch die
hinzukommenden Auswertungen (falls erwuenscht) werden von stdin gelesen.
Hierbei muessen die Auswertungen nach den alten Listen kommen, weil bei
den Listen Zeile um Zeile, bei den Auswertungen aber Paragraph um
Paragraph gelesen wird.

Das Programm `cat' gibt den Text einer Datei einfach auf den Bildschirm
aus.  Unter DOS macht dies der Befehle `type'.  Unter gewissen
Betriebssystemen kann man den Aufruf von Perl weglassen, wenn die
Programme execute permission bekommen ('chmod 700 *.pl').

Das shell script `extract' versucht die ganze Informationsbeschaffung zu
automatisieren.  Alle Auswertung einer Allianz werden in die Datei
`rohdaten' kopiert, und dann wird `extract <nr>' gestartet.  Die alten
Listen werden als arc/<liste>.<nr> gespeichert.  Die aktuellen Daten
finden sich dann immer in den Dateien daten-*.  Wenn man keine neuen
Daten zu verarbeiten hat, kann man das script `zusammenfassung'
aufrufen, um sich diese aktuellen Daten neu zusammenfassen zu lassen.

Emacs:

Fuer alle Spieler, welche ihre Zuege mit Emacs schreiben, gibt es
atlantis.el -- dies stellt eigene modes fuer die Auswertung, die
Befehle, und die Weltkarte zur Verfuegung.  atlantis.el sollte es am
selben Ort geben, von dem auch dieses aperl Packet stammt.  Emacs gibt
es auf den Simtel.net mirrors auch fuer DOS.

