R Integration Functions | JMP 12

JMP Support 800.450.0135 (US)

Documentation Feedback
Your feedback is important to us. us any comments about our documentation.

JSL Syntax Reference • JSL Functions • R Integration Functions

•

R Integration Functions

R Connect( <named_arguments> )

Returns the current R connection object. If there is no connection to R, it intializes the R integration interfaces and returns an active R integration interface connection as a scriptable object.

R scriptable object.

Optional. Sends all source lines to the JMP log. This option is global. The default value is true.

R Execute( { list of inputs }, { list of outputs }, "rCode", <named_arguments> )

Submit the specified R code to the active global R connection given a list of inputs. On completion, the outputs are returned into the specified list.

0 if successful; nonzero otherwise.

{ list of inputs }

A list of JMP variable names to be sent to R as inputs.

{ list of outputs }

A list of JMP variable names to contain the outputs returned from R.

A quoted string that contains the R code to submit.

Expand(Boolean)

An optional, Boolean, named argument. Performs an Eval Insert() on the R code before submitting to R.

An optional, Boolean, named argument. Sends all source lines to the JMP log. This option is global. The default value is true.

Send the JMP variables x and y to R, execute the R statement z <- x * y, and then get the R variable z and return it to JMP.

rc = R Execute( {x, y}, {z}, "z <- x * y" );

R Get( variable_name )

Gets the named variable from R to JMP.

The value of the named variable.

Required. The name of an R variable whose value to return to JMP.

Assume that a matrix named qbx and a data frame named df are present in your R connection.

// Get the R variable qbx and placed it into a JMP variable qbx

qbx = R Get( qbx );

// Get the R variable df and placed it into a JMP data table referenced by df

df = R Get( df );

R Get Graphics( "format" )

Gets the last graphics object written to the R graph display window in the specified format.

A JMP picture object.

Required. Specifies the graphics format to be used. The valid formats are "png", "bmp", "jpeg", "jpg", "tiff", and "tif".

R Init( named_arguments )

Initializes the R session.

0 if the initialization is successful; any nonzero value otherwise.

Optional. Sends all source lines to the JMP log. This option is global. The default value is true.

R Is Connected()

Determines whether a connection to R exists.

1 if connected; 0 otherwise.

R JMP Name to R Name( name )

Maps the specified JMP variable name to the corresponding R variable name using R naming rules.

The name of a JMP variable to be sent to R.

A string that contains the R name.

R Send( name, <R Name( name )>)

Sends named variables from JMP to R.

0 if the send is successful; any nonzero value otherwise.

required. The name of a JMP variable to be sent to R.

Optional. You can give the variable that you send to R a different name. For example

R Send(Here:x, R Name("localx"))

For data tables only:

Selected(Boolean)

optional, named, Boolean. Send only selected rows from the referenced data table to R.

Excluded(Boolean)

optional, named, Boolean. Send only excluded rows from the referenced data table to R.

Labeled(Boolean)

optional, named, Boolean. Send only labeled rows from the referenced data table to R.

Hidden(Boolean)

optional, named, Boolean. Send only hidden rows from the referenced data table to R.

Colored(Boolean)

optional, named, Boolean. Send only colored rows from the referenced data table to R.

Markered(Boolean)

optional, named, Boolean. Send only markered rows from the referenced data table to R.

Row States(Boolean, <named arguments>)

optional, named. Includes a Boolean argument and optional named arguments. Send row state information from the referenced data table to R by adding an additional data column named “RowState”. Multiple row states are created by adding together individual settings. The individual values are as follows:

‒	Selected = 1

‒	Excluded = 2

‒	Hidden = 4

‒	Labeled = 8

‒	Colored = 16

‒	Markered = 32

The named arguments for the Row States() argument are as follows:

Colors(Boolean)

optional, named, Boolean. Sends row colors. Adds additional data column named “RowStateColor”.

Markers(Boolean)

optional, named, Boolean. Sends row markers. Adds additional data column named “RowStateMarker”.

Create a matrix, assign it to X, and send the matrix to R:

rc = R Send( X );

Open a data table, assign a reference to it (dt), and send the data table, along with its current row states, to R:

dt = Open( "$SAMPLE_DATA/Big Class.jmp" );

rc = R Send( dt, Row States(1) );

R Send File( "pathname", <R Name("name")>)

Sends the specified data file from JMP to R.

0 if the send is successful; any nonzero value otherwise.

required. A quoted string that contains a pathname for a file.

Optional. You can give the data file that you send to R a different name.

R Submit( "rCode", <named_arguments> )

Submits the specified R code to the active global R connection.

0 if successful; nonzero otherwise.

A required, quoted string that contains the R code to submit.

Expand(Boolean)

An optional, Boolean, named argument. Performs an Eval Insert() on the R code before submitting to R.

An optional, Boolean, named argument. Sends all source lines to the JMP log. This option is global. The default value is true.

An optional, Boolean, named argument. If set to true (1), the submit can be canceled either by pressing the ESCAPE key, or by using this message to an R connection: rconn<<Control( Interrupt( 1 ) ). False (0) is the default value.

rc = R Submit("\[

R Submit File( "pathname" )

Submits statements to R using a file pointed in the specified pathname.

0 if successful; nonzero otherwise.

A quoted string that contains the pathname to the file that contains the R code to be executed.

Terminates the currently active R integration interface

1 if an active R connection exists; otherwise 0.