For the latest version of JMP Help, visit JMP.com/help.


JSL Syntax Reference > JSL Functions > Display Functions
Publication date: 11/10/2021

Display Functions

Alpha Shape(Triangulation())

Description

Returns the alpha shape for the given triangulation.

Border Box(<Left(pix)>, <Right(pix)>, <Top(pix)>, <Bottom(pix)>, <Sides(Boolean)>, db)

Description

Constructs a bordered display box that contains another display box. Optional arguments (Left, Right, Top, Bottom) add space between the border box and what it contains. The other optional argument (Sides) draws borders around the border box on any single side or combination of sides; draws the border in black or the highlight color; makes the background transparent or white or erases the background of a display box that contains it.

Returns

The display box.

Required Argument

db

A display box object (for example, a text box or another border box).

Optional Arguments

Left(pix)

An integer that measures pixels.

Right(pix)

An integer that measures pixels.

Top(pix)

An integer that measures pixels.

Bottom(pix)

An integer that measures pixels.

Sides(pix)

An integer that maps to settings for the display box.

Notes

The formula for deriving the integer for Sides is: 1*top + 2*left + 4*bottom + 8*right + 16*highlightcolor + 32*whitebackground + 64*erase. Thus, if you want to just draw a black border on the top and bottom, 1+4 = 5. If you want that same box with a white background, 5+32 = 37.

See Also

Border Box in the Scripting Guide

Box Plot Seg(<data>, <frequency>, <weight>, <Vertical(Boolean)>)

Description

Returns a display seg that represents a box plot based on the passed x and y values.

Returns

The display box (a box plot).

Optional Arguments

data

The data values within the box plot.

frequency

The frequency values within the box plot.

weight

The weights for observations on continuous Ys.

Vertical(Boolean)

A vertical (1) or horizontal (0) box plot.

Example

win = New Window( "Box Plot Seg Example",
Graph Box(
	Frame Size( 40, 180 ),
	Y Scale( 0, 100 ),
	Box Plot Seg(
		[20, 30, 40], // data
		[1, 1, 3], // frequencies
		[1, 1, 1], // weights
		1 // vertical
		)
	)
);

Busy Light(< <<Automatic(Boolean)>, <Size(x, y)>, < <<Disable>)

Description

Creates a rotating image to indicate a busy process.

Returns

A rotating image.

Optional Argument and Messages

<<Automatic(Boolean)

Rotates the image.

Size(x, y)

Specifies the size of the image in pixels.

<<Disable

Hides the image.

Example

win = New Window( "Example",
	blb = Busy Light( <<Automatic( 1 ), Size( 50, 50 ) ) );

Button Box(title, script, < <<Set Icon(path)>, < <<Set Icon Location(left|right)>

Description

Constructs a button with the text title that executes script when clicked.

Returns

The display box (button box).

Required Arguments

title

A quoted string or a string variable.

script

A quoted string or a reference to a string that specifies a valid JSL script.

Optional Messages

<<Set Icon("path")

Displays the image in the quoted pathname on the button. Most common graphic formats are supported, such as GIF, JPG, PNG, BMP, TIF. Since the title argument is optional, you can create a button with only a text title, with only an icon, or with both a text title and an icon. In the last case, the icon is placed next to the text title.

<<Set Icon Location("left"|"right")

Allows the position of the icon on a button to be either left or right of the text.

Example

The following example shows a simple button box. When the user clicks the button box, "Pressed" is printed to the log.

win = New Window( "Simple Example",
	ex = Button Box( "Press me" )
);
ex << Set Script( Print( "Pressed" ) );

Notes

Line-break characters are ignored in button boxes.

See Also

Button Box in the Scripting Guide

Calendar Box(title, < <<Date>, < <<Min Date>, < <<Max Date>, < <<Show Time>)

Description

Constructs a pop-up calendar with selectable days and time.

Returns

The display box (calendar box).

Required Argument

title

A quoted string or a string variable.

Optional Messages

<<Date

The currently selected date.

<<Min Date

The earliest date that can be selected.

<<Max Date

The latest date that can be selected.

<<Show Time

The time that can be specified.

Example

The following example creates a calendar with October 5, 1989 initially selected. The minimum date and maximum date are specified, so the user can select only dates in that range.

New Window( "Calendar Box Example", cal = Calendar Box() );
date = Date MDY (10, 5, 1989);
cal << Date( date );
cal << Show Time( 0 ); // omit the time
 
/* earliest date that can be selected is 60 days before 10/5/1989
"start" truncates the value so the time is not included */
cal << Min Date( Date Increment(date, "Day", -60, "start" ) );
 
// latest date that can be selected is 60 days after 10/5/1989
cal << Max Date( Date Increment(date, "Day",  60, "start" ) );
 
cal << Set Function( Function( {this}, Print( Abbrev Date(this << Get Date()) ) ) ); // print the abbreviated date to the log

See Also

Calendar Box in the Scripting Guide

Cell Plot(Y(column(s)), <X(column)>)

Description

Displays each value in a cell graph.

Check Box({list}, <script>, < <<Get(n)>, < <<Set(n, Boolean)>, < <<Get Selected>, < <<Enable Item(n, Boolean)>, < <<Item Enabled(check box item)>)

Description

Constructs a display box to show one or more check boxes.

Returns

The display box (Check Box).

Required Argument

list

A list of quoted strings or a reference to a list of strings.

Optional Argument

script

An optional JSL script.

Optional Messages

<<Get(n)

Returns 1 if the check box item specified by n is selected, or 0 otherwise.

<<Set(n, Boolean)

Sets the check box item specified by n as either selected (1) or cleared (0).

<<Get Selected

Returns a list of quoted strings that contain the names of the check box items that are selected.

<<Enable Item(n, Boolean)

Sets the check box item specified by n as either enabled (1) or disabled (0). The state of a disabled check box cannot be changed.

<<Item Enabled(check box item)

Returns 0 or 1 depending on whether the specific check box item is enabled.

Example

Create three check boxes labeled “one”, “two”, and “three”. The first check box is selected.

New Window( "Example", Check Box( {"one", "two", "three"}, <<Set( 1, 1 ) ) );

See Also

Check Box in the Scripting Guide

Col Box(title, display boxes)

Description

Returns a column box made up of the specified display boxes.

Arguments

title

The quoted title of the column.

display boxes

Display boxes that hold content within the column box.

Example

win = New Window( "Example",
	exx = 1;
	exy = 4;
	exz = 8;
	Table Box(
		String Col Box( "strings", {"x", "y", "z"} ),
		Col Box(
			"boxes",
			Slider Box( 0, 10, exx, Show( exx ) ),
			Slider Box( 0, 10, exy, Show( exy ) ),
			Slider Box( 0, 10, exz, Show( exz ) )
		)
	);
);

Col List Box(<Data Table(name)>, <"All"|"Character"|"Numeric">, <width(pixels)>, <"Grouped">, <MaxSelected(n)>, <nLines(n)>, <MaxItems(n)>, <MinItems(n)>, <On Change(expr)>, < <<Modeling Type("Any"|"Continuous"|"Ordinal"|"Nominal"|Multiple Response"|"Unstructured Text"|"Vector"|"None"|"Row State") >, < <<Set Data Type(Any|Numeric|Character)>, <script>)

Description

Constructs a display box to show a list box that allows selection of data table columns.

Returns

The display box (Col List Box).

Optional Arguments

Data Table(name)

The quoted name of the data table.

"All" | "Character" | "Numeric"

Adds all columns of the current data table into the list. Omitting "All" results in an empty col list box with the “optional” label. To display “optional character”, specify "Character". To display “optional numeric”, specify "Numeric".

width(pixels)

Sets the width of the list box to pixels. pixels is a number that measures pixels.

"Grouped"

Displays grouped columns in the box.

MaxSelected(n)

Sets whether only one item can be selected. For n>1, n is ignored.

nLines(n)

Sets the length of the list box to n number of lines. n is an integer.

script

A script.

MaxItems(n)

A number that allows only n columns to be added to the list.

MinItems(n)

A number that only requires at least n columns for the list. If n=2, the top two slots in the col list box an initial display of “required numeric” (or whatever you set the data type to be).

On Change(expr)

Evaluates the expression when the selection in the list changes. Dragging between two column list boxes that have this argument results in both expressions being evaluated. The expression for the target being dragged is evaluated first, then the expression for the source is evaluated.

Optional Messages

<<Set Tips({Tip text 1, Tip text 2, ...})

Quoted strings that set tool tips for items in the list box. A quoted null string or an empty list results in no tips. A list shorter that the list of items in the list box will use the last tip text for the remaining items in the list and the list box.

<<Set Tip(Tip text)

A quoted string that overrides any tool tips set using Set Tips() function. If there is a tip set for the box, you cannot set tips for each individual item.

Using Set Tip() with no arguments clears the list box tip and allows the individual item tool tips to be displayed.

Notes

The MaxSelected(n) argument only affects whether one or more than one item can be selected. It does not enforce a limit greater than 1.

Specialty modeling types can be used only in a role (determined by the platform) that explicitly accepts columns of the same type.

See Also

Col List Box in the Scripting Guide

Col Span Box(title, display box args)

Description

Creates spanned columns headers inside a table box. The top column header spans two child column headers.

Returns

The display box (a Col Span Box).

Arguments

title

The title that appears in the box.

display box args

Display boxes.

Example

win = New Window( "Col Span Box",
	<<Modal,
	Table Box(
		Col Span Box(
			"Confidence Limits",
			neb = Number Col Edit Box( "Upper limits", [0, 0] ),
			Number Col Edit Box( "Lower limits", [0, 0] )
		)
	)
);

See Also

Col Span Box in the Scripting Guide

Combo Box({items <(tip string)>, ...}, <script>)

Description

Constructs a display box to show a drop-down list.

Returns

The display box (Combo Box).

Arguments

items

The items that the user can select.

tip string

A quoted string that specifies tooltip text.

script

An optional JSL script.

See Also

Combo Box in the Scripting Guide

Context Box(display box, ...)

Description

Defines a scoped evaluation context. Each Context Box is executed independently of each other.

Returns

A display box.

Arguments

Any number of display boxes.

Contour Seg(Triangulation, [levels], <zColor([colors]|{colors}, <"Cycle Colors"|"Interpolate Colors">)>, <"Fill"|"Fill Between"|"Fill Below"|"Fill Above">, <Transparency([]|t)>)

Description

Returns a display seg that represents contours of a Triangulation.

Required Arguments

Triangulation

The columns to include in the Triangulation.

[levels]

A matrix of values that control the contour levels that are drawn.

Optional Arguments

zColor([colors]|{colors}

Colors for each level, specified as a list or matrix.

"Cycle Colors"|"Interpolate Colors

Cycle Colors" alternates the colors (for example, red, green, red, green). With Interpolate Colors, the first contour is red, and the last is green. The contours between smoothly blend the colors.

"Fill Below"|"Fill Between"|"Fill Above"|"Fill"

"Fill Below" fills the region below the lines. "Fill Between" fills only the middle region. "Fill Above" fills the region above the lines.. "Fill" works like "Fill Above", but the default is to display lines if no Fill options are specified.

Transparency([]|t)

The transparency specified as a number or matrix.

Example

dt = Open( "$SAMPLE_DATA/Cities.jmp" );
tri = Triangulation( X( :X, :Y ), Y( :POP ) );
{xx, yy} = tri << Get Points();
win = New Window( "Contour Seg Example",
	g = Graph Box(
		X Scale( Min( xx ) - .1, Max( xx ) + .1 ),
		Y Scale( Min( yy ) - .1, Max( yy ) + .1 ),
		Contour Seg(
			tri,
			[0, 400, 1000, 2000, 9000],
			zColor( 5 + [64 32 0 16 48] ),
			Transparency( [1, 1, 1, 1, 1] )
		)
	)
);

Notes

The triangulation is computed using the Xs, and the Y is a continuous variable defined at each position. The [levels] in this case defines values of POP that are drawn as lines, one line per level. If any Fill argument is specified, then the filled regions are [level1, level2], [level2, level3], ..., [level-n].

Current Journal()

Description

Gets the display box at the top of the current (topmost) journal.

Returns

Returns a reference to the display box at the top of the current journal.

See Also

Current Journal in the Scripting Guide

Current Report()

Description

Gets the display box at the top of the current (topmost) report window.

Returns

Returns a reference to the display box at the top of the current report window.

Current Window()

Description

Returns a reference to the current window.

Data Filter Context Box(display box)

Description

Returns a display box that defines the extent of the local data filters that a display tree contains. Data filters and Data Filter Context Boxes can be arranged in a hierarchy and shared among platforms or boxes that the Data Filter Context Boxes contain.

See Also

Filtering Display Boxes in the Scripting Guide

Data Filter Source Box(display box)

Description

Defines which graph is the “source” of the selection filter. Selected rows in reports that are within the Data Filter Source box are included for analysis in the other reports that are within a common Data Filter Context Box.

See Also

Filtering Display Boxes in the Scripting Guide

Data Table Box(data table)

Description

Returns a table box the represents the specified data table.

Example

dt = Open( "$SAMPLE_DATA/Big Class.jmp" );
win = New Window( "Example", Data Table Box( dt ) );

Data Table Col Box(column)

Description

Returns a column box that corresponds to the specified data table column.

Example

dt = Open( "$SAMPLE_DATA/Big Class.jmp" );
win = New Window( "Example",
	Table Box( Data Table Col Box( :name ), Data Table Col Box( :height ) )
);

Dialog(contents)

Description

Dialog is deprecated. Use New Window() with the Modal argument instead.

See Also

Convert Deprecated Dialog to New Window in the Scripting Guide

Excerpt Box(report, subscripts)

Description

Returns a display box containing the excerpt designated by the report held at number report and the list of display subscripts subscripts. The subscripts reflect the current state of the report, after previous excerpts have been removed.

Expr As Picture(Expr(...), <Width(pixels)>)

Description

Converts expr() to a picture as it would appear in the Formula Editor.

Returns

Reference to the picture.

Required Argument

Expr(...)

Place any valid JSL expression that can be displayed as a picture inside expr().

Optional Argument

Width(pixels)

Sets the width of the box to pix. pix is a number that measures pixels.

See Also

Picture Object in the Scripting Guide

Filter Col Selector(<Data Table(name)>, <Width(pixels)>, <nLines(n)>, <script>, <OnChange(expr)>)

Description

Returns a display box that contains a list of items. Control allows column filtering.

Get Project(title|index|display box|window)

Description

Returns a single project.

Examples

The following examples show how to get the window title of various projects.

Get Project( 1 ) << Get Window Title;
// first open project
Get Project( "My Project" ) << Get Window Title;
// first project named “My Project”
Get Project( display box ) << Get Window Title;
// parent project of the specified display box

Get Project List()

Description

Returns a list of all open projects.

Example

Get Project List() << Get Window Title;
// list of the titles of all open projects

Get Window(<Project(title|index|display box|window)>, <Type(string)>, title|index|display box)

Description

Returns a reference to a specific open window by title, index, or display box. When run in a project, Get Window() returns windows from the current project.

Optional Arguments

Project

Specifies the title (a quoted string), index, display box, or window from another project.

Type(string)

To limit the search to particular types of windows, use the Type() argument and one of these quoted strings: "Data Tables", "Journals", "Reports", or "Dialogs".

Examples

The following examples show how to get the window title of various windows.

Get Window( 1 ) << Get Window Title;
// first window in the current project
 
Get Window( "Big Class" ) << Get Window Title;
// Big Class window in the current project
 
Get Window( ob ) << Get Window Title;
// parent window of specified display box in the current project
 
Get Window( Project(), 1 ) << Get Window Title;
// first window, no project (global scope)
 
Get Window( Project( myProject ), "Big Class" << Get Window Title;
// Big Class window in the specified project

Get Window List(<Project(title|index|display box|window),><Type(string)>)

Description

Returns a list of currently open windows. By default, Get Window List() returns references to open windows in the current project. You can return an open window list from something other than the current project by using the Project() argument. To limit the search to particular types of windows, use the Type () argument and one of these quoted strings: "Data Tables", "Journals", "Reports", or "Dialogs".

Optional Arguments

Project

Specifies the title, index, display box, or window from another project.

Type

To limit the search to particular types of windows, use the Type () argument and one of these quoted strings: "Data Tables", "Journals", "Reports", or "Dialogs".

Examples

Get Window List() << Get Window Title;
// list of open windows in the current project
Get Window List( Type( "Reports" ) ) << Get Window Title;
// list of the titles of open reports in the current project
Get Window List( Project( 0 ), Type( "Reports" ) ); // positional arguments
// list of the titles of open reports outside of a project
Get Window List( 2 );
// second window list

Global Box(global)

Description

Constructs a box for editing global value directly.

See Also

Global Box in the Scripting Guide

Graph()

See Graph Box(properties, script).

Graph 3D Box(properties)

Description

Constructs a display box with 3-D content.

Returns

The display box.

Arguments

properties

Properties can include: Frame Size(x, y), Xname("title"), Yname("title"), Zname("title").

Notes

This display box constructor is experimental.

Graph Box(properties, script)

Graph(properties, script)

Description

Constructs a graph with axes.

Returns

The display box (Graph Box).

Arguments

properties

Named property arguments: Title("title"), XScale(low, high), YScale(low, high), FrameSize(h, v), XName("x"), YName("y"), SuppressAxes.

script

Any script to be run on the graph box.

See Also

Create New Graphs from Scratch and Customize Them in the Scripting Guide

Graph Box in the Scripting Guide

H Center Box(<child box>)

Returns a display box that contains the optional child display box argument. The box is centered in the horizontal space defined by the maximum size of that child display box and all of the other siblings of the center box.

H List Box(<Align("center"|"bottom")>, display box, ...)

Description

Creates a display box that contains other display boxes and displays them horizontally.

Arguments

Align("center"|"bottom")

Specify center or bottom alignment of the contents in the list box. The contents are bottom aligned by default.

display box

Any number of display box arguments can be contained in the list box.

See Also

H List Box and V List Box in the Scripting Guide

H Scroll Box(<Size(h)>, display box)

Description

Returns a display box that positions a larger child box using a horizontal scroll bar.

Arguments

Size(h)

The horizontal length of the scroll bar.

Notes

The flexible argument is deprecated. Use Set Stretch instead. See V Scroll Box(<Size(v)>, display box) for an example.

H Sheet Box(<<Hold(report), display boxes)

Description

Returns a display box that arranges the display boxes provided by the arguments in a horizontal layout. The <<Hold() message tells the sheet to own the report(s) that is excerpted.

See Also

H Sheet Box and V Sheet Box in the Scripting Guide

H Splitter Box(<Size(h, v)>, display box, ...)

Description

Returns a display box that arranges the display boxes provided by the arguments in a horizontal layout (or panel). The splitter enables the user to interactively resize the panel.

Required Argument

display box

Any number of display box arguments can be contained in the splitter box.

Optional Argument

Size(h, v)

Specifies the size of the splitter box in pixels. This size is for the outer splitter box. Inner display boxes are proportionately sized according to the width and height of the outer splitter box.

Optional Messages

<<Size(n)

Specifies the proportions of the last panel. <<Size(.25) resizes the last panel to 25% the splitter box height (or width, for vertical splitter boxes).

<<Set Sizes({n, n})

Specifies the proportions of each panel. db<<Set Sizes({.75, .25}) sizes the first panel to 75% and the second panel to 25% of the splitter box height (or width, for vertical splitter boxes).

<<Close Panel(n, <Boolean>)

Closes the panel that you specify. <<Close Panel(2) closes the second panel. With three or more panels, you must include the second Boolean value. That value indicates which panel expands to fill the space left by the closed panel.

<<Close Panel(2,0) closes the second panel; the following sibling takes the extra space.

<<Close Panel(2,1) closes the second panel; the preceding sibling takes the extra space.

<<Open Panel(n, <Boolean>)

Opens the panel that you specify. With three or more panels, you must include the second Boolean value. Works similar to <<Close Panel described above. The panels are initially opened. You use <<Open Panel only after using <<Close Panel.

<<Get Sizes()

Returns the proportions of each panel as a list.

See Also

H Splitter Box and V Splitter Box in the Scripting Guide

Hier Box(text, Hier Box(...), ...)

Description

Constructs a node of a tree (similar to Diagram output) containing text. Hier Box can contain additional Hier Boxes, allowing you to create a tree. The text can be a quoted string or a Text Edit Box.

Hist Seg([data], <[freq column]>, <[weight column]>, <Vertical(Boolean)>, <Row States()>

Description

Returns a histogram seg.

Required Argument

data

The data in matrix format.

Optional Arguments

freq column

The frequency column in matrix format.

weight column

The weight column in matrix format.

Vertical(Boolean)

Displays the histogram vertically by default (or if set to 1). Display the histogram horizontally by setting the value to 0.

Row States

Specifies a data table reference or row states.

Icon Box(name)

Description

Constructs a display box containing an icon, where the argument is a name such as Popup Image shown here, Locked Image shown here, Labeled Image shown here, Sub Image shown here, Excluded Image shown here, Hidden Image shown here, Continuous Image shown here, Nominal Image shown here, or Ordinal Image shown here. The argument can also be a path to an image.

Argument

name

A quoted string that is the name of a JMP icon or the path to an icon.

Example

Icon Box( "Nominal" ) constructs a display box that contains the Nominal icon.

Icon Box( "$SAMPLE_IMAGES/pi.gif" ) inserts the pi.gif sample image.

Notes

Some icons are used on both Windows and macOS. Other icons are platform specific.

Consider installing the Built-In JMP Icons add-in. The add-in lets you view icons interactively and see what they look like in different contexts. Download the add-in from https://community.jmp.com/t5/JMP-Add-Ins/Built-In-JMP-Icons/ta-p/42251.

If Box(Boolean, display boxes)

Description

Constructs a display box whose contents are conditionally displayed.

Arguments

Boolean

1 displays the display boxes inside the If Box. 0 does not display them.

display boxes

Any display box tree.

If Seg(<State(Boolean)>)

Description

Returns a display seg that shows or hides display seg children.

Arguments

State(Boolean)

Determines whether the display seg children are shown (1) or hidden (0).

Example

lines = [30 20 80 70, 10 90 90 10, 40 20 60 30];
win = New Window( "Lines Seg Example",
	g = Graph Box( If Seg( true, <<Append( Lines Seg( lines ) ) ) )
);

Journal Box(string)

Description

Constructs a display box that displays the quoted string. We recommend that you do not generate the journal text by hand.

See Also

Journal Box in the Scripting Guide

Line Seg(x, y, <Row States(dt|dt, [rows]|dt, {{rows}, ...}|{row states})>, <Sizes(s)>)

Description

Creates a display seg of connected line segments for the given x and y values. The optional third argument enables row state assignments from either a data table or independently.

Lines Seg([x1 y1 x2 y2, ...])

Description

Returns a display seg with a sequence of line segments for the given x and y values.

Lineup Box(<nCol(n)>, <Spacing(pixels, <vspace>), display boxes, ...)

Description

Constructs a display box to show an alignment of boxes in n columns.

See Also

Line Up Items in the Scripting Guide

List Box({item, ...}, <Width(pixels)>, <maxSelected(n)>, <nLines(n)>, <script>)

Description

Creates a display box to show a list box of selection items (quoted strings). The argument can be a list of two-item lists containing the item name and a quoted string that specifies the modeling type or sorting order. Item names are case sensitive by default. The icon appears next to the corresponding item in the list box.

Marker Seg(x, y, <Row States(dt|dt, [rows]|dt, {{rows}, ...}|{row states})>, <Sizes(s)>)

Description

Creates a display seg with markers for all of the x and y values. The optional third argument enables row state assignments from either a data table or independently.

Matrix Box(x)

Matrix Box(matrix, < <<Column Names(col1, col2, ...)>, < <<Row Names(row1, row2, ...)>)

Description

Displays the matrix given in the usual array form. Column and row names are quoted strings.

Mouse Box(display box arguments)

Description

Returns a box that can make JSL callbacks for dragging and dropping, marking, or clicking and tracking mouse actions.

Arguments

display box arguments

Specifies the object that the user interacts with, such as a Text Box or Button Box. See the Scripting Index in the Help menu.

See Also

Mouse Box in the Scripting Guide

Move to Project(<Source(project)|Destination(project)>, <Windows({list of windows to move})>)

Description

Moves one or more windows into a project or out of a project, or between projects.

Arguments

Source(project)

The project containing the windows that you want to move.

Destination(project)

The project to which you want to move the windows.

Windows({list of windows to move})

A list of windows to move to the project. If omitted, all windows will be moved. Note that the data table and all of its dependent reports will be moved. However, you need to specify only the data table name or report name in the windows argument to move it.

Example

dt = Open( "$SAMPLE_DATA/Big Class.jmp" );
report = dt << Run Script( "Bivariate" );
project = New Project();
// move the report and data table to a new project
Move to Project( Destination( project ), Windows( {report} ) );

New Image()

New Image(width, height)

New Image(filepath)

New Image(Open(url) )

New Image(picture)

New Image(matrix)

New Image(rgb|r|rgba, {matrix, ...})

Description

Creates a new image which can then be edited using JSL. Valid formats are png, bmp, jpeg, jpg, tiff, tif, and gif.

Returns

An image.

Arguments

All argument sets are optional, but all arguments within each set are required.

width, height

Sets the width and height of the image in pixels.

filepath

The quoted filepath to an image.

Open(url)

Opens the image at the specified URL path.

picture

A JSL picture object.

matrix

The image as a matrix of JSL color pixels.

rgb|r|rgba, {matrix, ...}

Specifies the channels ("rgb", "r", or "rgba") and provides a matrix of values (0.0-1.0) for each channel. Examples:

	New Image( "r", [r matrix] );
	New Image( "rgb", {[r matrix], [g matrix], [b matrix]} );
	New Image( "rgba", {[r matrix], [g matrix], [b matrix], [a matrix]} );

New Project(arguments)

Description

Creates a project using the specified script.

Arguments

<<Add Bookmarks({<File(path)>, <Folder(path, Expanded(Boolean)>)>, <Group(name, <Expanded(Boolean)>, {contents}>)

Creates bookmarks for frequently used files in the project. The argument is a list of bookmark items, each of which is specified using File(), Folder(), or Group(). Group() accepts File(), Folder(), and Group() as children.

<<Reset Layout

Sets the project to use the default layout.

<<Run Script

Specifies the data tables and reports that appear in the project.

<<Save(<path>)

Saves the project. Include a quoted path and file name to save the project to a specific location. Save As is an alias.

<<Set Bookmarks({<File(path)>, <Folder(path, Expanded(Boolean)>)>, <Group(name, <Expanded(Boolean)>, {contents}>)

Sets the bookmarks for the project. The argument is a list of bookmark items, each of which is specified using File(), Folder(), or Group(). Group() accepts File(), Folder(), and Group() as children.

<<Set Layout

Sets the window layout of the project.

<<Show Bookmarks

Shows or hides the bookmarks.

<<Show Log

Shows or hides the log.

<<Show Window List

Shows or hides the Window List.

Example

The following example creates a project from BigClass.jmp and two reports.

project = New Project();
project << Run Script(
	dt = Open( "$SAMPLE_DATA/Big Class.jmp" );
	dt << Run Script( "Bivariate" );
	dt << Run Script( "Distribution" );
);

See Also

Creating Projects in the Scripting Guide

Create a Bookmark Group in the Scripting Guide

New Window(title, <arguments>, display box)

Description

Makes a new window with the required quoted title and a display box tree.

Optional Arguments

<<Script(<script>)

Creates a new script window. The optional quoted string script is placed inside the script window.

<<Journal

Creates an empty journal.

<<Size Window(x, y)

Creates a new window of the specified height and width.

<<Modal

Makes the new window a modal window, which prevents any other actions in JMP until the window is closed. If you do not include an OK or Cancel button, one is added automatically for you. Note: If used, this argument must be the second argument, directly after the window title. Available modal window arguments are:

<<On Open(expr) runs expr when the window is created.

Note: In data tables, On Open (or OnOpen) scripts that execute other programs are never run. Set the Evaluate OnOpen Scripts preference to control when the script is run.

<<On Close(expr) runs expr when the window is closed. Returns 0 if the window fails to close.

<<On Validate(expr) runs expr when the OK button is pressed. If it returns True, the window is closed otherwise the window remains open.

<<Return Result changes the window’s return value when it closes to match that of the deprecated Dialog() function.

Show Toolbars(Boolean)

Shows or hides the toolbar. The default value is 1. (Windows only.)

Show Menu(Boolean)

Shows or hides the menu bar. The default value is 1. (Windows only.)

Suppress AutoHide(Boolean)

Suppresses or uses the auto-hide feature for menus and toolbars. The default value is 1. (Windows only).

Notes

Dialog() is deprecated. Use New Window() with the Modal argument instead.

See Also

Convert Deprecated Dialog to New Window in the Scripting Guide

Number Col Box(title, numbers)

Description

Creates a column named title (a quoted string) with numeric entries given in list or matrix form.

Number Col Edit Box(title, {numbers}|[numbers])

Description

Creates a column named title (a quoted string) with numeric entries given in list or matrix form. The numbers can be edited.

Number Edit Box(initial value, <width>)

Description

Creates an editable number box that initially contains the initial value argument.

Returns

The display box object.

Argument

initial value

Any number to use as the initial value. If you use a date or time format, a date and time selector window is created.

<width>

Sets the width of the box in characters.

See Also

Number Edit Box in the Scripting Guide

Outline Box(title, display box, ...)

Description

Creates a new outline named title (a quoted string) containing the listed display boxes.

See Also

Outline Box in the Scripting Guide

Page Break Box()

Description

Creates a display box that forces a page break when the window is printed.

Panel Box(title, display box)

Description

Creates a display box labeled with the quoted string title that contains the listed display boxes.

See Also

Panel Box in the Scripting Guide

Picture Box(Open(picture), format)

Description

Creates a display box that contains a graphics picture object.

Returns

A reference to the display box.

Argument

Open(picture)

Opens the directory that contains the picture.

format

Specifies the graphic file format. Specifying the format opens the picture in JMP. If you omit this argument, the picture opens in the default graphics program. Valid formats are the quoted strings "png", "bmp", "jpeg", "jpg", "tiff", "tif", and "gif".

Example

New Window( "Example",
	Picture Box( Open( "$SAMPLE_IMAGES/pi.gif", gif ) ) );

Platform(data table, script)

Description

Evaluates the specified script in the context of the specified data table.

Returns

The resulting display box for embedding in a display tree.

Example

dt = Open( "$SAMPLE_DATA/Big Class.jmp" );
win = New Window( "Platform example",
	H List Box(
		Platform(
			dt,
			Bubble Plot(
				X( :weight ),
				Y( :height ),
				Sizes( :age ),
				Title Position( 0, 0 )
			)
		),
		Platform(
			dt,
			Bubble Plot(
				X( :weight ),
				Y( :age ),
				Sizes( :height ),
				Title Position( 0, 0 )
			)
		)
	)
);

Plot Col Box(title, numbers)

Description

Returns a display box labeled with the quoted string title to graph the numbers. The numbers can be either a list or a matrix.

Poly Seg(x values, y values)

Description

Returns a display seg that represents a polygon with vertices based on the x values and y values.

Example

x = [10, 50, 90];
y = [10, 90, 10];
win = New Window( "Poly Seg Example",
g = Graph Box( Poly Seg( x, y ) ) );
frame = g[FrameBox( 1 )];
seg = (frame << Find Seg( "Poly Seg" ));

Popup Box({command1, script1, command2, script2, ...})

Description

Creates a red triangle menu. The single argument is an expression yielding a list of an even number of items alternating between the quoted command string and the expression that you want evaluated when the command is selected. If the command is an empty string, a separator line is inserted.

Notes

Pressing ALT and right-clicking the red triangle menu opens a window with check boxes for the commands.

See Also

Popup Box in the Scripting Guide

Display Options for JMP Reports in Using JMP

Radio Box({item, ...}, <script>)

Description

Constructs a display box to show a set of radio buttons. The items are quoted strings. The optional script is run every time a radio button is selected.

See Also

Radio Box in the Scripting Guide

Range Slider Box(minValue, maxValue, lowVariable, highVariable, script)

Description

Range Slider Box() returns a display box that shows a range slider control that ranges from minValue to maxValue. As the two sliders’ positions change, their values are placed into lowVariable and highVariable, and the script is run.

Returns

The display box (Range Slider Box).

Arguments

minValue, maxValue

Numbers that set the minimum and maximum value the slider represents.

lowVariable

The variable whose value is set and changed by the lower slider.

highVariable

The variable whose value is set and changed by the upper slider.

script

Any valid JSL commands that are run as the slider is moved.

Report(obj)

Description

Returns the display tree of a platform obj. This can also be sent as a message to a platform:

obj<<Report.

Scene Box(x size, y size)

Description

Creates an x-sized by y-sized scene box for 3-D graphics.

Scene Display List

Description

Returns a display list for 3-D graphics.

Example

ex = Scene Display List();
ex << Color( .9, .9, .9 );
ex << Text( center, middle, .3, "Hello World" );
exScene = Scene Box( 600, 600 );
exScene << Background Color( 0 );
exScene << Show Arcball( always );
New Window( "See HelloWorld.jsl in sample scripts", exScene );
exScene << Perspective( 45, .2, 20 );
exScene << Translate( 0.0, 0.0, -4.5 );
exScene << Arcball( ex, 1.5 );
exScene << Update;

Script Box(<script>, <language>, <width>, <height>)

Description

Constructs an editable box that contains the quoted string script. The editable box is a script window and can both be edited and run as JSL.

Optional Arguments

script

A quoted string that appears in the script box.

language

A quoted string that provides syntax highlighting for the specified language. Valid languages are "JSL", "Text", "SAS", "SAS Output", "SASLog", "R", "MATLAB", "JavaScript", "C", "SQL", "Python", "JSON", and "XML".

width

An integer that sets the width of the script box.

height

An integer that sets the height of the script box.

Example

// JSON
New Window( "JSON",
	Script Box(
		"{\!"a\!":1,\!"b\!":\!"test\!"}",
		"JSON"
	)
);

Scroll Box(<Size(h,v)>, display box, ...)

Description

Creates a display box that positions a larger child box using scroll bars.

Returns

A reference to the scroll box object.

Required Argument

display box

Any number of display box arguments can be contained in the scroll box.

Optional Argument

Size(h,v)

The h and v arguments specify the size of the box in pixels.

Notes

You can send a scroll box object a message to set the background color:

<<Set Background Color( {R, G, B} | <color> )

The Flexible argument is deprecated. Use the Set Stretch message instead. See V Scroll Box(<Size(v)>, display box) for an example.

You can set the Boolean flags for horizontal (h) and vertical (v) scrolling to enable (1) or disable (0) the scroll bars. If scrolling is disabled in a given direction, the Scroll Box will behave as a regular container in that direction.

<<Set Scrollers (h, v)

To return the flags for scrolling, use the following message:

<<Get Scrollers

To set the horizontal (h) and vertical (v) positions (in pixels) for the scrollers on the scroll bar:

<<Set Scroll Position (h,v)

To return the flags for scroll position, use the following message:

<<Get Scroll Position

To return the maximum positions for horizontal and vertical scrolling, use the following message:

<<Get Scroll Extents

Example

The following example shows a window containing a scroll box with the specified settings.

win = New Window( "Example",
	sb = Scroll Box(
		Size( 150, 75 ),
		List Box(
			{"First Item", "Second Item",
			"Third Item", "Fourth Item",
			"Fifth Item"},
			width( 200 ),
			max selected( 2 ),
			nLines( 6 )
		)
	)
);
win << Set Window Size( 300, 200 );
sb << Set Scrollers( 1, 1 ); // enable both scroll bars
// position the scrollers on the scroll bar
sb << Set Scroll Position( 0, 20 );

Shape Seg( {Path(path), ...}, <Row States(dt|dt,[rows]|dt,{{rows}, ...}|{row states})>)

Description

Returns a display seg with a collection of shapes.

Required Argument

Path

Specifies the path with an Nx3 matrix or with a text representation. A path matrix has three columns for x, y, and flags for each point in the path. The flag values are 0 for control, 1 for move, 2 for a line segment, 3 for a cubic Bézier segment, and are negative if the point also closes the path. Path text supports SVG syntax.

Optional Arguments

Row States

Specifies a data table reference and optionally rows or the actual row state.

Example

win = New Window( "Shape Seg Example",
	Graph Box(
		Shape Seg(
			{Path( [10 10 1, 10 70 0, 70 70 0, 70 10 -3] ),
			Path( "M20,20 C20,60 60,60 60,20 Z" )},
			Row States( {Selected State( 1 ), Color State( "red" )} )
		)
	)
);

Sheet Box(<<Hold(rpt), display box, ...)

Description

Returns a display box that can organize other display boxes vertically or horizontally.

See Also

H Sheet Box and V Sheet Box in the Scripting Guide

Sheet Panel Box(title, display box)

Description

Specifies whether the Sheet Box should be horizontal or vertical.

Slider Box(minValue, maxValue, variable, script, <Set Width(n)>, <Rescale Slider(min, max)>)

Description

Creates an interactive slider control.

Returns

The display box (Slider Box).

Required Arguments

minValue, maxValue

Numbers that set the minimum and maximum value the slider represents.

variable

The variable whose value is set and changed by the slider box.

script

Valid JSL commands that are run as the slider box is moved.

Optional Arguments

Set Width(n)

Specifies the width of the slider box in pixels.

Rescale Slider(minValue, maxValue)

Resets the maximum and minimum values for the slider box.

Notes

You can send Set Width and Rescale Slider as messages to a slider object. For example:

ex = .6;
New Window( "Example", mybox = Slider Box( 0, 1, ex, Show( ex ) ) );
mybox << Set Width( 200 ) << Rescale Slider( 0, 5 );

See Also

Slider Box in the Scripting Guide

Spacer Box(<Size(h, v)>, <Color(color)>)

Description

Creates a display box that can be used to maintain space between other display boxes, or to fill a cell in a LineUp Box.

Returns

A reference to the display box.

Optional Arguments

Size(h, v)

The h and v arguments specify the size of the box in pixels.

Color(color)

Sets the color of the box to the JSL color argument.

See Also

Spacer Box in the Scripting Guide

Spin Box(script)

Description

Returns a display box that shows a button with up and down controls.

Argument

script

Invoked with an argument that indicates the direction of the arrow clicked. Negative is down, and positive is up. A value of 1 indicates a single click, while larger values indicate a repeating action.

Example

win = New Window( "Example",
	Lineup Box(
		2,
		nb = Number Edit Box( 3 ),
		sb = Spin Box( Function( {value}, nb << Increment( value ) ) )
	)
);
nb << Set Increment( 1 );

Splitter Box(<Size(x, y)>, display box, ...)

Description

Returns a display box that can organize other display boxes horizontally or vertically with interactive control of sizes. Child sizes are specified as a proportion of the width or height of the splitter box. The optional Size argument is used only for the top-most splitter box. Lower level display boxes are sized like any other child box.

Use H Splitter Box() or V Splitter Box().

See Also

H Splitter Box and V Splitter Box in the Scripting Guide

String Col Box(title, {string, ...})

Description

Creates a column in the data table containing the quoted string items. The column is named after the quoted title.

String Col Edit Box(title, {string, ...})

Description

Creates a column in the data table containing the quoted string items. The string boxes are editable. The column is named after the quoted title.

Notes

To retrieve the data, use the following message:

data = obj << Get;

See Also

String Col Edit Box in the Scripting Guide

Tab Box(Tab Page Box(Title(page title 1), <options>, contents of page 1), Tab Page Box(Title(page title 2), <options>, contents of page 2), ...);

Description

(Previously called Tab List Box.) Creates a tabbed window pane. The arguments are an even number of items alternating between the name of a tab page and the contents of the tab page. The page titles must be quoted.

Arguments

Tab Page Box

Returns a display box that can be used in a tab box or as a stand-alone container with a title.

Title(page title #) specifies the title of page 1.

Options include <<Closeable(Boolean) (specifies whether the box can be closed), <<Tip(string) (a quoted string that specifies a tooltip), and <<Icon(string) (a quoted string that specifies the icon).

contents of page # is a quoted string that specifies the text on the tab.

Example

New Window( "Example",
	Tab Box(
		t1 = Tab Page Box( Title( "alpha" ), Panel Box( "panel", Text Box( "text" ) ) ),
		t2 = Tab Page Box( Title( "beta" ), Popup Box( {"x", ex = 1, "y", ex = 2} ) ),
	)
);

Notes

Certain messages that you can send to Tab Page Box have been renamed:

Set Title is called Title.

Set Tip is called Tip.

Set Icon is called Icon.

Set Closeable is called Closeable.

See Also

Tab Box and Tab Page Box in the Scripting Guide

Tab List Box(title, tabExpr1, ...)

See Tab Box(Tab Page Box(Title(page title 1), <options>, contents of page 1), Tab Page Box(Title(page title 2), <options>, contents of page 2), ...);.

Tab Page Box(Title(string), <options>, contents)

Description

Returns a display box that can be used in a tab box or as a stand-alone container with a title.

Required Argument

Title

A quoted string that specifies the title on the tab.

Optional Messages

<<Tip(string)

A quoted string that specifies a tooltip.

<<Closeable(Boolean)

Specifies whether the page can be closed.

<<Icon(string)

A quoted string that specifies the icon.

<<Set Font(font name, <size>, <"bold"|"italic"|"underline"|strikeout">, <angle>

Specifies the font properties.

<<Set Font Name("font name")

Specifies the name of the font.

<<Set Font Scale(f)

Specifies the scale factor for the font. The scale factor is applied to the size that is determined by the base font and point size.

<<Set Font Size(n)

Specifies the font size in pixels.

<<Set Font Style("plain"|"bold")

Specifies the font style.

Notes

Certain messages that you can send to Tab Page Box have been renamed:

Set Title is called Title.

Set Tip is called Tip.

Set Icon is called Icon.

Set Closeable is called Closeable.

See Also

Tab Box and Tab Page Box in the Scripting Guide

Table Box(display box, ...)

Description

Creates a report table with the display boxes listed as columns.

Text Box(text, <arguments>)

Description

Constructs a box that contains the quoted string text.

Arguments

<<Justify Text(position)

Justifies the text left, center, or right as specified in quotes.

<<Set Wrap(pixels)

Sets the point at which text wraps.

See Also

Text Box in the Scripting Guide

Text Edit Box(text, <arguments>)

Description

Constructs an editable box that contains the quoted string text.

Arguments

<<Password Style(Boolean)

Displays asterisks in the box rather than the password.

<<Set Script

Runs the specified script after the text is edited.

<<Set Width(pixels)

Sets the point at which text wraps.

See Also

Text Edit Box in the Scripting Guide

This Project()

Description

Gets the current project when a JSL script is run from that project.

Example

The following example gets the window title of the current project.

project = New Project();
project << Save( "$DOCUMENTS/Test Project.jmpprj" );
project << Run Script(
	New Window( "Project Title",
		Text Box(This Project() << Get Window Title())
	);
);

Tree Box(<{rootnodes}>, <Size(width, height)>, <MultiSelect(Boolean)>)

Description

Constructs a box to show a hierarchical tree composed of tree nodes.

Arguments

{rootnodes}

Specifies the names for the root nodes created by Tree Node() which the box contains.

Size(width, height)

Specifies the width and height (in pixels) of the box.

MultiSelect(Boolean)

Indicates that more than one item in the tree can be selected.

Tree Node(<data>)

Description

Creates a node for display in a Tree Box display. Tree Node is used for both parent and child nodes.

Notes

If you send a root node that contains one or more nodes with the Set Node Select Script defining a collapse message, then macOS runs the script twice. Windows doesn’t run the script. This behavior on macOS doesn’t just affect increments. Any script runs twice. It will print to the log twice, create a column twice, try to delete something twice, and so on.

Triangulation(<dt>, X(col1, col1), <Y(col)>)

Description

Returns an object containing the Delaunay triangulation of the given point set. The optional Y will be averaged for duplicate points, and all points in the output will be unique.

Examples

tri = Triangulation(
	X( [0 0 1 1], [0 1 0 1] ),
	Y( [0 1 2 3] )
);
dt = Open( "$SAMPLE_DATA/Cities.jmp" );
tri = Triangulation( X( :X, :Y ), Y( :POP ) );

V Center Box(display box...)

Returns a display box that contains the child display box argument. The box is centered in the vertical space defined by the maximum size of that child display box and all of the other siblings of the center box.

V List Box(<Align("Center"|"Right")>, display box, ...)

Description

Creates a display box that contains other display boxes and displays them vertically.

Arguments

Align

Specify right or center alignment of the contents in the list box. The contents are center aligned by default.

display box

Any number of display box arguments can be contained in the list box.

See Also

H List Box and V List Box in the Scripting Guide

V Scroll Box(<Size(v)>, display box)

Description

Returns a display box that places a scroll bar on the bottom and right if the contents are bigger than the size of the scroll box.

Arguments

Size(v)

The vertical length of the scroll bar.

display box

Any number of display box arguments can be contained in the scroll box.

Example

dt = Open( "$SAMPLE_DATA/Big Class.jmp" );
New Window( "stretchable",
	H Splitter Box(
		Size( 400, 200 ),
		Scroll Box(
			Size( 200, 200 ),
			dt <<Run Script( "Distribution" ),
			<<Set Stretch( "Window", "Window" )
		),
		Scroll Box(
			Size( 200, 200 ),
			dt <<Run Script( "Bivariate" ),
			<<Set Stretch( "Window", "Window" )
		),
		<<Set Stretch( "Window", "Window" )
	)
);

Notes

The flexible argument is deprecated. Use Set Stretch instead.

V Sheet Box(<<Hold(report), display box, ...)

Description

Returns a display box that arranges the display boxes provided by the arguments in a vertical layout. The <<Hold() message tells the sheet to own the report(s) that is excerpted.

See Also

H Sheet Box and V Sheet Box in the Scripting Guide

V Splitter Box(<Size(h,v)>, display box..., <arguments>)

Description

Returns a display box that arranges the display boxes provided by the arguments in a vertical layout (or panel). The splitter enables the user to interactively resize the panel.

Arguments

Size(v)

The vertical length of the scroll bar.

display box

Any number of display box arguments can be contained in the splitter box.

Optional Arguments

For more information about the optional arguments, see H Splitter Box(<Size(h, v)>, display box, ...).

See Also

H Splitter Box and V Splitter Box in the Scripting Guide

Web Browser Box(url)

Description

Creates a display box that contains a web page. Available only on Windows in Internet Explorer.

Returns

A reference to the web browser box object.

Argument

url

A quoted string containing the URL to the web page to display.

Example

The following example creates a splitter box with the web browser box on the left and the bubble plot on the right.

dt = Open( "$SAMPLE_DATA/PopAgeGroup.jmp" );
New Window( "Example",
	H Splitter Box(
		Size( 800, 300 ),
		wb = Web Browser Box( "http://www.jmp.com" ),
		dt << Run Script( "Bubble Plot Region" )
	)
);
wb << Set Stretch( "Window", "Window" ); // auto stretch horizontally and vertically
wb << Set Max Size( 10000, 10000 ); // maximum size in pixels

Notes

The <a href> target “_blank” opens the web page in a new Internet Explorer window. The <a href> target “_new” opens the web page in the active Internet Explorer tab.

Window(<string|int>)

Returns

Either a list of references to all open windows, or a reference to an explicitly named window.

Arguments

string

A quoted string containing the name of a specific open window.

int

The number of a specific open window.

Notes

If no argument is provided, a list of all open windows is returned.

If the argument (either a window name or number) does not exist, an empty list is returned.

Wrap List Box(display box, ...)

Description

Creates a list box that contains other display boxes and displays them horizontally, but wraps them when printing.

Arguments

display box

Any number of display box arguments can be contained in the list box.

Want more information? Have questions? Get answers in the JMP User Community (community.jmp.com).