OSGeo - User contributions [en]

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2010-03-24T14:12:49Z

Wiki-Khoffmann:

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png|GD-Output]] [[Image:agg.png|AGG-Output]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen
# benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss
# auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Folgendes Beispiel zeigt das gleiche Thema, nur mit einem OFFSET 7 7 für den Kreissektor "Produzierendes Gewerbe". Dieser OFFSET wird leider auch in der Legende dargestellt.

[[Image:Kreisdiagramme_offset.png]]
[[Image:Kreise_legende-off.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE=itemname minsize maxsize minval maxval"

Dabei ist:
* itemname der Name des Attributs, welches die Kreisgröße bestimmt
* minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel
* minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen
# benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Nicht-Verwendung sowie der Benutzung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:
* A mit 1000, 500, 200
* B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert die horizontale Achse von der aus der Balken erzeugt wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken erstellt.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.org/output/dynamic_charting.html

https://trac.osgeo.org/mapserver/ticket/2136

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-07-28T09:42:18Z

Wiki-Khoffmann: /* Beispiel eines LAYERs mit Kreissektorendiagrammen */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png|GD-Output]] [[Image:agg.png|AGG-Output]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen
# benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss
# auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Folgendes Beispiel zeigt das gleiche Thema, nur mit einem OFFSET 7 7 für den Kreissektor "Produzierendes Gewerbe". Dieser OFFSET wird leider auch in der Legende dargestellt.

[[Image:Kreisdiagramme_offset.png]]
[[Image:Kreise_legende-off.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE=itemname minsize maxsize minval maxval"

Dabei ist:
* itemname der Name des Attributs, welches die Kreisgröße bestimmt
* minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel
* minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen
# benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Nicht-Verwendung sowie der Benutzung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:
* A mit 1000, 500, 200
* B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert die horizontale Achse von der aus der Balken erzeugt wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken erstellt.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

https://trac.osgeo.org/mapserver/ticket/2136

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-07-28T09:40:21Z

Wiki-Khoffmann: /* Dynamische Kreisgrößen ab Version 5.2 */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png|GD-Output]] [[Image:agg.png|AGG-Output]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen
# benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss
# auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Folgendes Beispiel zeigt das gleiche Thema, nur mit einem OFFSET 7 7 für den Kreissektor "Prodzierendes Gewerbe". Dieser OFFSET wird leider auch in der Legende dargestellt.

[[Image:Kreisdiagramme_offset.png]]
[[Image:Kreise_legende-off.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE=itemname minsize maxsize minval maxval"

Dabei ist:
* itemname der Name des Attributs, welches die Kreisgröße bestimmt
* minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel
* minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen
# benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Nicht-Verwendung sowie der Benutzung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:
* A mit 1000, 500, 200
* B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert die horizontale Achse von der aus der Balken erzeugt wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken erstellt.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

https://trac.osgeo.org/mapserver/ticket/2136

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-05T09:25:08Z

Wiki-Khoffmann: /* Beispiel eines LAYERs mit Kreissektorendiagrammen */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png|GD-Output]] [[Image:agg.png|AGG-Output]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen
# benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss
# auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Folgendes Beispiel zeigt das gleiche Thema, nur mit einem OFFSET 7 7 für den Kreissektor "Prodzierendes Gewerbe". Dieser OFFSET wird leider auch in der Legende dargestellt.

[[Image:Kreisdiagramme_offset.png]]
[[Image:Kreise_legende-off.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:
* itemname der Name des Attributs, welches die Kreisgröße bestimmt
* minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel
* minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen
# benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Nicht-Verwendung sowie der Benutzung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:
* A mit 1000, 500, 200
* B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert die horizontale Achse von der aus der Balken erzeugt wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken erstellt.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

https://trac.osgeo.org/mapserver/ticket/2136

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

File:Kreise legende-off.png

2008-05-05T09:22:05Z

Wiki-Khoffmann: Legende für Kreisdiagramme mit einem OFFSET

Legende für Kreisdiagramme mit einem OFFSET

File:Kreisdiagramme offset.png

2008-05-05T09:19:51Z

Wiki-Khoffmann: Karte mit Kreisdiagrammen und einem OFFSET Datenquelle: Statistisches Landesamt Berlin 2005

Karte mit Kreisdiagrammen und einem OFFSET
Datenquelle: Statistisches Landesamt Berlin 2005

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-05T08:56:35Z

Wiki-Khoffmann: /* Balkendiagramme */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png|GD-Output]] [[Image:agg.png|AGG-Output]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen
# benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss
# auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:
* itemname der Name des Attributs, welches die Kreisgröße bestimmt
* minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel
* minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen
# benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Nicht-Verwendung sowie der Benutzung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:
* A mit 1000, 500, 200
* B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert die horizontale Achse von der aus der Balken erzeugt wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken erstellt.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

https://trac.osgeo.org/mapserver/ticket/2136

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-05T08:56:05Z

Wiki-Khoffmann: /* Kreissektorendiagramme */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png|GD-Output]] [[Image:agg.png|AGG-Output]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen
# benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss
# auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:
* itemname der Name des Attributs, welches die Kreisgröße bestimmt
* minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel
* minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Nicht-Verwendung sowie der Benutzung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:
* A mit 1000, 500, 200
* B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert die horizontale Achse von der aus der Balken erzeugt wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken erstellt.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

https://trac.osgeo.org/mapserver/ticket/2136

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-05T08:51:34Z

Wiki-Khoffmann: /* Links */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png|GD-Output]] [[Image:agg.png|AGG-Output]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:
* itemname der Name des Attributs, welches die Kreisgröße bestimmt
* minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel
* minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Nicht-Verwendung sowie der Benutzung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:
* A mit 1000, 500, 200
* B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert die horizontale Achse von der aus der Balken erzeugt wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken erstellt.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

https://trac.osgeo.org/mapserver/ticket/2136

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-05T08:50:39Z

Wiki-Khoffmann: /* Links */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png|GD-Output]] [[Image:agg.png|AGG-Output]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:
* itemname der Name des Attributs, welches die Kreisgröße bestimmt
* minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel
* minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Nicht-Verwendung sowie der Benutzung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:
* A mit 1000, 500, 200
* B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert die horizontale Achse von der aus der Balken erzeugt wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken erstellt.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

https://trac.osgeo.org/mapserver/ticket/2136

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-05T08:48:47Z

Wiki-Khoffmann: /* PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png|GD-Output]] [[Image:agg.png|AGG-Output]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:
* itemname der Name des Attributs, welches die Kreisgröße bestimmt
* minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel
* minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Nicht-Verwendung sowie der Benutzung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:
* A mit 1000, 500, 200
* B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert die horizontale Achse von der aus der Balken erzeugt wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken erstellt.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-04T10:54:24Z

Wiki-Khoffmann: /* Unterstützte Bibliotheken */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png|GD-Output]] [[Image:agg.png|AGG-Output]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:
* itemname der Name des Attributs, welches die Kreisgröße bestimmt
* minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel
* minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:
* A mit 1000, 500, 200
* B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T22:27:55Z

Wiki-Khoffmann: /* PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png]] [[Image:agg.png]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:
* itemname der Name des Attributs, welches die Kreisgröße bestimmt
* minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel
* minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:
* A mit 1000, 500, 200
* B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T22:27:38Z

Wiki-Khoffmann: /* Dynamische Kreisgrößen ab Version 5.2 */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png]] [[Image:agg.png]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:
* itemname der Name des Attributs, welches die Kreisgröße bestimmt
* minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel
* minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:

- A mit 1000, 500, 200

- B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T22:26:44Z

Wiki-Khoffmann:

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png]] [[Image:agg.png]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:

- itemname der Name des Attributs, welches die Kreisgröße bestimmt

- minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel

- minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:

- A mit 1000, 500, 200

- B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T22:26:19Z

Wiki-Khoffmann:

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png]] [[Image:agg.png]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:

- itemname der Name des Attributs, welches die Kreisgröße bestimmt

- minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel

- minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:

- A mit 1000, 500, 200

- B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

----

Dieses Dokument wurde erarbeitet von [[User:Khoffmann | Karsten Hoffmann]].

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T22:20:32Z

Wiki-Khoffmann: /* PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png]] [[Image:agg.png]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:

- itemname der Name des Attributs, welches die Kreisgröße bestimmt

- minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel

- minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:

- A mit 1000, 500, 200

- B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

[[Image:balken_ohne.png]]

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

[[Image:balken_mit.png]]

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

File:Balken mit.png

2008-05-03T22:19:07Z

Wiki-Khoffmann: Balkendiagramm mit minval-, maxval-Angabe

Balkendiagramm mit minval-, maxval-Angabe

File:Balken ohne.png

2008-05-03T22:18:42Z

Wiki-Khoffmann: uploaded a new version of "Image:Balken ohne.png": Balkendiagramm ohne minval-, maxval-Angabe

Balkendiagramme ohne minval-, maxval-Angaben

File:Balken ohne.png

2008-05-03T22:15:29Z

Wiki-Khoffmann: Balkendiagramme ohne minval-, maxval-Angaben

Balkendiagramme ohne minval-, maxval-Angaben

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T22:11:34Z

Wiki-Khoffmann: /* Unterstützte Bibliotheken */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png]] [[Image:agg.png]]

''Output mit '''GD''' und '''AGG'''''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:

- itemname der Name des Attributs, welches die Kreisgröße bestimmt

- minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel

- minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:

- A mit 1000, 500, 200

- B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

Bild

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T22:11:10Z

Wiki-Khoffmann: /* Unterstützte Bibliotheken */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

[[Image:gd.png]] [[Image:agg.png]]

Output mit '''GD''' und '''AGG'''

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:

- itemname der Name des Attributs, welches die Kreisgröße bestimmt

- minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel

- minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:

- A mit 1000, 500, 200

- B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

Bild

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

File:Gd.png

2008-05-03T22:08:14Z

Wiki-Khoffmann: GD-Output

GD-Output

File:Agg.png

2008-05-03T22:07:57Z

Wiki-Khoffmann: AGG-Output

AGG-Output

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T22:03:53Z

Wiki-Khoffmann: /* Beispiel eines LAYERs mit Balkendiagrammen */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

Bild

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:

- itemname der Name des Attributs, welches die Kreisgröße bestimmt

- minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel

- minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:

- A mit 1000, 500, 200

- B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

Bild

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

[[Image:balkendiagramme.png]]
[[Image:balken_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

File:Balken legende.png

2008-05-03T22:02:30Z

Wiki-Khoffmann: Legende für Balkendiagramme

Legende für Balkendiagramme

File:Balkendiagramme.png

2008-05-03T22:02:11Z

Wiki-Khoffmann: Karte mit Balkendiagrammen

Karte mit Balkendiagrammen

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T22:01:48Z

Wiki-Khoffmann: /* Beispiel eines LAYERs mit Balkendiagrammen */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

Bild

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:

- itemname der Name des Attributs, welches die Kreisgröße bestimmt

- minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel

- minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:

- A mit 1000, 500, 200

- B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

Bild

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T22:01:12Z

Wiki-Khoffmann: /* Beispiel eines LAYERs mit Kreissektorendiagrammen */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

Bild

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

''Datenquelle: Statistisches Landesamt Berlin 2005''

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:

- itemname der Name des Attributs, welches die Kreisgröße bestimmt

- minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel

- minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:

- A mit 1000, 500, 200

- B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

Bild

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

Karte
Datenquelle: Statistisches Landesamt Berlin 2005

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T21:59:37Z

Wiki-Khoffmann: /* Beispiel eines LAYERs mit Kreissektorendiagrammen */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

Bild

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]
[[Image:Kreise_legende.png]]

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:

- itemname der Name des Attributs, welches die Kreisgröße bestimmt

- minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel

- minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:

- A mit 1000, 500, 200

- B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

Bild

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

Karte
Datenquelle: Statistisches Landesamt Berlin 2005

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

File:Kreise legende.png

2008-05-03T21:58:50Z

Wiki-Khoffmann: Legende Kreisdiagramme

Legende Kreisdiagramme

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T21:58:25Z

Wiki-Khoffmann: /* Beispiel eines LAYERs mit Kreissektorendiagrammen */

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

Bild

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

[[Image:Kreisdiagramme_agg.png]]

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:

- itemname der Name des Attributs, welches die Kreisgröße bestimmt

- minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel

- minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:

- A mit 1000, 500, 200

- B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

Bild

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

Karte
Datenquelle: Statistisches Landesamt Berlin 2005

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

File:Kreisdiagramme agg.png

2008-05-03T21:57:22Z

Wiki-Khoffmann: Kreisdiagramme mit AGG

Kreisdiagramme mit AGG

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T21:53:26Z

Wiki-Khoffmann:

Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0.

Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und dem Erstellen einer Map-Datei voraus.

==Einleitung==

Seit der Version 5.0 existiert mit dem neuen Layertyp CHART eine komfortable Möglichkeit automatisch Kreissektoren- oder Balkendiagramme auf der Basis von Sachdaten zu erzeugen. Dieser Layertyp ist auf punkt-, linien- und flächenhaften Daten anwendbar. I.d.R. werden Balken- und Kreissektorendiagramme in der thematischen Kartographie nur auf Punkt- und Flächenobjekten angewandt. Es lassen sich nun recht einfach thematische Karten vom Typ Standortdiagrammkarte und Flächendiagrammkarte erzeugen.
Bei linienhaften Objekten können quantitative Attributwerte über verschiedene Linienbreiten dargestellt werden. Dies ergibt eine Liniendiagrammkarte.
Zur Erstellung der Diagramme werden Vektordaten mit dazugehörigen Sachdaten in einer Attributtabelle verwendet.

==Unterstützte Bibliotheken==

Der Layertyp CHART wird im UMN MapServer von der GD- und der AGG-Bibliothek unterstützt. Die Ausgabe mittels AGG bietet jedoch eine qualitativ bessere Darstellung, besonders bei Kreisdiagrammen aufgrund des generellen Antialiasing.
Eine Ausgabe der Diagramme in anderen Formaten, wie PDF, SWF oder SVG, die mit anderen Bibliotheken erstellt werden, ist nicht möglich.

Bild

==Kreissektorendiagramme==

Diagramme werden in einem gesonderten LAYER vom Typ CHART erzeugt. Der Diagramtyp und die Diagrammgröße werden über PROCESSING-Parameter bestimmt.
Für jeden Kreissektor im Diagramm wird ein CLASS-Block angelegt. Im dazugehörigen STYLE-Block wird dann mit SIZE [Attributname] auf den jeweiligen Wert in der Attributtabelle verwiesen. Mit diesem Wert wird dynamisch die Größe (der Winkel) des entsprechenden Kreissektors erzeugt.

Folgende Übersicht erläutert den Aufbau näher:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=PIE" # Diagrammtyp, voreingestellt ist PIE für Kreissektorendiagramme
PROCESSING "CHART_SIZE=30" # Größe (Durchmesser) der Diagramme in Pixel
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Kreissektors, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Sektorengrößen benutzt werden sollen
COLOR r g b # Farbe, mit der der Kreissektor gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Kreissektor gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
OFFSET a b # ’a’ gibt die Anzahl der Pixel an, um die der Kreissektor nach außen verschoben werden soll, bei ’b’ muss auch ein Wert angegeben werden, der aber ignoriert wird
END
END
CLASS
…
END
…
END

Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===Beispiel eines LAYERs mit Kreissektorendiagrammen===

LAYER
NAME unternehmen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=pie"
PROCESSING "CHART_SIZE=39"
CLASS
NAME "übrige Dienstleistungen"
STYLE
SIZE [L_M_N]
OUTLINECOLOR 0 0 0
COLOR 56 168 0
END
END
CLASS
NAME "Dienstleistungen für Unternehmen"
STYLE
SIZE [J_K_O]
COLOR 230 230 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Handel, Gastgewerbe, Verkehr, ..."
STYLE
SIZE [G_H_I]
COLOR 0 112 255
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Produzierendes Gewerbe"
STYLE
SIZE [D_E_F]
COLOR 255 0 0
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird die Anzahl der Betriebe in den Stadtbezirken Berlins aufgeteilt auf die verschiedenen Wirtschaftsbereiche dargestellt. Die Angaben bei SIZE verweisen jeweils auf eine Spalte in der Attributtabelle, in der die Anzahl der Betriebe für einen bestimmten Wirtschaftsbereich vorliegen.

Die daraus resultierende und mit AGG erzeugte Karte sowie die Legende sehen folgendermaßen aus:

Karte

Ein Nachteil ist, dass in der Version 5.0 nur Kreissektorendiagramme mit einer festen Größe (Durchmesser) erzeugt werden. Man kann die Kreissektoren also nicht im Zusammenhang zu einem übergeordneten Attribut darstellen. Nur die Anteile der jeweiligen Werte können anhand der Kreissektoren abgelesen werden.

===Dynamische Kreisgrößen ab Version 5.2===

Ab der Version 5.2 wird es mit einem zusätzlichen PROCESSING-Parameter möglich sein, die Kreisgrößen abhängig von einem Attribut zu variieren:

PROCESSING "CHART_SIZE_RANGE = itemname minsize maxsize minval maxval"

Dabei ist:

- itemname der Name des Attributs, welches die Kreisgröße bestimmt

- minsize und maxsize die minimale und maximale Größe der Kreisdiagramme in Pixel

- minval und maxval die minimalen und maximalen Werte des Attributs, welches die Kreisdiagrammgrößen bestimmt, diese korrespondieren dann mit den bei minsize, maxsize angegeben Größen

Sind die Attributwerte kleiner als minval wird die Kreisgröße mit der Angabe bei minsize gezeichnet und sind die Attributwerte größer als maxval werden die Kreisdiagramme mit der bei maxsize angegeben Größe erstellt.

==Balkendiagramme==

Balkendiagramme werden nach dem gleichen Prinzip wie die Kreissektorendiagramme erzeugt. Es gibt jedoch ein paar zu beachtende Besonderheiten.

Hier zunächst die Erläuterung der LAYER-Struktur:

LAYER
TYPE CHART
PROCESSING "CHART_TYPE=BAR" # Diagrammtyp, hier BAR für Balkendiagramme
PROCESSING "CHART_SIZE=30 40" # Breite und Höhe der Balkendiagramme in Pixel
PROCESSING "CHART_BAR_MINVAL=val" # kleinster Attributwert
PROCESSING "CHART_BAR_MAXVAL=val" # größter Attributwert
…
CLASS
NAME "Text" # Erläuterung bzw. Name des Balkens, der in der Legende erscheint
STYLE
SIZE [Attributname] # gibt an, aus welcher Spalte der Attributtabelle die Sachdaten zur Erzeugung der Balkenhöhen benutzt werden sollen
COLOR r g b # Farbe, mit der der Balken gefüllt wird
OUTLINECOLOR r g b # wenn angegeben, wird eine Umrandungslinie um den Balken gezeichnet
WIDTH w # Breite der Umrandungslinie in Pixel, wenn OUTLINECOLOR spezifiziert wurde
END
END
CLASS
…
END
…
END

Auch hier gilt: Im STYLE-Block kann bei SIZE auch ein fester Wert angegeben werden. Mindestens zwei CLASS-Blöcke sind erforderlich, um die Diagramme zu erzeugen.

===PROCESSING-Parameter CHART_BAR_MINVAL und CHART_BAR_MAXVAL===

Die beiden optionalen Parameter PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" erzeugen miteinander vergleichbare Balkendiagramme in einer Karte. Ohne diese Angabe werden die Diagrammhöhen nicht relativ zueinander gezeichnet und sie sind nicht miteinander vergleichbar. In diesem Fall wird der größte Balken in jedem Diagramm mit der bei PROCESSING "CHART_SIZE=Breite Höhe" angegeben Höhe gezeichnet, unabhängig von dem jeweiligen Attributwert. Alle anderen Balken in einem Diagramm werden anhand ihrer Sachdaten relativ zu dem größten Balken in diesem Diagramm erzeugt.

Um also miteinander vergleichbare Balkendiagramme zu erstellen, müssen die beiden zusätzlichen Parameter (oder auch nur einer davon) angegeben werden.
I.d.R. reicht die Angabe des größten darzustellenden Attributwertes aus. Die vertikale Achse (y-Achse) des Diagramms reicht dann von 0 bis zum größten Wert bei positiven Attributwerten. Es können aber auch negative Werte in den Diagrammen dargestellt werden.

Folgendes Beispiel soll den Unterschied der Verwendung von PROCESSING "CHART_BAR_MINVAL=val" und PROCESSING "CHART_BAR_MAXVAL=val" verdeutlichen:

Vorgegeben sind 2 Objekte A und B mit folgenden Attributwerten:

- A mit 1000, 500, 200

- B mit 2000, 500, 200

Als Ergebnis ohne eine minval- und maxval-Angabe erhält man:

Bild

Die roten Balken haben bei beiden Diagrammen dieselben Größen während sich die anderen Balken unterscheiden. Diese Darstellung entspricht nicht den Attributwerten und vermittelt falsche Informationen.

Bei der Verwendung der minval- und maxval-Angabe werden die Diagramme in einem richtigen Verhältnis zueinander erzeugt. Der rote Balken bei A ist halb so groß
wie bei B und die blauen und gelben Balken haben jeweils dieselbe Größe. Diese Darstellung entspricht somit den Daten.

Wenn nur ein Wert für maxval angegeben wird, wird der Balken immer vom Wert 0 aus gezeichnet. Eine Angabe bei minval verlagert sozusagen die Achse von der aus der Balken gezeichnet wird.
Bei Attributwerten die größer als der maxval-Wert sind, werden die Balken auch so hoch wie bei dem dort angegebenen Wert gezeichnet. Bei Werten die kleiner als der minval-Wert sind, wird kein Balken gezeichnet.

===Beispiel eines LAYERs mit Balkendiagrammen===

LAYER
NAME wahlen
TYPE CHART
DATA pbezirke
STATUS ON
PROCESSING "CHART_TYPE=bar"
PROCESSING "CHART_SIZE=50 55"
PROCESSING "CHART_BAR_MAXVAL=43"
CLASS
NAME "CDU"
STYLE
SIZE [CDU]
OUTLINECOLOR 0 0 0
COLOR 0 77 168
END
END
CLASS
NAME "SPD"
STYLE
SIZE [SPD]
COLOR 230 0 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "PDS"
STYLE
SIZE [PDS]
COLOR 169 0 230
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Grüne"
STYLE
SIZE [GRUENE]
COLOR 56 168 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "FDP"
STYLE
SIZE [FDP]
COLOR 255 255 0
OUTLINECOLOR 0 0 0
END
END
CLASS
NAME "Sonstige"
STYLE
SIZE [SONSTIGE]
COLOR 130 130 130
OUTLINECOLOR 0 0 0
END
END
END

In diesem LAYER wird das Ergebnis der Europawahl 2004 in Berlin auf Ebene der Stadtbezirke dargestellt. Der bei PROCESSING "CHART_BAR_MAXVAL=43" angegebene Wert 43 ist die bei dieser Wahl höchste erreichte Prozentzahl von einer Partei in einem Bezirk.

Die daraus resultierende Karte sowie die Legende sehen folgendermaßen aus:

Karte
Datenquelle: Statistisches Landesamt Berlin 2005

Ein Nachteil ist hierbei, dass in der automatisch erstellten Legende nur die Farben der Balken erläutert werden aber nicht die Balkenhöhen. Der Kartenleser kann also nicht einschätzen welche Balkenhöhe wie viel Prozent entspricht.

==Links==

http://mapserver.gis.umn.edu/docs/howto/dynamic-charting

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T21:46:14Z

Wiki-Khoffmann:

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T21:43:02Z

Wiki-Khoffmann:

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T21:40:58Z

Wiki-Khoffmann:

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T21:39:49Z

Wiki-Khoffmann:

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T21:37:27Z

Wiki-Khoffmann:

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T21:31:19Z

Wiki-Khoffmann:

Konstruktion von Diagrammen mit dem UMN MapServer 5.0

2008-05-03T21:30:56Z

Wiki-Khoffmann: New page: Dieses Dokument erläutert die dynamische Konstruktion von Kreissektoren- und Balkendiagrammen im UMN MapServer 5.0. Diese Anleitung setzt Grundkenntnisse in UMN MapServer-Anwendungen und...

Komitee für Bildung und Dokumentationserstellung

2008-05-03T21:29:40Z

Wiki-Khoffmann:

== Komitee für Bildung und Dokumentationserstellung ==

Die Aufgabe des Komitees für Bildung und Dokumentationserstellung ist es, die Nutzung der unter dem Dach der OSGeo entwickelten
Softwareprodukte durch Anleitungen und Tutorials zu unterstützen.
Diese Anleitungen sollen vorrangig im WIKI erstellt werden, um die Vorteile einer gemeinsamen Erstellung ausnutzen zu können.
Fühlen Sie sich frei sich als Mitglied in dieses Komitee einzutragen und eigene Anleitungen zu erstellen.

== Mitglieder ==
* [[User:Kai Behncke | Kai Behncke]]
* [[User:Peter_panther | Florian Thürkow]]
* [[User:Simon Appelt | Simon Appelt]]
* [[User:jtmapmedia | Jörg Thomsen]]
* [[User:Markus Weißmann | Markus Weißmann]]
* [[User:Sven Boehme | Sven Boehme]]
* [[User:Matthias Heber | Matthias Heber]]
* [[User:Khoffmann | Karsten Hoffmann]]

== Anleitungen ==
* [[Anleitung für Routing (Pgrouting) und UMN MapServer mit den Freien Geodaten aus Osnabrück (Frida) | Anleitung für Routing (Pgrouting) und UMN MapServer mit den Freien Geodaten aus Osnabrück (Frida)]]

* [[Neuerungen des UMN MapServers 5.0 | Neuerungen des UMN MapServers 5.0]]

* [[Installation von MapServer, Apache und PostgreSQL/PostGIS auf Debian 4.0 | Installation von MapServer, Apache und PostgreSQL/PostGIS auf Debian 4.0]]

* [[UMN-Mapserver_Performancetest | UMN-Mapserver Performancetest]]

* [[Wxs mapscript]]

* [[Konstruktion von Diagrammen mit dem UMN MapServer 5.0 | Konstruktion von Diagrammen mit dem UMN MapServer 5.0]]

Auf der FOSSGIS 2008 in Freiburg wurde beschlossen, dass im Rahmen von OSGeo Dach (Bildung) gemeinschaftlich das neue Handbuch für den UMN MapServer erstellt wird. Die Erstellung des Buches wird über ein WIKI laufen. Sofern Sie Interesse haben tragen Sie sich bitte in die folgende Mailingliste [http://lists.osgeo.org/mailman/listinfo/viscom-discuss-de http://lists.osgeo.org/mailman/listinfo/viscom-discuss-de] ein, und setzen Sie, wenn Sie möchten, oben auch einen namentlichen Link.

Hier gehts zur Gliederung des Handbuches
[http://wiki.osgeo.org/wiki/HBUMNMapServer_ger http://wiki.osgeo.org/wiki/HBUMNMapServer_ger]

== Links ==
* [http://download.osgeo.org/mapserver/docs/mapserver-users-manual.pdf mapserver user manual ]

[[Category: Education]]

Komitee für Bildung und Dokumentationserstellung

2008-04-14T08:42:54Z

Wiki-Khoffmann: /* Mitglieder */

== Komitee für Bildung und Dokumentationserstellung ==

Die Aufgabe des Komitees für Bildung und Dokumentationserstellung ist es, die Nutzung der unter dem Dach der OSGeo entwickelten
Softwareprodukte durch Anleitungen und Tutorials zu unterstützen.
Diese Anleitungen sollen vorrangig im WIKI erstellt werden, um die Vorteile einer gemeinsamen Erstellung ausnutzen zu können.
Fühlen Sie sich frei sich als Mitglied in dieses Komitee einzutragen und eigene Anleitungen zu erstellen.

== Mitglieder ==
* [[User:Kai Behncke | Kai Behncke]]
* [[User:Peter_panther | Florian Thürkow]]
* [[User:Simon Appelt | Simon Appelt]]
* [[User:jtmapmedia | Jörg Thomsen]]
* [[User:Markus Weißmann | Markus Weißmann]]
* [[User:Sven Boehme | Sven Boehme]]
* [[User:Matthias Heber | Matthias Heber]]
* [[User:Khoffmann | Karsten Hoffmann]]

== Anleitungen ==
* [[Anleitung für Routing (Pgrouting) und UMN MapServer mit den Freien Geodaten aus Osnabrück (Frida) | Anleitung für Routing (Pgrouting) und UMN MapServer mit den Freien Geodaten aus Osnabrück (Frida)]]

* [[Neuerungen des UMN MapServers 5.0 | Neuerungen des UMN MapServers 5.0]]

* [[Installation von MapServer, Apache und PostgreSQL/PostGIS auf Debian 4.0 | Installation von MapServer, Apache und PostgreSQL/PostGIS auf Debian 4.0]]

* [[UMN-Mapserver_Performancetest | UMN-Mapserver Performancetest]]

* [[Wxs mapscript]]

Auf der FOSSGIS 2008 in Freiburg wurde beschlossen, dass im Rahmen von OSGeo Dach (Bildung) gemeinschaftlich das neue Handbuch für den UMN MapServer erstellt wird. Die Erstellung des Buches wird über ein WIKI laufen. Sofern Sie Interesse haben tragen Sie sich bitte in die folgende Mailingliste [http://lists.osgeo.org/mailman/listinfo/viscom-discuss-de http://lists.osgeo.org/mailman/listinfo/viscom-discuss-de] ein, und setzen Sie, wenn Sie möchten, oben auch einen namentlichen Link.

Hier gehts zur Gliederung des Handbuches
[http://wiki.osgeo.org/wiki/HBUMNMapServer_ger http://wiki.osgeo.org/wiki/HBUMNMapServer_ger]

== Links ==
* [http://download.osgeo.org/mapserver/docs/mapserver-users-manual.pdf mapserver user manual ]

[[Category: Education]]

User:Khoffmann

2007-09-29T11:44:16Z

Wiki-Khoffmann:

Dipl.-Geogr. Karsten Hoffmann

Institut für Geoinformatik und Fernerkundung, Universität Osnabrück

khoffmann@igf.uni-osnabrueck.de

D-A-CH

2007-09-29T11:41:56Z

Wiki-Khoffmann: /* Mitgliederliste */

''This is the start page of the German Local Chapter as per [[Local Chapter Guidelines]]''

''Das ist die deutschsprachige Einstiegsseite zur OSGeo Foundation, die zu einer regionalen Gruppe werden könnte wie sie in den [[Local Chapter Guidelines]] beschrieben wird.

== Einführung ==
Bitte tragen Sie sich in die [[Deutsch#Mitgliederliste | Mitgliederliste]] ein, wenn Sie Interesse an einem deutschsprachigen [[Local Chapters]] haben. Der Eintrag ist freiwillig, dieses Wiki und alle enthaltenen Informationen sind öffentlich sichtbar. Die Kommunikation erfolgt über die [http://lists.osgeo.org/mailman/listinfo/viscom-discuss-de Mailing-Liste discuss-de] ([http://lists.osgeo.org/pipermail/viscom-discuss-de/ Archiv]) oder dieses Wiki.
Eingeladen an dem deutschsprachigen Local Chapter mitzuwirken sind ausdrücklich alle Interessierten, völlig unabhängig davon ob Anwender oder Entwickler, völlig unabhängig davon ob erfahren im Umgang mit OS-GIS-Software oder "Neuling". Die OSGeo lebt von der Beteiligung jedes Einzelnen, jeder Beitrag ist willkommen.

== Unser Name ==
Wir brauchen einen offiziellen Namen für die deutschsprachige Gruppe der OSGe, Vorschläge:
* OSGeo DACH

Der Begriff der "Foundation" lässt sich ebenfalls nicht gut [http://dict.leo.org/ende?lp=ende&lang=de&searchLoc=0&cmpType=relaxed&sectHdr=on&spellToler=on&search=Foundation&relink=on direkt übersetzen], in vielen Dokumenten ist deshalb von der "OSGeo Foundation" zu lesen, was allerdings gegen die Vorgaben zur Nutzung des OSGeo Logo und Markennamen geht.

== Rechtsform, Konto ==
Die OSGeo Foundation ist als non-profit Firma in Delaware, USA gegründet worden. Dort gibt es auch ein Konto und wird das Budget verwaltet. Für formale Arbeiten und als zentrale Anlaufstelle für Fragen rund um die OSGeo wurde Tyler Mitchell als Executive Director angestellt, seine Stelle wird auch aus diesem Budget finanziert. Unabhängig davon werden wir nationale Konten benötigen, da die Transferkosten und der Aufwand, Geld über internationale Grenzen zu transportieren, nach wie vor unsinnig ist. In Deutschland gibt es bereits ein Netzwerk und Organisation für die Förderung freier Software, den GAV e.V. (GRASS Anwender-Vereinigung), eine formale Organisation mit der Rechtsform "eingetragener Verein". Der GAV und OSGeo sind im Gespräch, wie eine Kooperation gestaltet werden kann. Eine erste, pragmatische Kooperation betrifft die Überschüsse der letzten FOSSGIS-Konferenzen, die das Organisationsteam der FOSSGIS-Konferenzen zweckgebunden an den GAV e.V. spenden wird. Bei den nächsten Konferenzen kann das Organisationsteam auf diesen Puffer zurückgreifen.
* [http://www.grass-verein.de/ GAV] (GRASS Anwender-Vereinigung e.V.)
* [http://www.fossgis.de FOSSGIS.de] (Organisationsteam der FOSSGIS-Konferenzen)

== Ziele ==
Die Ziele der deutschsprachigen OSGeo Arbeitsgruppe entwickeln sich durch die Beiträge der Mitglieder. Eine erste Orientierung geben die [[Local Chapter Guidelines | Richtlinien für lokale Gruppen]], einzelne Schwerpunkte werden sich im Laufe der Arbeit herauskristallisieren.
* Bereitstellung eines Netzwerkes für die Mitglieder, ggf. mit Job-Börse.
* Organisation der jährlichen deutschsprachigen Konferenz (siehe [[FOSSGIS 2006]])
* Kontaktstelle für neue Mitglieder und Sponsoren
* Führung eines Regionalbüros mit Konto, Telefon, Ansprechpartner
* Übersetzung von Dokumenten, Inhalten, Webseiten und Lokalisierung von Software (Anpassung an örtliche Besonderheiten)
* Lösungen im deutschsprachigen Raum bewerben
* Erstellung von regionalisierten Software-Paketen
* Training, Support und Entwicklung von e-Learning Inhalten in deutscher Sprache
* Förderung von offenen Standards und freien Zugang zu räumlichen Daten im deutschsprachigen Umfeld.
* Förderung der OSGeo Foundation durch Präsentationen, Informationsveranstaltungen, Messestände, etc.

== Komitees ==

An dieser Stelle folgen nach und nach die Komitees der deutschsprachigen OSGeo Gemeinschaft. Fühlen Sie sich frei selber ein Komitee zu gründen oder sich einem bestehenden anzuschließen.

* [[Komitee für Bildung und Dokumentationserstellung | Komitee für Bildung und Dokumentationserstellung]]

== Kommunikation ==
Die Kommunikaiton läuft über dieses Wiki, Mailing Listen, Webseite und natürlich das persönliche Gespräch auf Messen, Konferenzen und Anwendertreffen. Das neue OSGeo Portal bietet eine einfache Möglichkeit zur Übersetzung ins Deutsche. Falls Sie bei der Übersetzung gerne helfen möchten wenden Sie sich bitte an die Translation Group des [[WebCom | Website Committee]].

== Steuerung ==
Die deutschprachige Gruppe der OSGeo ist noch informell. Beteiligen Sie sich an der Gestaltung, indem Sie sich einbringen. Entscheidungen werden wie bei Open Source üblich per Email an die Mailing Liste geschickt und diskutiert. Beschlussfähige Vorschläge werden von einem Mitglied vorgeschlagen und von einem zweiten Mitglied unterstützt.

=== Wahl ===
Die Wahl erfolgt über Ablehung, Zustimmung oder Gleichgültigkeit:
-1 = Veto, Ablehung
-0 = nicht einverstanden, beugt sich aber der Mehrheit
0 = trägt die Entscheidung der anderen mit, kann aber nicht beurteilen, ob sie gut ist (zu wenig Information, keine Zeit sich zu informieren, etc.)
+0 = unterstützt den Antrag passiv, kann aber nicht aktiv zum Thema beisteuern
+1 = Zustimmung, unterstützt den Antrag voll und arbeitet auch mit

=== Veto ===
Wer mit -1 wählt legt ein Veto ein. Damit das Veto angenommen werden kann muss es innerhalb der Wahlfrist begründet und am besten gleich mit einem Alternativvorschlag eingebracht werden.

=== Unterstützung ===
Wer mit +1 wählt muss auch bereit sein aktiv mit der Lösung mitzumachen. Sonst gibt es zu viele faule Beobachter und zu wenige Arbeiter.

=== Veto überstimmen ===
Ein Veto kann überstimmt werden
* durch eine absolute Mehrheit der Mitglieder
* oder wenn mindestens vier Mitglieder mit einer +1 wählen.

Alle Ergebnis können immer angefochten werden (bis uns was besseres einfällt).

== Offizieller Status und Dokumente ==
Die OSGeo Foundation ist eine rechtliche Organisation die aus mittlerweile 59 Mitgliedern und 9 Direktoren besteht. Alle offiziellen Projekte und Dokumente müssen von dem Direktorium abgenommen werden bevor sie offiziellen Status erreichen. Offizielle Dokumente werden in den statischen Dokumenten-Ordner auf osgeo.org hinterlegt und werden dadurch "Official Policy" der OSGeo Foundation. Sobald die Mitgliederliste 10 bis 15 Einträge hat, die sich aktiv einbringen wollen, können wir einen Antrag auf einen eigenen Projektbereich mit Dokumentenordner, SVN, Webseite, etc. und offiziellem Status beantragen.

Die Sammlung deutschsprachiger Dokumente ist der Migration zum Opfer gefallen, wird aber nach und nach wieder aufgebaut. Falls Sie selbst Dokumente beisteuern können wenden Sie dich bitte an das [[Promotion and Visibility Committee]].
* [[Intern: Entwurf Artikel GIS BUSINESS | ]]

== Weitere Wiki-Seiten zu regionalen (''local'') Themen und Veranstaltungen ==
* [http://wiki.osgeo.org/index.php/Deutsch/NAS Entwicklung freier NAS-Schnittstelle]
* [http://wiki.osgeo.org/index.php/LinuxTag_2007 LinuxTag 2007]
* [[AGIT_2007]]
* [[Intergeo_2007]]
* [[FOSSGIS 2008]]

== Mitgliederliste ==
* [[User:Arnulf Christl | Arnulf Christl]]
* [[User:Ofreier | Olaf Freier]] ([http://www.hinte-messe.de/ Hinte GmbH])
* [[User:Peter Stamm | Peter Stamm]]
* [[User:Schmitz | Sebastian Schmitz]]
* [[User:Astrid Emde | Astrid Emde]]
* [[User:Uli Rothstein | Uli Rothstein]]
* [[User:Garand | Michel Garand]]
* [[User:christoph | Christoph Baudson]]
* [[User:dietmar | Dietmar Fleischhauer]]
* [[User:Georgloesel | Georg Lösel]]
* [[User:Olaf Knopp | Olaf Knopp]]
* [[User:Torsten Brassat | Torsten Brassat]]
* [[User:Jtmapmedia | Jörg Thomsen]]
* [[User:Silke Reimer | Silke Reimer]]
* [[User:Till Adams | Till Adams]]
* [[User:Athina Trakas | Athina Trakas]]
* [[User:mlechner | Marco Lechner]]
* [[User:maltehm | Malte Halbey-Martin]]
* [[User:Kai Behncke | Kai Behncke]]
* [[User:Cplass | Christian Plass]]
* [[User:Thomas Kastler | Thomas Kastler]]
* [[User:Constanze Tschritter | Constanze Tschritter]]
* [[User:Marko Samson | Marko Samson]]
* [[User:Markus Weißmann | Markus Weißmann]]
* [[User:Robert.Dettmann | Robert Dettmann]] ([http://www.creata-software.de/ creaTa Software GmbH])
* [[User:Verena Diewald | Verena Diewald]]
* [[User:sholl | Stephan Holl]]
* [[User:GEppelt | Gunter Eppelt]]
* [[User:Sholler | Sebastian Holler]]
* [[User:Thomas Baschetti | Thomas Baschetti]]
* [[User:Peter Loewe| Peter Löwe]]
* [[User:Peter_panther| Florian Thürkow]]
* [[User:Fjbehr| Dr. Franz-Josef Behr]]
* [[User:crischan| Christian Wygoda (FH Eberswalde)]]
* [[User:Uwe.Seidel| Uwe Seidel (http://www.seicontec.net)]]
* [[User:Khoffmann | Karsten Hoffmann]]

* Bitte tragen Sie sich hier mit Link auf Ihren OSGeo-Wiki Account einLadzinski

[[Category:Local Chapters]]

User:Khoffmann

2007-09-29T11:38:52Z

Wiki-Khoffmann:

Dipl.-Geogr. Karsten Hoffmann

Institut für Geoinformatik und Fernerkundung, Universität Osnabrück

khoffmann@igf.uni-osnabrueck.de