HISTOGRAM-Befehl

Gruppiert Datensätze auf Basis von Werten in einem Zeichenfeld oder einem numerischen Feld, zählt die Anzahl der Datensätze in jeder Gruppe und zeigt die Gruppen und Auszählungen in einem Balkendiagramm an.

Syntax

HISTOGRAM {<ON> Zeichenfeld|<ON> numerisches_Feld MINIMUM Wert MAXIMUM Wert {<INTERVALS Zahl>|FREE Intervallwert <...n> letztes_Intervall}} <TO {SCREEN|Dateiname|GRAPH|PRINT}> <IF Test> <WHILE Test> <FIRST Bereich|NEXT Bereich> <HEADER Kopfzeilentext> <FOOTER Fußzeilentext> <KEY Trennfeld> <SUPPRESS> <COLUMNS Zahl> <APPEND> <OPEN>

Parameter

Name	Beschreibung
ON Zeichenfeld	Das Zeichenfeld oder der Ausdruck, das/der für das Histogramm verwendet werden soll.
ON numerisches_Feld	Das numerische Feld oder der Ausdruck, das/der für das Histogramm verwendet werden soll.
MINIMUM Wert	Nur für numerische Felder anwendbar. Der Mindestwert des ersten numerischen Intervalls. MINIMUM ist optional, wenn Sie FREE verwenden, ansonsten muss es angegeben werden.
MAXIMUM Wert	Nur für numerische Felder anwendbar. Der Maximalwert des letzten numerischen Intervalls. MAXIMUM ist optional, wenn Sie FREE verwenden, ansonsten muss es angegeben werden.
INTERVALS Zahl Optional	Nur für numerische Felder anwendbar. Die Anzahl der gleich großen Intervalle, die von Analytics im Bereich zwischen Minimal- (MINIMUM) und Maximalwert (MAXIMUM) erstellt werden. Wenn Sie keine Anzahl von Intervallen angeben, wird der Standardwert verwendet. Der Standardwert wird im Dialogfeld Optionen auf der Registerkarte Befehl im Feld Intervalle festgelegt.
FREE Intervallwert <...n> Letztes_Intervall Optional	Nur für numerische Felder anwendbar. Erstellt benutzerdefinierte Intervalle, indem je Intervall der Anfangspunkt sowie der Endpunkt des letzten Intervalls angegeben werden. Wenn Sie Werte für MINIMUM und MAXIMUM festlegen, sind diese Werte der Anfangspunkt des ersten Intervalls und der Endpunkt des letzten Intervalls. Durch jeden Intervallwert wird dann ein zusätzliches Intervall innerhalb des Bereichs erstellt. Die von Ihnen angegebenen Intervallwerte müssen größer als der Wert MINIMUM und genauso groß oder kleiner als der Wert MAXIMUM sein. Intervallwerte müssen in numerischer Reihenfolge angegeben werden und dürfen keine doppelten Werte enthalten: FREE -1000; 0; 1000; 2000; 3000 Wenn Sie sowohl FREE als auch INTERVALS angeben, wird INTERVALS ignoriert.
TO SCREEN \| Dateiname \| GRAPH \| PRINT	Der Ort, an den die Ergebnisse des Befehls gesendet werden sollen: SCREEN Zeigt die Ergebnisse im Analytics-Anzeigebereich an. Tipp Sie können auf jeden verknüpften Ergebniswert im Anzeigebereich klicken, um einen Drill-Down auf die zugeordneten Datensätze innerhalb der Quelltabelle durchzuführen. Dateiname Speichert die Ergebnisse in einer Datei. Geben Sie Dateiname als Zeichenfolge in Anführungszeichen mit einer geeigneten Dateierweiterung an. Beispiel: TO "Ausgabe.TXT" Standardmäßig wird die Datei im Ordner mit dem Analytics-Projekt gespeichert. Verwenden Sie entweder einen absoluten oder relativen Dateipfad, um die Datei in einen anderen bestehenden Ordner zu speichern: TO "C:\Ausgabe.TXT" . TO "Ergebnisse\Ausgabe.TXT" GRAPH Zeigt die Ergebnisse in einem Diagramm im Analytics-Anzeigebereich an. PRINT Sendet die Ergebnisse an den Standarddrucker. Hinweis In eine Datei ausgegebene Histogrammergebnisse werden als Textdarstellung eines Balkendiagramms angezeigt.
IF Test Optional	Ein bedingter Ausdruck, der wahr sein muss, damit ein Datensatz verarbeitet wird. Der Befehl wird nur für Datensätze ausgeführt, welche die Bedingung erfüllen. Hinweis Der IF-Parameter wird nur für Datensätze ausgewertet, die nach Anwendung von Bereichsparametern (WHILE, FIRST, NEXT) in einer Tabelle übrig sind.
WHILE Test Optional	Ein bedingter Ausdruck, der wahr sein muss, damit ein Datensatz verarbeitet wird. Der Befehl wird ausgeführt, bis die Bedingung falsch ist oder das Tabellenende erreicht wurde. Hinweis Wenn Sie WHILE zusammen mit FIRST oder NEXT verwenden, endet die Datensatzverarbeitung, sobald eine Grenze erreicht wird.
FIRST Bereich \| NEXT Bereich Optional	Die Anzahl der zu verarbeitenden Datensätze: FIRST Verarbeitung beim ersten Datensatz beginnen, bis die angegebene Datensatzanzahl erreicht wird NEXT Verarbeitung beim aktuell ausgewählten Datensatz beginnen, bis die angegebene Datensatzanzahl erreicht wird Verwenden Sie Bereich, um die Anzahl der zu verarbeitenden Datensätze anzugeben. Wenn Sie FIRST und NEXT nicht angeben, werden standardmäßig alle Datensätze verarbeitet.
HEADER Kopfzeilentext Optional	Der Text, der am Anfang jeder Seite eines Berichts eingefügt wird. Kopfzeilentext muss als eine in Anführungszeichen gesetzte Zeichenfolge angegeben werden. Der Wert überschreibt die Analytics-Systemvariable HEADER.
FOOTER Fußzeilentext Optional	Der Text, der am Ende jeder Seite eines Berichts eingefügt wird. Fußzeilentext muss als eine in Anführungszeichen gesetzte Zeichenfolge angegeben werden. Der Wert überschreibt die Analytics-Systemvariable FOOTER.
KEY Trennfeld Optional	Das Feld oder der Ausdruck zur Gruppierung der Zwischensummenberechnungen. Bei jeder Änderung des Werts von Trennfeld wird eine Zwischensumme berechnet. Trennfeld muss ein Zeichenfeld oder -ausdruck sein. Sie können nur ein einziges Feld angeben. Es kann jedoch auch ein Ausdruck verwendet werden, der mehrere Felder enthält.
SUPPRESS Optional	Werte über dem Wert MAXIMUM und unter dem Wert MINIMUM werden von der Befehlsausgabe ausgeschlossen.
COLUMNS Zahl Optional	Die Länge der X-Achse in der Textdarstellung des Balkendiagramms, wenn Sie Histogrammergebnisse in eine Textdatei ausgeben. Der Wert Zahl ist die Anzahl der Zeichen (Textspalten), die für die X-Achse und die Bezeichnungen der Y-Achse verwendet werden. Wenn Sie COLUMNS nicht angeben, wird der Standardwert von 78 Zeichen verwendet.
APPEND Optional	Hängt die Befehlsausgabe an das Ende einer vorhandenen Datei an, statt die Datei zu überschreiben. Hinweis Vergewissern Sie sich, dass die Struktur der Befehlsausgabe und der bestehenden Datei identisch sind: dieselben Felder dieselbe Feldanordnung abzugleichende Felder mit derselben Länge abzugleichende Felder mit demselben Datentyp Analytics hängt eine Ausgabe an eine bestehende Datei beliebiger Struktur an. Falls die Struktur der Ausgabe und der bestehenden Datei nicht übereinstimmen, kann die Datenintegrität verletzt sein, es können Daten fehlen oder falsch sein.
OPEN Optional	Öffnet die durch den Befehl erstellte Tabelle, nachdem der Befehl ausgeführt wird. Nur gültig, wenn der Befehl eine Ausgabetabelle erstellt.

Beispiele

Grundlegendes Histogramm für Stundenlöhne

Sie verwenden HISTOGRAM, um ein Diagramm mit der Verteilung der Stundenlöhne zwischen 0 und 100 Dollar zu erstellen:

HISTOGRAM ON Tarif MINIMUM 0 MAXIMUM 100 TO GRAPH

Histogramm mit definierten Intervallen für Stundenlöhne

Als Fortsetzung des vorigen Beispiels verwenden Sie HISTOGRAM, um die Diagrammbereiche sinnvoller festzulegen.

Die meisten Stundenlöhne liegen zwischen 20 und 50 Dollar. Daher umfasst das Diagramm die folgende Anzahl von Intervallen:

drei im Bereich von 20 bis 50
eines für 0 bis 20
eines für 50 bis 100
eines für über 100

HISTOGRAM ON Tarif MINIMUM 0 MAXIMUM 100 FREE 20;30;40;50;100 TO GRAPH

Bemerkungen

Hinweis

Weitere Informationen über die Funktion dieses Befehls finden Sie in Hilfe für Analytics.

Niedrige und hohe Werte füllen

Sie können die Befehle STATISTICS oder PROFILE vor der Ausführung des Befehls HISTOGRAM für ein numerisches Feld durchführen, um die Parameterwerte MINIMUM und MAXIMUM automatisch mit den niedrigsten und höchsten Werten des Felds zu füllen.

Verbundene Befehle

Das Erstellen eines Histogramms für ein Zeichenfeld ähnelt dem Klassifizieren. Das Erstellen eines Histogramms für ein numerisches Feld ähnelt der Verteilung.

Anders als andere Gruppierungsoperationen in Analytics unterstützen Histogramme keine Zwischensummen numerischer Felder.