{"id":23848,"library":"hepconvert","title":"hepconvert","description":"High Energy Physics file conversion package (ROOT, Parquet, etc.). Current version 1.4.0, requires Python >=3.9. Active development, monthly releases.","status":"active","version":"1.4.0","language":"python","source_language":"en","source_url":"https://github.com/scikit-hep/hepconvert","tags":["hep","physics","ROOT","parquet","conversion","scikit-hep"],"install":[{"cmd":"pip install hepconvert","lang":"bash","label":"pip"},{"cmd":"conda install -c conda-forge hepconvert","lang":"bash","label":"conda"}],"dependencies":[{"reason":"ROOT file I/O","package":"uproot","optional":false},{"reason":"array manipulation for HEP data","package":"awkward","optional":false},{"reason":"Parquet file support","package":"pyarrow","optional":false},{"reason":"numerical operations","package":"numpy","optional":false},{"reason":"histogram operations (for add_histograms)","package":"boost_histogram","optional":true}],"imports":[{"wrong":"from hepconvert import convert_root_to_parquet","symbol":"root_to_parquet","correct":"from hepconvert import root_to_parquet"},{"symbol":"parquet_to_root","correct":"from hepconvert import parquet_to_root"},{"symbol":"merge_root","correct":"from hepconvert import merge_root"}],"quickstart":{"code":"from hepconvert import convert_root_to_parquet\nconvert_root_to_parquet(\"input.root\", \"output.parquet\", branches=[\"branch1\", \"branch2\"])","lang":"python","description":"Quickly convert a ROOT file to Parquet, selecting specific branches."},"warnings":[{"fix":"Explicitly pass branches=[...] to select only what you need.","message":"convert_root_to_parquet by default converts all branches; this can be slow for large files. Always specify 'branches' to slim selection.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade to >=1.3.8 with: pip install --upgrade hepconvert","message":"merge_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.","severity":"gotcha","affected_versions":"<1.3.8"},{"fix":"Use Python 3.9 or later.","message":"Python 3.8 support dropped in 1.4.0. The package now requires Python >=3.9.","severity":"deprecated","affected_versions":">=1.4.0"},{"fix":"Upgrade to >=1.4.0 or use Python API with correct types.","message":"CLI 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.","severity":"gotcha","affected_versions":"<1.4.0"}],"env_vars":null,"search_vec":"'1.4.0':13 '3.9':16 'activ':17 'convers':6,25 'current':11 'develop':18 'energi':3 'etc':10 'file':5 'hep':21,28 'hepconvert':1 'high':2 'month':19 'packag':7 'parquet':9,24 'physic':4,22 'python':15 'releas':20 'requir':14 'root':8,23 'scikit':27 'scikit-hep':26 'version':12","created_at":"2026-05-01T08:09:56.824387+00:00","updated_at":"2026-05-01T08:09:56.824387+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.4.0","cli_name":"hepconvert","cli_version":"Usage: hepconvert [OPTIONS] COMMAND [ARGS]...","type":"library","homepage":null,"github":"https://github.com/zbilodea/hepconvert","docs":null,"changelog":"https://github.com/zbilodea/hepconvert/releases","pypi":"https://pypi.org/project/hepconvert/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","serialization"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-08-02","install_tag":null}}