|
3.4.5
|
dissoc[iate] -sam[ple] <sample name>
-amp[licon] <amplicon name> [-ofRef <reference sequence name>]
[-file <file> [-format <format>]]
dissoc[iate] -sam[ple] <sample name>
-readData <read data name>
[-file <file> [-format <format>]]
dissoc[iate] -sam[ple] <sample name>
-amp[licon] <amplicon name> [-ofRef <reference sequence name>]
-readData <read data name>
[-file <file> [-format <format>]]
dissoc[iate] -mul[tiplexer] <multiplexer name>
[-primer1Mid <primer1Mid name>
[-ofPrimer1MidGroup <primer1MidGroup name>]]
[-primer2Mid <primer2Mid name>
[-ofPrimer2MidGroup <primer2MidGroup name>]]
[-file <file> [-format <format>]]
dissoc[iate] -mul[tiplexer] <multiplexer name>
[-primer1Mid <primer1Mid name>
[-ofPrimer1MidGroup <primer1MidGroup name>]]
[-primer2Mid <primer2Mid name>
[-ofPrimer2MidGroup <primer2MidGroup name>]]
-sam[ple] <sample name>
[-file <file> [-format <format>]]
dissoc[iate] -mul[tiplexer] <multiplexer name>
-sam[ple] <sample name>
[-file <file> [-format <format>]]
dissoc[iate] -mul[tiplexer] <multiplexer name>
-amp[licon] <amplicon name> [-ofRef <reference sequence name>]
-readData <readData name>
[-file <file> [-format <format>]]
dissoc[iate] -mul[tiplexer] <multiplexer name>
-readData <readData name>
[-file <file> [-format <format>]]
The 'dissociate' command is used to dissociate records in many-to-many
relationships. If a general relationship is dissociated, the more
specific associations that depend on it automatically will be dissociated
as well (e.g., dissociating a sample from a read data will also result in
the dissociation of the sample's read data-sample-amplicon associations).
General relationships that are included as part of specific relationships
are not, however, automatically dissociated (e.g., when dissociating a
read data-sample-amplicon relationship, the more general sample-amplicon
relationship that it includes will not be dissociated).
In any of the command forms above where '-amplicon' is being specified,
the '-ofRef' option can be used to disambiguate amplicons with the same
name but which are from different reference sequences.
The '-amplicon' option may be specified as a "*" to allow multiple
amplicons to be dissociated with a single command. In the context of a
command where '-amplicon' and '-sample' are both specified, the "*" is
interpreted to indicate that all of the amplicons of the sample should be
dissociated. In the context of a command where '-amplicon',
'-multiplexer', and '-readData' are all specified, the "*" is interpreted
to indicate that all of the amplicons associated with the multiplexer in
the context of that read data should be dissociated. In either case, the
'-ofRef' option can still be used to restrict the "*" selection of
amplicons to be that subset of amplicons belonging to the indicated
reference sequence.
In a similar manner to the '-ofRef' option for amplicons, the
'-ofPrimer1MidGroup' and '-ofPrimer2MidGroup' options can be used to
disambiguate '-primer1Mid' and '-primer2Mid' specifications, respectively.
The '-primer1Mid' and '-primer2Mid' options may also be specified as a
"*". If no '-ofPrimer1MidGroup' or '-ofPrimer2MidGroup' option is
supplied, the "*" refers to all the MIDs of the project. If a MID group
is specified, the "*" refers to only the MIDs of that MID group.
Explanations of the various command forms are as follows:
Run 'help general tabularCommands' for information about the '-file'
option.
dissoc[iate] -sam[ple] <sample name>
-amp[licon] <amplicon name>
[-ofRef <reference sequence name>]
[-file <file> [-format <format>]]
If a sample and an amplicon are specified, they are dissociated. The
'-ofRef' option can be used to disambiguate amplicons with the same name
that refer to different reference sequences. If a "*" is passed as the
'-amplicon' option value, with no '-ofRef' option, all amplicons of the
sample are dissociated. If both a "*" and the '-ofRef' option are used,
then all amplicons of the sample belonging to the indicated reference
sequence will be dissociated.
dissoc[iate] -sam[ple] <sample name>
-readData <read data name>
[-file <file> [-format <format>]]
If a sample and a read data are specified, the sample itself, all
amplicons of the sample currently associated with the read data, and the
read data are dissociated.
dissoc[iate] -sam[ple] <sample name>
-amp[licon] <amplicon name>
[-ofRef <reference sequence name>]
-readData <read data name>
[-file <file> [-format <format>]]
If a sample, amplicon, and read data are specified, the sample itself, the
amplicon, and the read data are dissociated. The '-ofRef' option can be
used to disambiguate amplicons with the same name that refer to different
reference sequences. If a "*" is passed as the '-amplicon' option value,
all amplicons of the sample are dissociated. This is identical to using
the invocation form with only the sample and read data specified.
dissoc[iate] -mul[tiplexer] <multiplexer name>
[-primer1Mid <primer1Mid name>
[-ofPrimer1MidGroup <primer1MidGroup name>]]
[-primer2Mid <primer2Mid name>
[-ofPrimer2MidGroup <primer2MidGroup name>]]
[-file <file> [-format <format>]]
If some combination of MIDs and a multiplexer are specified, the MIDs will
be dissociated from the multiplexer. Any samples associated with those
MIDs via the multiplexer will be dissociated as well. Note that a
multiplexer may be used on more than one read data, and MID dissociations
will impact sample associations on all of those read data at once. Also
note, that depending on the pre-existing sample associations and
encoding type of the multiplexer (both, either, primer1, or primer2),
dissociating an MID might impact more than one sample (e.g., if the
multiplexer encoding is 'both' and there is a sample1 associated with
primer1Mid mid1 and primer2Mid mid2 and there is a sample2 associated with
primer1Mid mid1 and primer2Mid mid3, dissociating primer1 mid1 from the
multiplexer will cause both samples to be dissociated).
dissoc[iate] -mul[tiplexer] <multiplexer name>
[-primer1Mid <primer1Mid name>
[-ofPrimer1MidGroup <primer1MidGroup name>]]
[-primer2Mid <primer2Mid name>
[-ofPrimer2MidGroup <primer2MidGroup name>]]
-sam[ple] <sample name>
[-file <file> [-format <format>]]
If some combination of MIDs, a multiplexer, and a sample are specified,
the sample will be dissociated from the specific MID association, but the
MID associations with the multiplexer will be left intact. The
'-primer1Mid' and '-primer2Mid' options are constrained by the encoding
type of the multiplexer. Since this form of the command is expecting to
dissociate specific sample-MID associations, it must be given an
appropriate combination of MID options that are compatible with the
encoding type. If the encoding type is 'both', '-primer1Mid' and
'-primer2Mid' options must both be specified along with the sample.
If the encoding type is 'either', it is permissible to provide both MIDs
or just a single MID along with the specified sample.
dissoc[iate] -mul[tiplexer] <multiplexer name>
-sam[ple] <sample name>
[-file <file> [-format <format>]]
If a multiplexer and a sample are specified, the sample gets dissociated
from all MID combinations that have been used to associate the sample
with the multiplexer. The pre-existing multiplexer-MID associations are
left intact.
dissoc[iate] -mul[tiplexer] <multiplexer name>
-amp[licon] <amplicon name> [-ofRef <reference sequence name>]
-readData <readData name>
[-file <file> [-format <format>]]
If a multiplexer, amplicon and readData are specified, the amplicon is
dissociated from the specific read data-multiplexer context. If the
amplicon is simultaneously associated with the same multiplexer on a
different read data, that relationship will be left intact. A "*" may be
provided with the '-amplicon' option to indicate that all amplicons
associated with the read data-multiplexer should be dissociated. The
'-ofRef' option can be used, if necessary, to disambiguate among amplicons
with the same name or to restrict the "*" set of amplicons to those of
the specified reference sequence. Severing the relationship of an
amplicon with a read data-multiplexer simultaneously dissociates the
amplicon from all of the samples associated with the multiplexer in that
read data context. The general sample-amplicon relationships, however,
remain intact.
dissoc[iate] -mul[tiplexer] <multiplexer name>
-readData <readData name>
[-file <file> [-format <format>]]
If a multiplexer and a read data are specified, the multiplexer will be
dissociated from that specific read data. The internal relationships of
the multiplexer such as MID and sample associations remain intact, but any
amplicons that were associated with the specific read data-multiplexer
will be dissociated. If the multiplexer is simultaneously associated with
other specific read data, those associations remain unchanged.