ABFPROBETABLE2PROBEMAP - Create epochprobemap files for a Marder ndi session
ABFPROBETABLE2PROBEMAP(S) reads all ABF files within the NDI session
directory specified by the ndi.session or ndi.dataset object S and
generates corresponding epochprobemap files. This function utilizes
the 'probetable.csv' file and any 'subject*.txt' files found in the
main session directory to map recorded channels to probes and subjects.
ABFPROBETABLE2PROBEMAP(S, OPTIONS) allows for customization of the
epochprobemap creation process through a structure of name-value pair
arguments.
Inputs:
S (ndi.session or ndi.dataset)
An ndi.session or ndi.dataset object representing the experimental
session containing the ABF data. The function will operate on the
directory associated with this object.
Options:
'acquisitionDelay' (duration, default = seconds(0))
A duration specifying the minimum time that must have passed since
an ABF file's creation date for it to be processed. This can be
useful to avoid processing files that are still being written.
'overwrite' (logical, default = false)
A logical flag indicating whether existing epochprobemap files
should be overwritten. If true, the function will re-create
epochprobemap files even if they already exist. If false, existing
files will be skipped.
Notes:
- The 'probetable.csv' file is expected to have columns that can be
used to match channel names (found in the ABF header) to probe
information. The exact column names used for matching are
determined within the
NDI.SETUP.CONV.MARDER.CHANNELNAMETABLE2PROBENAME function.
- The 'subject*.txt' files are expected to contain a single line with
the subject's local identifier.
See also: NDI.SESSION, NDI.DATASET, NDI.EPOCH.EPOCHPROBEMAP_DAQSYSTEM,
NDI.SETUP.CONV.MARDER.CHANNELNAMETABLE2PROBENAME,
NDR.FORMAT.AXON.READ_ABF_HEADER