DEFINE

This command defines the following entities.

Syntax of command line - keywords:

DEFINE CHARACTERS keyword c 1 c 2 ...
DEFINE TAXA keyword t 1 t 2 ...
DEFINE NAMES keyword n 1, n 2, ...

where c 1, c 2 ... are character numbers, ranges or previously defined keywords, t 1, t 2 ... are taxon numbers, ranges or previously defined keywords, and n 1, n 2 ... are taxon names. Taxon names must be separated by a comma or the end of a line. If the keyword contains spaces, it must be enclosed in quotation marks ("). If a keyword is defined in terms of a previously defined keyword, the meaning of the new keyword is fixed at the time of its definition - that is, it is not affected by subsequent changes in the meaning of the previously defined keyword. The NAMES form of the command is mainly intended for use in INPUT files.

Examples

DEFINE CHARACTERS "reproductive organization" 12 23-24
RESTART
USE 13,2 27,1
DEFINE TAXA g1 remaining

The keyword "g1" continues to represent those taxa with attributes "13,2 27,1", even though the set of taxa represented by the keyword "remaining" may change later in the session.

DEFINE NAMES cereals Echinochloa, Eleusine, Oryza, Panicum, Zea

Syntax of command line - buttons

DEFINE BUTTON switches bitmap.BMP " c 1; c 2; ..." " shorthelp" " fullhelp"
DEFINE BUTTON CLEAR
DEFINE BUTTON SPACE

where bitmap.BMP is the image to be displayed on the button, c 1, c 2, ... are commands, shorthelp is a short help message ("hint") for the button, and fullhelp is detailed help for the button (optional). The buttons are added to the toolbar in the order in which they are defined.

The optional switches are as follows.

The special parameters "?", "?K", "?L", and "?L1" can be used in place of predetermined sets of taxa or characters in the commands invoked by the button. They cause an appropriate dialog box to be displayed, so that the user can make a selection. "?" causes the default dialog box to be displayed (keyword or character/taxon selection depending on the DISPLAY KEYWORDS setting). "?K" causes the keyword selection dialog box to be displayed. "?L" causes the character or taxon selection dialog box to be displayed. "?L1" is applicable only to taxa. It has the same effect as "?L", except that the dialog is not displayed if it would contain only a single taxon - that taxon is automatically selected.

DEFINE BUTTON CLEAR clears all the buttons, and DEFINE BUTTON SPACE puts a space between buttons.

Example:
DEFINE BUTTON START.BMP "INCLUDE TAXA CEREALS; RESTART" "Start a new identification, including only cereals"
DEFINE BUTTON /U CHANGE.BMP "CHANGE ?L" "Change previously entered information about the specimen being identified" "This button allows you to change previously entered information about the specimen being identified."

Syntax of command line - end of identification

N.B. This feature was designed for use with older versions of Intkey. We recommend against using it with the current version, as it usually obscures other important information which the program displays at the end of an identification.

DEFINE ENDIDENTIFY switch " c 1; c 2; ..."

where c 1, c 2, ... are commands. The optional switch /T= n causes the output to be produced in n tiled windows.

Example:
DEFINE ENDIDENTIFY "DESCRIBE REMAINING BRIEF"

Syntax of command line -information

DEFINE INFORMATION " s" " c"

where s is the subject to be displayed in the INFORMATION dialog, and c is an Intkey command. The subjects are added to the list box in the dialog in the order in which they are defined, and after any subjects which were defined when the Intkey data files were generated. The special parameter "?S" should be used in place of a set of taxa in the command c. It means "the taxon currently selected in the INFORMATION dialog".

Example: DEFINE INFORMATION "Diagnostic description" "diagnose ?S none"

Syntax of command line - subjects

DEFINE SUBJECTS w1 w2 ...

where w1 , w2 , ... are words, or phrases enclosed in quotation marks ("). The words or phrases are placed in the "Subjects" list box in the "Select Multiple Images" dialog box, which is invoked by the "Multiple Images" option of the "Control" menu in taxon-image windows. The images displayed are restricted to those whose "subjects" contain any of the words or phrases selected in the list box.

Example:
DEFINE SUBJECTS anatomy "distribution map" "habit " habitat inflorescence type

The space in "habit " prevents it from matching "habitat" in a subject. "type" matches "holotype" and "isotype", but " type" would not.