diagramme.pl
--help
| --version
diagramme.pl
[ --verbose
| --no_verbose
]
--intlen
INTLEN
--qntprz
QNTPRZ
--viewport
BREITE
xHOEHE
--margin
OBEN
:RECHTS
:UNTEN
:LINKS
--in
IN
--out
OUT
--help
Gibt eine kurze Hilfe aus
--version
Gibt kurze Hinweise zum Programm und die Version aus.
--verbose
Erhöht den Umfang der Meldungen nach STDERR.
--no_verbose
Unterdrückt die Ausgabe von Meldungen. Die Optionen --verbose
und --no_verbose
werden der Reihe nach ausgewertet.
--intlen
INTLEN
INTLEN
ist eine positive Zahl. Der Wertebereich auf der x-Achse (das Interval [xmin, xmax]
) wird in annähernd gleichlange Abschnitte geteilt, deren Länge INTLEN
nicht überschreitet:
Die Anzahl n
der Abschnitte ist die kleinste ganze Zahl, für die xmax - xmin <= n *
. Der erste „Teilungspunkt” bei INTLEN
n
verbleibenden Abschnitten ist xmin
. Ausgehend vom Teilungspunkt x
bei n
verbleibenden Abschnitten ist der nächste Teilungspunkt x + round((xmax - x)/n)
bei n - 1
verbleibenden Abschnitten.
--qntprz
QNTPRZ
QNTPRZ
ist der Prozentsatz der kleinen und der großen Zahlenreihen, durch die eine „untere” und eine „obere” Ausgleichskurve gelegt wird.
Die Zahlenreihen einer Gruppe (Verteilung der „Pinwandzettel”) werden nach den letzten Zahlen der Reihen geordnet.
Ist n
die Anzahl der Zahlenreihen, so sei q
die kleinste ganze Zahl, für die 100 * q >=
. Durch die ersten QNTPRZ
* nq
und die letzten q
Zahlenreihen wird eine Ausgleichskurve gelegt.
--viewport
BREITE
xHOEHE
Die Breite und Höhe der zu erzeugenden Grafik-Ausgaben (Diagramme), s. punktediagramm.rng
, Element size
.
--margin
OBEN
:RECHTS
:UNTEN
:LINKS
Die Größen der Ränder der Diagramme. Der Ausgabebereich in Bild-Koordinaten ergibt sich aus der Größe (s. VIEWPORT
abzüglich der Ränder, s. punktediagramm.rng
, Element scloutrange
.
--in
IN
IN
ist der Pfad der Eingabedatei.
Die Eingabedatei ist eine Textdatei, die zeilenweise gelesen wird. Zeilen, die mit dem Zeichen #
beginnen, sind Kommentare. Andere Zeilen enthalten je eine Zahlenreihe. Die Elemente einer Zeile sind durch Leerzeichen oder Komma oder Folgen dieser Zeichen getrennt. Das erste Element einer Zeile ist der Name einer Gruppe, zu der die Zahlenreihe gehört, die folgenden Elemente sind die Zahlen der Zahlenreihe.
--out
OUT
Das Programm gibt für jede Gruppe von Zahlenreihen eine XML-Datei aus. OUT
enthält den Platzhalter ${key}
. ${key}
wird durch den Namen der Gruppe ersetzt. Das Ergebnis ist der Pfad der Ausgabedatei.
Eine spezielle Version der Datei pinw.js
(Quelltext) kann Informationen zur Verteilung der „Pinwandzettel” ausgeben. Dieses Skript verarbeitet die Ausgabe von pinw.js
(Quelltext) bei der Einstellung pinwinfo=detailed_field_count
. Die aneinandergehängten Ausgaben von pinw.js
(Quelltext) sind in einer Eingabedatei IN
enthalten.
Dieses Skript gibt XML-Dateien aus (XML-Namensraum http://herbaer.de/xmlns/20200803/punktediagramm/
, s. punktediagramm.rng
) aus denen graphische Darstellungen erzeugt werden können (s. pd_svg.xslt
). Es wird vom Skript diagramme
(Quelltext) aufgerufen.
Das Programm ist mit Perl Version 5.24.1 entwickelt. Es benutzt außer Standard-Modulen die folgenden Module:
Herbaer::Ausgleichskurve
, Ausgleichskurve.pm
(Quelltext)Berechnet eine Ausgleichskurve durch eine Menge von Punkten.
Herbaer::Punktediagramm
Punktediagramm.pm
(Quelltext)Erzeugt Daten zur graphischen Darstellung.
Herbaer::Readargs
Die Funktionen read_args
aus diesem Modul verarbeitet die Befehlszeilenargumente, die Funktion print_message_with_values
gibt die Hilfe mit den aktuellen Einstellungen aus.
Herbaer::Replace
Ersetzt Platzhalter in Zeichenketten.