= Description of model API =

Here we describe the aplication interface of classes that form the `libElegent` library.

== Constants == 

The class `Constants` encapsulates physics and mathematical constants (e.g. proton mass, Euler’s constants) as well as process description (e.g. pp or app mode, centre-of-mass energy). The constants are set up by the static `Init` method which creates an instance of the class referenced by the global pointer `cnts`.


== Hadronic models == 

All models of hadronic interactions are implemented as classes inheriting from the `Model` class. If the model exists in several variants or versions, or if its amplitude can be calculated in several modes, the user can make a choice via the `Configure` method. Afterwards, the `Init` method shall be used to initialize model parameters and perform (potentially) time-expensive initialisations (e.g. pre-sampling).

The scattering amplitude (in t-space) and profile function (amplitude in b-space) can be caluculated by `Amp(t)` and `Prf(b)` methods respectively. For details (normalisation etc.) see the journal publication linked from the [[https://elegent.hepforge.org/|home page]].


== Coulomb and Coulomb-interference ==

The code related to the Coulomb amplitude and the Coulomb-hadronic interference is grouped in the `CoulombInterference` class.

The choice of the [[FormFactors|form factor parametrisation]] is made by `ffType` data member (possibilities are given by the `FFType` enum). The methods `FF_e(t)`, `FF_m(t)` and `FF_sq(t)` return the electric, magnetic and square of the effective form factor.

The amplitude due to Coulomb, hadronic or both interactions can be obtained from the `Amp(t)` method. The type of the amplitude is chosen via the `mode` data member (choices given by the `CIMode` enum).


== Generator class ==

The `Generator` class implements a Monte-Carlo generator of elastic nucleon-nucleon scattering events according to a given cumulative distribution function (can be built by `ElegentTDistributionSampler` program). The constructor takes these parameters:
{{{
	Generator(file, path, t_min, t_max, verbosity)
}}}
where `file` refers to a ROOT file with the cumulative distribution function. `path` gives the path of the distribution within the file. `t_min` and `t_max` can be used to constrain the t-range of the generated events. `verbosity` sets the verbosity level.

After creation of a `Generator` instance, its `Init` method shall be called to load and prepare all necessary data.

Finally, a random event in HepMC format can be generated as follows:
{{{
		GenEvent* gEv = new GenEvent();
		gEv->set_event_number(...);
		generator.Generate(gEv);
}}}