Skip to main content

Next-generation Python interface to the HepMC high-energy physics event record API

Project description

pyhepmc-ng is an alternative wrapper of the HepMC-v3 C++ library.

The official wrapper is pyhepmc. Why should you use this one?

pyhepmc-ng is easy to install

The command pip install pyhepmc-ng just works! You only need a compiler that supports C++14, everything else is handled by pip.

Under the hood, the bindings are build with the excellent pybind11 library. pybind11 is automatically installed as a requirement by pip. You don't need an external installation of the HepMC library, either. A copy of this light-weight library is included.

The original pyhepmc package is not easy to install. It uses SWIG to create the bindings, which has to be installed separately. It also requires you to install the C++ library HepMC separately. When you try a pip-install, it will in general not work out-of-the-box. Instead you will get intimidating error messages, which are difficult to decipher.

pyhepmc-ng is actively developed and maintained

The last release of pyhepmc was May 2013.

pyhepmc-ng is unit tested

Everything in pyhepmc-ng is unit tested. A few bugs were already found in HepMC3 in this way, notably in the HEPEVT_Wrapper class.

pyhepmc-ng supports Pythonic code

pyhepmc-ng is not a blind mapping of C++ code to Python. It uses Python idioms where it is appropriate.

  • C++ methods which act like properties are represented as properties, e.g. GenParticle::set_status and GenParticle::status are mapped to a single GenParticle.status field in Python
  • Tuples and lists are implicitly convertible to FourVectors
  • ReaderAscii and WriterAscii support the context manager protocol

License: pyhepmc-ng is covered by the BSD license, but the license only applies to the binding code. The HepMC code is covered by the GPL-v3 license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pyhepmc_ng-0.2.1.tar.gz (80.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page