1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68
|
BATCH_STRINGS explanation of the batch string format
Batch strings are the format in which options must be specified for
the MEX files in the psychometric functions toolbox. See below for an
example that illustrates the format.
Batch strings in MATLAB are horizontal string vectors, containing
newline characters, suitable for reading from and writing to ordinary
text files. The rules for construction of a batch string follow. If using
MATLAB 5, you do not need to worry about this because the function
BATCH will construct the string for you from ordinary MATLAB matrices and
variables.
Batch strings are used rather than MATLAB structs in order to allow the
MEX files to be used with MATLAB 4, and also to retain compatibility with
the UNIX command-line and stand-alone versions of the software. Note that
most of the accompanying M-files, by contrast, are NOT compatible with
MATLAB 4. As a result, if MATLAB 5 is unavailable, batch strings will be
more conveniently read from text files, instead of being generated on the
command line.
Variables are recorded in a batch string in key/value pairs. Keys must
be prefixed by the character #, and must be the first word of a line.
There should be no whitespace between the # and they key word, because
this causes the variable to be ignored: entries can be "commented out"
conveniently in this way.
Values are separated from their keys by whitespace. There are two sorts
of values: strings, and lists of numbers.
Strings variables within a batch string can contain any characters.
Quotes are not needed, and are undesirable in most cases because they
will be interpreted literally.
Numbers may be expressed in a variety of formats, as illustrated in the
example below. Numbers in a list may be delimited by commas, semicolons
or whitespace. Brackets are not required, but a single pair encompassing
the whole list is permitted: {}, [] or ().
See BATCH, BATCH2STRUCT and STRUCT2BATCH for a convenient
interface with MATLAB 5.
Example of a batch string:
#name NJH
#eyes 2
#colour brown
#glasses true
#favourite_food #-browns
#favourite_numbers
[ -INF,
0, 1, 3.1415927,
6.02e23;
EPS 65536, NAN
2/3 25]
# oops
this field will not be read, because of
the whitespace between the # and the key word
Part of the psignifit standalone distribution version 2.5.6.
Copyright (c) J.Hill 1999-2005.
Please read the LICENSE and NO WARRANTY statement in Legal.txt
mailto:psignifit@bootstrap-software.org
http://bootstrap-software.org/psignifit/
|