Multi Channel Systems MC_DataTool binary export (.raw)
MC_DataTool, Multi Channel Systems’ converter, exports MC_Rack recordings to binary .raw files.
With the header option the file starts with a text header that gives the sampling rate, the
electrode gain and the stream names. OpenReadout reads these files as one trace with a channel per
stream. Exports without the header, and MC_Rack .mcd recordings themselves, are not read.
Derived from Neo’s RawMCSRawIO (BSD-3, read as documentation and run as the reference reader)
and one public file. Provenance: docs/provenance/mcs-raw.md.
Crate: openreadout-ephys, format id mcs-raw (MCS_RAW_FORMAT_ID), extension raw, reader
McsRawReader, dataset McsRawDataset (open, open_input, header, file_len, frames).
Detection: the file starts with MC_DataTool binary conversion (MCS_RAW_MAGIC,
looks_like_mcs_raw) → definite. Other .raw files (Thermo, Waters) are left to their readers.
Layout (parse_header → McsRawHeader)
- Header (Windows-1252, CR LF lines, searched for
EOHin the firstMAX_MCS_HEADERbytes):MC_DataTool binary conversion,Version <v>(version), thenkey = valuelines (entries):MC_REC file(source_file),Sample rate(sample_rate_hz),ADC zero(adc_zero),El = <gain><unit>/AD(gain,unit, e.g.0.2083µV/AD) andStreams = El_21;El_31;…(streams, at mostMAX_MCS_STREAMS). The samples start afterEOH\r\n(data_offset). - Samples: frames of one uint16 per stream, little-endian, back to back;
frames= whole frames in the file. - Values: raw ×
gain+ offset, offset = −gain×adc_zero(scaleandoffsetof every channel), in theElunit. unreadable: a file is refused (exit 6) when it lacks a usable rate, ADC zero or gain, or has a stream not namedEl_…(only the electrode gain is in the corpus file’s header).
Mapping
One trace Signals, one channel per stream (dtype uint16), one sweep, start_s 0;
format_version the MC_DataTool version; extra: application (MC_DataTool),
application_version, source_file, adc_zero. Reads are capped at MAX_MCS_READ_VALUES.
check finding codes
partial_frame, duplicate_stream (warnings).
Oracle mapping
oracle/gen.py mcs_raw(): Neo’s RawMCSRawIO, its uint16 chunk × gain + offset per channel.
Observed corpus values
| id | version | streams | frames | rate | gain |
|---|---|---|---|---|---|
gin-rawmcs-raw-mcs-with-header-1 |
2.6.10 | 60 (El_12 … El_87) |
100,000 | 20 kHz | 0.2083 µV |
Vocabulary (every public identifier in crates/openreadout-ephys/src/mcsraw/ must appear here)
| identifier | meaning |
|---|---|
McsRawReader, MCS_RAW_FORMAT_ID, McsRawDataset, open, open_input, header, file_len, frames |
entry points |
McsRawHeader, parse_header, entries, version, source_file, sample_rate_hz, adc_zero, gain, unit, streams, data_offset, unreadable |
the header |
MCS_RAW_MAGIC, MAX_MCS_HEADER, MAX_MCS_STREAMS, MAX_MCS_READ_VALUES, looks_like_mcs_raw |
detection and limits |
How this reader was derived, file by file: provenance log.