rate_dataset::add_stream

Source: dataset/rate/rate_dataset__add_stream.pro

 rate_dataset::add_stream
        Add a new datastream to a dataset

 Usage:
        strid=dsid->add_stream(type, channel)

 Arguments:
        type    string  input   The type of stream to add: this must
                                be a type of stream known for the
                                dataset type.
        channel string  input   A channel specifier for the stream. If
                                the channel isn't valid for the stream
                                type, then an error will be generated.

 Keywords:
        name    string  input   A name by which the stream can be
                                referred to. (If none is given, then
                                the stream definition routines will
                                give it one).
        menu                    If set, then ignore the channel and name and
                                create the stream using its GUI setup.
        group   long            A widget group leader, only used in
                                menu case.
        derived                 If set, then this is a derived stream
                                we are adding (different valid list)

 History:
        Original: 18/11/99; SJT
        Added enforced channel specification: 6/12/99; SJT
        Added menu key: 9/12/99; SJT
        Changed from generic to rate as pad & spect will have very
        different requirements: 23/2/00; SJT
        Added _extra key to carry anything supported by specific
        stream types: 30/6/00; SJT
        Verify homogeneity of streams: 10/7/00; SJT
        Add derived key: 17/7/00; SJT
        Treat dss with only sector averages as homogenous on
        sectoring: 11/8/00; SJT
        Don't set inhomogeneous sectoring if new stream is locally
        sectored (sector ratios): 29/4/02; SJT