Examples

A collection of VISPA modules can be found at https://forge.physik.rwth-aachen.de/projects/vispa-modules. Check the Module List for a description of the modules.

This page gives examples of modules that are either delivered with the VISPA installation package or that can be installed from the linked locations. Further examples are available from different locations, e.g. from the ones at the bottom of the page.

Example C++ Module

While C++ modules are generally more elaborate to write and it is necessary to compile and link them, they often have advantages in terms of necessary computing time. A general recommendation is to use C++ modules for all tasks that are very computing-intensive, but to stick to Python modules for everything else. The preferences will of course depend on the task and the user.

The table lists some examples on how to write and use C++ modules.

Module Summary
SimpleCppModule A general overview how to write and install a simple C++ analysis module using the VISPA plugin mechanism
LHE Input Module This module allows to run an analysis with input from Monte Carlo generators in the Les Houches Event (LHE) format
See the Module List for more examples.

Example Python Modules

A selection of Python modules is listed in the following. The examples are part of the VISPA distribution. Full analysis examples (xml format) as well as the scripts described below (py format) can also be viewed and downloaded on the developer website Analysis designer examples.

High Energy Physics

Module Summary
Count Count the number of events
Rename Rename particles according to the default name in a particle data list
Split Split 1 input event data stream into 3 output data streams, each containing 1/3 of the data
Sort Sort reconstructed particles by pt and filter particles with abs(eta) < 2.0
Select Common event selection for data from different streams. Data streams are kept separated
HistogramKinematics Create histogram of kinematic properties of final state particles. Uses the ROOT package for histogramming.

Astroparticle Physics

Module Summary
IsotropyUHECRGenerator Create ultra-high energy cosmic rays (UHECRs) with an isotropic distribution
UHECRToHealpixMap Create a map with the Healpix projection from UHECRs
PlotHealpixMap Plot a map with the Healpix projection using matplotlib

More scripts and analysis examples can be found at AnalysisDesigner examples and AnalysisDesigner examples with ROOT. The latter directory includes advanced examples using ROOT, e.g. for multivariate data analysis.

Further examples

See the Module List for a collection of modules.

To create plots from text input using ROOT, Python modules are available from EasyRootPlot. The EasyRootPlot modules are designed to perform most tasks by configuration settings without changing the source code