outputting: opens/closes graph/text files

In rbsa: Ancillary Functions for R Programming

Description

(open8graph) According to the global constant rbsa0$mfi$v a graphical device is open or not. To be called before plotting something that ones want to keep under rbsa0$mgr$v type.
(close8graph) Closes the file open by open8graph. When monitor$pau$v is TRUE, a pause is issued.
(open8text) Opens the standard output text for /rbsa/. According to the global constant rbsa0$mfi$v the standard output text of rbsa is open (in append mode) or not. The name of this file is provided by the constant rbsa0$fou$v. Must be called before printing something ones want to keep on file.
(close8text) Closing the output file rbsa0$fou$v according to rbsa0$mfi$v. A pause allowing to stop the process is issued if rbsa0$pau$v is TRUE.

Usage

 
  open8graph(prefix=rbsa0$fpx$v,...) 
  close8graph(mensaje=character(0),monitor=rbsa0$monitor$v) 
  open8text(append=TRUE) 
  close8text(mensaje=character(0),monitor=rbsa0$monitor$v) 

Arguments

prefix	When numeric, it is used with three digits to complete the constant rbsa0$fpx$v. If not, must be a character giving the complete prefix to use before the suffix.
...	argument(s) to be transmitted to the opening device of graphics. Quite useful for specific character and picture sizes, or to get more than one graph into the file.
mensaje	Message to display on the terminal. When empty, no message will be displayed.
monitor	List of monitoring constants, see rbsa0$monitor$v to know its structure.
append	Must the current file rbsa0$fou$v be continued ?

Details

(open8graph) The file opened for storing the graph is named with two components separated with dots: the prefix and the suffix. The prefix is either given by the first argument or
paste(rbsa0$fpx$v,prefix,sep="."); the suffix is rbsa0$mgr$v associated to the type of the graph (either 'pdf' or 'png').
(close8graph) This action is conditioned by the value of rbsa0$mfi$v. The pausing is conditionned by (i) a non empty mensaje and (ii) monitor$pau$v.
(open8text) Usual derivation is done with sink until close8text is called.
(close8text) This action is conditioned by the value of rbsa0$mfi$v. The pausing is conditionned by (i) a non empty mensaje and (ii) monitor$pau$v.

Value

(open8graph) 0 when is.character(prefix) and prefix+1 when is.numeric(prefix). The last option is intended to generate a series of numbered graph file names.
(close8graph) Nothing but the actions indicated in the description field are performed.
(open8text) nothing but the indicated actions are performed
(close8text) nothing but the actions indicated in the description field are performed

Examples

 
  open8graph("my_graph"); 
  close8graph(); 
  open8graph(5); 
  close8graph(); 

rbsa documentation built on May 2, 2019, 6:07 p.m.