Format der Skriptdateien
Skriptdateien haben die Dateierweiterung .ISC. Für die Befehle einer Skriptdatei gelten folgende Richtlinien:
- 1 Zeile pro Befehl (ausgenommen die Befehle ARIADNE und MATH)
- Parameter zu Befehlen werden in runden Klammern eingefügt, Referenzen in eckigen Klammern
- Elemente einer Graphik sind durch trennende Punkte adressiert (ähnlich zur Pascal Syntax)
- Werte werden durch das '=' Zeichen zugewiesen
- Bemerkungen und Kommentare müssen mit einem Strichpunkt als erstem Zeichen der Zeile beginnen
Verfügbare Befehle
| Befehl |
Beschreibung |
Ariadne (align, size)....
/Ariadne |
Stellt einen HTML-Text zwischen den Schlüsselwörtern Ariadne und /Ariadne in einem separaten Ariadne-Fenster dar. Beachten Sie, dass die Ariadne-Schlüsselwörter jeweils in einer separaten Zeile gespeichert werden müssen. Das Ariadne-System ist ein skriptgesteuertes Hilfesystem, das den Benutzer leitet, wenn er DataLab über Skripts betritt.
Das Format des Ariadne-Fensters kann durch die Parameter align und size angepasst werden. align legt die Ausrichtung fest (mögliche Werte: LEFT, RIGHT, TOP, und BOTTOM). size gibt die Breite bzw. Höhe des Ariadne-Fensters in Pixel an.
Hinweis: Das Ariadne-Hilfesystem kann Knopf-Icons anzeigen, um den Benutzer auf einen bestimmten Knopf aufmerksam zu machen. |
| Chart [cnum] |
Das ist kein Befehl, sondern eine Referenz zur Graphiknummer cnum. Zugang zu den Eigenschaften der Graphik kann erlangt werden, in dem der Name der Eigenschaft getrennt durch einen Punkt angehängt wird.
| Chart[cnum].DataColor=value |
Die Farbe der Daten |
| Chart[cnum].ScaleColor=value |
Die Farbe der Skalen- und Achsenbeschriftungen |
| Chart[cnum].BackGndColor=value |
Die Hintergrundfarbe |
| Chart[cnum].FillColor=value |
Die Füllfarbe des Diagrammfensters |
| Chart[cnum].Width=value |
Die Breite des Diagrammfensters. |
| Chart[cnum].Height=value |
Die Höhe des Diagrammfensters. |
| Chart[cnum].Left=value |
Die Position des linken Randes des Diagrammfensters. |
| Chart[cnum].Top=value |
Die Position des oberen Randes des Diagrammfensters. |
| Chart[cnum].Mode=value |
Der Diagramm-Modus kann entweder LINES, POINTS, SPECTRUM, oder CLFLINES sein. Der Modus POINTS akzeptiert einen zusätzlichen Parameter (1..25), der die Markierungsart definiert. |
| Chart[cnum].KindOfChart=value |
Diagrammtyp. Folgende Werte können zugewiesen werden: COLIDX, COLCOL, ROWIDX, ROWROW, HISTOGRAM, PROBPLOT, CUMUDIST. Für jeden Diagrammtyp können in runden Klammern weitere Details spezifiziert werden. Werden keine Details angegeben, so werden die zuletzt verwendeten Einstellungen wirksam.
|
| Chart[cnum].XAxis=axnum |
Index der Zeilen/Spalten, die für die x-Achse einer Darstellung verwendet werden. Die Spezifikation der axnum muss nicht für alle Diagramme gültig sein. |
| Chart[cnum].YAxis=axnum |
Index der Zeilen/Spalten, die für die y-Achse einer Darstellung verwendet werden. Die Spezifikation der axnum muss nicht für alle Diagramme gültig sein. |
| Chart[cnum].Axis=axnum |
Index der Zeilen/Spalten der Standardachsen |
|
| CloseAllCharts |
Schließt alle sichtbaren Diagramme. Der Blick auf die Matrix ist nicht betroffen. |
| CorrelFunc (f1, f2, vis1, vis2, visScat) |
Der Befehl CorrelFunc öffnet das Korrelationsfunktions-Fenster, in dem er die Funktionen f1 und f2 als gewählte Variablen betrachtet. Die Marker vis1, vis2, und visScat (wahr oder falsch) legen fest, welches der Diagramme sichtbar ist (die erste Variable, die zweite Variable und die Streudarstellung neben der Korrelationsfunktion). |
| Data |
Das Schlüsselwort Data ist eine Referenz auf die Datenmatrix von DataLab und ermöglicht den Zugriff auf einzelne Teile der Matrix durch Anhängen eines Punktes und eines der folgenden Bezeichner: ELEM, COLNAME, ROWNAME, STATE, und CLASS.
| Data.Elem[cn,rn]=value |
Speichert den Wert value in der Zelle an der Stelle [cn,rn]. cn und rn ist der Spalten- bzw. Zeilenindex. Der Parameter value kann jeder beliebige erlaubt Wert sein (hängt vom Skalentyp der Variablen ab). |
| Data.ColName[cn]=name |
Setzt den Namen der Spalte cn auf den Bezeichner name. |
| Data.RowName[rn]=name |
Setzt den Namen der Zeile rn auf den Bezeichner name. |
| Data.State[cn,rn]=keywords |
Setzt die Zelle an der Stelle [cn,rn] auf den Zustand der durch den Parameter keywords definiert wird. cn und rn ist der Spalten- bzw. Zeilenindex. Der Parameter keywords kann eine beliebige Kombination aus MARKA, MARKB, EMPTY, und RESET sein, die durch ein '+'-Zeichen miteinander verbunden werden. Bitte beachten Sie, dass der Bezeichner RESET alle anderen Bezeichner überschreibt und den Deafault-Zustand der Zelle herstellt. |
| Data.Class[rn]=cnum |
Setzt die Klassennummer der Zeile rn auf den Wert cnum. cnum kann Werte zwischen 0 und 255 annehmen. |
Hinweis: Jeder der rn und cn Parameter kann durch einen Stern (*) ersetzt werden um eine ganze Spalte oder eine ganze Zeile (oder die gesamte Matrix, falls beide durch Sterne ersetzt werden) zu beeinflussen.
Beispiele:
Data.Elem[3,*]=2.99 füllt alle Zellen der dritten Spalte mit dem Wert 2.99
Data.State[*,4]=MARKA+MARKB markiert alle Zellen der vierten Zeile als Typ A und B
Data.ColName[5]=Apples or Nuts setzt den Variablennamen der Spalte 5 auf "Apples or Nuts"
|
| DefaultWinSize (dx,dy) |
Legt die Standardgröße der Diagrammfenster fest. Die Größe wird vom Befehl WinArrange verwendet. Die Parameter dx und dy legen die Breite und Höhe des Fensters fest. |
| Fill (ulx,uly,lrx,lry,fillvalue) |
Füllt den Bereich [ulx,uly] ... [lrx,lry] der Datenmatrix mit dem Wert fillvalue |
| ImportASCFile (FileName) |
Importiert die Datendatei, die durch den FileName festgelegt ist. Falls kein Pfad im Dateinamen enthalten ist, wird zuerst versucht, die Datei im Verzeichnis zu finden, aus dem das Skript geladen worden ist. Ist die Datei dort nicht vorhanden, wird versucht die Datei im Arbeitsverzeichnis zu finden. Ist sie dort auch nicht, wird eine Fehlermeldung ausgegeben. Das Format der Datendatei muss mit den Spezifikationen des ASC-Formats übereinstimmen. |
| Initialize |
Bringt DataLab in einen definierten Anfangszustand. Dabei werden alle Diagramme geschlossen und die Datenmatrix gelöscht. Die Größe der Datenmatrix wird auf 5 Spalten und 100 Zeilen gestellt. |
| LoadIDTFile (Filename) |
Lädt eine Datendatei, die im IDT-Formats gespeichert wurde. Falls kein Pfad im Dateinamen enthalten ist, wird zuerst versucht, die Datei im Verzeichnis zu finden, aus dem das Skript geladen worden ist. Ist die Datei dort nicht vorhanden, wird versucht die Datei im Arbeitsverzeichnis zu finden. Ist sie dort auch nicht, wird eine Fehlermeldung ausgegeben. |
| MarkData (ulx,uly,lrx,lry,mt) |
Markiert alle Daten im Bereich [ulx,uly] ... [lrx,lry] mit der Markierungsart mt. Die Parameter ulx und uly legen die Zellenkoordinaten der linken oberen Zelle des Zellenbereiches fest, der markiert werden soll. Die Parameter lrx und lry legen die untere rechte Zelle dieses Bereiches fest. Der Parameter mt kann die Werte 'A', 'B', oder 'AB' annehmen, und legt die Art der Markierung fest, die angewendet wird.
Beispiel:
Markdata (1,1,2,5,A) markiert alle Zellen [1,1] bis [2,5] als Typ A.
|
| Math.../Math |
Die Schlüsselwörter MATH und /MATH markieren einen Abschnitt mit mathematischen Formeln. Innerhalb dieses Bereichs dürfen keine anderen Skriptbefehle stehen.
|
| MinVers (vnum) |
Spezifiziert die kleinste Versionsnummer vnum die das Skript benötigt um fehlerfrei zu laufen. Falls DataLab älter als die angegebene Version ist, wird eine Warnung ausgegeben. vnum muss als Gleitkommazahl mit 3 Kommastellen angegeben werden. |
| MLRCalc |
Öffnet das Fenster zur MLR Berechnung. Dieser Befehl öffnet ein modales Fenster. Daher blockiert es so lange alle folgenden Skriptbefehle, bis es wieder geschlossen wird. |
| NewChart (cnum) |
Erstellt und zeigt eine neues Datendiagrammfenster mit der Nummer cnum an. Falls ein Diagrammfenster mit der Nummer cnum bereits existiert, hat NewChart keine Auswirkungen. Gibt man keinen Parameter an, so wird ein Diagramm mit der nächsten verfügbaren Nummer erstellt. |
| Resize (NrCols, NrRows) |
Ändert die Größe der Datenmatrix. Die Parameter NrCols und NrRows legen die neue Größe der Matrix fest. |
| Rot3D (c1, c2, c3) |
Zeigt im 3D-Rotationsfenster die Variablen c1, c2, und c3 an. |
| ScaleCols (SclType, VarList) |
Skalierung ausgewählter Spalten. Der Parameter SclType bestimmt die Art der Skalierung, der Parameter VarList die von der Skalierung betroffenen Spalten. SclType darf folgende Werte annehmen: meancenter, standardize, sum=AAA, max=AAA, range(AAA:BBB); AAA und BBB sind jeweils numerische Werte.
Der Parameter VarList umfasst die Liste der Spalten, die entsprechend skaliert werden sollen. Die Variablennummern müssen mit Beistrichen getrennt werden, zusammenhängende Bereiche von Variablen können durch "v:w" spezifiziert werden (v ist die erste, w die letzte Nummer des Bereichs).
Beispiele:
ScaleCols (standardize, 3, 7:9) standardisiert die Spalten 3,7,8, und 9
ScaleCols (sum=100, 1:10) skaliert die Spalten 1 bis 10, so dass in jeder Spalte die Summe gleich 100 ist
ScaleCols (range(-1:1),2,3,10) skaliert die Spalten 2,3 und 10 so dass die Werte in jeder Spalte jeweils den Bereich von -1 bis +1 abdecken
|
| ScaleRows (SclType, VarList) |
Skalierung ausgewählter Zeilen. Der Parameter SclType bestimmt die Art der Skalierung, der Parameter VarList die von der Skalierung betroffenen Zeilen. SclType darf folgende Werte annehmen: meancenter, standardize, sum=AAA, max=AAA, range(AAA:BBB); AAA und BBB sind jeweils numerische Werte.
Der Parameter VarList umfasst die Liste der Variablen, die entsprechend skaliert werden sollen. Die Variablennummern müssen mit Beistrichen getrennt werden, zusammenhängende Bereiche von Variablen können durch "v:w" spezifiziert werden (v ist die erste, w die letzte Nummer des Bereichs).
Beispiele:
ScaleRows (meancenter, 1:3, 7:9) zentriert die Zeilen 1, 2, 3, 7, 8, und 9
ScaleRows (max=50, 3,7,9) skaliert die Zeilen 3, 7 und 9, so dass der maximale Absolutwert in diesen Zeilen jeweils gleich 50 ist
|
| Sort (Dir, SortCrit, ulx,uly,lrx,lry) |
Sortiert die Datenmatrix entsprechend der angegebenen Parameter. Dir gibt die Sortierrichtung an (gültige Werte asc (aufsteigend) und desc (absteigend)), SortCrit das Sortierkriterium (gültige Werte sind cx (Spaltennummer, z.B. "c6"), rx (Zeilennummer. z.B. "r2"), class, colname und rowname), und ulx, uly, lrx, lry definieren den Sortierbereich, in dem die Matrix sortiert werden soll. Die Parameter ulx und uly legen die Zellenkoordinaten der linken oberen Zelle des Sortierbereiches fest, die Parameter lrx und lry die rechte untere Zelle dieses Bereiches. Möchte man den gesamten Bereich sortieren, gibt man für die Bereichsparameter jeweils -1 ein. Das Sortierkriterium wird immer mit sortiert, auch wenn es außerhalb des Sortierbereichs liegt. Die Zeilen- und Spaltenbezeichner werden ebenfalls immer mitsortiert (je nach angegebenem Sortierkriterium).
Beispiele:
Sort (asc, c1, -1,-1,-1,-1) sortiert die gesamte Matrix so, dass die erste Spalte in aufsteigender Reihenfolge entsteht.
Sort (desc, c6, 1,-1,3,-1) sortiert die Spalten 1,2,3, und 6 so, dass Spalte 6 in absteigender Reihenfolge entsteht (der Sortierbereich umfasst alle Zeilen der Spalten 1 bis 3; Spalte 6 wird als Sortierkriterium ebenfalls mitsortiert.
Sort (asc, rowname, 1,-1,1,-1) sortiert die erste Spalte der Matrix so, dass die Zeilenbezeichner in aufsteigender alphabetischer Reihenfolge entstehen.
|
| Summary: text |
Der Kommentar text wird im Dialogfenster bei der Auswahl eines Skript angezeigt. |
| StatTests |
Öffnet das Formular für statistische Tests |
| UnmarkData (ulx,uly,lrx,lry,mt) |
Hebt die Markierung aller Daten im Bereich [ulx,uly] ... [lrx,lry] unter Verwendung der Markierungsart mt auf. Die Parameter ulx und uly legen die Zellenkoordinaten der linken oberen Zelle des Zellenbereiches fest, der markiert werden soll. Die Parameter lrx und lry legen die untere rechte Zelle dieses Bereiches fest. Der Parameter mt kann die Werte 'A', 'B', oder 'AB' annehmen, und legt die Art der Markierung fest, die entfernt werden soll.
Beispiel:
Unmarkdata (1,1,2,5,B) entfernt alle Markierungen der Art B von den Zellen [1,1] bis [2,5].
|
| WinArrange |
Ordnet die Fenster auf dem Bildschirm nebeinander an. |
| ZoomNorm (cnum) |
Setzt den Bereich des Diagrammfensters cnum so, dass all Daten sichtbar werden |
|
Technische Dokumentation 
