TopReX generator (version~3.25). Short manual

TL;DR

TopReX 3.25 is a specialized event generator for simulating certain pp and p pbar collision processes, including non-standard top quark decays and spin effects, complementing PYTHIA.

Contribution

It introduces a new event generator that simulates processes not yet available in PYTHIA, with capabilities for standalone use and detailed top quark decay modeling.

Findings

Supports non-SM top quark decay channels

Includes spin polarization effects in top quark decays

Can operate independently or as an external process in PYTHIA

Abstract

This is the manual of the specialized event generator TopReX 3.25. The generator provides the simulation of several important processes in pp and p pbar collisions, not implemented in PYTHIA (yet). Some of these processes include t-quarks whose spin polarizations are taken into account in the subsequent decay of the t-quarks. Several non-SM top quark decay channels are included, too. All calculated subprocesses can be accessed from PYTHIA as external processes. In addition, TopReX can be used as stand alone event generator, providing partonic final states before showering. In this mode the control of the event generation is taken by TopReX itself. A few simple examples of main routines, which show how to use TopReX in the different modes are discussed.