Skip to main content
https://git.km3net.de/km3py/km3pipe/badges/master/pipeline.svg https://git.km3net.de/km3py/km3pipe/badges/master/coverage.svg Codacy Badge https://git.km3net.de/examples/km3badges/-/raw/master/docs-latest-brightgreen.svg https://zenodo.org/badge/24634697.svg

KM3Pipe is a framework for KM3NeT related stuff including MC, data files, live access to detectors and databases, parsers for different file formats and an easy to use framework for batch processing.

The main Git repository, where issues and merge requests are managed can be found at https://git.km3net.de/km3py/km3pipe.git

The framework tries to standardise the way the data is processed by providing a Pipeline-class, which can be used to put together different built-in or user made Pumps, Sinks and Modules. Pumps act as data readers/parsers (from files, memory or even socket connections), Sinks are responsible for writing data to disk and Modules take care of data processing, output and user interaction. Such a Pipeline setup can then be used to iteratively process data in a file or from a stream. In our case for example, we store several thousands of neutrino interaction events in a bunch of files and KM3Pipe is used to stitch together an analysis chain which processes each event one-by-one by passing them through a pipeline of modules.

Although it is mainly designed for the KM3NeT neutrino detectors, it can easily be extended to support any kind of data formats. The core functionality is written in a general way and is applicable to all kinds of data processing workflows.

To start off, run:

pip install km3pipe

If you have Docker (https://www.docker.com) installed, you can start using KM3Pipe immediately by typing:

docker run -it git.km3net.de:4567/km3py/km3pipe

Feel free to get in touch if you’re looking for a small, versatile framework which provides a quite straightforward module system to make code exchange between your project members as easily as possible. KM3Pipe already comes with several types of Pumps, so it should be easy to find an example to implement your owns. As of version 8.0.0 you find Pumps and Sinks based on popular formats like HDF5 (https://www.hdfgroup.org), ROOT (https://root.cern.ch) but also some very specialised project internal binary data formats, which on the other hand can act as templates for your own ones. Just have a look at the io subpackage and of course the documentation if you’re interested!

Read the latest docs at https://km3py.pages.km3net.de/km3pipe.

KM3NeT public project homepage http://www.km3net.org

Acknowledgements

Thanks especially to the gracious help of all contributors:

Tamas Gal, Moritz Lotze, Johannes Schumann, Piotr Kalaczynski, Jonas Reubelt, Michael Moser, Thomas Heid, Alba Domi, Agustin Sanchez Losa, Zineb Aly, Jordan Seneca, Nicole Geisselbrecht, Javier Barrios, Valentin Pestel, Jannik Hofestaedt, Matthias Bissinger, Vladimir Kulikovskiy, Lukas Hennig, Godefroy Vannoye

Download files

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

Source Distribution

km3pipe-11.0.0.tar.gz (363.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

km3pipe-11.0.0-py3-none-any.whl (201.0 kB view details)

Uploaded Python 3

File details

Details for the file km3pipe-11.0.0.tar.gz.

File metadata

  • Download URL: km3pipe-11.0.0.tar.gz
  • Upload date:
  • Size: 363.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.4

File hashes

Hashes for km3pipe-11.0.0.tar.gz
Algorithm Hash digest
SHA256 c2d04b6109e551adfe6d17c6ff7725bb7d999834c236b112b4335c4567c27cf8
MD5 a77ba67dc337db7ceed0b379e9f6f918
BLAKE2b-256 f30839a01cf088b864c8b011115d17bd2203dfa9b8fe6b51677c3dab01a759e8

See more details on using hashes here.

File details

Details for the file km3pipe-11.0.0-py3-none-any.whl.

File metadata

  • Download URL: km3pipe-11.0.0-py3-none-any.whl
  • Upload date:
  • Size: 201.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.4

File hashes

Hashes for km3pipe-11.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d47a96253a6630ac441f87ea8a4a79727c438915094097a2c3bce34ba5d8f8bc
MD5 1a927bda4ea7192487d0c1aef49c2d9c
BLAKE2b-256 5d9cb9eb1b08e1ee0b7f80f3b03161985996cccddc6f0032802cdc0957d0786d

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page