14.1 mzParquet Converter

mzParquet Converter

Convert mass spectrometry vendor files to the open .mzparquet (opens in a new tab) format.

Download from the mzParquet Converter releases page (opens in a new tab).


GUI Application

The mzParquet Converter GUI provides a desktop application for converting vendor raw files to .mzparquet without using the command line.

PlatformDownload
Windows x64 (.msi)mzParquet Converter Installer (opens in a new tab)
Windows x64 (.exe)mzParquet Converter Setup (opens in a new tab)
macOS Apple Silicon (.dmg)mzParquet Converter (opens in a new tab)
PlatformThermo .rawBruker .d
Windows
macOS (Apple Silicon)

Note: Thermo .raw conversion is not available on macOS due to ThermoFisher library limitations.

Features:

  • Drag and drop — drop .raw files or .d folders directly onto the window
  • Browse — click to select files via a file dialog
  • Batch conversion — queue multiple files and convert them all at once
  • Progress tracking — real-time progress percentage for each file
  • Skip existing — automatically detects already-converted files (with option to force re-convert)

CLI Downloads

ThermoParquet — Thermo .raw.mzparquet

PlatformDownload
Windows x64ThermoParquet-x86_64-pc-windows-msvc.exe (opens in a new tab)
Linux x64ThermoParquet-x86_64-unknown-linux-gnu (opens in a new tab)

Note: ThermoParquet requires the ThermoFisher RawFileReader runtime, which is only available on Windows and Linux.

dotD2parquet — Bruker .d.mzparquet

PlatformDownload
Windows x64dotD2parquet-x86_64-pc-windows-msvc.exe (opens in a new tab)
Linux x64dotD2parquet-x86_64-unknown-linux-gnu (opens in a new tab)
macOS Apple SilicondotD2parquet-aarch64-apple-darwin (opens in a new tab)

Supported Instruments

VendorFormatConverterPlatforms
Thermo Fisher.rawThermoParquetWindows, Linux
Bruker timsTOF.ddotD2parquetWindows, Linux, macOS

Usage

# Thermo .raw → .mzparquet
ThermoParquet sample.raw
# Output: sample.mzparquet
 
# Bruker .d → .mzparquet
dotD2parquet sample.d
# Output: sample.mzparquet

Batch conversion (shell)

# Convert all .raw files in a directory
for f in *.raw; do ThermoParquet "$f"; done
 
# Convert all .d folders
for d in *.d; do dotD2parquet "$d"; done

Batch conversion (PowerShell)

# Convert all .raw files
Get-ChildItem *.raw | ForEach-Object { .\ThermoParquet.exe $_.FullName }
 
# Convert all .d folders
Get-ChildItem -Directory *.d | ForEach-Object { .\dotD2parquet.exe $_.FullName }

Output Format

The .mzparquet file is an Apache Parquet file with Zstandard compression and the following schema:

ColumnTypeDescription
scanuint32Scan/spectrum number
leveluint32MS level (1, 2, …)
rtfloat32Retention time (minutes for Thermo, seconds for Bruker)
mzfloat32Mass-to-charge ratio
intensityuint32Peak intensity
ion_mobilityfloat32?Ion mobility (1/K0, Bruker only)
isolation_lowerfloat32?Isolation window lower bound
isolation_upperfloat32?Isolation window upper bound
precursor_scanuint32?Parent MS1 scan number
precursor_mzfloat32?Precursor m/z
precursor_chargeuint32?Precursor charge state

Files can be read with any Parquet library — Python (pyarrow, polars, pandas), R (arrow), Rust, etc.

import polars as pl
 
df = pl.read_parquet("sample.mzparquet")
print(df.head())

Linux Compatibility

CLI binaries are built on Ubuntu 22.04 (glibc 2.35). Compatible distros:

DistroglibcCompatible
Ubuntu 22.04 LTS2.35
Ubuntu 24.04 LTS2.39
Debian 12 (Bookworm)2.36
Fedora 36+2.35+
Rocky / Alma Linux 92.34
Ubuntu 20.04 LTS2.31
CentOS 72.17

Requires glibc ≥ 2.35. Check your version: ldd --version

ThermoParquet additionally requires libicu and openssl (pre-installed on most Ubuntu/Debian systems).