Skip to main content

OpenTFRaw

CI DOI crates.io PyPI docs.rs License: Apache-2.0 Rust MSRV

Part of the OpenMassSpec stack for mass spectrometry raw-file access.

Rust and Python reader for Thermo Fisher .raw mass spectrometry files, covering format versions 8 through 66 (LCQ Classic through Orbitrap Astral and modern TSQ).

Documentation: sigilweaver.app/opentfraw/docs

Install

Prefer openmassspec-io with the thermo feature/extra unless you need this parser standalone (minimal dependencies, or building your own abstraction) - the umbrella gives you format auto-detection, mzML conversion, and Arrow streaming across all wired-in vendors for free:

cargo add openmassspec-io --features thermo
pip install openmassspec[thermo]

Standalone:

Rust:

cargo add opentfraw

Python:

pip install opentfraw

Quickstart

Rust:

use opentfraw::RawFileReader;

let raw = RawFileReader::open_path("sample.raw")?;
let mut file = std::fs::File::open("sample.raw")?;
for scan_num in 1..=raw.num_scans {
    let peaks = raw.read_scan_peaks(&mut file, scan_num)?;
    println!("scan {scan_num}: {} peaks", peaks.mz.len());
}

Python:

import opentfraw

raw = opentfraw.RawFile("run.raw")
mz, intensity = raw.peaks(3)
print(raw.scan(3)["filter_string"])
raw.to_mzml("run.mzML")

See the docs site for the full guide, format specification, and API reference.

Used by

Project Description
Mascope by Karsa Oy Mass spectrometry data analysis platform using OpenTFRaw to ingest Thermo .raw files.

License

Apache-2.0. See LICENSE.

The format specification was developed by binary analysis of public mass-spectrometry datasets (PRIDE accessions). See CORPUS.md and ATTRIBUTION.md.

Release files for opentfraw 1.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for opentfraw 1.4.1
File Size Uploaded
opentfraw-1.4.1.tar.gz 96.2 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for opentfraw 1.4.1
File
opentfraw-1.4.1-cp38-abi3-win_amd64.whl CPython 3.8 abi3 Windows x86-64 Details
opentfraw-1.4.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.8 abi3 Linux glibc 2.17+ x86-64 Details
opentfraw-1.4.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.8 abi3 Linux glibc 2.17+ ARM64 Details
opentfraw-1.4.1-cp38-abi3-macosx_11_0_arm64.whl CPython 3.8 abi3 macOS 11.0+ ARM64 Details
opentfraw-1.4.1-cp38-abi3-macosx_10_12_x86_64.whl CPython 3.8 abi3 macOS 10.12+ x86-64 Details

Total release size: 2.2 MB

Release files / opentfraw-1.4.1.tar.gz

Download URL opentfraw-1.4.1.tar.gz
Size 96.2 kB
Tags Source
SHA-256 checksum
How to use checksums
23d7a0750338bb625b0a57643b810bd40616183afeb5aced8b0c2f239267849a
BLAKE2b-256 checksum
How to use checksums
28b075ef5433394841c63283d4d065b8f8fadd80ff9dbbda72f025b6708ed4b0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.

Transparency log

Release files / opentfraw-1.4.1-cp38-abi3-win_amd64.whl

Download URL opentfraw-1.4.1-cp38-abi3-win_amd64.whl
Size 322.4 kB
Tags CPython 3.8 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
b0f8a8d3393346654573e766ae56eaca8a55142b22d7eb0fd7edade26600deb7
BLAKE2b-256 checksum
How to use checksums
eaaa33f8a1aaa31525f76816a942c9ba4923e40210dabb21326d349f1c53f706
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.

Transparency log

Release files / opentfraw-1.4.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL opentfraw-1.4.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 480.5 kB
Tags CPython 3.8 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
9a37df7f9f82727db382e7161184583e3aed784e2fb5097bfbc44dcfd918d14e
BLAKE2b-256 checksum
How to use checksums
960beb38c60b6101900ce504e2cc9ecf0fee726d07fdcb266a4603519e61d36b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.

Transparency log

Release files / opentfraw-1.4.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL opentfraw-1.4.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 468.0 kB
Tags CPython 3.8 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
e3c5818829f9132b1b5420d4f0a361a3dbe8d884fd69fdfa650d6a584b3f1c14
BLAKE2b-256 checksum
How to use checksums
4f99fefd3707f0af493a60ddb2be0f11dcca027bda35b5a03197ef961662d7aa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.

Transparency log

Release files / opentfraw-1.4.1-cp38-abi3-macosx_11_0_arm64.whl

Download URL opentfraw-1.4.1-cp38-abi3-macosx_11_0_arm64.whl
Size 425.4 kB
Tags CPython 3.8 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
7ae0249f094f6c73d5c69d3f94f3590eb939f868ac0fdd1f35e21b1afa325348
BLAKE2b-256 checksum
How to use checksums
72707a04813c45524f6c2427abdec61486abee2c2ce8611d2cf4dfbc337db792
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.

Transparency log

Release files / opentfraw-1.4.1-cp38-abi3-macosx_10_12_x86_64.whl

Download URL opentfraw-1.4.1-cp38-abi3-macosx_10_12_x86_64.whl
Size 428.2 kB
Tags CPython 3.8 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
9d9fd62b8978ab8acb2ea6c37a7f4bc6db3ff1f0cfe84185dcdf08a4099ea94c
BLAKE2b-256 checksum
How to use checksums
b867c801a2e578e121b6e05ce88bc5f52ddda09e55c04827d83aca15f2b8a19d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.

Transparency log

Release history Release notifications | RSS feed

1.6.0

6 release files

1.5.0

6 release files

This release

1.4.1 This release

6 release files

1.4.0

6 release files

1.3.7

6 release files

1.3.6

6 release files

1.3.5

6 release files

1.3.4

6 release files

1.3.3

6 release files

1.3.2

6 release files

1.3.1

6 release files

1.3.0

6 release files

1.2.0

6 release files

1.1.0

6 release files

1.0.6

6 release files

1.0.5

6 release files

1.0.4

6 release files

1.0.3

6 release files

1.0.1

6 release files

1.0.0

6 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page