An analysis framework for KM3NeT
Project description
KM3Pipe
=======
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 framework tries to standardise the way the data is processed within our collaboration by providing a `Pipeline`-class, which can be used to put together different built-in or user made `Pumps` and `Modules`. `Pumps` act as data readers/parsers (from files, memory or even socket connections) and `Modules` take care of data processing and output. Such a `Pipeline` setup can then be used to iteratively process data in a file. In our case for example we store several thousands of neutrino interaction events in a bunch of files and KM3Pipe is used to put together an analysis chain which processes each event one-by-one.
Although it is mainly designed for the KM3NeT neutrino detectors, it can easily be extended to support any kind of data formats. 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 easy as possible.
KM3Pipe already comes with several types of `Pumps` (the modules which act as a data-parser/reader) so it should be easy to find an example to implement your owns. As of version 1.2.3 you find `Pumps` 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 templates for your own ones. Just have a look at the `pumps` subpackage and of course the documention if you're interested!
Read the docs at http://km3pipe.readthedocs.io
KM3NeT related documentation (internal) at http://wiki.km3net.de/index.php/KM3Pipe
KM3NeT public project homepage http://www.km3net.org
Quick Install
=============
To install the latest stable version:
.. code-block:: bash
pip install km3pipe
If you're not using a virtual environment (https://virtualenvwrapper.readthedocs.io), you can install it in your own home directory, however I recommend using virtual environments for any Python related stuff.
.. code-block:: bash
pip install --user km3pipe
To install the latest developer version:
.. code-block:: bash
git clone git@github.com:tamasgal/km3pipe.git
cd km3pipe
pip install -e .
The following video shows how to install the latest developer version and run the test suite.
.. raw:: html
<script type="text/javascript" src="https://asciinema.org/a/43603.js" id="asciicast-43603" async></script>
.. image:: https://travis-ci.org/tamasgal/km3pipe.svg?branch=develop
:target: https://travis-ci.org/tamasgal/km3pipe
.. image:: https://img.shields.io/badge/docs-latest-brightgreen.svg?style=flat
:target: http://km3pipe.readthedocs.io/en/latest/
=======
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 framework tries to standardise the way the data is processed within our collaboration by providing a `Pipeline`-class, which can be used to put together different built-in or user made `Pumps` and `Modules`. `Pumps` act as data readers/parsers (from files, memory or even socket connections) and `Modules` take care of data processing and output. Such a `Pipeline` setup can then be used to iteratively process data in a file. In our case for example we store several thousands of neutrino interaction events in a bunch of files and KM3Pipe is used to put together an analysis chain which processes each event one-by-one.
Although it is mainly designed for the KM3NeT neutrino detectors, it can easily be extended to support any kind of data formats. 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 easy as possible.
KM3Pipe already comes with several types of `Pumps` (the modules which act as a data-parser/reader) so it should be easy to find an example to implement your owns. As of version 1.2.3 you find `Pumps` 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 templates for your own ones. Just have a look at the `pumps` subpackage and of course the documention if you're interested!
Read the docs at http://km3pipe.readthedocs.io
KM3NeT related documentation (internal) at http://wiki.km3net.de/index.php/KM3Pipe
KM3NeT public project homepage http://www.km3net.org
Quick Install
=============
To install the latest stable version:
.. code-block:: bash
pip install km3pipe
If you're not using a virtual environment (https://virtualenvwrapper.readthedocs.io), you can install it in your own home directory, however I recommend using virtual environments for any Python related stuff.
.. code-block:: bash
pip install --user km3pipe
To install the latest developer version:
.. code-block:: bash
git clone git@github.com:tamasgal/km3pipe.git
cd km3pipe
pip install -e .
The following video shows how to install the latest developer version and run the test suite.
.. raw:: html
<script type="text/javascript" src="https://asciinema.org/a/43603.js" id="asciicast-43603" async></script>
.. image:: https://travis-ci.org/tamasgal/km3pipe.svg?branch=develop
:target: https://travis-ci.org/tamasgal/km3pipe
.. image:: https://img.shields.io/badge/docs-latest-brightgreen.svg?style=flat
:target: http://km3pipe.readthedocs.io/en/latest/
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
km3pipe-2.5.tar.gz
(56.0 kB
view hashes)
