Working with PRTools is subject to a set of global variables that control the operation of various routines. Here some information on the commands that control them is presented

Memory

If datasets become too large and hardly fit into the available memory, Matlab may crash or slows down due to heavy disk swapping. To prevent this the command prmemory sets the maximum size of datasets. For larger sizes commands start to handle data, where possible, by an internal buffering procedure. Otherwise, an error is generated. The default value is 50*10^6 (in Matlab 8 byte doubles). Depending on the available hardware users may increase this.

An additional buffering scheme can be controlled by setbatch. It controls the processing of datasets by mappings in batches.

PRTools programmers may use prmem to program their own batch loops depending on the value set by prmemory.

CPU Time

Various routines depend on iterative optimization procedures. They stop when a particular accuracy has been reached or after a predetermined number of iterations. For some problems this might last prohibitively long. For that reason an additional condition has been included: such loops will stop after a globally set time. This guarantees a normal ending of all functions applied to any dataset, at the cost possibly sub-optimal results.

The routine that this controls is prtime. It sets the maximum time in seconds allowed for a single iterative loop. By default this is 10 seconds. Users can change this number from the command line. A warning is generated each time a loop is prematurely ended by this routine.

Warnings

PRTools has it own warning system to inform the user of unexpected situations or choices made in the software. It has four levels:

  • 0: no warnings. The warning system is switched off.
  • 1: show sever warnings only. These are useful for users as results might be wrong or need a different interpretation than might be expected.
  • 2: show also warnings for the designer, e.g. when other procedures had to be used than demanded, e.g. due sample size problems or limited computer time.
  • 3: show also light warnings, primarily useful for programmers.

Warning generated in relation with prtime have level 2. Users can change the level from the command line by prwarning. The default level is 1.

Waitbar

Many PRTools routines estimate their progress and report this in a specific PRTools waitbar. This waitbar can be positioned by the user at an arbitrary location on the screen. The waitbar usually properly restarts after an error, except in case a command is stopped by Control-C. In that case the waitbar window should be deleted.

The waitbar overhead can be considerably, e.g. 20%. However, information about progress is often preferred over speed. In case of batch processing progress can be reported in the command window instead of graphically. Users can control the waitbar by the command prwaitbar. Some useful options are

  • prwaitbar off: switch off the waitbar
  • prwaitbar on: switch on the waitbar
  • prwaitbar report: report progress not graphically but in the command window.
  • prwaitbar: reset the waitbar

Gridsize

The plotc command that shows classifiers in a 2D feature space classify an NxN sampling of a region that is defined by a previous scatterplot (scatterd or scattern). By default N = 30. For complicated classifiers this is not sufficient. N = 100 or even N = 300 may be needed at the cost of a considerably larger computing time. Users can define N by the gridsize command.

Inspect globals

User can inspect and reset global variables defined in PRTools by prglobal.