hepconvert

library1.4.0pypypi✓ verified 79d ago

High Energy Physics file conversion package (ROOT, Parquet, etc.). Current version 1.4.0, requires Python >=3.9. Active development, monthly releases.

data serialization

pip install hepconvert

github ↗package ↗changelog ↗

INSTALL

IMPORT

SIG · HEPCONVERT

hepconvert

datapythonv1.4.0

Install

5.8s avg

Import

—

Disk

116MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.4.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 116.7MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 5.8s · import 0.000s · 109MB

116MB installed

● package 116MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

root_to_parquet

✓ from hepconvert import root_to_parquet

✗ from hepconvert import convert_root_to_parquet

parquet_to_root

✓ from hepconvert import parquet_to_root

merge_root

✓ from hepconvert import merge_root

Quickly convert a ROOT file to Parquet, selecting specific branches.

from hepconvert import convert_root_to_parquet convert_root_to_parquet("input.root", "output.parquet", branches=["branch1", "branch2"])

hepconvert --version

Debug

Known issues

gotchaconvert_root_to_parquet by default converts all branches; this can be slow for large files. Always specify 'branches' to slim selection.

fix

Explicitly pass branches=[...] to select only what you need.

affects: all

gotchamerge_root can silently lose 100 entries when using entry-number size selection (fixed in 1.3.8). If using 1.3.6 or earlier, upgrade.

fix

Upgrade to >=1.3.8 with: pip install --upgrade hepconvert

affects: <1.3.8

deprecatedPython 3.8 support dropped in 1.4.0. The package now requires Python >=3.9.

fix

Use Python 3.9 or later.

affects: >=1.4.0

gotchaCLI arguments for options like '--size' are case-sensitive and must match exactly. Mixing types (e.g., passing a string for an integer option) fails with unclear error in <1.4.0.

fix

Upgrade to >=1.4.0 or use Python API with correct types.

affects: <1.4.0

Upgrade

Version history

1.4.0latest on PyPI · released Feb 13, 2025

Audit

Dependencies

uprootrequiredROOT file I/O

awkwardrequiredarray manipulation for HEP data

pyarrowrequiredParquet file support

numpyrequirednumerical operations

boost_histogramoptionalhistogram operations (for add_histograms)

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/zbilodea/hepconvert ↗

packagehttps://pypi.org/project/hepconvert/ ↗

changeloghttps://github.com/zbilodea/hepconvert/releases ↗