summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pst-bar
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-06-04 16:14:38 +0000
committerKarl Berry <karl@freefriends.org>2010-06-04 16:14:38 +0000
commit986f8648fe327306fe99b55c50d04260c5fb5561 (patch)
treed242fcd438f1bf9f822601fcc1a5def90deb6f76 /Master/texmf-dist/doc/generic/pst-bar
parentccc0daef0963f0cf4278b61475a603872ceefe41 (diff)
pst-bar doc update (3jun10)
git-svn-id: svn://tug.org/texlive/trunk@18734 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/pst-bar')
-rw-r--r--Master/texmf-dist/doc/generic/pst-bar/pst-bar-docDE.pdfbin0 -> 121106 bytes
-rw-r--r--Master/texmf-dist/doc/generic/pst-bar/pst-bar-docDE.tex736
2 files changed, 736 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/pst-bar/pst-bar-docDE.pdf b/Master/texmf-dist/doc/generic/pst-bar/pst-bar-docDE.pdf
new file mode 100644
index 00000000000..80afdd67fc3
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-bar/pst-bar-docDE.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/pst-bar/pst-bar-docDE.tex b/Master/texmf-dist/doc/generic/pst-bar/pst-bar-docDE.tex
new file mode 100644
index 00000000000..d053993e863
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/pst-bar/pst-bar-docDE.tex
@@ -0,0 +1,736 @@
+%% $Id: pst-bar-doc.tex 63 2008-11-26 18:00:46Z herbert $
+%% geaendert am 7.2.09 ch. roemer
+\documentclass[11pt,ngerman,BCOR10mm,DIV12,bibliography=totoc,parskip=false,smallheadings
+ headexclude,footexclude,oneside]{pst-doc}
+\listfiles
+
+\usepackage[T1]{fontenc}
+\usepackage[ansinew]{inputenc}
+\usepackage{babel}
+
+\usepackage{pst-bar}%
+\let\pstBarVersion\fileversion
+\usepackage{booktabs}%
+\usepackage{filecontents}%
+\usepackage{verbatim}%
+\makeatletter
+\def\kernhack#1#2{%
+ \begingroup
+ \setbox\z@\hbox{#1#2}%
+ \dimen@\wd\z@
+ \setbox\z@\hbox{#1{}#2}\advance\dimen@-\wd\z@
+ \ifdim\dimen@=\z@\else\kern\dimen@\fi
+ \endgroup
+}
+\def\switch#1#2{%
+ \begingroup
+ \def\@switch##1#1##2\@nil#1##3\@stop{%
+ \def\reserved@a{##3}%
+ \ifx\reserved@a\@empty#2\else
+ \setbox\z@\hbox{##1#1}%
+ \setbox\tw@\hbox{\kernhack{#1}{##2}\switch{#1}{##2}}%
+ \dimen@\wd\tw@\advance\dimen@\wd\z@%
+ \wd\z@\dimen@%
+ \rlap{\hb@xt@\dimen@{\hfil\unhbox\tw@}}%
+ \box\z@
+ \fi
+ }%
+ \@switch#2\@nil#1\@nil#1\@stop
+ \endgroup
+}
+% Given an e-mail address of the form abc@def.ghi.jkl, reverses it to be jkl
+% ghi. def. abc@
+\def\switchemail#1{\expandafter\@switchemail#1\@stop}
+% Helper function for \switchemail. Note the \copy, because \kernhack will
+% destroy the box otherwise. Need to do some funky stuff because of catcodes.
+\begingroup
+\makeatother
+\def\tmp#1#2#3{%
+ \gdef#1##1@##2#2{%
+ \begingroup
+ \setbox#3\hbox{\switch{.}{##2}}%
+ \switch{@}{##1@\copy#3}%
+ \endgroup
+ }%
+}
+\makeatletter
+\tmp\@switchemail\@stop\@tempboxa
+\endgroup
+\makeatother
+
+\usepackage[T1]{fontenc}%
+
+\begin{filecontents*}{example1.csv}
+ Set 1, Set 2, Set 3
+ 1, 2, 3
+ 1, 2, 3
+\end{filecontents*}
+
+\begin{filecontents*}{example2.csv}
+ Set 1, Set 2, Set 3
+ 1, 2, 3
+ 0.5, 1.5, 1
+\end{filecontents*}
+
+\begin{filecontents*}{example3.csv}
+ Set 1, Set 2, Set 3
+ 1, 2, 3
+ 0.5, 1.5, 1
+ 0.75, 1.6, 0.9
+ 0.9, 2.2, 2.5
+\end{filecontents*}
+
+\begin{filecontents*}{example4.csv}
+ Set 1, Set 2, Set 3
+ 1, 0, 3
+\end{filecontents*}
+
+\begin{filecontents*}{example5.csv}
+ 0, 2, 0
+\end{filecontents*}
+
+\begin{filecontents*}{example6.csv}
+ Set 1, Set 2, Set 3
+ 1.3, 2.5, 0.9
+\end{filecontents*}
+
+\begin{filecontents*}{example7.csv}
+ 0.7, 1.9, 0.4
+ 1.2, 2.7, 1.4
+\end{filecontents*}
+
+\begin{document}
+\title{\texttt{pst-bar}\\ Balken- und Säulendiagramme mit \texttt{pstricks}\\
+ {\small v.\pstBarVersion}}
+\author{Alan Ristow}
+\docauthor{Alan Ristow\\Herbert Vo\ss\\Juliane Horn (\"Ubersetzung)}
+\date{\today}
+\maketitle
+
+ \begin{abstract}
+ Mithilfe von \LPack{pst-bar} kann man \LPack{pstricks} verwenden, um Balkendiagramme
+ direkt aus einer Daten-Datei zu erzeugen. Dieses Paket befindet sich allerdings noch im
+ Beta-Stadium -- die üblichen Warnungen bezüglich Beta-Software treffen
+ daher zu. Es wird zusätzliche Merkmale und verbesserte Dokumentationen (den Inhalt
+ sowie die Ausstattung betreffend) geben, wenn sich der Code stabilisiert.
+ \end{abstract}
+
+\section{Einführung}
+ Aufgrund der Leistung und Flexibilität von \LPack{pstricks} [1] ist es möglich, mit
+ \LPack{pst-bar} Balkendiagramme zu erstellen, deren Einzelheiten in einer
+ mit Komma abgetrennten Datei gespeichert sind.
+ Es gibt mehrere Lösungen, um Säulendiagramme in \TeX\ und \LaTeX\ -
+ Dokumenten zu "`zeichnen"'.
+ Die offensichtliche Lösung ist, ein externes Programm wie \Index{gnuplot}
+ oder \Index{Matlab} zu verwenden, das Balkendiagramme in einem Format speichert, welches
+ direkt von \TeX\ oder \LaTeX\ gelesen werden kann. Diese Methode hat den Nachteil, dass
+ zusätzlicher Aufwand nötig ist, um den Diagrammen ein einheitliches Erscheinungsbild zu
+ geben, welches zu anderen Grafiken im Dokument passt. In vielen Fällen kann der Diagrammtext
+ von \LaTeX\ mithilfe der Pakete \LPack{psfrag} oder \verb|psfragx| eingefügt werden
+ (das Matlab-Programm \Index{LaPrint} kann diesen Prozess bei Matlab-Diagrammen
+ beschleunigen, da es speziell für diesen Zweck entwickelt wurde [2]). Jedoch schreiben
+ einige Programme die Textelemente in EPS (Encapsulated Postscript)-Dateien, sodass die
+ Optionen von \LPack{psfrag} nicht funktionieren.
+
+Balkendiagramme können aber auch mit den eingebauten Zeichenwerkzeugen in
+\TeX\ und \LaTeX\ gezeichnet werden. Dafür wird das \LPack{histogr} Paket [3] verwendet,
+welches neben Histogrammen auch sehr einfache Balkendiagramme erstellen kann. Es scheint eine
+Annäherung an das \LPack{bar} Paket [4] für \LaTeX\ 2.09 zu sein, da es eine neue Umgebung
+für das Zeichnen von Säulendiagrammen definiert. Allerdings sind die eingebauten
+Zeichenwerkzeuge begrenzt und die Arbeit am \LPack{bar} Paket wurde wohl nach 1994 beendet.
+
+Es wurden technisch verfeinerte Zeichenwerkzeuge für \TeX\ und
+\LaTeX\ entwickelt; die bekanntesten sind \verb|eepic|, \verb|texdraw| und \verb|latexdraw|,
+\verb|LaTeXPiX|, MetaPost, \LPack{mfpic}, und \LPack{pstricks}. Mit jedem dieser Mittel
+können Balkendiagramme gesetzt werden; jedoch besitzt keines eine eingebaute Unterstützung
+für diese, sodass die Diagramme mit der "`Brachialgewalt"'--Methode angefertigt werden
+müssen, das
+bedeutet ein manuelles Einzeichnen von Kästen, welche die Balken im Diagramm
+darstellen. Je nach Werkzeug kann es sein, dass auch die Achsen manuell eingezeichnet
+werden müssen. Das \LPack{pst-bar} Paket soll den Prozess des Zeichnens von Balken- und
+Säulendiagrammen unter Verwendung von \LPack{pstricks} automatisieren.
+
+Derzeit gibt es zwei Möglichkeiten für die Erstellung von Balkendiagrammen mit
+\verb|pstricks|. Die Erste ist die oben genannte Brachialgewalt-Methode, bei der eine Reihe
+von
+\Lcs{psframe}s mit passenden Höhen, Breiten und Farben gezeichnet werden, um zum gewünschten
+Ergebnis zu gelangen [5]. Zwar ist diese Möglichkeit vortrefflich und bietet den größten
+Spielraum, allerdings ist sie mühsam und arbeitsintensiv. Die zweite Option ist das
+\LPack{bardiag} Paket; es automatisiert im Wesentlichen [6] die Vorgehensweise mit brachialer
+Gewalt im.
+Dieser Ansatz ist wirkungsvoll, jedoch benötigt \LPack{bardiag} zahlreiche externe Pakete.
+Weiterhin verwendet es \LaTeX\ , um mathematische Befehle durchzuführen und es ist nicht
+kompatibel mit dem normalen \TeX.
+
+Durch \LPack{pst-bar} werden diese Probleme vermieden. Es beruft sich ausschließlich auf
+Pakete der \verb|pstricks|-Familie, stellt umfassende Anpassungsfunktionen zur Verfügung,
+baut auf Postscript für fast alle mathematischen Operationen und sollte mit dem einfachen
+\TeX\ kompatibel sein (bisher ungetestet). Damit Balkendiagramme angefertigt und beschriftet
+werden können, benutzt \verb|pst-bar| Befehle, um die Angaben der durch Komma
+abgegrenzten Datei zu lesen. Vielfache Datenreihen können dabei entweder gesammelt oder
+gestapelt grafisch dargestellt werden; die Balken können horizontal oder vertikal
+eingezeichnet werden. Eine zusätzliche Option ermöglicht es, Blockdiagramme zu erzeugen,
+welche die Unterschiede zwischen den nachfolgenden Reihen von Daten in der Datendatei zeigen
+(siehe auch Kapitel ~\ref{sec:block}).
+
+Zu diesem Zeitpunkt sollte \verb|pst-bar| noch als Beta-Software betrachtet werden. Es wird
+nicht garantiert, dass die Änderungen am Code, welche zwischen dieser Ausgabe und der ersten
+dauerhaften Ausgabe auftreten, auch rückwärts kompatibel sind.
+
+\section{Erstellen von Balken- und Säulendiagrammen}
+Das Zeichnen von Balkendiagrammen mit \verb|pst-bar| erfolgt in drei Schritten:
+(i) Lesen der Datendatei, (ii) Zeichnen der Balken und (iii) Einzeichnen der Achsen. Die
+ersten beiden Schritte erfolgen direkt durch \verb|pst-bar|. Für den dritten ist das
+\LPack{pst-plot} Paket notwendig, das fester Bestandteil von \verb|pstricks| ist.
+
+Die folgenden Abschnitte befassen sich mit dem Format der Datendatei, mit dem Laden von Daten
+aus der Datei und mit dem Erstellen eines Balkendiagramms mithilfe dieser Daten.
+
+\subsection{Format der Datendatei}
+Die Datei mit den Daten muss durch Komma begrenzt sein und jede Reihe muss die gleiche Anzahl
+an Einträgen enthalten. Eine Kopfzeile ist erlaubt, aber kein Eintrag in dieser Zeile darf
+Kommas oder \Lcs{par} Befehle beinhalten (gilt ebenso für \verb|\\|). Eine der Dateien,
+welche für diese Dokumentation benutzt werden, sieht so aus: \verbatiminput{example1.csv}%
+In diesem Fall sind \verb|Set 1|, \verb|Set 2|, und \verb|Set 3| die Kopfzeilen. Die
+nachfolgenden Reihen, später als \emph{data rows} gekennzeichnet, umfassen die Daten, die mit
+den Überschriften verknüpft werden. Die Datei wird in einem säulenähnlichen Stil angeordnet,
+sodass man mit \verb|Set 1| die Daten \verb|1| und \verb|1| verbindet, mit \verb|Set 2| die
+Daten \verb|2| und \verb|2| und so weiter. Zuerst werden die Daten grafisch dargestellt und
+anschließend mit dem Text der Kopfzeile beschriftet.
+
+\emph{Achtung!} Es gibt zwei sehr wichtige Bedingungen für die Daten innerhalb der Datei:
+\begin{itemize}
+ \item Alle Daten außerhalb der Kopfzeile müssen numerisch sein. Falls keine Kopfzeile
+ vorhanden ist, müssen alle Daten der Datei numerisch sein.
+ \item Jede Zeile muss dieselbe Anzahl von Einträgen haben.
+\end{itemize}
+Werden diese Bedingungen nicht eingehalten, können Postscript-Fehler oder (seltener) falsch
+beschriftete oder gezeichnete Balkendiagramme die Folge sein.
+
+Wie diese Dateien grafisch dargestellt werden, hängt von der Art des gewünschten Diagramms
+ab. Siehe dazu Kapitel ~\ref{sec:cluster} -- \ref{sec:block} und die Beispiele in
+Kapitel~\ref{sec:examples}.
+
+\subsection{Lesen der Datendatei}
+Der Befehl \verb|\readpsbardata| liest die Datei:
+\begin{verbatim}
+ \readpsbardata[<options>]{<data>}{<filename>}
+\end{verbatim}
+Geben Sie für die Daten einen Makro-Namen an, den Sie noch nicht benutzen.
+
+Die verfügbaren Optionen sind:
+\begin{center}
+\begin{tabular}{ll}
+\toprule
+Parameter & Definition\\
+\midrule
+\Lkeyword{header} & \verb|true|, wenn die erste Zeile der Datei eine Kopfzeile ist\\
+ & \verb|false|, wenn \verb|true| nicht zutrifft\\
+ & Standard: \verb|true|\\
+\bottomrule
+\end{tabular}
+\end{center}
+
+Setzt man \verb|header| auf \verb|false|, so geht \verb|pst-bar| davon aus, dass kein
+header (Kopfzeile) existiert und die erste Zeile wird als Daten-Zeile angesehen.
+
+\subsection{Einzeichnen der Balken}
+\label{sec:drawing_bars}%
+Der Befehl \verb|\psbarchart| zeichnet die Balken für das Diagramm.
+\begin{verbatim}
+ \psbarchart[<options>]{<data>}
+\end{verbatim}
+Für \verb|<data>| verwenden Sie bitte den Makro-Namen, den Sie bei \Lcs{readpsbardata}
+ausgewählt hatten.
+Die Säulen werden in Spalten eingeteilt, die eine \Lcs{psxunit} breit sind. Die Anzahl der
+Säulen in einer Spalte entspricht dabei der Zahl der Datenreihen in einer Datei. Die
+Unterseite jeder Spalte wird mit den Überschriften (header) der Datei beschriftet, wenn man
+bei \Lcs{readpsbardata} für \Lkeyword{header} \verb|true| angegeben hat. Allerdings
+wird nur die Balken- und Säulenbeschriftung erstellt -- der Rahmen und die Achsen müssen extra
+bestimmt werden.
+
+Die verfügbaren Optionen sind:
+\begin{center}
+\begin{tabular}{ll}
+\toprule
+Parameter & Definition\\
+\midrule
+\Lkeyword{chartstyle} & \Lkeyval{cluster} erzeugt eine Gruppe von Balken\\
+ & \Lkeyval{stack} sammelt die Gruppen in einer Einzelspalte\\
+ & \Lkeyval{block} erstellt einen schwebenden Balken (Minimum ist nicht 0)\\
+ & Standard: \Lkeyval{cluster}\\
+ \Lkeyword{barstyle} & Name(n) des Balken-Stils für jeden Balken\\
+ & Standard: \verb|{black,darkgray,gray,lightgray,white,red,green,blue}|\\
+ \Lkeyword{barcolsep} & beeinflusst den Zwischenraum zwischen den Spalten\\
+ & Standard: \verb|0.4|\\
+ \Lkeyword{barsep} & beeinflusst den Zwischenraum zwischen den Balken \\
+ & (\Lkeyval{cluster} und \Lkeyval{block} Diagramme)\\
+ & Standard: \verb|0.0|\\
+ \Lkeyword{barlabelrot} & Drehwinkel der Spaltenbeschriftung\\
+ & Standard: \verb|0|\\
+ \Lkeyword{orientation} & \Lkeyval{vertical} für vertikal gezeichnete Balken\\
+ & \Lkeyval{horizontal} für horizontal gezeichnete Balken\\
+ & Standard: \Lkeyval{vertical}\\
+\bottomrule%
+\end{tabular}
+\end{center}
+
+Die Anzahl der angegebenen \verb|barstyle|s muss der Anzahl von Balken in jeder Spalte
+entsprechen oder größer als diese sein. Andernfalls entsteht ein Postcript-Fehler. Bei den
+\Lkeyval{cluster} und \Lkeyval{stack} \verb|chartstyle|s entspricht dies den Datenreihen in
+der Datei; beim \Lkeyval{block} \verb|chartstyle| entspricht es der halben Anzahl
+der Datenreihen. Außerdem ist bei der Angabe der \verb|barstyle|s darauf zu achten, dass die
+Stile in geschweiften Klammern angegeben werden, wie z.\,B.:
+\begin{BDef}
+\Lcs{psbarchart}\OptArgs\Largb{\ldots}
+\end{BDef}
+
+Die verfügbaren \Lkeyword{barstyle}s sind standardmäßig \Lkeyval{red}, \Lkeyval{green},
+\Lkeyval{blue}, \Lkeyval{black}, \Lkeyval{white}, \Lkeyval{gray}, \Lkeyval{lightgray},
+und \Lkeyval{darkgray}. Jeder davon erzeugt einen Balken in der angegebenen Farbe mit
+rechtwinkligen Ecken und schwarzem Umriss. Mit dem Befehl \Lcs{newpsbarstyle} können
+zusätzlich neue \Lkeyword{barstyle}s definiert werden, siehe dazu
+Kapitel ~\ref{sec:customizing}.
+
+Abbildung ~\ref{fig:bar_layout} zeigt, wie \Lcs{psbarchart} die Balken im
+Standard-\Lkeyword{chartstyle}, \Lkeyval{cluster}, anlegt. Beim \Lkeyval{stack}
+\Lkeyword{chartstyle} wird die \Lkeyword{barsep} Option nicht berücksichtigt.
+
+\begin{figure}[t]
+ \centering%
+ \begin{pspicture}(0,0)(4in,2in)%
+ \psframe[linestyle=dashed](0,0)(4in,2in)%
+ \psframe[linestyle=none,fillstyle=hlines,hatchangle=45,%
+ hatchcolor=lightgray,hatchwidth=0.4pt,hatchsep=8pt](0,0)(1in,2in)%
+ \psframe[fillcolor=darkgray,fillstyle=solid](0.2in,0in)(0.45in,0.8in)%
+ \psframe[fillcolor=lightgray,fillstyle=solid](0.55in,0in)(0.8in,1.1in)%
+ \psline[linestyle=dotted](1in,0in)(1in,2in)%
+ \psframe[fillcolor=darkgray,fillstyle=solid](1.2in,0in)(1.45in,0.6in)%
+ \psframe[fillcolor=lightgray,fillstyle=solid](1.55in,0in)(1.8in,0.4in)%
+ \psline[linestyle=dotted](2in,0in)(2in,2in)%
+ \psframe[fillcolor=darkgray,fillstyle=solid](2.2in,0in)(2.45in,0.4in)%
+ \psframe[fillcolor=lightgray,fillstyle=solid](2.55in,0in)(2.8in,0.3in)%
+ \psline[linestyle=dotted](3in,0in)(3in,2in)%
+ \psframe[fillcolor=darkgray,fillstyle=solid](3.2in,0in)(3.45in,1.1in)%
+ \psframe[fillcolor=lightgray,fillstyle=solid](3.55in,0in)(3.8in,0.9in)%
+ \rput[b](0.5in,1.8in){\small$\mathtt{\backslash psxunit}$}%
+ \psline{->}(0.2in,1.87in)(0in,1.87in)%
+ \psline{->}(0.8in,1.87in)(1in,1.87in)%
+ \psline(0.45in,0.85in)(0.45in,1.3in)%
+ \psline(0.55in,1.15in)(0.55in,1.3in)%
+ \rput[l](0.8in,1.25in){\small$\mathtt{barsep} \times
+ \mathtt{\backslash psxunit}$}%
+ \psline{->}(0.75in,1.25in)(0.55in,1.25in)%
+ \psline{->}(0.25in,1.25in)(0.45in,1.25in)%
+ \psline{->}(0.6in,0.9in)(0.8in,0.9in)%
+ \psline{->}(1.2in,0.9in)(1in,0.9in)%
+ \rput[l](1.25in,0.9in){\small$0.5 \times \mathtt{barcolsep} \times
+ \mathtt{\backslash psxunit}$}%
+ \end{pspicture}
+ \caption{\label{fig:bar_layout}%
+Schematische Darstellung für das Layout des Balkendiagramms. Die schraffierte Fläche markiert
+den Bereich, in dem die Daten der ersten Spalte der Datei dargestellt sind. Die Breite der
+Balken entspricht $[(1 - \mathtt{barsep} - 0.5 \times \mathtt{barcolsep}) \times
+\mathtt{\backslash psxunit}] / N$, wobei $N$ für die Anzahl der Balken in einer Spalte
+steht.}%
+\end{figure}
+
+\subsection{Anpassung des Diagramms}\label{sec:customizing}%
+Um einen angefertigten Balkentyp hinzuzufügen, ist der Befehl \Lcs{newpsbarstyle} zu
+verwenden:
+\begin{BDef}
+\Lcs{newpsbarstyle}\Largb{<name>}\Largb{<definition>}
+\end{BDef}
+Diese Bezeichnung ist eine Textfolge, die derzeitig von keinem anderen \Lkeyword{barstyle}
+verwendet wird. Die Definition kann sich aus jedem \LPack{pstricks} Schlüssel bzw. aus jeder
+Gruppe von Schlüsseln ergeben, die mit \Lcs{psframe} anwendbar sind. Zum Beispiel wird
+\Lkeyval{red} \Lkeyword{barstyle} wie folgt definiert:
+\begin{BDef}
+\Lcs{newpsbarstyle}\Largb{red}\Largb{\Lkeyset{fillcolor=red},\Lkeyset{fillstyle=solid},
+\Lkeyword{framearc}=0}
+\end{BDef}
+
+Um den Typ, mit dem die Spaltenbezeichnungen festgelegt werden, anzupassen, wird
+\Lcs{psbarlabel} neu definiert. Wenn die Beschriftung aus kleinen Kursivbuchstaben bestehen
+soll, sieht diese so aus:
+\begin{BDef}
+\LcsStar{renewcommand}\Lcs{psbarlabel}\Largb{\small\itshape}
+\end{BDef}
+Üblicherweise erstellt \Lcs{psbarlabel} die Spaltenbeschriftung in der aktuellen Schriftart.
+
+Um den Abstand zwischen den Säulen und der Spaltenbeschriftung zu regulieren, wird
+\Lcs{psbarlabelsep} neu definiert. Dabei ist es als Befehl, nicht als Umfang, definiert und
+muss daher mit \Lcs{renewcommand*} wiederdefiniert werden. Als Standard benutzt man \verb|0pt|.
+
+Am Ende ist es möglich, die Daten der Datei mit \Lcs{psbarscale} anzupassen und zu
+manipulieren, wie z.\,B.
+\begin{BDef}
+\Lcs{psbarscale}\Largr{<scale>}\Largb{<Postscript code>}
+\end{BDef}
+welches von Herbert Vo\ss' \verb|\pstScale| aus \LPack{pstricks-add} beeinflusst wurde [7].
+Die Daten werden durch den Wert in Klammern eingestuft und können im Weiteren mit dem
+Postscript Code gesteuert werden. Für den Fall, dass man den Logarithmus der eingegebenen
+Daten grafisch darstellen will, würde man \Lcs{psbarscale}\Largr{1}\Largb{log} benutzen.
+Der Postscript Code bezieht sich auf die Daten vor der Skalierung.
+
+\section{Die Arten von Diagrammen}
+Wie bereits in ~\ref{sec:drawing_bars} beschrieben, gibt es drei verschiedene Möglichkeiten
+für den Parameter \Lkeyword{chartstyle}. Der Standard-Typ \Lkeyval{cluster} ist ein
+allgemeines Balkendiagramm, bei dem die Balken aufgrund ähnlicher Daten gruppiert werden. Die
+zweite Option, \Lkeyval{stack}, zeichnet eine Reihe von Säulen aufeinander gestapelt, statt
+sie nebeneinander in einer Gruppe anzuordnen. Benutzt man \Lkeyval{block}, die dritte
+Alternative, so werden angehäufte Balken zwischen zwei Datenpunkten eingezeichnet und somit
+eine Spanne von Werten anstelle eines einzelnen Wertes veranschaulicht.
+
+Die folgenden Abschnitte beschreiben jeden \Lkeyword{chartstyle} im Detail und erklären, wie
+die Eingabedaten verwendet werden. Zusätzlich werden für jeden Fall Muster
+gezeigt. Im Kapitel ~\ref{sec:examples} sind vollständige Beispiele einschließlich der Achsen
+aufgezeigt.
+
+\subsection{\texttt{cluster}}\label{sec:cluster}%
+In einem \Lkeyval{cluster} Diagramm wird jede Variable in einer Reihe, die durch Kommas
+getrennt ist, als ein Balken in einer einzelnen Spalte dargestellt. Jede Reihe steht daher
+für eine neue Balkeneinheit. Die Datei
+\verbatiminput{example1.csv}%
+erzeugt nachstehendes Diagramm:
+
+ \hfill%
+ \begin{minipage}[b]{1.5in}%
+ \psset{unit=0.5in}%
+ \begin{pspicture}(0,-0.5)(3,3)%
+ \readpsbardata{\data}{example1.csv}%
+ \psbarchart[barstyle={red,blue}]{\data}%
+ \end{pspicture}
+ \end{minipage}%
+ \hfill%
+ \begin{minipage}[b][1.75in][c]{3.5in}%
+ \begin{verbatim}
+\psset{unit=0.5in}%
+\begin{pspicture}(0,-0.5)(3,3)%
+ \readpsbardata{\data}{example1.csv}%
+ \psbarchart[barstyle={red,blue}]{\data}%
+\end{pspicture}\end{verbatim}
+ \end{minipage}%
+ \hfill%
+
+\subsection{\texttt{stack}}
+Bei einem \Lkeyval{stack} Diagramm befindet sich in jeder Spalte lediglich ein Balken. Dieser
+eine Balken besteht aus so vielen Abschnitten, wie die Datendatei Reihen hat. Jede Reihe wird
+auf die Oberkante der Vorigen "`gestapelt"'. Die Datei
+\verbatiminput{example2.csv}%
+erzeugt folgendes Diagramm:\\
+\vspace*{.5cm}\\
+ \hfill%
+ \begin{minipage}[b]{1.5in}%
+ \psset{unit=0.5in}%
+ \begin{pspicture}(0,-0.5)(3,4)%
+ \readpsbardata{\data}{example2.csv}%
+ \psbarchart[barstyle={red,blue},chartstyle=stack]{\data}%
+ \end{pspicture}
+ \end{minipage}
+ \hfill%
+ \begin{minipage}[b][2.25in][c]{3.5in}%
+ \begin{verbatim}
+\psset{unit=0.5in}%
+\begin{pspicture}(0,-0.5)(3,4)%
+ \readpsbardata{\data}{example2.csv}%
+ \psbarchart[barstyle={red,blue},%
+ chartstyle=stack]{\data}%
+\end{pspicture}\end{verbatim}
+ \end{minipage}
+ \hfill%
+
+Beachten Sie, dass diese Säulen hier breiter sind als bei
+\Lkeyset{chartstyle=cluster}, da sie bei \Lkeyval{stack} vertikal aufeinander gestapelt
+werden, bei \Lkeyval{cluster} allerdings horizontal nebeneinander auf der x-Achse angeordnet
+sind. Um eine ähnliche Balkenbreite wie im \Lkeyval{cluster} - Diagramm zu erhalten, stellt
+man \Lkeyword{xunit}\verb|=0.25in| ein.
+
+\subsection{\texttt{block}}\label{sec:block}%
+In einem \verb|block| Diagramm kann an jedem Balken eine Reihe von Werten abgelesen werden.
+Daher benötigt jede Säule zwei Datenlinien aus der Datei, eine für die Markierung der oberen
+und eine für die Markierung der unteren Grenze. Gibt es mehrere Paare von Datenlinien, werden
+sie gesammelt dargestellt. Existiert eine ungerade Anzahl von Datenreihen, so wird die letzte
+nicht beachtet.
+\vspace*{.5cm}
+
+Aus: \verbatiminput{example3.csv}%
+entsteht dieses Diagramm:
+
+ \hfill%
+ \begin{minipage}[b]{1.5in}%
+ \psset{unit=0.5in}%
+ \begin{pspicture}(0,-0.5)(3,3.5)%
+ \readpsbardata{\data}{example3.csv}%
+ \psbarchart[barstyle={red,blue},chartstyle=block]{\data}%
+ \end{pspicture}
+ \end{minipage}%
+ \hfill%
+ \begin{minipage}[b][1.5in][c]{3.5in}%
+ \begin{verbatim}
+\psset{unit=0.5in}%
+\begin{pspicture}(0,-0.5)(3,3.5)%
+ \readpsbardata{\data}{example3.csv}%
+ \psbarchart[barstyle={red,blue},%
+ chartstyle=block]{\data}%
+\end{pspicture}\end{verbatim}
+ \end{minipage}
+
+\section{Beispiele}\label{sec:examples}%
+Grundlegende Beispiele für jeden Typ einschließlich Achsen und Gitternetzlinien:
+
+ \begin{verbatim}
+\begin{filecontents*}{example2.csv}
+ Set 1, Set 2, Set 3
+ 1, 2, 3
+ 0.5, 1.5, 1
+\end{filecontents*}\end{verbatim}
+
+ \hfill%
+ \begin{minipage}[b]{1.5in}%
+ \psset{unit=0.5in}%
+ \begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example2.csv}%
+ \psbarchart[barstyle={red,blue}]{\data}%
+ \end{pspicture}
+ \end{minipage}%
+ \hfill%
+ \begin{minipage}[b][2.25in][c]{3.5in}%
+ \begin{verbatim}
+\psset{unit=0.5in}%
+\begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,%
+ subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,%
+ ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example2.csv}%
+ \psbarchart[barstyle={red,blue}]{\data}%
+\end{pspicture}\end{verbatim}
+ \end{minipage}
+
+ \hfill%
+ \begin{minipage}[b]{1.5in}%
+ \psset{unit=0.5in}%
+ \begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example2.csv}%
+ \psbarchart[barstyle={red,blue},chartstyle=stack]{\data}%
+ \end{pspicture}
+ \end{minipage}%
+ \hfill%
+ \begin{minipage}[b][2.25in][c]{3.5in}%
+ \begin{verbatim}
+\psset{unit=0.5in}%
+\begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,%
+ subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,%
+ ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example2.csv}%
+ \psbarchart[barstyle={red,blue},%
+ chartstyle=stack]{\data}%
+\end{pspicture}\end{verbatim}
+ \end{minipage}
+
+ \hfill%
+ \begin{minipage}[b]{1.5in}%
+ \psset{unit=0.5in}%
+ \begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example2.csv}%
+ \psbarchart[barstyle={red,blue},chartstyle=block]{\data}%
+ \end{pspicture}
+ \end{minipage}%
+ \hfill%
+ \begin{minipage}[b][2.25in][c]{3.5in}%
+ \begin{verbatim}
+\psset{unit=0.5in}%
+\begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,%
+ subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,%
+ ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example2.csv}%
+ \psbarchart[barstyle={red,blue},%
+ chartstyle=block]{\data}%
+\end{pspicture}\end{verbatim}
+ \end{minipage}
+
+Verwendung von \verb|\newpsbarstyle|:
+
+ \hfill%
+ \begin{minipage}[b]{1.5in}%
+ \psset{unit=0.5in}%
+ \newpsbarstyle{yellowhatch}{framearc=0.5,fillstyle=hlines*,rot=45,fillcolor=yellow}%
+ \newpsbarstyle{redoutline}{framearc=0.5,fillcolor=black,linecolor=red,linewidth=1.5pt}%
+ \begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example2.csv}%
+ \psbarchart[barstyle={yellowhatch,redoutline}]{\data}%
+ \end{pspicture}
+ \end{minipage}%
+ \hfill%
+ \begin{minipage}[b][2.75in][c]{3.5in}%
+ \begin{verbatim}
+\psset{unit=0.5in}%
+\newpsbarstyle{yellowhatch}{framearc=0.5,%
+ fillstyle=hlines*,rot=45,fillcolor=yellow}%
+\newpsbarstyle{redoutline}{framearc=0.5,%
+ fillcolor=black,linecolor=red,%
+ linewidth=1.5pt}%
+\begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,%
+ subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,%
+ ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example2.csv}%
+ \psbarchart[barstyle={yellowhatch,%
+ redoutline}]{\data}%
+\end{pspicture}\end{verbatim}
+ \end{minipage}
+
+\vspace*{2cm}
+
+Verwendung von \verb|[orientation=horizontal]|:\\
+
+ \hfill%
+ \begin{minipage}[b]{2in}%
+ \psset{unit=0.5in}%
+ \newpsbarstyle{yellowhatch}{framearc=0.5,fillstyle=hlines*,rot=45,fillcolor=yellow}%
+ \newpsbarstyle{redoutline}{framearc=0.5,fillcolor=black,linecolor=red,linewidth=1.5pt}%
+ \begin{pspicture}(0,-0.5)(4,3.5)%
+ \psgrid[yunit=1.5in,gridlabels=0,subgriddiv=0,griddots=30](0,0)(3,1)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=x,ticks=x](0,0)(3,3)%
+ \readpsbardata{\data}{example2.csv}%
+ \psbarchart[barstyle={yellowhatch,redoutline},orientation=horizontal]{\data}%
+ \end{pspicture}
+ \end{minipage}%
+ \hfill%
+ \begin{minipage}[b][2.75in][c]{3.5in}%
+ \begin{verbatim}
+\psset{unit=0.5in}%
+\newpsbarstyle{yellowhatch}{framearc=0.5,%
+ fillstyle=hlines*,rot=45,fillcolor=yellow}%
+\newpsbarstyle{redoutline}{framearc=0.5,%
+ fillcolor=black,linecolor=red,%
+ linewidth=1.5pt}%
+\begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,%
+ subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,%
+ ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example2.csv}%
+ \psbarchart[barstyle={yellowhatch,%
+ redoutline}]{\data}%
+\end{pspicture}\end{verbatim}
+ \end{minipage}\\
+
+Komplexe Effekte sind unter mehrfacher Benennung von \Lcs{psbarchart} in einem einzelnen
+Diagramm möglich. Zum Beispiel kann ein besonders wichtiger Balken in grün hervorgehoben
+werden, indem man die Daten in zwei Dateien aufgespaltet. Eine enthält eine Null für den
+Datenwert, der hervorgehoben werden soll und die andere enthält Nullen für alle anderen
+Daten \emph{außer} der Hervorzuhebenden.
+
+\vspace*{2ex}%
+
+Datei 1 (\verb|example4.csv|): \verbatiminput{example4.csv}%
+
+Datei 2 (\verb|example5.csv|): \verbatiminput{example5.csv}%
+Beachten Sie, dass die zweite Datei keine Kopfzeile hat, damit die Balkenbeschriftung nicht
+doppelt erfolgt.
+
+ \hfill%
+ \begin{minipage}[b]{1.5in}%
+ \psset{unit=0.5in}%
+ \begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example4.csv}%
+ \psbarchart[barstyle={blue}]{\data}%
+ \readpsbardata[header=false]{\data}{example5.csv}%
+ \psbarchart[barstyle={green}]{\data}%
+ \end{pspicture}
+ \end{minipage}%
+ \hfill%
+ \begin{minipage}[b][2.25in][c]{3.5in}%
+ \begin{verbatim}
+\psset{unit=0.5in}%
+\begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,%
+ subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,%
+ ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example4.csv}%
+ \psbarchart[barstyle={blue}]{\data}%
+ \readpsbardata[header=false]{\data}%
+ {example5.csv}%
+ \psbarchart[barstyle={green}]{\data}%
+\end{pspicture}\end{verbatim}
+ \end{minipage}
+
+Verschiedene Diagrammarten können auch in einem Balkendiagramm kombiniert werden.
+
+\vspace*{.5cm}%
+
+Datei 1 (\verb|example6.csv|): \verbatiminput{example6.csv}%
+
+Datei 2 (\verb|example7.csv|): \verbatiminput{example7.csv}%
+
+ \hfill%
+ \begin{minipage}[b]{1.5in}%
+ \psset{unit=0.5in}%
+ \begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example6.csv}%
+ \psbarchart[barstyle={black}]{\data}%
+ \readpsbardata[header=false]{\data}{example7.csv}%
+ \psbarchart[barstyle={red},chartstyle=block,barcolsep=0.8]{\data}%
+ \end{pspicture}
+ \end{minipage}%
+ \hfill%
+ \begin{minipage}[b][2.25in][c]{3.5in}%
+ \begin{verbatim}
+\psset{unit=0.5in}%
+\begin{pspicture}(0,-0.5)(3,4.5)%
+ \psgrid[xunit=1.5in,gridlabels=0,%
+ subgriddiv=0,griddots=30](0,0)(1,4)%
+ \psaxes[axesstyle=frame,Ox=0,Dx=1,labels=y,%
+ ticks=y](0,0)(3,4)%
+ \readpsbardata{\data}{example6.csv}%
+ \psbarchart[barstyle={black}]{\data}%
+ \readpsbardata[header=false]{\data}%
+ {example7.csv}%
+ \psbarchart[barstyle={red},chartstyle=block,%
+ barcolsep=0.8]{\data}%
+\end{pspicture}
+\end{pspicture}\end{verbatim}
+ \end{minipage}
+
+\section{Tipps}
+\begin{itemize}
+ \item Informieren Sie sich über Befehle, um die Erstellung und Platzierung der
+ Beschriftung zu erleichtern.
+ \item Erlauben Sie die automatische Beschriftung der Balken mit den Werten der Datendatei.
+ \item Erlauben Sie die automatische Beschriftung der Balken nach Ihrer Wahl.
+ \item Verbessern Sie die Syntaxanalyse der Überschrift, um Kommas zwischen den Einträgen
+ der Kopfzeile zu erlauben.
+ \item Fügen Sie eine Fehler-Überprüfung hinzu, um sicherzustellen, dass jede Reihe der
+ Datei dieselbe Anzahl an Einträgen enthält; falls nicht, wird der Fehler in \TeX\
+ oder \LaTeX\ übertragen.
+ \item Verbessern Sie die Dokumentation.
+\end{itemize}
+
+\nocite*
+\bibliographystyle{plain}%
+\bibliography{pst-bar-doc}%
+
+\printindex
+
+
+\end{document}