Run Point-and-Click Interface

Execute various operations in a simple point-and-click user interface.

utilities, iplot
run.simplepanel(P, popup=TRUE, verbose = FALSE)
redraw.simplepanel(P, verbose = FALSE)
An interaction panel (object of class "simplepanel", created by simplepanel or grow.simplepanel).
Logical. If popup=TRUE (the default), the panel will be displayed in a new popup window. If popup=FALSE, the panel will be displayed on the current graphics window if it already exists, and on a new window otherwi
Logical. If TRUE, debugging information will be printed.

These commands enable the user to run a simple, robust, point-and-click interface to any Rcode. The interface is implemented using only the basic graphics package in R.

The argument P is an object of class "simplepanel", created by simplepanel or grow.simplepanel, which specifies the graphics to be displayed and the actions to be performed when the user interacts with the panel.

The command run.simplepanel(P) activates the panel: the display is initialised and the graphics system waits for the user to click the panel. While the panel is active, the user can only interact with the panel; the Rcommand line interface and the RGUI cannot be used. When the panel terminates (typically because the user clicked a button labelled Exit), control returns to the Rcommand line interface and the RGUI.

The command clear.simplepanel(P) clears all the display elements in the panel, resulting in a blank display except for the title of the panel.

The command redraw.simplepanel(P) redraws all the buttons of the panel, according to the redraw functions contained in the panel.

If popup=TRUE (the default), run.simplepanel begins by calling so that a new popup window is created; this window is closed using when run.simplepanel terminates. If popup=FALSE, the panel will be displayed on the current graphics window if it already exists, and on a new window otherwise; this window is not closed when run.simplepanel terminates.

For more sophisticated control of the graphics focus (for example, to use the panel to control the display on another window), initialise the graphics devices yourself using or similar commands; save these devices in the shared environment env of the panel P; and write the click/redraw functions of P in such a way that they access these devices using dev.set. Then use run.simplepanel with popup=FALSE.


  • The return value of run.simplepanel(P) is the value returned by the exit function of P. See simplepanel.

    The functions clear.simplepanel and redraw.simplepanel return NULL.

See Also


  • clear.simplepanel
  • redraw.simplepanel
  • run.simplepanel
if(interactive()) {
Documentation reproduced from package spatstat, version 1.42-2, License: GPL (>= 2)

Community examples

Looks like there are no examples yet.