sdynpy.fileio.sdynpy_rattlesnake.read_system_id_nc4

• Module: sdynpy.fileio.sdynpy_rattlesnake

• Source: GitHub

Signature¶

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

Read system-identification spectral data from a Rattlesnake nc4 file.

Parses FRF, response CPSD, drive CPSD, noise CPSD, and coherence arrays from the first non-channel environment group found in file. Applies response and reference transformation matrices when present in the environment group.

Parameters¶

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

• coordinate_override_column : str, optional Name of a channel-table column whose string values are parsed as coordinates. When None (default) coordinates are assembled from the node_number and node_direction channel-table columns.

Returns¶

• frfs : TransferFunctionArray Frequency response functions with shape (n_responses, n_drives).

• response_cpsd : PowerSpectralDensityArray Response cross-power spectral density matrix.

• drive_cpsd : PowerSpectralDensityArray Drive (reference) cross-power spectral density matrix.

• response_noise_cpsd : PowerSpectralDensityArray Response noise cross-power spectral density matrix.

• drive_noise_cpsd : PowerSpectralDensityArray Drive noise cross-power spectral density matrix.

• coherence : MultipleCoherenceArray Multiple coherence for each response channel.