rainbow.agilent.read

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

Reads an Agilent .D directory or .dx archive.

Parameters:
  • path (str) – Path of the directory or .dx file.

  • display_precision (int or 'auto', optional) – Decimals for the displayed m/z labels (cosmetic). 'auto' picks per file: 4 for the high-resolution MassHunter profile and TOF centroids, and 0 (whole numbers) for unit-resolution data.

  • hrms (bool, optional) – Flag for parsing the MassHunter profile spectrum (MSProfile.bin).

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

  • telemetry (bool, optional) – Flag for parsing instrument telemetry traces, in a .dx archive or alongside a MassHunter DAD’s signals.

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

  • bin_width (float, optional) – m/z bin width in daltons, the lossy binning control. For regular MS the default is nominal mass (1 Da); for the HRMS profile, omit it (the default) to keep the per-scan representation (one ProfileDataFile per flight-time grid), or pass a width to project onto the shared m/z grid.

  • peaks (bool, optional) – Flag for reading the run’s integrated peaks into DataDirectory.peaks (see injection_peaks()).

Returns:

DataDirectory representing the Agilent data.