sdynpy.fileio.sdynpy_rattlesnake.read_modal_data

• Module: sdynpy.fileio.sdynpy_rattlesnake

• Source: GitHub

Signature¶

def sdynpy.fileio.sdynpy_rattlesnake.read_modal_data(file, coordinate_override_column=None, read_only_indices=None)

Read modal test data from a Rattlesnake nc4 file.

Reads the full time history, FRF matrix, and multiple coherence array from a Rattlesnake modal-test nc4 file. Time data are reshaped into (n_averages, n_channels, samples_per_frame) blocks.

Parameters¶

• file : str or netCDF4.Dataset Path to a Rattlesnake nc4 file, or an already-open netCDF4.Dataset.

• coordinate_override_column : str, optional Channel-table column whose string values are parsed as coordinates. When None (default) coordinates are built from node_number and node_direction.

• read_only_indices : slice or array_like, optional Index expression applied to the channel axis when loading time data. Defaults to slice(None) (all channels).

Returns¶

• time_data : TimeHistoryArray Averaged time blocks with shape (n_averages, n_channels).

• frf_data : TransferFunctionArray Frequency response function matrix.

• coherence_data : MultipleCoherenceArray Multiple coherence for each response channel.

• channel_table : pandas.DataFrame Full channel table from the nc4 file.

Warns¶

• UserWarning

• If the number of complete averages in the time data does not match the

• num_averages attribute stored in the test settings group.