EventDisplay
============

.. toctree::
   :maxdepth: 1
   :caption: Contents:

   EventDisplay_DetectorGeometry
   EventDisplay_Events

The event display is a visualization tool which displays
the detector geometry and the data objects of the different reconstruction
stages within PandaRoot.

It is based on the FairEventDisplay which delivers most of the functionality.
Within PandaRoot only a few extensions for PANDA specific data types are done.

Start via macro
---------------

The event display is started via the macro ``macro/tools/eventDisplay.C``.
The only parameter is the prefix for the data files to be displayed.
If no prefix is given the default string ``../data/evtcomplete`` is taken.
The macro automatically tries to include the ``sim``, ``digi`` and ``reco`` file
and visualizes the data objects therein.
If only specific data objects should be displayed the other objects have to be
commented out in the macro.

Usage of the event display
--------------------------

The startup of the event display shows a side view of the detector.

.. image:: ./Images/EventDisplay_StartUp.png
	:width: 600
	:alt: Event Display

The view of the detector model can be controlled either via the mouse
or the keyboard:

.. list-table:: Detector model inside event view
   :header-rows: 1
   
   * - action
     - mouse
     - mouse + keyboard
     - keyboard
   * - rotate
     - left button
     - shift (fast), control (slow)
     -
   * - zoom
     - right button or scroll wheel
     -
     - in (+, j), out (-, k)
   * - shift
     - middle button
     - command
     - arrow keys
   * - wire frame
     -
     -
     - w
   * - solid
     -
     -
     - r
   * - solid + boundaries
     -
     -
     - t
   * - toggle background
     -
     -
     - e

In addition three other views are available: RPhi View, RhoZ View and Multi View.
They can be accessed via the tabs on top of the page.

.. image:: ./Images/EventDisplay_Camera.png
	:width: 600
	:alt: Event Display

**TIP** Underneath the ``Hide`` tab is a hidden menu bar with ``File`` and ``Camera`` (see red arrow).
Here you can save screenshots of the display or change the perspective of the view.
Especially the ``Orthographic (XOY)`` is very useful to look along the beam axis onto the detector.