Create a New Data Table

You can start a new data table, or start a new data table and store its reference in a global variable. In either case, specify the table name as an argument.

New Table( "My Table" );

dt = New Table( "My Table" );

The following sections describe the optional arguments for the New Table() function.

Private, Invisible, and Visible

The optional visibility argument specifies whether the new data table is shown. visibility( "invisible" ) hides the data table from view; it appears only in the JMP Home Window and the Window menu. visibility( "private" ) avoids opening the data table. visibility( "visible" ) shows the data table. "visible" is the default value.

New Table( "My Table", visibility( "private" ) );

Making a table private can prevent memory problems when a script opens and closes many tables. Private data tables have no physical window, so less memory is required than with invisible tables.

Note: The advantages of using private data tables is based on the size of the data in the table. If the data table has only five columns and 20 rows, the savings for a private data table is substantial. However, for a table with 100 columns and 1,000,000 rows, using a private data table is not helpful because the data requires a lot of memory.

Actions

An optional argument that can define the new table. For example, the following script creates a new data table named Little Class. It adds three rows and two named columns as well as entering values for each cell in the table:

dt = New Table( "Little Class",

	Add Rows( 3 ),

	New Column( "name",

		Character,

		"Nominal",

		Set Values( {"KATIE", "LOUISE", "JANE"} )

),

	New Column( "height",

		"Continuous",

		Set Values( [59, 61, 55] )

);