|
1.
|
|
2.
|
|
3.
|
|
4.
|
|
5.
|
Click OK.
|
All analysis platforms have a Script submenu with the commands shown here to create a JSL script that duplicates the analysis in its current state. These commands are choices for where to send that script.
Saves the script as a new property in the data table. In the data table window, you see the script named for the platform, and it has a pop-up menu to let you Run Script. Properties such as saved scripts are saved with the data table for later use. Many sample data tables have example scripts.
Saves the script for all objects within a multi-platform report in a script window, where you can view, edit, and submit it. An example is Fit Y by X, where various combinations of continuous, nominal, and ordinal columns result in Bivariate, Oneway, Contingency, and Logistic platform objects all within a single report. Save Script to Script Window saves only the script for the single object from which you selected the option. Save Script for All Objects saves the script for all objects within the window, regardless of which object’s menu option you used. Another example is that if you have By groups, Save Script for All Objects saves the script for all the BY group objects within the window, whereas Save Script to... captures the script for only the one group. All the BY groups appear in the same window when the report is re-run, because Save Script For All Objects wraps all By-variable analyses in a New Window() command. For example, a bivariate fit of height by weight grouped by males and females would result in the following script.
Displays a data table window with the BY group data associated with the analysis when it has By groups, and brings the data table window forward otherwise.
|
2.
|
From the same menu, select Compare Means > Each Pair, Student’s t.
|
|
3.
|
From the same menu, select Script > Save Script to Script Window.
|
The script records the choices that you made in the menu. Since these are all Boolean (on or off) options, they have an argument of 1 to turn them on. In addition to the options selected, three additional display options have been implied from the other commands given. Choices that you make in menus and their corresponding JSL commands have exactly the same effects.
You could submit this script to get exactly this report quickly, without all the interactive steps. To run a script from a script window, select the text and then either select Edit > Run Script, or type CONTROL-R (Windows) or COMMAND-R (Macintosh). If you select no text, the entire window is run.
All platform scripts start with a command to call the platform, in this case Oneway. Inside the Oneway command are two types of arguments: arguments like the Y and X column role lists are required at launch, and options like Each Pair(1) are sent to the platform after it is launched.
In most platforms, you can run the platform repeatedly across subgroups of the rows as defined by one or more by columns. To do this in scripts, include a By argument in the launch command, listing each column as the argument to By.
|
1.
|
This launch message produces a report window with two nodes in the outline, one for the rows of the data table where sex is “F” and a second for rows where sex is “M.” Rather than returning a reference to a platform, Bivariate[], the platform object returns a list of references {Bivariate[], Bivariate[]}:
Multiple columns listed for By() produce nodes for each subgroup. For example, By(sex, age) would produce nodes for females age 12, females age 13, ..., females age 17, males age 12, males age 13, ..., and males age 17.
The following shows how to launch a platform with BY groups and extract results from each group:
In addition to the Script submenu in an analysis platform, a Script All By-Groups submenu appears when appropriate. This submenu lets you save scripts to reproduce a report created with By groups. It contains the following options:
Note: To save a script to a data table, journal, or script window, use the Save ByGroup function. See the JMP Scripting Index for examples.