io

Read/write routines for save and generate signal objects

Module for reading/writing and generating signal objects from and to other formats

qampy.io.create_signal_from_matlab(symbols, fn, fs, keys, **kwargs)

Load data from matlab file and generate signal object

Parameters:

• symbols (signal_object) – The signal object corresponding to the symbols at the transmitter

• fn (basestring) – filename of the matlab file

• keys (list or tuple) –

  Nested list of keys (array names) in the matlab file. Depending on how the data is structured the keys can be in one of the following formats:

  If the symbols are given as a multi-dimensional array of complex numbers:

  [[ keyname ]]

  If the symbols are given as multi-dimensional real arrays pairs for real and imaginary part:

  [[ key_real, key_imag ]]

  If the different symbols of modes are saved in different complex arrays:

  [[key_mode1], …, [key_modeN]]

  If the symbols are given as pairs of real arrays for each mode:

  [[key_mode1_real, key_mode1_imag], … [key_modeN_real, key_modeN_imag]]

• kwargs (dict) – Keyword arguments to pass to core.io.ndarray_from_matlab (see documentation for details)

Returns:

signal – signal object containing the data loaded from matlab file

Return type:

signal_object

qampy.io.load_symbols_from_matlab_file(fn, M, keys, fb=10000000000.0, fake_polmux=False, fake_pm_delay=0, normalise=True, **kwargs)

Create a signal object from matlab file.

Parameters:

• fn (basestring) – Matlab filename

• M (int) – QAM order

• keys (list) –

  Nested list of keys (array names) in the matlab file. Depending on how the data is structured the keys can be in one of the following formats:

  If the symbols are given as a multi-dimensional array of complex numbers:

  [[ keyname ]]

  If the symbols are given as multi-dimensional real arrays pairs for real and imaginary part:

  [[ key_real, key_imag ]]

  If the different symbols of modes are saved in different complex arrays:

  [[key_mode1], …, [key_modeN]]

  If the symbols are given as pairs of real arrays for each mode:

  [[key_mode1_real, key_mode1_imag], … [key_modeN_real, key_modeN_imag]]

• fb (float, optional) – Symbol rate

• fake_polmux (boolean, optional) – Whether the signal uses fake polmux, thus the single dimension matlab symbol array should be duplicated

• fake_pm_delay (int, optional) – Number of symbols to delay the second dimension in the fake pol-mux

• normalise (boolean, optional) – Normalise the symbols to an average power of 1 or not. Note that if you do not normalise you need to be very careful with your signal metrics

• kwargs (dict) – Keyword arguments to pass to core.io.ndarray_from_matlab (see documentation for details)

Returns:

sig – Signal generated from the loaded symbols

Return type:

signal_object