Setplspref

From Eigenvector Research Documentation Wiki
Revision as of 13:08, 7 October 2008 by imported>Jeremy
Jump to navigation Jump to search

Purpose

Set overriding options (preferences) for PLS_Toolbox functions.

Synopsis

setplspref(mfile,options)
setplspref(mfile,option,value)
setplspref(mfile,'factory') %reset preferences for specified file
setplspref('factory') %reset all preferences to factory settings

Description

Sets user-defined "overriding default options" for a PLS_Toolbox function. These preferences will, for a given function, override any factory-default options of the same name. Any option which is defined in the factory-defaults but not specified in the user-defined default options will remain at the factory-default setting.

The keyword 'factory' can be used to reset all or some of the options back to the factory default values: When given as the mfile name (mfile) then all preferences for all functions will be reset; when given as the options structure (options), then all options for the named function will be reset. When given as the value for a specified option, only that option's default is reset.

See below for other input forms.

Inputs

  • mfile = the function name for which preferences are being set.

The subsequent inputs can be one of three forms:

  • Form 1:
    • options = a structure to use as the overriding default options forthe given function. Any previous overriding options are erased.
  • Form 2:
    • option = a string defining the option to set. Any other overriding options for this mfile are left alone and only that one option is changed.
    • value = a value for the particular option
  • Form 3:
    • option = a string defining the option to set. Any other overriding options for this mfile are left alone and only that one option is changed.
    • 'factory' = the string 'factory' resets the speicified option to the factory default.

Examples

options = []; options.plots = 'none'; setplspref('pca',options)
setplspref('pca','plots','none');
setplspref('pca','factory');

See Also

getplspref