skip to main content
Roche logo
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.