a catalogue of the available data traces
Parameters: kwargs (dict) – to allow for optional parameters in the sub-class Returns: catalogue of the available traces with description and all information necessary to index the trace and grab it from the analyzer (i.e. channel, name, parameter etc. Return type: list
the purpose of this function is to query the analyzer for the available traces, and then it then returns a list where each list-item represents one available trace. How this is achieved is completely up to the user with the only requirement that the items from this list must be passed to the self.get_traces function, which will return one network item for each item in the list that is passed.
Typically the user will get this list of all available traces, and then by some functionality in the widgets (or whatever) will down-select the list and then return that down-selected list to the get_traces function to retrieve the desired networks.
Each list item then must be a python object (str, list, dict, etc.) with all necessary information to retrieve the trace as an Network object. For example, each item could be a python dict with the following keys: * “name”: the name of the measurement e.g. “CH1_S11_1” * “channel”: the channel number the measurement is on * “measurement”: the measurement number (MNUM in SCPI) * “parameter”: the parameter of the measurement, e.g. “S11”, “S22” or“a1b1,2”
- “label”: the text the item will use to identify itself to the user e.g “Measurement 1 on Channel 1”