# Balkendiagramm

> Referenz der Dashboard-Komponente für das Balkendiagramm, den kategorialen Vergleich lebender Datenpunkte, mit allen Eigenschaften des Editors.

Das **Balkendiagramm** vergleicht lebende Datenpunkte nebeneinander: ein Balken je Adresse, in
diesem Augenblick gelesen. Es ist ein kategoriales Diagramm, kein Zeitdiagramm: es gibt keine
Zeitachse, kein Zeitfenster, keinen Abtasttakt und keine Aufbewahrung dahinter. Um Datenpunkte
über die Zeit zu verfolgen, nehmen Sie das [Liniendiagramm](component-line-chart).

Ein Datenpunkt, der nicht liest, bleibt aus dem Vergleich heraus, statt auf null gezeichnet zu
werden, und das Diagramm sagt das unter der Zeichnung (`1 von 4 Datenpunkten liest nicht und
bleibt außen vor.`). Ein Bild, das gerade erst geöffnet wurde, sagt noch nichts: noch nicht
gelesen ist nicht dasselbe wie liest nicht.

## Inhalt und Datenpunkte {#content-and-points}

| Eigenschaft | Was sie tut | Werte | Vorgabe |
|---|---|---|---|
| Titel des Diagramms | Wahlweise eine Überschrift, die im Diagrammfeld gezeichnet wird. Das ist die eigene Überschrift des Diagramms, nicht der Titel in der Ecke der Komponente (der wohnt im gemeinsamen Abschnitt Darstellung). | Text | leer |
| Datenpunkte | Die verglichenen Kategorien, eine Karte je Balken, in der erklärten Reihenfolge. Jede Karte hält die drei Felder darunter. **Datenpunkt hinzufügen** hängt einen an. | Liste | leer |
| · Adresse | Verwurzelte Logic-Adresse, die der Balken liest. Das Feld schlägt aus der Liste der lebenden Datenpunkte vor, auf numerische Datenpunkte eingeengt, und zeigt den aktuellen Messwert des Datenpunkts, sobald er benannt ist. | Adresse | leer |
| · Bezeichnung | Wie die Achse und die Legende den Balken nennen. | Text | leer fällt auf die Adresse zurück |
| · Farbe | Die Farbe des Balkens als `#RRGGBB`. | Hex-Farbe | leer nimmt die nächste Farbe der Palette |
| Reihenfolge | Die Reihenfolge, in der die Balken gezeichnet werden. Die erklärte Reihenfolge lässt eine Station dort, wo der Bediener sie hingestellt hat, was sie auch produziert hat; das Sortieren beantwortet stattdessen, wer führt. | wie erklärt · kleinste zuerst · größte zuerst | wie erklärt |

## Format {#format}

Eine Erklärung für das ganze Diagramm, auf den Balken, in den Tooltips und in den
Beschriftungen gleichermaßen, denn ein Diagramm schreibt eine Zahl auf eine Weise.

| Eigenschaft | Was sie tut | Werte | Vorgabe |
|---|---|---|---|
| Einheit | Wahlweise eine technische Einheit, die hinter jeden Messwert geschrieben wird. | Text | leer |
| Dezimalstellen | Feste Nachkommastellen für die Messwerte. | 0 bis 15 | leer verwendet die Vorgabe der Station |
| Liest sich als | Wie jeder Messwert ausgeschrieben wird. Der Wert selbst wird durch die Wahl nie umgerechnet. | Zahl · Prozent · Dauer | Zahl |
| Der Wert zählt in | Was eine Einheit des Werts bedeutet, solange das Format eine Dauer ist. Nur bei diesem Format gezeigt. | Sekunden · Millisekunden · Minuten | Sekunden |

## Balken {#bars}

| Eigenschaft | Was sie tut | Werte | Vorgabe |
|---|---|---|---|
| Die Balken auf die Seite legen | Zeichnet die Balken waagerecht. Lange Bezeichnungen lesen sich quer besser als unter einem Balken. Ist die Zelle zu schmal für die Bezeichnungen, die Messwerte und die Skala nebeneinander, gibt sie Platz in dieser Reihenfolge ab: Eine Bezeichnung, die länger ist als ihr Anteil an der Breite, endet mit Auslassungspunkten, dann entfallen die Messwerte, dann die Bezeichnungen selbst. Der Tooltip über einem Balken zeigt weiterhin seine ganze Bezeichnung und seinen Messwert, und jeder Teil kehrt zurück, sobald die Zelle breit genug für ihn ist. | ein / aus | aus |
| Zu einem Balken stapeln | Stapelt die Kategorien zu einem einzigen Balken, statt sie nebeneinanderzustellen. Nebeneinander beantwortet "wie viel hat jeder"; gestapelt beantwortet "wie teilt sich das Ganze", was die Frage des Kreisdiagramms gerade gezeichnet ist. | ein / aus | aus |
| Jeden Messwert auf seinen Balken schreiben | Schreibt den formatierten Wert auf jeden Balken. Ist die Zelle zu niedrig, um die Messwerte über stehende Balken zu schreiben, oder liegen die Balken auf der Seite und ist sie zu schmal, um die Messwerte neben sie zu schreiben, zeigt sie der Tooltip. Ein Messwert, der über den seines Nachbarn geschrieben würde, entfällt ebenfalls und steht im Tooltip. | ein / aus | ein |
| Min. | Der Boden, an dem die Wertachse festgehalten wird, in der eigenen Einheit der Messwerte. Leer lässt die Achse sich immer wieder an das anpassen, was gerade gelesen wird, was den höchsten Balken an den oberen Rand des Feldes setzt, was er auch gemessen hat. Eine festgehaltene Skala ist das, was zwei Blicke vergleichbar macht. | Zahl | leer (autom.) |
| Max. | Die Decke, an der die Wertachse festgehalten wird. Die beiden Enden sind voneinander unabhängig: ein Boden kann halten, während die Decke den Daten folgt. | Zahl | leer (autom.) |
| Legende | Wo die Legende sitzt. Nur angeboten, solange die Balken gestapelt sind: stehen sie auseinander, sind sie auf der Achse bereits benannt, und eine Legende würde dieselbe Liste zweimal drucken; in eine Säule gestapelt ist die Legende das Einzige, was die Segmente auseinanderhalten kann. Eine Zelle, die zu schmal ist, um alle Bezeichnungen in die eine Zeile der Legende zu schreiben, führt die Segmente stattdessen eines pro Zeile auf: Eine Bezeichnung, die länger ist als ihre Zeile, endet mit Auslassungspunkten, und der Tooltip über der Zeile zeigt sie ganz. Die Liste belegt höchstens fünf Zeilen, und weniger in einer Zelle, die zu niedrig ist, um dem Diagrammfeld zusätzlich ein Drittel ihrer Höhe zu lassen: Hat sie mehr Segmente als Zeilen, zeigt sie sie seitenweise, mit den Pfeilen und dem Seitenzähler (etwa 1/3) in ihrer letzten Zeile. Sobald die Zelle breit genug ist, kehrt die Zeile zurück. | über dem Diagrammfeld · unter dem Diagrammfeld · keine | über dem Diagrammfeld |

Ist eine Zelle für alles zu klein, lässt sie Teile weg, bevor das Diagrammfeld zu klein zum Lesen
wird. In einer niedrigen Zelle entfallen bei nebeneinander stehenden Balken zuerst die Messwerte
über den Balken, dann die Bezeichnungen darunter; liegen die Balken auf der Seite, nebeneinander
oder gestapelt, entfallen die Zahlen der Skala darunter. In einer schmalen Zelle entfallen bei
stehenden Balken, nebeneinander oder gestapelt, die Zahlen der Skala daneben, und eine Bezeichnung
unter einem Balken, die nicht mehr passt, endet mit Auslassungspunkten. Der Tooltip über einem
Balken zeigt weiterhin seine Bezeichnung und seinen Messwert, und jeder Teil kehrt zurück, sobald
die Zelle Platz für ihn hat.

## Bereiche der Skala {#scale-bands}

Der Abschnitt **Skalierung** erklärt Abschnitte des Wertebereichs und was jeder bedeutet, über
denselben Editor für Bereiche, den sich jede Komponente der Visualisierung teilt. Auf einem
Balkendiagramm sind die Bereiche eine Palette: sie färben die Balken danach, wohin jeder
Messwert fällt, und sonst nichts. Es werden mehrere Messwerte auf einmal verglichen, es gibt
also keinen einen Abschnitt, *in* dem die Zeichnung steht, und deshalb tragen die Bereiche hier
kein Feld für ein Wort, und es wird keine Markierung für eine Referenz angeboten.

Jeder Bereich deckt alles bis zu seiner Grenze ab, von dort, wo der Bereich über ihm in der
Liste endete; ein Messwert hinter der letzten Grenze gehört zu keinem Bereich und behält die
verfasste Farbe des Balkens. Der Ton benennt die Bedeutung, also Unauffällig, Hinweis, Erfolg,
Vorsicht oder Kritisch, und das laufende Design entscheidet über die Farbe.

## Werkzeugkasten {#toolbox}

Der Abschnitt **Werkzeugkasten** wählt, welche Schaltflächen der Bediener auf diesem Diagramm
bekommt. Ein Vergleich hat keine Achse zum Begehen, es werden also nur die Werkzeuge angeboten,
die er einlösen kann; ist keines davon angekreuzt, wird gar keine Leiste gezeichnet.

| Werkzeug | Was es tut | Im Vorgabesatz |
|---|---|---|
| PNG speichern | Lädt die Zeichnung als PNG herunter. | ja |
| PNG kopieren | Legt die Zeichnung als PNG in die Zwischenablage. | ja |
| Vollbild | Füllt das Fenster mit diesem Diagramm. | ja |