Bedingte Tabellenanzeige

<< Click to Display Table of Contents >>

Navigation:  Datenmodifikation > Filterung >

Bedingte Tabellenanzeige

Die Darstellung bzw. Unterdrückung von Tabelleninhalten kann an bestimmte Bedingungen geknüpft werden.

Definiert werden können:

Minimalwerte als Schwellenwerte zur Darstellung verschiedener Tabellenbereiche,

spezifische Inhalte wie konkrete numerische Werteausprägungen oder leere Tabellen.

Außerdem gibt es eine Reihe von Variablen- bzw. Label-Eigenschaften, die deren Darstellung innerhalb von Tabellen steuern.


Definition von Minimalwerten

Die lokale Variante dieser Statements wird jeweils dem aktuellen TABLE-Statement nachgestellt. Existiert eine jeweilige globale Voreinstellung, gilt diese für alle in der Folge definierten Tabellen.

[Global]CellMinimum

Option zum TABLE-Statement zur Unterdrückung kleiner Zellenbesetzungen

Syntax:

CELLMINIMUM = <value>;

Voreinstellung: 0.0001

Die Option CELLMINIMUM gibt an, ab welcher Minimalbesetzung eine Zelle in einer Tabelle als besetzt gilt und ausgegeben werden soll. In allen Zellen, in denen das Zellminimum nicht erreicht wird, wird ein »-« ausgegeben.

Beispiel:

CELLMINIMUM = 10;

Optionen beziehen sich immer auf die zuletzt angeforderte Tabelle. Sie werden deshalb immer nach der TABLE-Anweisung geschrieben. Schreibt man Optionen vor der ersten TABLE-Anweisung, führt dies zu einem syntaktischen Fehler. Die Optionen dienen dazu, »un-interessante« Zellen, Zeilen oder Spalten in der Tabelle zu unterdrücken. Empirisch unbesetzte Zeilen oder Spalten kann man ausgeben lassen, indem man ROWMINIMIM oder COLMINIMUM auf den Wert 0 setzt.

GLOBALCELLMINIMUM ist die globale Vorstellung für alle definierten Tabellen. Es gilt jeweils das zuletzte gesetzte GLOBALCELLMINIMUM.

[Global]ColMinimum

Option zum TABLE-Statement zur Unterdrückung kleiner n in Kopfvariablen

Syntax:

[GLOBAL]COLMINIMUM = <value>;

Voreinstellung: 0.0001

Es werden nur die Spalten ausgegeben, in denen mindestens die angegebene Fallzahl enthalten ist.

GLOBALCOLMINIMUM ist die globale Vorstellung für alle definierten Tabellen. Es gilt jeweils das zuletzte gesetzte GLOBALCOLMINIMUM.

[Global]RowMinimum

Option zum TABLE-Statement zur Unterdrückung kleiner n in der Seitengruppenvariable

Syntax:

[GLOBAL]ROWMINIMUM = <value>;

Voreinstellung: 0.0001

Es werden nur die Zeilen ausgegeben, in denen mindestens die angegebene Fallzahl enthalten ist.

GLOBALROWMINIMUM ist die globale Vorstellung für alle definierten Tabellen. Es gilt jeweils das zuletzte gesetzte GLOBALROWMINIMUM.

[Global]TableMinimum

Option zum TABLE-Statement

Syntax:

[GLOBAL]TABLEMINIMUM = <value>;

Man kann Tabellen vom Typ TABLE danach filtern, dass eine Minimalbesetzung an Fällen (Gesamt-N) vorliegt. Zur Unterdrückung der leeren Tabelle muss zusätzlich SUPPRESSEMPTYTABLE = YES; gesetzt sein.

Bei TABLE ADD-Konstrukten wird die Prüfung für die Subtabellen unterdrückt. Es wird nur die Starttabelle geprüft. Da aber Zählergebniss aller Tabellen (inkl. ADD) eingehen sollen, wird bei der resultierenden Tabelle die Summe aller FRAMECELLS betrachtet. Genauer formuliert: es werden alle Labels der ersten Variable im Kopf addiert, dann werden alle Labels der ersten Variable in der Y-Richtung addiert. Wenn beide n kleiner sind als das Minimum, gilt die Tabelle als leer.

RowCellMinimum

Option zum TABLE- bzw. XTAB-Statement

Syntax:

ROWCELLMINIMUM = <value>;

Eine Tabellenzeile wird unterdrückt, wenn nicht mindestens eine Zelle je Zeile eine absolute Besetzung von "<value>" hat.

SuppressIfLess

Statement zur Unterdrückung spezifischer Zellinhalte, die wegen zu geringer Basis nicht ausgewiesen werden sollen.

Syntax:

SUPPRESSIFLESS < cellelement> <place> <typ> = <value>;

place ::= < DATACELL | FRAMECELL X | FRAMECELL Y >
typ ::= < ABSOLUTE | PHYSICALRECORDS | VALIDN | VALIDPHYS | ESS >

Man kann sich mit "<place>" dabei auf die Tabellenzelle selbst beziehen, oder auf die Basiszellen im XFrame oder im YFrame. Innerhalb dieser Zellen kann man sich auf die Summe der Gewichte beziehen (ABSOLUTE), auf die ungewichteten Fälle (PHYSICALRECORDS), auf die gewichtete oder ungewichtete Basis, die gültig in einen Mittelwert etc. eingegangen ist (VALIDN / VALIDPHYS), oder auf die effective sample size (ESS).

Ein SUPPRESSIFLESS-Statement gilt für alle in der Folge definierten Tabellen und kann für die dann jeweils folgenden Tabellen durch einen weiteren SUPPRESSIFLESS-Befehl abgelöst werden.

Beispiele:

Um Mittelwerte zu unterdrücken, in die gewichtet weniger als als 10 gültige Fälle eingegangen sind, kann man schreiben:

SUPPRESSIFLESS MEAN DATACELL VALIDN = 10;

Um Spaltenprozente zu unterdrücken, bei denen die ungewichtete Basis weniger als 30 beträgt:

SUPPRESSIFLESS COLUMNPERCENT FRAMECELL X PHYSICALRECORDS = 30;

Um Colchiqu zu unterdrücken, wenn die effektive Basis im XFrame kleiner als 30 ist:

SUPPRESSIFLESS COLCHIQU FRAMECELL X ESS = 30;

Besonderheit: SuppressIfLess und Ranking

SUPPRESSIFLESS ist i.d.R. ein reiner Ausgabefilter; alle Berechnungen erfolgen ohne Berücksichtigung von SUPPRESSIFLESS. Erst bei der Generierung des Ausgabestrings wird die Bedingung ausgewertet und ggf. die Ausgabe durch den ZERODASHCHAR ersetzt. Insbesondere werden im Normalfall Sortierungen in der Tabelle aufgrund eines CELLELEMENTS mit "Ausfällen" durch SUPPRESSIFLESS durch die Unterdrückung nicht berührt. Auch nicht sichtbare CELLELEMENTS werden zur Sortierung herangezogen. Bei Sortierung nach COLMEANRANK, COLMEANINVRANK, COLPERCENTRANK und COLPERCENTINVRANK wurde dieses Standardverhalten durch ein abweichendes Verfahren ersetzt: Durch SUPPRESSIFLESS unterdrückte Inhalte werden bei diesen CELLELEMENTS immer ans Ende der Tabelle sortiert.


Unterdrücken definierter Inhalte

SupressEmptyTable

Tabellenspezifische Voreinstellung zur optionalen Unterdrückung leerer Tabellen: der Befehl wird an alle Tabellen weitergegeben, die im Anschluss formuliert werden, bis es eine neue SUPPRESSEMPTYTABLE-Voreinstellung gibt.

Syntax:

SUPPRESSEMPTYTABLE = [ NO | YES | STRUCTURE ];

Default: NO

In für Endkunden bestimmten Läufen wird SUPRESSEMPTYTABLE gewöhnlich auf YES gesetzt: leere Tabellen werden dann nicht ausgewiesen. NO führt zur Ausgabe eines Tabellenrahmens ohne Inhalt. mit Anzeige eines konfigurierbaren Texts.

Die Option STRUCTURE gibt die Struktur von Tabellen vom Typ TABLE aus, d.h. alle Zellen werden mit ihrer Besetzung n=0 ausgegeben. Entsprechende Informationen liegen für Tabellen vom Typ CODEBOOK nicht vor. STRUCTURE wird so interpretiert, dass leere Tabellen in der Ausgabe kenntlich gemacht werden sollen, es erscheint an dieser Stelle dann der EMPTYTABLETEXT.

Tabellen können auch leer werden, weil keine ihrer Spalten/Zeilen mindestens mittels [GLOBAL]COLMINIMUM/[GLOBAL]ROWMINIUMUM definierte Fallzahlen enthält. Wenn in einem solchen Fall SUPPRESSEMPTYTABLE auf STRUCTURE gesetzt ist, ist eine Ausgabe der Tabelle als STRUCTURE nicht möglich: in diesem Fall wird der EMPTYTABLETEXT ausgegeben. Es ist möglich, dass eine mit SUPPRESSEMPTYTABLE=STRUCTURE; unterdrückte Tabelle nicht als Struktur ausgegeben werden kann, z.B. wenn Variablen keine Labels haben. Sie wird dann wie SUPPRESSEMPTYTABLE=NO; behandelt.

Wenn eine Tabelle aufgrund von SUPPRESSEMPTYTABLE=YES; unterdrückt wird, wird dies in den Warnungen (gtc.wrn) protokolliert. Bei STRUCTURE oder NO hinterlässt die unterdrückte Tabelle eine Spur in den Ausgabedateien, dies wird nicht protokolliert.

EmptyTableText

Text für bzw. anstelle leerer Tabellen

Syntax:

EMPTYTABLETEXT = „<text>“;

Enthält eine Tabelle keine Werte, wird der EMPTYTABLETEXT als TABLETITLE eines alleinstehenden Tabellenkopfes.

Ist SUPPRESSEMPTYTABLE = YES; gesetzt, erscheint der Text nicht in der Druckausgabe, sondern als Warnung.

PrintSuppressValue

Tabellenspezifische Voreinstellung zur optionalen Unterdrückung definierter numerischer Werte: der Befehl wird an alle Tabellen weitergegeben, die im Anschluss formuliert werden, bis es eine neue PRINTSUPPRESSVALUE-Voreinstellung gibt.

Syntax:

PRINTSUPPRESSVALUE = <number>;

Berechnungsergebnisse mit diesem bestimmten numerischen Wert werden nicht dargestellt, sondern durch den ZERODASHCHAR ersetzt. Wirkt sich auf alle folgenden Tabellen aus.

ColPercentLineLimit

Syntax:

COLPERCENTLINELIMIT = <number>;

Eine Zeile wird unterdrückt, wenn nicht mindestens eine Zelle einen Spaltenprozentwert von "<number>" hat.


Relevante Variablen- und Labeleigenschaften

Syntax:

<Keyword> <varlist> = [ YES | NO ];

NOEXPANDAT

Variablen-Eigenschaft: Kein Textersatz (z.B. @varname) für diese Variable(n)

[GLOBAL]PRINTALL

Variablen-Eigenschaft: Auch ungelabelte Werte in Tabelle ausgeben

STOREALPHA

Variablen-Eigenschaft: Variablenwert nicht als Code, sondern als Zeichenkette ausgeben

LEVEL

Label-Eigenschaft: Steuerung bedingter Tabellenanzeige für einzelne Labels