PBSmodelling (version 2.68.8)

getWinVal: Retrieve Widget Values for Use in R Code

Description

Get a list of variables defined and set by the GUI widgets. An optional argument scope directs the function to create local or global variables based on the list that is returned.

Usage

getWinVal(v=NULL, scope="", asvector=FALSE, winName="")

Value

A list (or vector) with named components, where names and values are defined by GUI widgets.

Arguments

v

vector of variable names to retrieve from the GUI widgets. If NULL, v retrieves all variables from all GUI widgets.

scope

scope of the retrieval. The default sets no variables in the non-GUI environment; scope="L" creates variables locally in relation to the parent frame that called the function; scope="P" creates variables in the temporary package workspace called .PBSmodEnv; and scope="G" creates global variables (pos=1).

asvector

return a vector instead of a list. WARNING: if a widget variable defines a true vector or matrix, this will not work.

winName

window from which to select GUI widget values. The default takes the window that has most recently received new user input.

Author

Alex Couture-Beil, Vancouver Island University, Nanaimo BC

Details

TODO: talk about scope=G/P/L and side effects of overwriting existing variables

See Also

parseWinFile, setWinVal, clearWinVal