rainbow.read_sequence

read_sequence(path, display_precision='auto', hrms=False, requested_files=None, telemetry=False, centroid=False, peaks=False, format=None, bin_width=None, **removed)[source]

Reads a multi-injection sequence directory.

Where read() reads a single run, this reads the whole sequence: a directory holding one injection subdirectory per sample, plus the sequence-level method and metadata. Each injection is read with read(), and the injections are returned in sorted-name order, which is acquisition order for ChemStation’s default naming, inside a DataSequence.

The vendor is detected from the injection subdirectories (.D means Agilent, .raw means Waters); pass format to override detection. Sequence reading is currently implemented for Agilent.

Parameters:
  • path (str) – Path of the sequence directory.

  • display_precision (int or 'auto', optional) – Decimals for displayed m/z labels (cosmetic).

  • hrms (bool, optional) – Flag for Agilent HRMS (MSProfile.bin) parsing.

  • requested_files (list, optional) – List of filenames to parse.

  • telemetry (bool, optional) – Flag for Agilent .dx telemetry traces.

  • centroid (bool, optional) – Flag for Agilent MassHunter centroid (MSPeak.bin) parsing.

  • peaks (bool, optional) – Flag for reading the integrated peaks from sequence.acaml and attaching them to each injection.

  • bin_width (float, optional) – m/z bin width passed to each injection’s read (see read()); the lossy binning control.

  • format (str, optional) – Force the vendor parser (‘agilent’ or ‘waters’), bypassing detection.

Returns:

DataSequence representing the sequence directory.