sync_acquisition_for_streams#
- ethograph.io.nwb_alignment.sync_acquisition_for_streams(nwbfile, stream_rates, media_paths=None)[source]#
Create ImageSeries acquisition items for ALL external media streams.
Reads the trials table to discover
{stream}_{device}columns. For each stream+device pair, creates anImageSeriesinnwbfile.acquisitionwithexternal_file,starting_frame, andrate(ortimestampsif offsets are present).- Parameters:
nwbfile (
NWBFile) – NWB file with a populated trials table.stream_rates (
dict[str,float]) – Mapping of stream name to sampling rate, e.g.{"video": 30.0, "audio": 44100.0, "pose": 30.0}. A{stream}_{device}key ("video_cam-2": 60.0) overrides its stream’s rate.media_paths (
DataFrame|None) – The pairing table the trials came from, one row per trial in the same order, whose media cells hold full paths. When given,external_filerecords those paths, so a reader finds the media without being told the folder; the trials table keeps the basenames either way.
- Return type: