Datatype-specific attributes are available (can be defined) for certain ACD datatypes only. Each datatype has its own set of these attributes. Additionally, there are various datatype-associated command line qualifiers (or simply "associated qualifiers") that are inbuilt for certain ACD datatypes and may also be defined as attributes in the appropriate data definition. Both types of attribute are described in detail below. Their value is set explicitly in an ACD data definition as follows:
DataAttributeName
: "DataAttributeValue
"
In the descriptions of the attributes, the value type and default value are indicated as follows:
DataAttributeName
:Type
("Default
")
size: "
. The number of elements in the array.integer
" ("1")
minimum: "
. Lower value limit. Defaults to the boundaries as specified by the systems set-up.float
" ("-FLT_MIN")
maximum: "
. Upper value limit. Defaults to the boundaries as specified by the systems set-up.float
" ("+FLT_MAX")
trueminimum: "
. Used for calculated values of boolean
" ("N")minimum:
and maximum:
. By default the minimum value is used if the minimum and maximum values overlap.
failrange: "
. Used for calculated values of boolean
" ("Y")minimum:
and maximum:
. By default the application fails if the calculated ranges overlap.
rangemessage: "
. Used for calculated values of string
" ("")minimum:
and maximum:
. Failure message to use if calculated ranges overlap.
sum: "
. Total for all values in the array (tested unless the float
" ("1.0")sumtest:
attribute is false).
sumtest: "
. If false, turns off testing for the boolean
" ("Y")sum:
attribute.
tolerance: "
. Specifies how closely the float
" ("0.01")sum:
should match the total. Most floating point fractions cannot be represented accurately in binary form.
warnrange: "
. Controls whether a warning is issued if values are given that are out of range.boolean
" ("Y")
increment: "
. Defines the steps the array values may take when iterated. The integer
" ("0")increment:
can be any valid float value. Implemented for GUIs to EMBOSS only and is not used by EMBOSS itself (it is disregarded during ACD file processing).
precision: "
. Defines the maximum number of significant decimal places that will be taken into account for this value. Implemented for GUIs to EMBOSS only and is not used by EMBOSS itself (it is disregarded during ACD file processing).integer
" ("0")
boolean
currently has no specific attributes.
The boolean
datatype has no associated qualifiers.
Care should be taken over the definition of the information:
and help:
global attributes. These are used to prompt the user (interactively or via a GUI), and to provide help text. The text provided in each case should reflect the expected default value of the boolean option, which may be the opposite of what the name implies. For example, if set to "Y"
by default, then the command line option would typically be -no
where Flag
Flag
is the qualifier. If set to "N"
by default, then the default action may be the opposite of what the information or help text implies. If the value is calculated, the user may need some extra guidance.
minimum: "
. Lower value limit. Defaults to the boundaries as specified by the systems set-up.float
" ("-FLT_MIN")
maximum: "
. Upper value limit. Defaults to the boundaries as specified by the systems set-up.float
" ("+FLT_MAX")
trueminimum: "
. Used for calculated values of boolean
" ("N")minimum:
and maximum:
. By default the minimum value is used if the minimum and maximum values overlap.
failrange: "
. Used for calculated values of boolean
" ("Y")minimum:
and maximum:
. By default the application fails if the calculated ranges overlap.
rangemessage: "
. Used for calculated values of string
" ("")minimum:
and maximum:
. Failure message to use if calculated ranges overlap.
increment: "
. The steps that this parameter is allowed to take, in case there is a need to iterate this parameter. The float
" ("1")increment:
attribute can be any valid float value.
precision: "
. The maximum number of significant decimal places that will be taken into account for this value.integer
" ("3")
warnrange: "
. Controls whether a warning is issued if values are given that are out of range.boolean
" ("Y")
minimum: "
. Lower value limit. Defaults to the boundaries as specified by the systems set-up.integer
" ("INT_MIN")
maximum: "
. Upper value limit. Defaults to the boundaries as specified by the systems set-up.integer
" ("INT_MAX")
trueminimum: "
. Used for calculated values of boolean
" ("N")minimum:
and maximum:
. By default the minimum value is used if the minimum and maximum values overlap.
failrange: "
. Used for calculated values of boolean
" ("Y")minimum:
and maximum:
. By default the application fails if the calculated ranges overlap.
rangemessage: "
. Used for calculated values of string
" ("")minimum:
and maximum:
. Failure message to use if calculated ranges overlap.
increment: "
. Defines the steps that this parameter is allowed to take, in case there is a need to iterate this parameter.integer
" ("0")
warnrange: "
. Controls whether a warning is issued if values are given that are out of range.boolean
" ("Y")
minimum: "
. Lower value limit.integer
" ("1")
maximum: "
. Upper value limit. Defaults to the boundaries as specified by the systems set-up.integer
" ("INT_MAX")
trueminimum: "
. Used for calculated values of boolean
" ("N")minimum:
and maximum:
. By default the minimum value is used if the minimum and maximum values overlap.
failrange: "
. Used for calculated values of boolean
" ("Y")minimum:
and maximum:
. By default the application fails if the calculated ranges overlap.
rangemessage: "
. Used for calculated values of string
" ("")minimum:
and maximum:
. Failure message to use if calculated ranges overlap.
minsize: "
. Where multiple ranges are defined integer
" ("0")minsize:
defines the minimum number of ranges that must be defined.
size: "
. Exact number of values required.integer
" ("0")
Only one of size:
or minsize:
should be defined for any range.
minlength: "
. The minimum length the regular expression string can be.integer
" ("1")
maxlength: "
. The maximum length the regular expression string can be.integer
" ("INT_MAX")
upper: "
. Convert the regular expression to upper case before compiling.boolean
" ("N")
lower: "
. Convert the regular expression to lower case before compiling.boolean
" ("N")
maxsize: "
. The maximum number of patterns.integer
" ("INT_MAX")
type:
The type of pattern, currently one of string
, nucleotide
or protein
.
minlength: "
. The minimum length the pattern can be.integer
" ("1")
maxlength: "
. The maximum length the pattern can be.integer
" ("INT_MAX")
upper: "
. Convert the pattern to upper case before compiling.boolean
" ("N")
lower: "
. Convert the pattern to lower case before compiling.boolean
" ("N")
maxsize: "
. The maximum number of patterns.integer
" ("INT_MAX")
type:
The type of pattern, currently one of string
, nucleotide
or protein
.
The pattern
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
pformat: "string
" ("")
File format.
pmismatch: "integer
" ("")
Pattern mismatch.
pname: "string
" ("")
Pattern base name.
minlength: "
. Minimum length of the string. The default minimum length is zero.integer
" ("0")
maxlength: "
. Maximum length of the string. There is no default maximum.integer
" ("INT_MAX")
pattern: "
. Defines a regular expression used to validate the string value: an invalid string will be reprompted for. EMBOSS uses the Perl-compatible regular expression library (PCRE) so any Perl-compatible regular expression should be usable.string
" ("")
word: "
. If set requires the result to be a valid word with no whitespace. Note that the default minimum length of zero allows an empty string however this is not accepted as a word.boolean
" ("N")
upper: "
. Converts the case of the string internally to upper case.boolean
" ("N")
lower: "
. Converts the case of the string internally to lower case.boolean
" ("N")
Only one of upper:
or lower:
should be specified.
Although there are (currently) no specific attributes for a toggle ACD type, care should be taken over the definition of the information:
and help:
attributes. These are used to prompt the user (interactively or via a GUI), and to provide help text. The text provided in each case should reflect the expected default value of the toggle option, which may be the opposite of what the name implies. For example, if set to "Y"
by default, then the command line option would typically be -no
where Flag
Flag
is the qualifier. If set to "N"
by default, then the default action may be the opposite of what the information or help text implies. If the value is calculated, the user may need some extra guidance.
name: "
. Individual codon data definitions can set their own default codon usage tables with the string
" ("Ehum.cut")name:
attribute. Alternatively, this can be set via the global attribute default:
.
nullok: "
. If the application can accept a null value for this definition and can run without a codon usage table, the boolean
" ("N")nullok:
attribute must be set to "Y"
. In such cases the codon usage file might not be specified (in the ACD file or on the command line) for the data definition. This might occur when the codon usage table is only required by the application under certain circumstances.
name: "
. Individual string
" ("")cpdb
inputs can set their own default names with the name:
attribute which in the current version has the same effect as setting the default:
global attribute.
nullok: "
. If the application can accept a null value for this definition and can run without clean PDB file input, the boolean
" ("N")nullok:
attribute must be set to "Y"
. In such cases a clean coordinate file might not be specified (in the ACD file or on the command line) for the data definition. This might occur when the file is only required by the application under certain circumstances.
name: "
. Base name of the default datafile.string
" ("")
extension: "
. File extension of the default datafile.string
" ("")
directory: "
. The EMBOSS data subdirectory to be searched.string
" ("")
nullok: "
. If the application can accept a null value for this definition and can run without a datafile, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted, or -no
(where Flag
Flag
is the name of the definition), to be specified on the command line.
extension: "
. The file extension for all files read from the directory. Files with other extensions will not be readstring
" ("")
fullpath: "
. If set to boolean
" ("N")"Y"
will interpret the specified directory as a full path rather than a relative path.
nullok: "
. If the application can accept a null value for this definition and can run without a directory the boolean
" ("N")nullok:
attribute must be set to "Y"
. In such cases a default directory might not be set, or -no
, where Flag
Flag
is the name of the data definition flag, might be given on the command line.
nulldefault: "
. By default, names for files in the directory are constructed from the path and extension as described above. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no directory) by default. This is useful for programs which only occasionally require a directory. If an empty string is specified for the directory on the command line, the default name generation will be used. In combination with the nullok:
, this allows qualifiers to be null by default, and turned on from the command line.
extension: "
. The extension for all files read from the directories. Files with other extensions will not be read.string
" ("")
fullpath: "
. If set to boolean
" ("N")"Y"
will interpret the given path as a full rather than a relative path specification.
nullok: "
. If the application can accept a null value for this definition and can run without a directory the boolean
" ("N")nullok:
attribute must be set to "Y"
. In such cases a default directory might not be set, or -no
, where Flag
Flag
is the name of the data definition flag, might be given on the command line.
length: "
. The number of state values (the length of the discrete characters string) in each setinteger
" ("0")
size: "
. The number of sets of values (usually 1) but some programs will accept multiple sets.integer
" ("1")
characters: "
. Defines which discrete state characters can be specified. This is defined as a string containing all possible characters.string
" ("01")
nullok: "
. If the application can accept a null value for this definition and can run without a boolean
" ("N")discretestates
file, the nullok:
attribute must be set to "Y"
. This allows the application to run without a default value or to be run with -no
(where Flag
Flag
is the name of the data definition) on the command line.
size: "
. The number of rows in the distance matrix.integer
" ("1")
missval: "
. If set to boolean
" ("N")"Y"
means the matrix can have missing values.
nullok: "
. If the application can accept a null value for this definition and can run without a distance matrix file, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows the application to run without a default value or to be run with -no
(where Flag
Flag
is the data definition flag) on the command line.
type: "
. Whether the feature input is "protein" or "nucleotide". There is a default based on the type of any input sequence, but a value should always be specified.string
" ("")
nullok: "
. If the application can accept a null value for this definition and can run without boolean
" ("N")features
input, the nullok:
attribute must be set to "Y"
. This allows the application to run without a default value or to be run with -no
(where Flag
Flag
is the data definition flag) on the command line.
The features:
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
fformat: "string
" ("")
Features format.
fopenfile: "string
" ("")
Features file name.
fask: "boolean
" ("N")
Prompt for begin/end/reverse.
fbegin: "integer
" ("0")
Start of the features to be used.
fend: "integer
" ("0")
End of the features to be used.
freverse: "boolean
" ("N")
Reverse (if DNA).
nullok: "
. If the application can accept a null value for this definition and can run without a boolean
" ("N")filelist
input, the nullok:
attribute must be set to "Y"
. This specifies that a missing input file is acceptable to the application, and that -no
(where Flag
Flag
is the data definition flag) can be used on the command line.
length: "
. Defines the number of loci (or values) in the frequencies file.integer
" ("0")
size: "
. The number of sets of values, usually 1 but some programs will accept multiple sets.integer
" ("1")
continuous: "
. Specifies a frequencies file with continuous character data values.boolean
" ("N")
genedata: "
. Specifies a frequencies file with genetic locus data values.boolean
" ("N")
within: "
. Specifies a frequencies file with continuous data for multiple individuals (additional values on each line).boolean
" ("N")
nullok: "
. If the application can accept a null value for this definition and can run without a boolean
" ("N")frequencies
file, the nullok:
attribute must be set to "Y"
. This allows the application to be run without a default value or with -no
(where Flag
Flag
is the of the data definition flag) on the command line.
nullok: "
. Specifies that a missing input file is acceptable to the application. The application can then run without a default value or with boolean
" ("N")-no
(where Flag
Flag
is the name of the data definition) on the command line.
directory: "@(value:
. Specifies a directory in which to search for the file. The directory is given by the environment variable ENVARNAME
"ENVARNAME
, which is resolved first as EMBOSS_
(in ENVARNAME
emboss.default
or set by a setenv
) call. It then checks for ENVARNAME
(set using setenv
). If an explicit path is given in the filename by the user, the directory is ignored.
protein: "
. If set to boolean
" ("Y")"Y"
will specify that the scoring matrix is a protein matrix. If not set the matrix is presumed to be for nucleic acids.
pname: "
. Defines the default protein matrix to use. The system default is string
" ("EBLOSUM62")EBLOSUM62
for protein matrices.
nname: "
. Defines the default nucleotide matrix to use. The system default is string
" ("EDNAFULL")EDNAFULL
for nucleotide matrices.
protein: "
. If set to boolean
" ("Y")"Y"
will specify that the scoring matrix is a protein matrix. If not set the matrix is presumed to be for nucleic acids.
pname: "
. Defines the default protein matrix to use. The system default is string
" ("EBLOSUM62")EBLOSUM62
for protein matrices.
nname: "
. Defines the default nucleotide matrix to use. The system default is string
" ("EDNAFULL")EDNAFULL
for nucleotide matrices.
length: "
. The number of values in the properties file.integer
" ("0")
size: "
. The number of sets of values, usually 1 but some programs will accept multiple sets.integer
" ("1")
characters: "
. Defines which property characters can be specified. This is defined as a string containing all possible characters.string
" ("")
nullok: "
. If the application can accept a null value for this definition and can run without a properties file, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nullok: "
. Used to set defaults for individual boolean
" ("N")scop
inputs and has the same effect as setting the default:
attribute.
type: "
. Forces the sequence to be of the given type. By default any sequence type is accepted. Ideally the string
" ("")type:
attribute will always be set so that the accepted input sequence type is clear. The sequence type must be a standard sequence type (Section A.7, “Sequence Types”).
features: "
. If the boolean
" ("N")features:
attribute is set, the sequence input will include feature information either in the same file (if the sequence format supports it) or in a separate file, which by default is in GFF format.
entry: "
. When set, the sequence input will include the full original text of the input sequence or database entry.boolean
" ("N")
nullok: "
. If the application can accept a null value for this definition and can run without sequence input, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
The sequence
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
sbegin: "integer
" ("0")
Start of the sequence to be used.
send: "integer
" ("0")
End of the sequence to be used.
sreverse: "boolean
" ("N")
Reverse (if DNA).
sask: "boolean
" ("N")
Ask for begin/end/reverse.
snucleotide: "boolean
" ("N")
Sequence is nucleotide.
sprotein: "boolean
" ("N")
Sequence is protein.
slower: "boolean
" ("N")
Make lower case.
supper: "boolean
" ("N")
Make upper case.
sformat: "string
" ("")
Input sequence format.
sdbname: "string
" ("")
Database name.
sid: "string
" ("")
Entryname.
ufo: "string
" ("")
UFO features.
fformat: "string
" ("")
Features format.
fopenfile: "string
" ("")
Features file name.
type: "
. Forces the sequence(s) to be of the given type. By default any sequence type is accepted. The string
" ("")type:
attribute is normally set so that the accepted input sequence type is clear. The sequence type must be a standard sequence type (Section A.7, “Sequence Types”).
features: "
. If the boolean
" ("N")features:
attribute is set, the sequence input will include feature information either in the same file (if the sequence format supports it) or in a separate file (by default in GFF format).
entry: "
. If set, the sequence input will include the full original text of the input sequence or database entry.boolean
" ("N")
nullok: "
. If the application can accept a null value for this definition and can run without sequence input, the boolean
" ("N")nullok:
must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
minseqs: "
. Minimum number of sequences to be read. By default, a minimum of one sequence is acceptable.integer
" ("1")
maxseqs: "
. Maximum number of sequences to be read. By default, there is no maximum.integer
" ("INT_MAX")
The seqall
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
sbegin: "integer
" ("0")
Start of the sequence to be used.
send: "integer
" ("0")
End of the sequence to be used.
sreverse: "boolean
" ("N")
Reverse (if DNA).
sask: "boolean
" ("N")
Ask for begin/end/reverse.
snucleotide: "boolean
" ("N")
Sequence is nucleotide.
sprotein: "boolean
" ("N")
Sequence is protein.
slower: "boolean
" ("N")
Make lower case.
supper: "boolean
" ("N")
Make upper case.
sformat: "string
" ("")
Input sequence format.
sdbname: "string
" ("")
Database name.
sid: "string
" ("")
Entryname.
ufo: "string
" ("")
UFO features.
fformat: "string
" ("")
Features format.
fopenfile: "string
" ("")
Features file name.
type: "
. Forces the sequence set to be of the given type. By default any sequence type is accepted. Ideally the string
" ("")type:
attribute will always be set so that the accepted input sequence type is always clear. The sequence type must be a standard sequence type (Section A.7, “Sequence Types”).
aligned: "
. If set, specifies that all sequences in the input are expected to be aligned. If false then the sequences are assumed to be unaligned, and are simply read into memory together for processing. We recommend always defining the boolean
" ("N")aligned:
attribute so that the nature of the sequence set is clearly defined.
features: "
. If the boolean
" ("N")features:
attribute is set, the sequence input will include feature information either in the same file (if the sequence format supports it) or in a separate file (by default in GFF format).
entry: "
. If set, the sequence input will include the full original text of the input sequence or database entry.boolean
" ("N")
nullok: "
. If the application can accept a null value for this definition and can run without sequence input, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no sequence input) as the default for programs where sequence input is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
minseqs: "
. Minimum number of sequences to be read. By default, a minimum of one sequence is acceptable.integer
" ("1")
maxseqs: "
. Maximum number of sequences to be read. By default, there is no maximum.integer
" ("INT_MAX")
The seqset
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
sbegin: "integer
" ("0")
Start of the sequence to be used.
send: "integer
" ("0")
End of the sequence to be used.
sreverse: "boolean
" ("N")
Reverse (if DNA).
sask: "boolean
" ("N")
Ask for begin/end/reverse.
snucleotide: "boolean
" ("N")
Sequence is nucleotide.
sprotein: "boolean
" ("N")
Sequence is protein.
slower: "boolean
" ("N")
Make lower case.
supper: "boolean
" ("N")
Make upper case.
sformat: "string
" ("")
Input sequence format.
sdbname: "string
" ("")
Database name.
sid: "string
" ("")
Entryname.
ufo: "string
" ("")
UFO features.
fformat: "string
" ("")
Features format.
fopenfile: "string
" ("")
Features file name.
type: "
. Forces the sequence set(s) to be of the given type. By default any sequence type is accepted. Ideally the string
" ("")type:
attribute will be set so that the accepted input sequence type is clear. The sequence type must be a standard sequence type (Section A.7, “Sequence Types”).
aligned: "
. If true, it specifies that all sequences in the input are expected to be aligned. If false then the sequences are assumed to be unaligned, and are simply read into memory together for processing. Ideally the boolean
" ("N")aligned:
attribute should always be set so that the nature of the sequence set is clearly defined.
features: "
. If set, will make the sequence input include feature information either in the same file (if the sequence format supports it) or in a separate file (by default in GFF format).boolean
" ("N")
entry: "
. If set, the sequence input will include the full original text of the input sequence or database entry.boolean
" ("N")
nullok: "
. If the application can accept a null value for this definition and can run without sequence input, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no sequence input) as the default for programs where sequence input is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
minsets: "
. Minimum number of sequence sets to be read. By default, a minimum of one sequence set is acceptable.integer
" ("1")
maxsets: "
. Maximum number of sequence sets to be read. By default, there is no maximum (other than system-imposed limits on the size of an integer).integer
" ("INT_MAX")
minseqs: "
. Minimum number of sequences to be read. By default, a minimum of one sequence is acceptable.integer
" ("1")
maxseqs: "
. Maximum number of sequences to be read. By default, there is no maximum.integer
" ("INT_MAX")
The seqsetall
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
sbegin: "integer
" ("0")
Start of the sequence to be used.
send: "integer
" ("0")
End of the sequence to be used.
sreverse: "boolean
" ("N")
Reverse (if DNA).
sask: "boolean
" ("N")
Ask for begin/end/reverse.
snucleotide: "boolean
" ("N")
Sequence is nucleotide.
sprotein: "boolean
" ("N")
Sequence is protein.
slower: "boolean
" ("N")
Make lower case.
supper: "boolean
" ("N")
Make upper case.
sformat: "string
" ("")
Input sequence format.
sdbname: "string
" ("")
Database name.
sid: "string
" ("")
Entryname.
ufo: "string
" ("")
UFO features.
fformat: "string
" ("")
Features format.
fopenfile: "string
" ("")
Features file name.
size: "
. The number of trees in the input file. Some can only accept a single tree so the value should be set to integer
" ("0")"1"
for these. A value of "0"
means that any number of trees is acceptable.
nullok: "
. If the application can accept a null value for this definition and can run without tree input, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
minseqs: "
. The minimum number of sequences that are expected in the output alignment.integer
" ("1")
The minseqs:
and maxseqs:
attributes can be used to validate application output, for example, when selecting formats on the command line with the -aformat
qualifier.
maxseqs: "
. The maximum number of sequences that are expected in the output alignment.integer
" ("INT_MAX")
The minseqs:
and maxseqs:
attributes can be used to validate application output, for example, when selecting formats on the command line with the -aformat
qualifier.
multiple: "
. Should be set to boolean
" ("N")"Y"
if the output can contain more than one alignment from the same input.
type:
The sequence type. Although this will default to the type of the first output sequence, it is recommended that a value is always defined to make the output sequence type clear.
taglist: "
. Defines additional tags to be reported from the internal feature table for the aligned sequences. The tag names and types must match the source code of the application. Each tag is in the format string
" ("")type:tagname[=columnname]
for example int:length
or string:gc=GC%
nullok: "
. If the application can accept a null value for this definition and can run without generating alignment output, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no alignment file) as the default for programs where an alignment file is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead.
The align:
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
aformat: "string
" ("")
Alignment format.
aextension: "string
" ("")
File name extension.
adirectory: "string
" ("")
Output directory.
aname: "string
" ("")
Base file name.
awidth: "integer
" ("0")
Alignment width.
aaccshow: "boolean
" ("N")
Show accession number in the header.
adesshow: "boolean
" ("N")
Show description in the header.
ausashow: "boolean
" ("N")
Show the full USA in the alignment.
aglobal: "boolean
" ("N")
Show the full sequence in alignment.
The align
datatype has two associated qualifiers (-aformat
and -aglobal
) which which are often hard-coded as attributes in an ACD file (see the EMBOSS Users Guide). aformat:
defines the default value for the -aformat
qualifier, which is the default alignment format. aglobal:
defines the default value for the -aglobal
qualifier, and should be set to "Y"
for programs that produce a global alignment.
name: "
. Base name of output file name. Use of string
" ("")-ofname
(see below) is preferred.
extension: "
. Extension of output file name. Use of string
" ("")-offormat
(see below) is preferred.
type: "
. Defines whether the feature output is string
" ("")"protein"
or "nucleotide"
. There is a default based on the type of any input sequence, but a value should always be specified.
multiple: "
. Should be set to boolean
" ("N")"Y"
if the feature annotation is for multiple sequences.
nullok: "
. If the application can accept a null value for this definition and can run without generating feature output, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no feature output) as the default for programs where feature output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The featout
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
offormat: "string
" ("")
Output feature format.
ofopenfile: "string
" ("")
Features file name.
ofextension: "string
" ("")
File name extension.
ofdirectory: "string
" ("")
Output directory.
ofname: "string
" ("")
Base file name.
ofsingle: "boolean
" ("N")
Separate file for each entry.
The featout
datatype has two associated qualifiers (-offormat
and -ofname
) which are often hard-coded as attributes in an ACD file (see the EMBOSS Users Guide). offormat:
defines the default value for the -offormat
qualifier which is the feature format and default file extension. ofname:
defines the default value for the -ofname
qualifier which is the default base file name
name: "
. Base name of output file name.string
" ("")
extension: "
. Extension of output file name.string
" ("")
nullok: "
. If the application can accept a null value for this definition and can run without generating codon output, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no data output) as the default for programs where data output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The outcodon
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
odirectory: "string
" ("")
Output directory.
oformat: "string
" ("")
Output format specific to this data type.
The outcodon
datatype has a datatype-associated command line qualifier (-oformat
) which is often hard-coded as an attribute in an ACD file (see the EMBOSS Users Guide). oformat:
defines the default value for the -oformat
qualifier which is the file format.
extension: "
. Extension of output file name. The string
" ("")extension:
attribute will default to the output file format.
nullok: "
. If the application can accept a null value for this definition and can run without generating coordinate file output, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no data output) as the default for programs where data output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The outcpdb
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
odirectory: "string
" ("")
Output directory.
oformat: "string
" ("")
Output format specific to this data type.
The outcpdb
datatype has a datatype-associated command line qualifier (-oformat
) which is often hard-coded as an attribute in an ACD file (see the EMBOSS Users Guide). oformat:
defines the default value for the -oformat
qualifier which is the file format and default file extension.
type: "
. Defines the output data type. It is recommended that a value is always defined to make the output data type clear.string
" ("")
nullok: "
. If the application can accept a null value for this definition and can run without generating formatted data output, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no data output) as the default for programs where data output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The outdata
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
odirectory: "string
" ("")
Output directory.
oformat: "string
" ("")
Output format specific to this data type.
The outdata
datatype has a datatype-associated command line qualifier (-oformat
) which is often hard-coded as an attribute in an ACD file (see the EMBOSS Users Guide). oformat:
defines the default value for the -oformat
qualifier which is the file format and default file extension.
fullpath: "
. If set to boolean
" ("N")"Y"
requires the path to be specified in full when passed to the program, although the user may provide a path from the current working directory.
extension: "
. The default extension for all files written to the directory.string
" ("")
nullok: "
. If the application can accept a null value for this definition and can run without an output directory, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no data output) as the default for programs where data output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
nullok: "
. If the application can accept a null value for this definition and can run without generating an output file, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no data output) as the default for programs where data output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The outdiscrete
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
odirectory: "string
" ("")
Output directory.
oformat: "string
" ("")
Output format specific to this data type.
The outdiscrete
datatype has a datatype-associated command line qualifier (-oformat
) which is often hard-coded as an attribute in an ACD file (see the EMBOSS Users Guide). oformat:
defines the default value for the -oformat
qualifier which is the file format and default file extension.
nullok: "
. If the application can accept a null value for this definition and can run without generating a distance matrix file, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no data output) as the default for programs where data output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The outdistance
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
odirectory: "string
" ("")
Output directory.
oformat: "string
" ("")
Output format specific to this data type.
The outdistance
datatype has a datatype-associated command line qualifier (-oformat
) which is often hard-coded as an attribute in an ACD file (see the EMBOSS Users Guide). oformat:
defines the default value for the -oformat
qualifier which is the file format and default file extension.
nullok: "
. If the application can accept a null value for this definition and can run without generating an output frequencies file, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no data output) as the default for programs where data output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The outfreq
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described elsewhere (see the EMBOSS Users Guide):
odirectory: "string
" ("")
Output directory.
oformat: "string
" ("")
Output format specific to this data type.
The outfreq
datatype has a datatype-associated command line qualifier (-oformat
) which is often hard-coded as an attribute in an ACD file (see the EMBOSS Users Guide). oformat:
defines the default value for the -oformat
qualifier which is the file format and default file extension.
name: "
. Base name of output file name. By default, any input file or sequence name will be used. If there is no input file processed so far, the default name is "outfile".string
" ("")
extension: "
. Extension of output file name.string
" ("")
append: "
. If set, specifies that output is appended to the end of an existing output file. By default the output file will be overwritten.boolean
" ("N")
nullok: "
. If the application can accept a null value for this definition and can run without generating an output file, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no output file) as the default for programs where an output file is only occasionally required. Examples include programs where the original output format is available, usually for users that still require it for parsing in automated scripts. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The knowntype:
global attribute (Section A.4, “Global Attributes”) should always be defined. If the output is not of any of the standard EMBOSS known types,
is the recommended value.ApplicationName
output
name: "
. Base name of output file name. By default, any input file or sequence name will be used. If there is no input file processed so far, the default name is "outfile".string
" ("")
extension: "
. Extension of output file name.string
" ("")
nullok: "
. If the application can accept a null value for this definition and can run without generating an output file, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no output file) as the default for programs where an output file is only occasionally required. Examples include programs where the original output format is available, usually for users that still require it for parsing in automated scripts. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The knowntype:
global attribute (Section A.4, “Global Attributes”) should always be defined. If the output is not of any of the standard EMBOSS known types (Section A.4, “Global Attributes”,
is the recommended value."ApplicationName
output"
nullok: "
. If the application can accept a null value for this definition and can run without generating an matrix file, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no data output) as the default for programs where data output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The outmatrix:
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
odirectory: "string
" ("")
Output directory.
oformat: "string
" ("")
Output format specific to this data type.
The outmatrix
datatype has a datatype-associated command line qualifier (-oformat
) which is often hard-coded as an attribute in an ACD file (see the EMBOSS Users Guide). oformat:
defines the default value for the -oformat
qualifier which is the file format and default file extension.
nullok: "
. If the application can accept a null value for this definition and can run without generating an matrix file, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no data output) as the default for programs where data output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The outmatrixf:
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
odirectory: "string
" ("")
Output directory.
oformat: "string
" ("")
Output format specific to this data type.
The outmatrixf
datatype has a datatype-associated command line qualifier (-oformat
) which is often hard-coded as an attribute in an ACD file (see the EMBOSS Users Guide). oformat:
defines the default value for the -oformat
qualifier which is the file format and default file extension.
nullok: "
. If the application can accept a null value for this definition and can run without generating a properties file, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no data output) as the default for programs where data output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The outproperties:
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
odirectory: "string
" ("")
Output directory.
oformat: "string
" ("")
Output format specific to this data type.
The outproperties
datatype has a datatype-associated command line qualifier (-oformat
) which is often hard-coded as an attribute in an ACD file (see the EMBOSS Users Guide). oformat:
defines the default value for the -oformat
qualifier which is the file format and default file extension.
nullok: "
. If the application can accept a null value for this definition and can run without generating an output file, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no data output) as the default for programs where data output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The outscop:
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
odirectory: "string
" ("")
Output directory.
oformat: "string
" ("")
Output format specific to this data type.
The outscop
datatype has a datatype-associated command line qualifier (-oformat
) which is often hard-coded as an attribute in an ACD file (see the EMBOSS Users Guide). oformat:
defines the default value for the -oformat
qualifier which is the file format and default file extension.
name: "
. Base name of output file name.string
" ("")
extension: "
. Extension of output file name.string
" ("")
nullok: "
. If the application can accept a null value for this definition and can run without generating a phylogenetic tree, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no data output) as the default for programs where data output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The outtree:
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
odirectory: "string
" ("")
Output directory.
oformat: "string
" ("")
Output format specific to this data type.
The outtree
datatype has a datatype-associated command line qualifier (-oformat
) which is often hard-coded as an attribute in an ACD file (see the EMBOSS Users Guide). oformat:
defines the default value for the -oformat
qualifier which is the file format and default file extension.
multiple: "
. Should be set to boolean
" ("N")"Y"
if the output can contain more than one report from the same input.
precision: "
. The floating point precision of any reported score values. For integer score values this can be set to integer
" ("3")"0"
.
type: "
. Where the report format is one of the standard feature table formats (see the EMBOSS Users Guide), the string
" ("")type:
attribute defines whether the report output is "protein"
or "nucleotide"
. There is a default based on the type of any input sequence, but a value should always be specified.
taglist: "
. Defines the additional tags to be reported from the internal feature table. The tag names and types must match the source code of the application. Each tag is in the format string
" ("")type:tagname[=columnname]
for example int:length
or string:gc=GC%
.
nullok: "
. If the application can accept a null value for this definition and can run without generating report output, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no report output) as the default for programs where report output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The report:
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
rformat: "string
" ("")
Report format.
rname: "string
" ("")
Base file name.
rextension: "string
" ("")
File name extension.
rdirectory: "string
" ("")
Output directory.
raccshow: "boolean
" ("N")
Show accession number in the report.
rdesshow: "boolean
" ("N")
Show description in the report.
rscoreshow: "boolean
" ("N")
Show the score in the report.
rusashow: "boolean
" ("N")
Show the full USA in the report.
rmaxall: "integer
" ("0")
Maximum total hits to report.
rmaxseq: "integer
" ("0")
Maximum hits to report for one sequence.
The report
datatype has three associated qualifiers (-rextension
, -rscoreshow
and -rformat
) which are often hard-coded as attributes in an ACD file (see the EMBOSS Users Guide). The rextension:
attribute sets the default value for the -rextension
qualifier, which is normally the program name. The rscoreshow:
boolean attribute specifies whether the feature score value should appear in the report. Where a score is not set by the program, the default 0.0 score can be excluded by setting the value to "N"
. The rformat:
attribute is required. It defines the default value for the -rformat
qualifier which is the report format.
name: "
. Base name of output file name.string
" ("")
extension: "
. Extension of output file name.string
" ("")
features: "
. If set, the sequence output will include feature information either in the same file (if the sequence format supports it) or in a separate file (by default in GFF format).boolean
" ("N")
type: "
. The output sequence type. Although this will default to the type of the first output sequence, it is recommended that a value is always defined to make the output sequence type clear. The sequence type must be a standard sequence type (Section A.7, “Sequence Types”).string
" ("")
nullok: "
. If the application can accept a null value for this definition and can run without generating sequence output, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no sequence output) as the default for programs where sequence output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The seqout
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
osformat: "string
" ("")
Output seq format.
osextension: "string
" ("")
File name extension.
osname: "string
" ("")
Base file name.
osdirectory: "string
" ("")
Output directory.
osdbname: "string
" ("")
Database name to add.
ossingle: "boolean
" ("N")
Separate file for each entry.
oufo: "string
" ("")
UFO features.
offormat: "string
" ("")
Features format.
ofname: "string
" ("")
Features file name.
ofdirectory: "string
" ("")
Output directory.
name: "
. Base name of output file name.string
" ("")
extension: "
. Extension of output file name.string
" ("")
features: "
. If set, the sequence output will include feature information either in the same file (if the sequence format supports it) or in a separate file (by default in GFF format).boolean
" ("N")
type: "
. The output sequence type. Although this will default to the type of the first output sequence, it is recommended that a value is always defined to make the output sequence type clear. The sequence type must be a standard sequence type (Section A.7, “Sequence Types”).string
" ("")
minseqs: "
. The minimum number of sequences that are expected in the output file.integer
" ("1")
maxseqs: "
. The maximum number of sequences that are expected in the output file.integer
" ("INT_MAX")
nullok: "
. If the application can accept a null value for this definition and can run without generating sequence output, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no sequence output) as the default for programs where sequence output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The seqoutall
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
osformat: "string
" ("")
Output seq format.
osextension: "string
" ("")
File name extension.
osname: "string
" ("")
Base file name.
osdirectory: "string
" ("")
Output directory.
osdbname: "string
" ("")
Database name to add.
ossingle: "boolean
" ("N")
Separate file for each entry.
oufo: "string
" ("")
UFO features.
offormat: "string
" ("")
Features format.
ofname: "string
" ("")
Features file name.
ofdirectory: "string
" ("")
Output directory.
The seqoutall
datatype has a datatype-associated command line qualifier (-ossingle
) which is often hard-coded as an attribute in an ACD file (see the EMBOSS Users Guide). ossingle:
defines the default value for the -ossingle
qualifier and can be set to "Y"
to direct output to multiple sequence files. For example, the EMBOSS program seqretsplit splits an input sequence input multiple files using this attribute.
name: "
. Base name of output file name.string
" ("")
extension: "
. Extension of output file name.string
" ("")
features: "
. If set, the sequence output will include feature information either in the same file (if the sequence format supports it) or in a separate file (by default in GFF format).boolean
" ("N")
type: "
. Output sequence type. Although this will default to the type of the first output sequence, it is recommended that a value is always defined to make the output sequence type clear. The sequence type must be a standard sequence type (Section A.7, “Sequence Types”).string
" ("")
minseqs: "
. The minimum number of sequences that are expected in the output file.integer
" ("1")
maxseqs: "
. The maximum number of sequences that are expected in the output file.integer
" ("INT_MAX")
aligned: "
. If true, specifies that all sequences in the output are expected to be aligned. If false then the sequences are assumed to be unaligned. We recommend always defining the boolean
" ("N")aligned:
attribute so that the nature of the sequence set is clearly defined.
nullok: "
. If the application can accept a null value for this definition and can run without generating sequence output, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no sequence output) as the default for programs where sequence output is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead. In combination with the nullok:
and missing:
attributes, this allows qualifiers to be null by default, and turned on from the command line.
The seqoutset
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
osformat: "string
" ("")
Output seq format.
osextension: "string
" ("")
File name extension.
osname: "string
" ("")
Base file name.
osdirectory: "string
" ("")
Output directory.
osdbname: "string
" ("")
Database name to add.
ossingle: "boolean
" ("N")
Separate file for each entry.
oufo: "string
" ("")
UFO features.
offormat: "string
" ("")
Features format.
ofname: "string
" ("")
Features file name.
ofdirectory: "string
" ("")
Output directory.
values: "
. A string containing a list of option labels and descriptions which define the options the user can choose from. The string
" ("")delimiter:
and codedelimiter:
attributes specify how to parse this string into individual list items.
delimiter: "
. The character used in the string
" (";")values:
string to separate list items. Defaults to a semi-colon (;
).
codedelimiter: "
. The character used in the string
" (":")values:
string to separate option labels from their descriptions. Defaults to a colon :
).
minimum: "
. The minimum number of selections required. By default 1 selection is required.integer
" ("1")
maximum: "
. The maximum number of selections allowed. By default exactly 1 selection is required. A higher value allows multiple selections.integer
" ("1")
trueminimum: "
. Used for calculated values of boolean
" ("N")minimum:
and maximum:
. By default the minimum value is used if the minimum and maximum values overlap.
failrange: "
. Used for calculated values of boolean
" ("Y")minimum:
and maximum:
. By default the application fails if the calculated ranges overlap.
rangemessage: "
. Used for calculated values of string
" ("")minimum:
and maximum:
. Failure message to use if calculated ranges overlap.
header: "
. Text that is displayed to the user above the list of options.string
" ("")
button: "
. Provided for interface developers. It has a boolean value used to suggest whether a list is best represented as checkboxes or radio buttons in an interface (value of boolean
" ("N")"Y"
) or if a text box should be used to enter a value ("N"
).
casesensitive: "
. Defines whether user input must match the exact case of the list item. Regardless of the case used by the user, the value of the parameter will be exactly what the corresponding list value is.boolean
" ("N")
values: "
. A string containing a list of option descriptions which define the options the user can choose from. The string
" ("")delimiter:
attribute specifies how to parse this string into individual selection list items.
delimiter: "
. The character used in the string
" (":")values:
string to separate list items. Defaults to a semi-colon (;
).
minimum: "
. The minimum number of selections required. By default 1 selection is required.integer
" ("1")
maximum: "
. The maximum number of selections allowed. By default exactly 1 selection is required. A higher value allows multiple selections.integer
" ("1")
trueminimum: "
. Used for calculated values of boolean
" ("N")minimum:
and maximum:
. By default the minimum value is used if the minimum and maximum values overlap.
failrange: "
. Used for calculated values of boolean
" ("Y")minimum:
and maximum:
. By default the application fails if the calculated ranges overlap.
rangemessage: "
. Used for calculated values of string
" ("")minimum:
and maximum:
. Failure message to use if calculated ranges overlap.
header: "
. Text that is displayed to the user above the list of options.string
" ("")
button: "
. Provided for interface developers. It has a boolean value used to suggest whether a list is best represented as checkboxes or radio buttons in an interface (value of boolean
" ("N")"Y"
) or if a text box should be used to enter a value ("N"
).
casesensitive: "
. Defines whether the input must match the exact case of the list item. Regardless of the case used by the user, the value of the parameter will be exactly what the corresponding list value is.boolean
" ("N")
The information:
attribute, defined for all datatypes, defines text to be used as a prompt after a list
or select
type list.
nullok: "
. If the application can accept a null value for this definition and can run without generating graphical output, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. Overrides the default name generation, and uses an empty string (no graph) as the default for programs where a graph is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead.boolean
" ("N")
The graph
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
gprompt: "boolean
" ("N")
Graph prompting.
gdesc: "string
" ("")
Graph description.
gtitle: "string
" ("")
Graph title.
gsubtitle: "string
" ("")
Graph subtitle.
gxtitle: "string
" ("")
Graph x axis title.
gytitle: "string
" ("")
Graph y axis title.
goutfile: "string
" ("")
Output file for non interactive displays.
gdirectory: "string
" ("")
Output directory.
The graph
datatype has four associated qualifiers which are often hard-coded as attributes in an ACD file (see the EMBOSS Users Guide). (-gtitle
, -gxtitle
, -gytitle
) are used to control the titles of the graph and its axes and are set with the attributes gtitle:
, gxtitle:
and gytitle:
. The goutfile:
attribute specifies the base file name for output. It is used, for example by the EMBOSS program tmap, to direct output to a named file rather than the default name, which is the name of first input sequence read (if any).
multiple: "
. The integer
" ("1")multiple:
attribute specifies the number of multiple XY graphs in a single output. The default value is 1, but any integer value may be defined in the ACD file.
nullok: "
. If the application can accept a null value for this definition and can run without generating graphical output, the boolean
" ("N")nullok:
attribute must be set to "Y"
. This allows a default value to be omitted or the application to be run with -no
on the command line (where Flag
Flag
is the data definition flag).
nulldefault: "
. The boolean
" ("N")nulldefault:
attribute overrides the default name generation, and uses an empty string (no graph) as the default for programs where a graph is only occasionally required. If an empty string is specified on the command line, the standard default value will be generated instead.
The xygraph
datatype has the following associated qualifiers which may be hard-coded as attributes in an ACD file. These qualifiers are described in the EMBOSS Users Guide:
gprompt: "boolean
" ("N")
Graph prompting.
gdesc: "string
" ("")
Graph description.
gtitle: "string
" ("")
Graph title.
gsubtitle: "string
" ("")
Graph subtitle.
gxtitle: "string
" ("")
Graph x axis title.
gytitle: "string
" ("")
Graph y axis title.
goutfile: "string
" ("")
Output file for non interactive displays.
gdirectory: "string
" ("")
Output directory.
The graph
datatype has four associated qualifiers which are often hard-coded as attributes in an ACD file (see the EMBOSS Users Guide). (-gtitle
, -gxtitle
, -gytitle
) are used to control the titles of the graph and its axes and are set with the attributes gtitle:
, gxtitle:
and gytitle:
. The goutfile:
attribute specifies the base file name for output. It is used to direct output to a named file, otherwise a default of the name of first input sequence read (if any) is used.