CHECKOFF

 

Introduction

The command puts variables on an ignore-list, so that they do not influence convergence using Gauss-Seidel iterations.

 

 

Syntax

CHECKOFF ;

CHECKOFF variables ;

CHECKOFF ? ;

 

[empty]

If no variables are stated, i.e. a CHECKOFF without arguments, the list of non-checked variables is cleared.

variables

Variablename(s) or list(s) (wild-cards are allowed)

?

Prints the list of currently ignored variables concerning convergence in Gauss-Seidel method.

         

 

Example

CHECKOFF accepts variable names or lists (including wildcards), for instance:

 

CHECKOFF kbys;

 

Note that the wildcards look for names in the Work databank. Currrent ignored variables can be seen with

 

CHECKOFF ?;

 

There is no CHECKON command. The CHECKOFF command is non-additive (like the ENDO and EXO commands). To eliminate a CHECKOFF-variable, just remove it from the list given to the CHECKOFF command. To clear the CHECKOFF-list, issue a CHECKOFF command with no arguments. An alternative to this is setting "OPTION solve gauss conv ignorevars = no". In that case the list will be ignored.

 

 

Note

In order for this command to work, "OPTION solve gauss conv ignorevars" must be set to 'yes' (which is its default value).

 

CHECKOFF is also the related to the ITERSHOW command. Sometimes a particular variable, or a type of variables, may postpone the convergence of the Gauss-Seidel algorithm. To avoid that, such variables may be put on the CHECKOFF list, and they will be ignored regarding convergence check.

 

 

Related

commands

SIM, OPTION, ITERSHOW