What's meaning of the contents in my RUN_DIRECTORY ?

Asked by Juice Soup on 2020-12-21

Hi,

  Every time I run a process, a run_directory will be created and except for the Events, Cards, and HTML folders, there are some more like Source and SubProcess.
  It seems that those folders are used to save codes created by meta-codes. But these code files are too many and I need some help to understand which is used for which. Where can I find the relatively detailed descriptions on the codes, especially those in SubProcess? For example, cuts.f and setcuts.f and similar files in P1_xxx sub-directory ?
  Many thanks!

Regards,

Soup

Question information

Language:
English Edit question
Status:
Solved
For:
MadGraph5_aMC@NLO Edit question
Assignee:
No assignee Edit question
Solved by:
Olivier Mattelaer
Solved:
2020-12-22
Last query:
2020-12-22
Last reply:
2020-12-21

Hi,

We do not have any real documentation that details each file/function in all the directory that we create
here is a short description for the LO output
Source Directory:

Source/DHELAS: all the helicity amplitude function needed to evaluate the matrix-element
Source/MODEl: all the routine to evaluate all the coupling associated to the model
Source/PDF: all the routine related to the PDF
Source: mainly routine associate to the adapative monte-carlo sampler (in particular dsample.f)

SubProcesses Directory
SubProcesses/genps.f: -> conversion from random number between [0,1] to four momenta
SubProcesses/cuts.f -> check if the four momenta pass the specified cut
SubProcesses/setcuts.f -> convert the cut to boundary condition for the phase-space integrator
SubProcesses/myamp.f -> analyse cut/mass to have some guess on how to integrate the function

Then you will have a bunch of P directory which all correspond to one (or a set) of initial state
in all of them you will have file
- matrix.f, matrix1.f , matrix2.f [the number and name depend of the level of optimization of the code]
which contains a series of call to the helicity wavefunction in order to evaluate the associated ampltidue
- auto-dsig.f (you can also have auto_dsig1.f, ...) which is responsible to pick which initial state to write in the events if you have a set and to do the convolution with the PDF
- addmothers.f: responsible to select the Leading color information for the events and to select intermediate particle information to write into the leshouches events
- setscales.f : determination of the various scale
- cluster.f : for the CKKW merging algorithm (and often used for the default dynamical scale)

I probably miss a bunch of other file but those are the most important to my point of view.

Cheers,

Olivier

> On 21 Dec 2020, at 14:05, Juice Soup <email address hidden> wrote:
>
> New question #694616 on MadGraph5_aMC@NLO:
> https://answers.launchpad.net/mg5amcnlo/+question/694616
>
> Hi,
>
> Every time I run a process, a run_directory will be created and except for the Events, Cards, and HTML folders, there are some more like Source and SubProcess.
> It seems that those folders are used to save codes created by meta-codes. But these code files are too many and I need some help to understand which is used for which. Where can I find the relatively detailed descriptions on the codes, especially those in SubProcess? For example, cuts.f and setcuts.f and similar files in P1_xxx sub-directory ?
> Many thanks!
>
> Regards,
>
> Soup
>
> --
> You received this question notification because you are an answer
> contact for MadGraph5_aMC@NLO.

Juice Soup (juice-soup) said : #2

Thanks Olivier Mattelaer, that solved my question.