DataLab is a compact statistics package aimed at exploratory data analysis. Please visit the DataLab Web site for more information....



List of Script Commands

Script files have the default extension .ISC. The commands of a script file follow the syntax definition below:

General guidelines:

  • 1 line per command (except of the commands ARIADNE and MATH)
  • parameters in parentheses
  • elements of a chart are addressed by separating dots (much like OOPS Pascal syntax)
  • values are assigned by '=' sign
  • comments must start with a semicolon as the first character of the line

Available commands:

Command Description
Ariadne (align, size)....
/Ariadne
Displays simple HTML text between the keywords Ariadne and /Ariadne in a separate Ariadne window. Note that the Ariadne keywords have to be stored in separate lines. The Ariadne system is a script controlled help system to guide users when entering DataLab using a DataLab script.

The format of the Ariadne window can be adjusted by the parameters align and size. align defines the alignment of the window (allowed values: LEFT, RIGHT, TOP, and BOTTOM). size specifies the width or the height of the Ariadne window in pixels.

Hint: The Ariadne help text may contain button icons to point the user to a particular button.

Chart [cnum] See script command "chart" for details
CloseAllCharts Closes all visible charts. Matrix view is not affected.
CorrelFunc (f1, f2, vis1, vis2, visScat) The command CorrelFunc brings up the correlation function window using the features f1 and f2 as the selected variables. The flags vis1, vis2, and visScat (true or false) determine which of the charts is visible (the first variable, the second variable, and the scatter plot besides the correlation function).
Data See script command "data" for details
DefaultWinSize (dx,dy) Sets the default size of the chart windows. This size is used by the command WinArrange. The parameters dx and dy specify the width and the height of the windows.
Fill (ulx,uly,lrx,lry,fillvalue) Fills the range [ulx,uly] ... [lrx,lry] of the data matrix by the value fillvalue.
Filter (Mode, Width, Range, Storage) See script command "filter" for details
FilterCoeffs (Width, [a1, a2, ..., ai], [b1, b2, ..., bi]) See script command "filtercoeffs" for details
ImportASCFile (FileName) Imports the data file specified by FileName. If the filename does not contain any path information, DataLab tries to find the file in the directory where the script has been loaded from. If the file cannot be found there the work directory is searched for. Finally, if the file is not contained in the work directory an error message is displayed. The format of the data file has to comply with the ASC format specification.
Initialize This command resets DataLab to a defined state. All diagram will be closed and the data matrix will be erased. The size of the data matrix is set to 5 columns and 100 rows.
LoadIDTFile (Filename) If the filename does not contain any path information, DataLab tries to find the file in the directory where the script has been loaded from. If the file cannot be found there the work directory is searched for. Finally, if the file is not contained in the work directory an error message is displayed. Load a data file stored in IDT format.
MarkData (ulx,uly,lrx,lry,mt) Marks all data in the range [ulx,uly] ... [lrx,lry] using the marking type mt. The parameters ulx, and uly specify the cell coordinates of the upper left cell of the cell range to be marked, the parameters lrx and lry specify the lower right cell of this area. The cell coordinates may be set to the constants NROW or NCOL, as well. The parameter mt may assume the values 'A', 'B', or 'AB', and defines the type marks to be applied.

Example:

Markdata (1,1,2,5,A) marks the cells [1,1] to [2,5] as type A.
Markdata (3,1,3,nrow,AB) marks all cells of column 3 as both type A and B.
Math.../Math The keywords MATH and /MATH identify a section containing mathematical formulas. This section must not contain any other script commands.
MinVers (vnum) Specifies the minimum release number vnum required to run this script. If DataLab is older than the specified version then the script issues a warning message. vnum has to be specified as floating point number with 3 decimal places.
MLRCalc Enters the MLR calculation window.
NewChart (cnum) Creates and displays an empty chart using chart number cnum. If a chart with number cnum already exists, NewChart has no effect at all. The parameter cnum may be omitted. In this case a chart with the first available number is created.
Resize (NrCols, NrRows) Resize the data matrix. The parameters NrCols and NrRows define the new size of the matrix.
Rot3D (c1, c2, c3) Displays the 3D rotation window using the variables c1, c2, and c3.
ScaleCols (SclType, VarList) Scaling of selected columns. The parameter SclType controls the type of the applied scaling, the parameter VarList specifies the affected columns. SclType may assume the following values: meancenter, standardize, sum=AAA, max=AAA, range(AAA:BBB); AAA and BBB are numeric values.
The parameter VarList contains the list of columns which are to be scaled. The column numbers have to be separated by commas, contiguous ranges of columns may be specified by "v:w" (v is the first, w the last column number of the range).

Examples:

ScaleCols (standardize, 3, 7:9) standardizes the columns 3,7,8, and 9
ScaleCols (sum=100, 1:10) scales the columns 1 to 10, so that the sum of all values in a column equals 100
ScaleCols (range(-1:1),2,3,10) scales the columns 2, 3 and 10, so that the values in each column span a range between -1 and +1.
ScaleRows (SclType, VarList) Scaling of selected rows. The parameter SclType controls the type of the applied scaling, the parameter VarList specifies the affected rows. SclType may assume the following values: meancenter, standardize, sum=AAA, max=AAA, range(AAA:BBB); AAA and BBB are numeric values.
The parameter VarList contains the list of rows which are to be scaled. The column numbers have to be separated by commas, contiguous ranges of rows may be specified by "v:w" (v is the first, w the last column number of the range).

Examples:

ScaleRows (meancenter, 1:3, 7:9) mean-centers the rows 1, 2, 3, 7, 8, and 9
ScaleRows (max=50, 3,7,9) scales the rows 3, 7 and 9, so that the maximum absolute value in a row equals 50
Sort (Dir, SortCrit, ulx,uly,lrx,lry) Sorts the data matrix according to the specified parameters. Dir defines the direction of sort (valid values asc (ascending) and desc (descending)), SortCrit specifies the sort criterion (valid values are cx (column number, e.g. "c6"), rx (row number, e.g. "r2"), class, colname and rowname), and ulx, uly, lrx, lry control the sorting range. The parameters ulx and uly specify the cell coordinates of the upper left cell of the sorting range, the parameters lrx and lry the lower right cell of this range. In order to sort the entire range of columns or rows, the corresponding parameters may be set to -1. The sort criterion will always be sorted, even if it is not part of the sorting range. The row and column names are also always sorted (depending on the sort criterion).

Examples:

Sort (asc, c1, -1,-1,-1,-1) sorts the entire matrix so that the values in the first column are arranged in ascending order.
Sort (desc, c6, 1,-1,3,-1) sorts the columns 1,2,3, and 6 so that the column 6 is arranged in descending order of its values (the sorting range contains all cells of the columns 1 to 3; column 6, which is the sort criterion, is sorted as well.
Sort (asc, rowname, 1,-1,1,-1) sorts the first column of the matrix so that the row names are arranged in ascending alphabetic order.
Summary: text The comment text is displayed in the file dialog when selecting the script file.
StatTests Opens the statistical tests form
UnmarkData (ulx,uly,lrx,rxy,mt) Unmarks all data in the range [ulx,uly] ... [lrx,lry] using the marking type mt. The parameters ulx, and uly specify the cell coordinates of the upper left cell of the cell range to be marked, the parameters lrx and lry specify the lower right cell of this area. The cell coordinates may be set to the constants NROW or NCOL, as well. The parameter mt may assume the values 'A', 'B', or 'AB', and defines the type marks which are to be removed.

Example:

Unmarkdata (1,1,2,5,B) removes all marks of type B from the cells [1,1] to [2,5].
Unmarkdata (1,1,ncol,nrow,AB) resets all markings of the entire data matrix.
WinArrange Tiles windows on screen
ZoomNorm (cnum) Sets the range of the chart cnum to display all available data


Last Update: 2012-Sep-04