FORMULA directive

Declares one or more formula data structures.

Options

VALUE = formula

Value for all the formulae; default *

MODIFY = string

Whether to modify (instead of redefining) existing structures (yes, no); default no

IPRINT = strings

Information to be used by default to identify the formulae in output (identifier, extra); if this is not set, they will be identified in the standard way for each type of output

Parameters

IDENTIFIER = identifiers

Identifiers of the formulae

VALUE = formula structures

Value for each formula

EXTRA = texts

Extra text associated with each identifier

Description

The IDENTIFIER parameter lists the identifiers of the formulae that are to be declared. The formula data structure stores a GenStat formula. This can be used to define the model to be fitted in a statistical analysis. Its main use is to give a formula as the argument of a procedure.

Values can be assigned to the formulae by either the VALUE option or the VALUE parameter. The option defines a common value for all the structures in the declaration, while the parameter allows the structures each to be given a different value. If both the option and the parameter are specified, the parameter takes precedence.

You can associate a text of extra annotation with each formula using the EXTRA parameter. If MODIFY is set to yes any existing attributes and values of the formulae are retained; otherwise these are lost.

For example:

FORMULA [VALUE=Drug*Logdose] Model

FORMULA BModel,Tmodel; \

VALUE=!F(Litter/Rat),!F(Vitamin*Protein)

The construction !F(Litter/Rat) is an example of an unnamed formula.

The IPRINT option can be set to specify how the formulae will be identified in output. If IPRINT is not set, they will be identified in whatever way is usual for the section of output is concerned. For example, the PRINT directive generally uses their identifiers (although this can be changed using the IPRINT option of PRINT itself).

Options: VALUE, MODIFY, IPRINT.

Parameters: IDENTIFIER, VALUE, EXTRA.