Event Visualisation Workflow

This module contains DPL worflow, which can be used to produce data (in JSON format) to be displayed be o2-eve. Workflow may be used:

on EPN to produce data which are then copied to online visualisation machine in P2 (see process description EventVisualisation Scripts)
locally to make visualisation based on simulated data

Prepare data based on simulated data

before one starts steps described below, please verify that:

for o2-eve-export-workflow step you should:
- start within the folder where simulated data was produced
- you need to store in the folder file ~~~ITSdictionary.bin~~~ and ~~~MFSdictionary.bin~~~ (available from O2-2288 jira)
for o2-eve step you should:
- have in the working folder:
  - .o2eve_config file (available from EventVisualisation/Scripts)
  - o2sim_geometry.root (copied from simulation folder)
  - o2sim_grp.root (copied from simulation folder)
- have (somewhere) folder with json files (f.e /home/ed/jsons)
- have (somewhere) folder with simplify geometry files (f.e /home/ed/geom/O2)

To visualise a simulated data one should:

Run simulation
# for example:

enter dev

$O2_ROOT/prodtests/sim_challenge.sh -n 5 -s pbpb
Run Workflow in folder with files produced by simulation
o2-global-track-cluster-reader --track-types TPC,ITS --cluster-types TPC,ITS | o2-eve-export-workflow --display-tracks TPC,ITS --display-clusters TPC,ITS
Run o2-eve pointing a folder where produced *.json files were stored (see description # Event Visualisation View)
enter dev

o2-eve -j -d /home/ed/jsons -o

parameter	default value	description
jsons-folder	jsons	name of the host allowed to produce files
eve-hostname		name of the host allowed to produce files (empty means no limit)
eve-dds-collection-index	-1	number of dpl collection allowed to produce files (-1 means no limit)
number-of_files	300	maximum number of json files in folder (newer one will replace oldest)
number-of_tracks	-1	maximum number of track stored in json file (-1 means no limit)
time-interval	5000	time interval in milliseconds between stored files
disable-mc	false	disable visualization of MC data
display-clusters	ITS,TPC,TRD,TOF	comma-separated list of clusters to display
display-tracks	TPC,ITS,ITS-TPC,TPC-TRD,ITS-TPC-TRD,TPC-TOF,ITS-TPC-TOF	comma-separated list of tracks to display
disable-root-input	false	disable root-files input reader
configKeyValues		semicolon separated key=value strings ...
skipOnEmptyInput	false	don't run the ED when no input is provided
min-its-tracks	-1	don't create file if less than the specified number of ITS tracks is present
min-tracks	1	don't create file if less than the specified number of all tracks is present
filter-its-rof	false	don't display tracks outside ITS readout frame
filter-time-min	-1	display tracks only in `[min, max]` microseconds time range in each time frame, requires `--filter-time-max` to be specified as well
filter-time-max	-1	display tracks only in `[min, max]` microseconds time range in each time frame, requires `--filter-time-min` to be specified as well