What is a recording?
Recording is collection of signals sampled
simultaneously over the same time period. The key point is that all the
signals’ time indexes line up, which implies that they were sampled at
the same rate and have their arrays have the same length in the time
Recordings provide a way for you to group related data, for example when
simultaneously recording neural activity (a signal with several
channels, one per neuron), the ambient sound heard (another signal),
and the test subject motion (yet another signal, whose channels describe
XYZ coordinates). Because all three signals occurred at the same time
and may need to be considered together during analysis, they should be
part of the same
How are Recordings saved?
When saved as files,
Recordings are represented as directories
Signals, which are represented as 2-3 files. For example,
a heircharchy might look lik:
└── gus027b13_p_PPS ├── gus027b13_p_PPS.pupil.csv ├── gus027b13_p_PPS.pupil.json ├── gus027b13_p_PPS.resp.csv ├── gus027b13_p_PPS.resp.epochs.csv ├── gus027b13_p_PPS.resp.json ├── gus027b13_p_PPS.stim.csv ├── gus027b13_p_PPS.stim.epochs.csv └── gus027b13_p_PPS.stim.json
As you can see,
There is one directory holding all the signals in the recording (
gus027b13_p_PPSis the name of the recording);
Each signal (
stimin this case) is represented by two tabular CSV files and one JSON file. Files that end in ‘.epochs.csv’ contain information that tag individual events and regions of time. Note that there are no tagged epochs for the
pupilsignal, while the
stimsignal presumably has information tagging when specific sounds were played, and the
respsignal presumably has information about how the animal behaved or responded.
More details on signal file formats may be found on the Signals documentation page.