Skip to main content

High Energy Physics Plotting Interface

Project description

Heppi (Hep Plotting Interface)

.. image::

.. image::

.. image::
:alt: Documentation Status

A High Energy Physics Plotting Interface

* Free software: ISC license
* Documentation:

``Heppi`` is a plotting interface written in pyROOT and uses json files as configuration file.
the plotcard systax is higly flexible allowing you to define different processes, variable, cuts
and selection categories.

* The recomended procedure to install ``Heppi`` is trough ``PyPI``
.. code-block::
pip install heppi

* For CERN users, you might need to install the package on your .local directory by adding ``--user`` option to the previous command.
.. code-block::
pip install heppi --user

* The dependencies will normaly be installed automatically.
* Since ``Heppi`` is based on pyROOT, ROOT env must be set

installation via Git:
* The alternative way to install Heppi is by cloning and building the project
.. code-block::
> git clone
> cd Heppi
> pip install dependencies --user
> make install-user

How to run

Produce a plotcard
* ``Heppi`` allows to create your own plotcard using the makeplotcard script. You can run
.. code-block::

Produce a stacked plots

* To run ``heepi`` plotmaker you have to run the script ``plot``
* you can print the options of the script by typing ``.\plot --help``
* you have to combine the trees using ```` script
* the commend I'm using is the follwing:

.. code-block::
./plot -s /dir/to/merged/trees --load plotcard.json --all

* if you want to print one variable in the plotcard you can replace the option ``--all`` by ``--variable`` or just ``-v`` followed by the name of the variable.
example :

.. code-block::
./plot -s /dir/to/merged/trees --load plotcard.json -v var1

Write a valid plotcard ?

* Produce the plotcard using a processe.json files and input root file.
* The tree name must be specified

.. code-block:: bash
./ --load /path/to/root/file.root \
--out plotcard.json \
--tree VBFMVADumper/*VBFDiJet

* the ``*`` will be replaced automatically by the remaining name of the tree found in the ``VBFMVADumper`` directory.
* This is for the use of .. _``flashgg``: type dumper trees only, a more standard version will be pushed soon

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter:
.. _`audreyr/cookiecutter-pypackage`:


0.1.0 (2015-12-13)

* First release on PyPI.

Project details

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 DigiCert DigiCert EV certificate StatusPage StatusPage Status page