HEPMDB - User contributions [en-gb]

AdminCpanel

2017-03-01T10:29:28Z

Hepmdb:

To change permition of the resisted user search for Special:UserRights

To change the menu type MediaWiki:Sidebar

Manual for WIKI
[[Media:Open4a-Getting-Started-with-mediawiki.pdf‎ |Download]]

'''MediaWiki has been successfully installed.'''

Consult the [//meta.wikimedia.org/wiki/Help:Contents User's Guide] for information on using the wiki software.

== Getting started ==
* [//www.mediawiki.org/wiki/Manual:Configuration_settings Configuration settings list]
* [//www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mailing list]

* navigation
** mainpage|mainpage-description
** portal-url|portal
** currentevents-url|currentevents
** recentchanges-url|recentchanges
** randompage-url|randompage

* SEARCH
* TOOLBOX
* LANGUAGES
* Admin
** Developer's Documentation|Developers Documentation
** AdminCpanel|Admin Cpanel

Developers Documentation

2016-12-13T19:31:14Z

Hepmdb:

Use the following document for a reference guide to HEPMDB.

= File Structure =

<nowiki>
- /html
- /admin</nowiki>

Developers Documentation

2016-12-13T19:31:08Z

Hepmdb:

Use the following document for a reference guide to HEPMDB.

----

= File Structure =

<nowiki>
- /html
- /admin</nowiki>

MediaWiki:Sidebar

2016-12-13T19:28:32Z

Hepmdb:

* navigation
** mainpage|mainpage-description
** FAQ|FAQ
** Staff_of_HEPMDB|Staff

* Features
** Registration|Registration
** Uploading_model|Uploading Model
** Calculate_section|Calculate

* Documentation
** http://theory.sinp.msu.ru/~pukhov/CALCHEP/calchep_man_3.3.6.pdf|CalcHEP 3.3.6 manual
** http://whizard.hepforge.org/manual/|WHIZARD 2.2 manual
** http://comphep.sinp.msu.ru/news|CompHEP manual
** https://cp3.irmp.ucl.ac.be/projects/madgraph/|MadGraph wiki

* SEARCH

* Admin
** Developers Documentation|Developer's Documentation
** AdminCpanel|Admin Panel

AdminCpanel

2016-12-13T19:27:39Z

Hepmdb:

Developers Documentation

2016-12-13T19:23:33Z

Hepmdb: Protected "Developers Documentation" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

Hello world

Developers Documentation

2016-12-13T19:23:16Z

Hepmdb: First revision

Hello world

Calculate section

2015-07-28T13:19:54Z

Hepmdb: /* The calculation part */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided into four parts:
# The top bar, containing the HEPMDB logo, the <tt>Show Iridis4 Queue</tt> and <tt>Go to Main Site</tt> buttons, and a drop down menu.
# The messages box, with general information on the last operations.
# The left menu, with the main functions and the program list.
# The calculation part, presenting results of computation.

=== The top bar ===
In the top bar, you will find:
* A <tt> Show Iridis4 Queue </tt> button that opens a window showing information on the total use of Iridis4 and the job queue for HEPMDB itself.
* A drop down menu.
* The <tt>Go to Main Site</tt> button which redirects you to the <tt>HEPMDB</tt> main page in the same tab.

The drop down menu contains a few useful items:
* <tt>User ID</tt>: This is very useful to reference if ever asking one of the developers about a problem with your account.
* <tt>Documentation</tt>: This takes you to these Wiki pages in a new tab.
* <tt>History</tt>: This opens a window with a full list of everything you have done on HEPMDB.
* <tt>Send a message to admin</tt>: This opens a window allowing you to send a message to an admin with your registered email.
* <tt>Reset Account</tt>: This will clear all your imported models and your .lhe and .nt files, and restore your account to its default settings.

=== The messages box ===
This part of the webpage displays information on any actions you have performed. For example, starting a job will display a message stating whether or not the job has been successfully submitted and the time of submission. The <tt>Check Job Progress</tt> button, located in the menus of CalcHEP, Whizard and Madgraph, will display any information on currently running jobs (like expected completion time) in the message box also.

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided into three panels. Each panel corresponds to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The calculation part ===
When the computation is done, the results will be displayed here. In the case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>File</tt> drop-down menu. You can import any model that has been uploaded to <tt>HEPMDB</tt> and shared publicly, or any you have uploaded and not shared.

When the model you wish to use is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit batch file</tt> option in the <tt>Selection</tt> drop down menu.

Besides writing the batch, you have four options in the editing window:
# <tt>Save Changes</tt>: This does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Import Full Template</tt>: This is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load Batch</tt>: This allows the user to load the batch file from a file.
# <tt>Save As</tt>: This option saves the current batch to a file. You still have to use the <tt>Save Changes</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
Once you have saved your batch file (making sure to have used the <tt>Save Changes</tt> button), you can now select <tt>Run Batch File</tt> from the <tt>Selection</tt> drop-down menu. You can check the status of the queued process via <tt>Check Job Progress</tt> in the <tt>File</tt> menu.

When you select <tt>Run Batch File</tt> a window should appear asking you to confirm the job submission. In this window it is possible to change the requested HPCx usage time (the current default is 10 minutes). Asking for a smaller amount of time will give your job a higher priority. However, it is important to note that if your job is still running at the end of the requested time it will be killed and returned to you with anything it managed in that time. Users are also limited to a request of 60 hours maximum.

When the computation is done <tt>HEPMDB</tt> will notify you by email. When you receive this email you can return to the <tt>Calculate Section</tt> of <tt>HEPMDB</tt> to view your results. If your results are not automatically displayed click again on the <tt>Check Job Progress</tt> button and they should be now be displayed in the main window. Any previous results can been reviewed using the history option found in the <tt>Tools</tt> menu.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: This is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: This enables you to load a batch file from a file.
# <tt>Save</tt>: This does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: This only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: This defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: In this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2015-07-28T13:19:25Z

Hepmdb: /* The left menu */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided into four parts:
# The top bar, containing the HEPMDB logo, the <tt>Show Iridis4 Queue</tt> and <tt>Go to Main Site</tt> buttons, and a drop down menu.
# The messages box, with general information on the last operations.
# The left menu, with the main functions and the program list.
# The calculation part, presenting results of computation.

=== The top bar ===
In the top bar, you will find:
* A <tt> Show Iridis4 Queue </tt> button that opens a window showing information on the total use of Iridis4 and the job queue for HEPMDB itself.
* A drop down menu.
* The <tt>Go to Main Site</tt> button which redirects you to the <tt>HEPMDB</tt> main page in the same tab.

The drop down menu contains a few useful items:
* <tt>User ID</tt>: This is very useful to reference if ever asking one of the developers about a problem with your account.
* <tt>Documentation</tt>: This takes you to these Wiki pages in a new tab.
* <tt>History</tt>: This opens a window with a full list of everything you have done on HEPMDB.
* <tt>Send a message to admin</tt>: This opens a window allowing you to send a message to an admin with your registered email.
* <tt>Reset Account</tt>: This will clear all your imported models and your .lhe and .nt files, and restore your account to its default settings.

=== The messages box ===
This part of the webpage displays information on any actions you have performed. For example, starting a job will display a message stating whether or not the job has been successfully submitted and the time of submission. The <tt>Check Job Progress</tt> button, located in the menus of CalcHEP, Whizard and Madgraph, will display any information on currently running jobs (like expected completion time) in the message box also.

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided into three panels. Each panel corresponds to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The calculation part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>File</tt> drop-down menu. You can import any model that has been uploaded to <tt>HEPMDB</tt> and shared publicly, or any you have uploaded and not shared.

When the model you wish to use is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit batch file</tt> option in the <tt>Selection</tt> drop down menu.

Besides writing the batch, you have four options in the editing window:
# <tt>Save Changes</tt>: This does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Import Full Template</tt>: This is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load Batch</tt>: This allows the user to load the batch file from a file.
# <tt>Save As</tt>: This option saves the current batch to a file. You still have to use the <tt>Save Changes</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
Once you have saved your batch file (making sure to have used the <tt>Save Changes</tt> button), you can now select <tt>Run Batch File</tt> from the <tt>Selection</tt> drop-down menu. You can check the status of the queued process via <tt>Check Job Progress</tt> in the <tt>File</tt> menu.

When you select <tt>Run Batch File</tt> a window should appear asking you to confirm the job submission. In this window it is possible to change the requested HPCx usage time (the current default is 10 minutes). Asking for a smaller amount of time will give your job a higher priority. However, it is important to note that if your job is still running at the end of the requested time it will be killed and returned to you with anything it managed in that time. Users are also limited to a request of 60 hours maximum.

When the computation is done <tt>HEPMDB</tt> will notify you by email. When you receive this email you can return to the <tt>Calculate Section</tt> of <tt>HEPMDB</tt> to view your results. If your results are not automatically displayed click again on the <tt>Check Job Progress</tt> button and they should be now be displayed in the main window. Any previous results can been reviewed using the history option found in the <tt>Tools</tt> menu.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: This is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: This enables you to load a batch file from a file.
# <tt>Save</tt>: This does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: This only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: This defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: In this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2015-07-27T13:50:51Z

Hepmdb: /* Using MadGraph */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided into four parts:
# The top bar, containing the HEPMDB logo, the <tt>Show Iridis4 Queue</tt> and <tt>Go to Main Site</tt> buttons, and a drop down menu.
# The messages box, with general information on the last operations.
# The left menu, with the main functions and the program list.
# The calculation part, presenting results of computation.

=== The top bar ===
In the top bar, you will find:
* A <tt> Show Iridis4 Queue </tt> button that opens a window showing information on the total use of Iridis4 and the job queue for HEPMDB itself.
* A drop down menu.
* The <tt>Go to Main Site</tt> button which redirects you to the <tt>HEPMDB</tt> main page in the same tab.

The drop down menu contains a few useful items:
* <tt>User ID</tt>: This is very useful to reference if ever asking one of the developers about a problem with your account.
* <tt>Documentation</tt>: This takes you to these Wiki pages in a new tab.
* <tt>History</tt>: This opens a window with a full list of everything you have done on HEPMDB.
* <tt>Send a message to admin</tt>: This opens a window allowing you to send a message to an admin with your registered email.
* <tt>Reset Account</tt>: This will clear all your imported models and your .lhe and .nt files, and restore your account to its default settings.

=== The messages box ===
This part of the webpage displays information on any actions you have performed. For example, starting a job will display a message stating whether or not the job has been successfully submitted and the time of submission. The <tt>Check Job Progress</tt> button, located in the menus of CalcHEP, Whizard and Madgraph, will display any information on currently running jobs (like expected completion time) in the message box also.

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The calculation part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>File</tt> drop-down menu. You can import any model that has been uploaded to <tt>HEPMDB</tt> and shared publicly, or any you have uploaded and not shared.

When the model you wish to use is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit batch file</tt> option in the <tt>Selection</tt> drop down menu.

Besides writing the batch, you have four options in the editing window:
# <tt>Save Changes</tt>: This does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Import Full Template</tt>: This is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load Batch</tt>: This allows the user to load the batch file from a file.
# <tt>Save As</tt>: This option saves the current batch to a file. You still have to use the <tt>Save Changes</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
Once you have saved your batch file (making sure to have used the <tt>Save Changes</tt> button), you can now select <tt>Run Batch File</tt> from the <tt>Selection</tt> drop-down menu. You can check the status of the queued process via <tt>Check Job Progress</tt> in the <tt>File</tt> menu.

When you select <tt>Run Batch File</tt> a window should appear asking you to confirm the job submission. In this window it is possible to change the requested HPCx usage time (the current default is 10 minutes). Asking for a smaller amount of time will give your job a higher priority. However, it is important to note that if your job is still running at the end of the requested time it will be killed and returned to you with anything it managed in that time. Users are also limited to a request of 60 hours maximum.

When the computation is done <tt>HEPMDB</tt> will notify you by email. When you receive this email you can return to the <tt>Calculate Section</tt> of <tt>HEPMDB</tt> to view your results. If your results are not automatically displayed click again on the <tt>Check Job Progress</tt> button and they should be now be displayed in the main window. Any previous results can been reviewed using the history option found in the <tt>Tools</tt> menu.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: This is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: This enables you to load a batch file from a file.
# <tt>Save</tt>: This does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: This only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: This defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: In this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2015-07-27T13:50:35Z

Hepmdb: /* Using WHIZARD */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided into four parts:
# The top bar, containing the HEPMDB logo, the <tt>Show Iridis4 Queue</tt> and <tt>Go to Main Site</tt> buttons, and a drop down menu.
# The messages box, with general information on the last operations.
# The left menu, with the main functions and the program list.
# The calculation part, presenting results of computation.

=== The top bar ===
In the top bar, you will find:
* A <tt> Show Iridis4 Queue </tt> button that opens a window showing information on the total use of Iridis4 and the job queue for HEPMDB itself.
* A drop down menu.
* The <tt>Go to Main Site</tt> button which redirects you to the <tt>HEPMDB</tt> main page in the same tab.

The drop down menu contains a few useful items:
* <tt>User ID</tt>: This is very useful to reference if ever asking one of the developers about a problem with your account.
* <tt>Documentation</tt>: This takes you to these Wiki pages in a new tab.
* <tt>History</tt>: This opens a window with a full list of everything you have done on HEPMDB.
* <tt>Send a message to admin</tt>: This opens a window allowing you to send a message to an admin with your registered email.
* <tt>Reset Account</tt>: This will clear all your imported models and your .lhe and .nt files, and restore your account to its default settings.

=== The messages box ===
This part of the webpage displays information on any actions you have performed. For example, starting a job will display a message stating whether or not the job has been successfully submitted and the time of submission. The <tt>Check Job Progress</tt> button, located in the menus of CalcHEP, Whizard and Madgraph, will display any information on currently running jobs (like expected completion time) in the message box also.

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The calculation part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>File</tt> drop-down menu. You can import any model that has been uploaded to <tt>HEPMDB</tt> and shared publicly, or any you have uploaded and not shared.

When the model you wish to use is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit batch file</tt> option in the <tt>Selection</tt> drop down menu.

Besides writing the batch, you have four options in the editing window:
# <tt>Save Changes</tt>: This does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Import Full Template</tt>: This is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load Batch</tt>: This allows the user to load the batch file from a file.
# <tt>Save As</tt>: This option saves the current batch to a file. You still have to use the <tt>Save Changes</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
Once you have saved your batch file (making sure to have used the <tt>Save Changes</tt> button), you can now select <tt>Run Batch File</tt> from the <tt>Selection</tt> drop-down menu. You can check the status of the queued process via <tt>Check Job Progress</tt> in the <tt>File</tt> menu.

When you select <tt>Run Batch File</tt> a window should appear asking you to confirm the job submission. In this window it is possible to change the requested HPCx usage time (the current default is 10 minutes). Asking for a smaller amount of time will give your job a higher priority. However, it is important to note that if your job is still running at the end of the requested time it will be killed and returned to you with anything it managed in that time. Users are also limited to a request of 60 hours maximum.

When the computation is done <tt>HEPMDB</tt> will notify you by email. When you receive this email you can return to the <tt>Calculate Section</tt> of <tt>HEPMDB</tt> to view your results. If your results are not automatically displayed click again on the <tt>Check Job Progress</tt> button and they should be now be displayed in the main window. Any previous results can been reviewed using the history option found in the <tt>Tools</tt> menu.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: This is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: This enables you to load a batch file from a file.
# <tt>Save</tt>: This does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: This only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

HEPMDB

2015-07-27T13:48:33Z

Hepmdb:

__NOTOC__
<table width="100%" border="0">
<tr>
<td width="100%" valign="top">
= What is HEPMDB? =

The '''H'''igh '''E'''nergy '''P'''hysics '''M'''odel '''D'''ata'''b'''ase (HEPMDB) was created to facilitate the connection between high energy physics theory and experiment, to store and validate theoretical models, and to develop a dictionary of the model signatures which identifies the fundamental theories responsible for signals expected at the LHC.

HEPMDB is also designed to collect different signatures of its models and their respective experimental efficiencies. Using this information, HEPMDB will be able to compare its Beyond Standard Model (BSM) predictions with LHC data. In doing so, HEPMDB will be able to discriminate the underlying theory.

The database is in the development stage and your input in the 'Forum' section is highly appreciated. The database collects particle physics models. These models are supposed to be public and represent themselves as a set of Feynman Rules which can be expressed in the input form of any matrix element generator such as CalcHEP, CompHEP, FeynArts, Madgraph, SHERPA, WHIZARD.

HEPMDB has an entrance for Model authors -- 'Authors' -- where Authors can test and validate their models. To become an 'Author' you should register in the 'Register' section. 'Authors' are welcome to upload the LanHEP or FeynRules sources of their models.

= Further Information =

Presently, this allows for the collection of high energy physics models, the ability to perform symbolic and numerical calculations of particle scattering processes and the storage of results for the respective model simulations.

===CalcHEP===

For the evaluation of particle physics processes, HEPMDB uses CalcHEP software package and gives users an option to run simulations on a remote HPCx supercomputing cluster. CalcHEP software is designed for automatic calculation of Feynman diagrams for generic models of elementary particle interactions. CalcHEP allows researchers to predict various observables for new models which provides an opportunity to compare model predictions with a large number amount of experimental data from particle accelerators.

The status of CalcHEP for world-leading theoretical and experimental High Energy Physics groups is well established (it has been used and respectively cited in about 300 journal publications since 2004). It has been effectively used by the HEP community. CalcHEP was created in 1999 from the CompHEP package which now counts more than 600 citations since 1999. In terms of the computing side of this software, there are several avenues of improving and exploiting the current capabilities.

In comparison with analogous packages which will be mentioned below, CalcHEP has several features which make it one of the world-leading tools for exploring particle physics. One of these features is a convenient menu-driven Graphical User Interface (GUI) with the detailed context help. This detailed context help is designed so that a user can start using CalcHEP straight after its installation.

Among other important features of CalcHEP is the option to easily implement a new model with an internal editor or external editors/packages. CalcHEP gives the user the option to perform calculations in two different gauges. This provides a powerful cross check of the model implementation and the batch interface. The batch interface allows the user to automate the input of many processes of production and decay, event generation and produce various kinematical distributions. One should also stress an additional feature of the batch interface which is to allow parallel calculations on multiprocessor clusters. This significantly enhances CalcHEP's performance.

===Alternatives===

One should note that there are alternative programs to CalcHEP, which can also be used by HEPMDB.

These include : [http://madgraph.hep.uiuc.edu/index.html MADGRAPH], [http://projects.hepforge.org/whizard/ WHIZARD] and
[http://comphep.sinp.msu.ru/overview CompHEP].

===== [http://hepmdb.soton.ac.uk Back to HEPMDB site] =====

</td>
<td width="550px" align="right" valign=top>
[[File:Tt main.png|500px]]
An example of the Calculate Section in HEPMDB

</td>
</tr>
</table>

HEPMDB

2015-07-27T13:48:14Z

Hepmdb:

__NOTOC__
<table width="100%" border="0">
<tr>
<td width="100%" valign="top">
= What is HEPMDB? =

The '''H'''igh '''E'''nergy '''P'''hysics '''M'''odel '''D'''ata'''b'''ase (HEPMDB) was created to facilitate the connection between high energy physics theory and experiment, to store and validate theoretical models, and to develop a dictionary of the model signatures which identifies the fundamental theories responsible for signals expected at the LHC.

HEPMDB is also designed to collect different signatures of its models and their respective experimental efficiencies. Using this information, HEPMDB will be able to compare its Beyond Standard Model (BSM) predictions with LHC data. In doing so, HEPMDB will be able to discriminate the underlying theory.

The database is in the development stage and your input in the 'Forum' section is highly appreciated. The database collects particle physics models. These models are supposed to be public and represent themselves as a set of Feynman Rules which can be expressed in the input form of any matrix element generator such as CalcHEP, CompHEP, FeynArts, Madgraph, SHERPA, WHIZARD.

HEPMDB has an entrance for Model authors -- 'Authors' -- where Authors can test and validate their models. To become an 'Author' you should register in the 'Register' section. 'Authors' are welcome to upload the LanHEP or FeynRules sources of their models.

= Further Information =

Presently, this allows for the collection of high energy physics models, the ability to perform symbolic and numerical calculations of particle scattering processes and the storage of results for the respective model simulations.

===CalcHEP===

For the evaluation of particle physics processes, HEPMDB uses CalcHEP software package and gives users an option to run simulations on a remote HPCx supercomputing cluster. CalcHEP software is designed for automatic calculation of Feynman diagrams for generic models of elementary particle interactions. CalcHEP allows researchers to predict various observables for new models which provides an opportunity to compare model predictions with a large number amount of experimental data from particle accelerators.

The status of CalcHEP for world-leading theoretical and experimental High Energy Physics groups is well established (it has been used and respectively cited in about 300 journal publications since 2004). It has been effectively used by the HEP community. CalcHEP was created in 1999 from the CompHEP package which now counts more than 600 citations since 1999. In terms of the computing side of this software, there are several avenues of improving and exploiting the current capabilities.

In comparison with analogous packages which will be mentioned below, CalcHEP has several features which make it one of the world-leading tools for exploring particle physics. One of these features is a convenient menu-driven Graphical User Interface (GUI) with the detailed context help. This detailed context help is designed so that a user can start using CalcHEP straight after its installation.

Among other important features of CalcHEP is the option to easily implement a new model with an internal editor or external editors/packages. CalcHEP gives the user the option to perform calculations in two different gauges. This provides a powerful cross check of the model implementation and the batch interface. The batch interface allows the user to automate the input of many processes of production and decay, event generation and produce various kinematical distributions. One should also stress an additional feature of the batch interface which is to allow parallel calculations on multiprocessor clusters. This significantly enhances CalcHEP's performance.

===Alternatives===

One should note that there are alternative programs to CalcHEP, which can also be used by HEPMDB.

These include : [http://madgraph.hep.uiuc.edu/index.html MADGRAPH], [http://projects.hepforge.org/whizard/ WHIZARD] and
[http://comphep.sinp.msu.ru/overview CompHEP].

===== [http://hepmdb.soton.ac.uk Back to HEPMDB site] =====

</td>
<td width="550px" align="right" valign=top>
[[File:Tt main.png|500px]]
[An example of the Calculate Section in HEPMDB]

</td>
</tr>
</table>

HEPMDB

2015-07-27T13:47:30Z

Hepmdb:

HEPMDB

2015-07-27T13:47:21Z

Hepmdb:

FAQ

2015-07-27T13:46:43Z

Hepmdb: /* Why should I use HEPMDB's Calculate section? */

__TOC__

== About HEPMDB ==

=== What is HEPMDB? ===

HEPMDB is a database that stores high energy physics models, and calculates theoretical cross sections for user defined processes in order to validate theory against experimental data. There are other projects similar to this, however HEPMDB is the only database that allows users to upload models, run processes and calculate cross sections on the site itself.

The model database can be accessed by everyone. However, in order to use HEPMDB's computational capabilities you will have to register first.

=== Current Capabilities ===

* Users can upload model files and model source files (i.e <tt>LanHEP</tt>, <tt>FeynRules</tt>) for various Matrix Element Generators inc. <tt>CalcHEP</tt>, <tt>MADGRAPH</tt>, <tt>WHIZARD</tt> etc.

* HEP simulations can be performed using any of the public models (currently 50+) uploaded to the site by registered users, or by your own privately uploaded model.

* Calculations are performed in the HPCx cluster interface, providing up to 16 cores per user. This allows for faster calculation and larger jobs than on a desktop or laptop.

* Model history is stored so that any modifications to the model itself can be tracked.

* Kinematical distributions of various properties can be plotted and stored in the Les Houches Event (.lhe) file format.

* Can search for and download existing models from HEPMDB.

* Option to leave reviews for other's models to aid development.

=== Future Prospects ===

The database is still in development, here are some of the possible prospects for the future development of HEPMDB.

* Addition of the <tt>LanHEP</tt> and <tt>FeynRules</tt> packages, and the <tt>CompHEP</tt> Matrix Element Generator.

* Allow users to upload their own Feynman rule or Matrix Element Generator packages.

* Compare BSM predictions with LHC data systematically in order to discriminate between the different theories.

* Extend database structure to deal with correlated signatures.

* Make format for model predictions consistent with LHC data format used by experimentalists.

* Install MicrOMEGAs package to evaluate dark matter relic density, and to provide scans of model parameter spaces.

* Possibly study events beyond parton level, up to detector simulation.

== Getting started ==

=== How do I register on HEPMDB? ===
To register, all you need are basic details such as your name, email and affiliation. Your account will be reviewed and approved by one of our administrators. You will be notified by email once your account is approved.
Registration can be done on the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=register HEPMDB main site].
As usual, all fields marked with an asterisk are mandatory. Check for further help [[Registration|here]].

== General usage ==

=== What is the Calculate section? ===
This section allows you to use the models uploaded on HEPMDB and directly compute results using <tt>HEPMDB</tt> computers. Only once registered will you be able to use <tt>HEPMDB</tt> Calculate section.
More information on how to use this section is provided [[Calculate section|here]].

=== Which programs can I use on <tt>HEPMDB</tt>? ===
Currently, three different programs can be used for computation on <tt>HEPMDB</tt>: <tt>CalcHEP</tt>, <tt>WHIZARD</tt> and <tt>MadGraph</tt>. Any model developed for these programs and uploaded on the <tt>HEPMDB</tt> website will be accessible.

=== Why should I use <tt>HEPMDB</tt>'s Calculate section? ===
There are many practical reasons for using the <tt>HEPMDB</tt> computing mainframe. Convenience may be the most obvious one; no installation is needed and it is simple to compare results between various matrix element generators. Also, <tt>HEPMDB</tt> has some integrated tools for plotting and analysing that are really quick to use.

Another reason is simply the efficiency; with 16 cores, <tt>HEPMDB</tt> is much faster than most local installations.

=== Where can I find some help on how to use the Calculate section? ===
These wiki pages will provide help. [[Calculate section|Here]] you can find a specific help page for the Calculate section, with information on the interface and descriptions of the different available programs: CalcHEP, WIZARD and MadGraph.

== Becoming an author ==

=== Who is an author? ===
If you want to use the HEPMDB computation abilities, you will have to become an author. Authors are also granted the right to upload new models (and encouraged to do so). In the future, they will also be able to add model signatures.

=== How do you upload a model? ===
As soon as your account is approved, you can upload new models. This is done through the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=upload upload model] page.

Further help can found [[Uploading model|here]].

== Using the results ==

=== Why can't I download the results lhe file? ===
It should be noted that it is not possible to download files bigger than 1GB from <tt>HEPMDB</tt>. Unfortunately, file sizes are not indicated yet.
The consequence of this download limit is that you cannot combine too many lhe files into one before uploading.

== Making a model for <tt>HEPMDB</tt> ==
=== How do I use an SLHA input file? ===
If you wrote a model, it may be using an SLHA input file. On <tt>HEPMDB</tt>, there is an option for the user to upload his/her own SLHA file. In order to use that one, you should use the file <tt>../models/SLHA.txt</tt> in your model. Any SLHA file that the user uploads will be renamed and relocated accordingly.

= Presentations on <tt>HEPMDB</tt> =

==== Miniworkshop on High Energy Physics Model Database (HEPMDB)====
March 2 2012, Durham, IPPP [http://indico.cern.ch/conferenceDisplay.py?confId=179627]

==== CalcHEP and HEPMDB: practical introduction and tutorial ====
by Alexander Belyaev, Friday, 4 May 2012, CERN [https://indico.cern.ch/conferenceDisplay.py?confId=189668]

==== HEPMDB: practical introduction and tutorial ====
Alexander Belyaev, 16 August 2013, CERN [http://indico.cern.ch/conferenceDisplay.py?confId=267908]

FAQ

2015-07-27T13:46:31Z

Hepmdb: /* Current Capabilities */

__TOC__

== About HEPMDB ==

=== What is HEPMDB? ===

HEPMDB is a database that stores high energy physics models, and calculates theoretical cross sections for user defined processes in order to validate theory against experimental data. There are other projects similar to this, however HEPMDB is the only database that allows users to upload models, run processes and calculate cross sections on the site itself.

The model database can be accessed by everyone. However, in order to use HEPMDB's computational capabilities you will have to register first.

=== Current Capabilities ===

* Users can upload model files and model source files (i.e <tt>LanHEP</tt>, <tt>FeynRules</tt>) for various Matrix Element Generators inc. <tt>CalcHEP</tt>, <tt>MADGRAPH</tt>, <tt>WHIZARD</tt> etc.

* HEP simulations can be performed using any of the public models (currently 50+) uploaded to the site by registered users, or by your own privately uploaded model.

* Calculations are performed in the HPCx cluster interface, providing up to 16 cores per user. This allows for faster calculation and larger jobs than on a desktop or laptop.

* Model history is stored so that any modifications to the model itself can be tracked.

* Kinematical distributions of various properties can be plotted and stored in the Les Houches Event (.lhe) file format.

* Can search for and download existing models from HEPMDB.

* Option to leave reviews for other's models to aid development.

=== Future Prospects ===

The database is still in development, here are some of the possible prospects for the future development of HEPMDB.

* Addition of the <tt>LanHEP</tt> and <tt>FeynRules</tt> packages, and the <tt>CompHEP</tt> Matrix Element Generator.

* Allow users to upload their own Feynman rule or Matrix Element Generator packages.

* Compare BSM predictions with LHC data systematically in order to discriminate between the different theories.

* Extend database structure to deal with correlated signatures.

* Make format for model predictions consistent with LHC data format used by experimentalists.

* Install MicrOMEGAs package to evaluate dark matter relic density, and to provide scans of model parameter spaces.

* Possibly study events beyond parton level, up to detector simulation.

== Getting started ==

=== How do I register on HEPMDB? ===
To register, all you need are basic details such as your name, email and affiliation. Your account will be reviewed and approved by one of our administrators. You will be notified by email once your account is approved.
Registration can be done on the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=register HEPMDB main site].
As usual, all fields marked with an asterisk are mandatory. Check for further help [[Registration|here]].

== General usage ==

=== What is the Calculate section? ===
This section allows you to use the models uploaded on HEPMDB and directly compute results using <tt>HEPMDB</tt> computers. Only once registered will you be able to use <tt>HEPMDB</tt> Calculate section.
More information on how to use this section is provided [[Calculate section|here]].

=== Which programs can I use on <tt>HEPMDB</tt>? ===
Currently, three different programs can be used for computation on <tt>HEPMDB</tt>: <tt>CalcHEP</tt>, <tt>WHIZARD</tt> and <tt>MadGraph</tt>. Any model developed for these programs and uploaded on the <tt>HEPMDB</tt> website will be accessible.

=== Why should I use <tt>HEPMDB</tt>'s Calculate section? ===
There are many practical reasons for using the <tt>HEPMDB</tt> computing mainframe. Convenience may be the most obvious one; no installation is needed and it is simple to compare results between various matrix element generators. Also, <tt>HEPMDB</tt> has some integrated tools for plotting and analysing that are really quick to use.

Another reason is simply the efficiency; with 12 cores, <tt>HEPMDB</tt> is much faster than most local installations.

=== Where can I find some help on how to use the Calculate section? ===
These wiki pages will provide help. [[Calculate section|Here]] you can find a specific help page for the Calculate section, with information on the interface and descriptions of the different available programs: CalcHEP, WIZARD and MadGraph.

== Becoming an author ==

=== Who is an author? ===
If you want to use the HEPMDB computation abilities, you will have to become an author. Authors are also granted the right to upload new models (and encouraged to do so). In the future, they will also be able to add model signatures.

=== How do you upload a model? ===
As soon as your account is approved, you can upload new models. This is done through the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=upload upload model] page.

Further help can found [[Uploading model|here]].

== Using the results ==

=== Why can't I download the results lhe file? ===
It should be noted that it is not possible to download files bigger than 1GB from <tt>HEPMDB</tt>. Unfortunately, file sizes are not indicated yet.
The consequence of this download limit is that you cannot combine too many lhe files into one before uploading.

== Making a model for <tt>HEPMDB</tt> ==
=== How do I use an SLHA input file? ===
If you wrote a model, it may be using an SLHA input file. On <tt>HEPMDB</tt>, there is an option for the user to upload his/her own SLHA file. In order to use that one, you should use the file <tt>../models/SLHA.txt</tt> in your model. Any SLHA file that the user uploads will be renamed and relocated accordingly.

= Presentations on <tt>HEPMDB</tt> =

==== Miniworkshop on High Energy Physics Model Database (HEPMDB)====
March 2 2012, Durham, IPPP [http://indico.cern.ch/conferenceDisplay.py?confId=179627]

==== CalcHEP and HEPMDB: practical introduction and tutorial ====
by Alexander Belyaev, Friday, 4 May 2012, CERN [https://indico.cern.ch/conferenceDisplay.py?confId=189668]

==== HEPMDB: practical introduction and tutorial ====
Alexander Belyaev, 16 August 2013, CERN [http://indico.cern.ch/conferenceDisplay.py?confId=267908]

HEPMDB

2015-07-27T13:35:00Z

Hepmdb: /* CalcHEP */

__NOTOC__
<table width="100%" border="0">
<tr>
<td width="100%" valign="top">
= What is HEPMDB? =

The '''H'''igh '''E'''nergy '''P'''hysics '''M'''odel '''D'''ata'''b'''ase (HEPMDB) was created to facilitate the connection between high energy physics theory and experiment, to store and validate theoretical models, and to develop a dictionary of the model signatures which identifies the fundamental theories responsible for signals expected at the LHC.

HEPMDB is also designed to collect different signatures of its models and their respective experimental efficiencies. Using this information, HEPMDB will be able to compare its Beyond Standard Model (BSM) predictions with LHC data. In doing so, HEPMDB will be able to discriminate the underlying theory.

The database is in the development stage and your input in the 'Forum' section is highly appreciated. The database collects particle physics models. These models are supposed to be public and represent themselves as a set of Feynman Rules which can be expressed in the input form of any matrix element generator such as CalcHEP, CompHEP, FeynArts, Madgraph, SHERPA, WHIZARD.

HEPMDB has an entrance for Model authors -- 'Authors' -- where Authors can test and validate their models. To become an 'Author' you should register in the 'Register' section. 'Authors' are welcome to upload the LanHEP or FeynRules sources of their models.

= Further Information =

Presently, this allows for the collection of high energy physics models, the ability to perform symbolic and numerical calculations of particle scattering processes and the storage of results for the respective model simulations.

===CalcHEP===

For the evaluation of particle physics processes, HEPMDB uses CalcHEP software package and gives users an option to run simulations on a remote HPCx supercomputing cluster. CalcHEP software is designed for automatic calculation of Feynman diagrams for generic models of elementary particle interactions. CalcHEP allows researchers to predict various observables for new models which provides an opportunity to compare model predictions with a large number amount of experimental data from particle accelerators.

The status of CalcHEP for world-leading theoretical and experimental High Energy Physics groups is well established (it has been used and respectively cited in about 300 journal publications since 2004). It has been effectively used by the HEP community. CalcHEP was created in 1999 from the CompHEP package which now counts more than 600 citations since 1999. In terms of the computing side of this software, there are several avenues of improving and exploiting the current capabilities.

In comparison with analogous packages which will be mentioned below, CalcHEP has several features which make it one of the world-leading tools for exploring particle physics. One of these features is a convenient menu-driven Graphical User Interface (GUI) with the detailed context help. This detailed context help is designed so that a user can start using CalcHEP straight after its installation.

Among other important features of CalcHEP is the option to easily implement a new model with an internal editor or external editors/packages. CalcHEP gives the user the option to perform calculations in two different gauges. This provides a powerful cross check of the model implementation and the batch interface. The batch interface allows the user to automate the input of many processes of production and decay, event generation and produce various kinematical distributions. One should also stress an additional feature of the batch interface which is to allow parallel calculations on multiprocessor clusters. This significantly enhances CalcHEP's performance.

===Alternatives===

One should note that there are alternative programs to CalcHEP, which can also be used by HEPMDB.

These include : [http://madgraph.hep.uiuc.edu/index.html MADGRAPH], [http://projects.hepforge.org/whizard/ WHIZARD] and
[http://comphep.sinp.msu.ru/overview CompHEP].

===== [http://hepmdb.soton.ac.uk Back to HEPMDB site] =====

</td>
<td width="550px" align="right" valign=top>
[[File:Tt main.png|500px]]
[http://www.proofreading247.co.uk Proofreading]
</td>
</tr>
</table>

FAQ

2015-07-27T13:24:50Z

Hepmdb: /* Where can I find some help on how to use the Calculate section? */

__TOC__

== About HEPMDB ==

=== What is HEPMDB? ===

HEPMDB is a database that stores high energy physics models, and calculates theoretical cross sections for user defined processes in order to validate theory against experimental data. There are other projects similar to this, however HEPMDB is the only database that allows users to upload models, run processes and calculate cross sections on the site itself.

The model database can be accessed by everyone. However, in order to use HEPMDB's computational capabilities you will have to register first.

=== Current Capabilities ===

* Users can upload model files and model source files (i.e <tt>LanHEP</tt>, <tt>FeynRules</tt>) for various Matrix Element Generators inc. <tt>CalcHEP</tt>, <tt>MADGRAPH</tt>, <tt>WHIZARD</tt> etc.

* HEP simulations can be performed using any of the public models (currently 50+) uploaded to the site by registered users, or by your own privately uploaded model.

* Calculations are performed in the HPCx cluster interface, providing up to 12 cores per user. This allows for faster calculation and larger jobs than on a desktop or laptop.

* Model history is stored so that any modifications to the model itself can be tracked.

* Kinematical distributions of various properties can be plotted and stored in the Les Houches Event (.lhe) file format.

* Can search for and download existing models from HEPMDB.

* Option to leave reviews for other's models to aid development.

=== Future Prospects ===

The database is still in development, here are some of the possible prospects for the future development of HEPMDB.

* Addition of the <tt>LanHEP</tt> and <tt>FeynRules</tt> packages, and the <tt>CompHEP</tt> Matrix Element Generator.

* Allow users to upload their own Feynman rule or Matrix Element Generator packages.

* Compare BSM predictions with LHC data systematically in order to discriminate between the different theories.

* Extend database structure to deal with correlated signatures.

* Make format for model predictions consistent with LHC data format used by experimentalists.

* Install MicrOMEGAs package to evaluate dark matter relic density, and to provide scans of model parameter spaces.

* Possibly study events beyond parton level, up to detector simulation.

== Getting started ==

=== How do I register on HEPMDB? ===
To register, all you need are basic details such as your name, email and affiliation. Your account will be reviewed and approved by one of our administrators. You will be notified by email once your account is approved.
Registration can be done on the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=register HEPMDB main site].
As usual, all fields marked with an asterisk are mandatory. Check for further help [[Registration|here]].

== General usage ==

=== What is the Calculate section? ===
This section allows you to use the models uploaded on HEPMDB and directly compute results using <tt>HEPMDB</tt> computers. Only once registered will you be able to use <tt>HEPMDB</tt> Calculate section.
More information on how to use this section is provided [[Calculate section|here]].

=== Which programs can I use on <tt>HEPMDB</tt>? ===
Currently, three different programs can be used for computation on <tt>HEPMDB</tt>: <tt>CalcHEP</tt>, <tt>WHIZARD</tt> and <tt>MadGraph</tt>. Any model developed for these programs and uploaded on the <tt>HEPMDB</tt> website will be accessible.

=== Why should I use <tt>HEPMDB</tt>'s Calculate section? ===
There are many practical reasons for using the <tt>HEPMDB</tt> computing mainframe. Convenience may be the most obvious one; no installation is needed and it is simple to compare results between various matrix element generators. Also, <tt>HEPMDB</tt> has some integrated tools for plotting and analysing that are really quick to use.

Another reason is simply the efficiency; with 12 cores, <tt>HEPMDB</tt> is much faster than most local installations.

=== Where can I find some help on how to use the Calculate section? ===
These wiki pages will provide help. [[Calculate section|Here]] you can find a specific help page for the Calculate section, with information on the interface and descriptions of the different available programs: CalcHEP, WIZARD and MadGraph.

== Becoming an author ==

=== Who is an author? ===
If you want to use the HEPMDB computation abilities, you will have to become an author. Authors are also granted the right to upload new models (and encouraged to do so). In the future, they will also be able to add model signatures.

=== How do you upload a model? ===
As soon as your account is approved, you can upload new models. This is done through the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=upload upload model] page.

Further help can found [[Uploading model|here]].

== Using the results ==

=== Why can't I download the results lhe file? ===
It should be noted that it is not possible to download files bigger than 1GB from <tt>HEPMDB</tt>. Unfortunately, file sizes are not indicated yet.
The consequence of this download limit is that you cannot combine too many lhe files into one before uploading.

== Making a model for <tt>HEPMDB</tt> ==
=== How do I use an SLHA input file? ===
If you wrote a model, it may be using an SLHA input file. On <tt>HEPMDB</tt>, there is an option for the user to upload his/her own SLHA file. In order to use that one, you should use the file <tt>../models/SLHA.txt</tt> in your model. Any SLHA file that the user uploads will be renamed and relocated accordingly.

= Presentations on <tt>HEPMDB</tt> =

==== Miniworkshop on High Energy Physics Model Database (HEPMDB)====
March 2 2012, Durham, IPPP [http://indico.cern.ch/conferenceDisplay.py?confId=179627]

==== CalcHEP and HEPMDB: practical introduction and tutorial ====
by Alexander Belyaev, Friday, 4 May 2012, CERN [https://indico.cern.ch/conferenceDisplay.py?confId=189668]

==== HEPMDB: practical introduction and tutorial ====
Alexander Belyaev, 16 August 2013, CERN [http://indico.cern.ch/conferenceDisplay.py?confId=267908]

FAQ

2015-07-27T13:22:45Z

Hepmdb: /* What is the Calculate section? */

__TOC__

== About HEPMDB ==

=== What is HEPMDB? ===

HEPMDB is a database that stores high energy physics models, and calculates theoretical cross sections for user defined processes in order to validate theory against experimental data. There are other projects similar to this, however HEPMDB is the only database that allows users to upload models, run processes and calculate cross sections on the site itself.

The model database can be accessed by everyone. However, in order to use HEPMDB's computational capabilities you will have to register first.

=== Current Capabilities ===

* Users can upload model files and model source files (i.e <tt>LanHEP</tt>, <tt>FeynRules</tt>) for various Matrix Element Generators inc. <tt>CalcHEP</tt>, <tt>MADGRAPH</tt>, <tt>WHIZARD</tt> etc.

* HEP simulations can be performed using any of the public models (currently 50+) uploaded to the site by registered users, or by your own privately uploaded model.

* Calculations are performed in the HPCx cluster interface, providing up to 12 cores per user. This allows for faster calculation and larger jobs than on a desktop or laptop.

* Model history is stored so that any modifications to the model itself can be tracked.

* Kinematical distributions of various properties can be plotted and stored in the Les Houches Event (.lhe) file format.

* Can search for and download existing models from HEPMDB.

* Option to leave reviews for other's models to aid development.

=== Future Prospects ===

The database is still in development, here are some of the possible prospects for the future development of HEPMDB.

* Addition of the <tt>LanHEP</tt> and <tt>FeynRules</tt> packages, and the <tt>CompHEP</tt> Matrix Element Generator.

* Allow users to upload their own Feynman rule or Matrix Element Generator packages.

* Compare BSM predictions with LHC data systematically in order to discriminate between the different theories.

* Extend database structure to deal with correlated signatures.

* Make format for model predictions consistent with LHC data format used by experimentalists.

* Install MicrOMEGAs package to evaluate dark matter relic density, and to provide scans of model parameter spaces.

* Possibly study events beyond parton level, up to detector simulation.

== Getting started ==

=== How do I register on HEPMDB? ===
To register, all you need are basic details such as your name, email and affiliation. Your account will be reviewed and approved by one of our administrators. You will be notified by email once your account is approved.
Registration can be done on the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=register HEPMDB main site].
As usual, all fields marked with an asterisk are mandatory. Check for further help [[Registration|here]].

== General usage ==

=== What is the Calculate section? ===
This section allows you to use the models uploaded on HEPMDB and directly compute results using <tt>HEPMDB</tt> computers. Only once registered will you be able to use <tt>HEPMDB</tt> Calculate section.
More information on how to use this section is provided [[Calculate section|here]].

=== Which programs can I use on <tt>HEPMDB</tt>? ===
Currently, three different programs can be used for computation on <tt>HEPMDB</tt>: <tt>CalcHEP</tt>, <tt>WHIZARD</tt> and <tt>MadGraph</tt>. Any model developed for these programs and uploaded on the <tt>HEPMDB</tt> website will be accessible.

=== Why should I use <tt>HEPMDB</tt>'s Calculate section? ===
There are many practical reasons for using the <tt>HEPMDB</tt> computing mainframe. Convenience may be the most obvious one; no installation is needed and it is simple to compare results between various matrix element generators. Also, <tt>HEPMDB</tt> has some integrated tools for plotting and analysing that are really quick to use.

Another reason is simply the efficiency; with 12 cores, <tt>HEPMDB</tt> is much faster than most local installations.

=== Where can I find some help on how to use the Calculate section? ===
These wiki pages will provide help. [[Calculate section|Here]] you can find a specific help page for the Calculate section, with information on the interface and descriptions of the different available programmes: CalcHEP, WIZARD and MadGraph.

== Becoming an author ==

=== Who is an author? ===
If you want to use the HEPMDB computation abilities, you will have to become an author. Authors are also granted the right to upload new models (and encouraged to do so). In the future, they will also be able to add model signatures.

=== How do you upload a model? ===
As soon as your account is approved, you can upload new models. This is done through the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=upload upload model] page.

Further help can found [[Uploading model|here]].

== Using the results ==

=== Why can't I download the results lhe file? ===
It should be noted that it is not possible to download files bigger than 1GB from <tt>HEPMDB</tt>. Unfortunately, file sizes are not indicated yet.
The consequence of this download limit is that you cannot combine too many lhe files into one before uploading.

== Making a model for <tt>HEPMDB</tt> ==
=== How do I use an SLHA input file? ===
If you wrote a model, it may be using an SLHA input file. On <tt>HEPMDB</tt>, there is an option for the user to upload his/her own SLHA file. In order to use that one, you should use the file <tt>../models/SLHA.txt</tt> in your model. Any SLHA file that the user uploads will be renamed and relocated accordingly.

= Presentations on <tt>HEPMDB</tt> =

==== Miniworkshop on High Energy Physics Model Database (HEPMDB)====
March 2 2012, Durham, IPPP [http://indico.cern.ch/conferenceDisplay.py?confId=179627]

==== CalcHEP and HEPMDB: practical introduction and tutorial ====
by Alexander Belyaev, Friday, 4 May 2012, CERN [https://indico.cern.ch/conferenceDisplay.py?confId=189668]

==== HEPMDB: practical introduction and tutorial ====
Alexander Belyaev, 16 August 2013, CERN [http://indico.cern.ch/conferenceDisplay.py?confId=267908]

FAQ

2015-07-27T13:22:17Z

Hepmdb: /* Getting started */

__TOC__

== About HEPMDB ==

=== What is HEPMDB? ===

HEPMDB is a database that stores high energy physics models, and calculates theoretical cross sections for user defined processes in order to validate theory against experimental data. There are other projects similar to this, however HEPMDB is the only database that allows users to upload models, run processes and calculate cross sections on the site itself.

The model database can be accessed by everyone. However, in order to use HEPMDB's computational capabilities you will have to register first.

=== Current Capabilities ===

* Users can upload model files and model source files (i.e <tt>LanHEP</tt>, <tt>FeynRules</tt>) for various Matrix Element Generators inc. <tt>CalcHEP</tt>, <tt>MADGRAPH</tt>, <tt>WHIZARD</tt> etc.

* HEP simulations can be performed using any of the public models (currently 50+) uploaded to the site by registered users, or by your own privately uploaded model.

* Calculations are performed in the HPCx cluster interface, providing up to 12 cores per user. This allows for faster calculation and larger jobs than on a desktop or laptop.

* Model history is stored so that any modifications to the model itself can be tracked.

* Kinematical distributions of various properties can be plotted and stored in the Les Houches Event (.lhe) file format.

* Can search for and download existing models from HEPMDB.

* Option to leave reviews for other's models to aid development.

=== Future Prospects ===

The database is still in development, here are some of the possible prospects for the future development of HEPMDB.

* Addition of the <tt>LanHEP</tt> and <tt>FeynRules</tt> packages, and the <tt>CompHEP</tt> Matrix Element Generator.

* Allow users to upload their own Feynman rule or Matrix Element Generator packages.

* Compare BSM predictions with LHC data systematically in order to discriminate between the different theories.

* Extend database structure to deal with correlated signatures.

* Make format for model predictions consistent with LHC data format used by experimentalists.

* Install MicrOMEGAs package to evaluate dark matter relic density, and to provide scans of model parameter spaces.

* Possibly study events beyond parton level, up to detector simulation.

== Getting started ==

=== How do I register on HEPMDB? ===
To register, all you need are basic details such as your name, email and affiliation. Your account will be reviewed and approved by one of our administrators. You will be notified by email once your account is approved.
Registration can be done on the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=register HEPMDB main site].
As usual, all fields marked with an asterisk are mandatory. Check for further help [[Registration|here]].

== General usage ==

=== What is the Calculate section? ===
This section allows you to use the models uploaded on HEPMDB and directly compute results using <tt>HEPMDB</tt> computers. Only once registered will you be able to use <tt>HEPMDB</tt> Calculate section.
More information on how to use this section is provided [[Calculate section|Here]].

=== Which programs can I use on <tt>HEPMDB</tt>? ===
Currently, three different programs can be used for computation on <tt>HEPMDB</tt>: <tt>CalcHEP</tt>, <tt>WHIZARD</tt> and <tt>MadGraph</tt>. Any model developed for these programs and uploaded on the <tt>HEPMDB</tt> website will be accessible.

=== Why should I use <tt>HEPMDB</tt>'s Calculate section? ===
There are many practical reasons for using the <tt>HEPMDB</tt> computing mainframe. Convenience may be the most obvious one; no installation is needed and it is simple to compare results between various matrix element generators. Also, <tt>HEPMDB</tt> has some integrated tools for plotting and analysing that are really quick to use.

Another reason is simply the efficiency; with 12 cores, <tt>HEPMDB</tt> is much faster than most local installations.

=== Where can I find some help on how to use the Calculate section? ===
These wiki pages will provide help. [[Calculate section|Here]] you can find a specific help page for the Calculate section, with information on the interface and descriptions of the different available programmes: CalcHEP, WIZARD and MadGraph.

== Becoming an author ==

=== Who is an author? ===
If you want to use the HEPMDB computation abilities, you will have to become an author. Authors are also granted the right to upload new models (and encouraged to do so). In the future, they will also be able to add model signatures.

=== How do you upload a model? ===
As soon as your account is approved, you can upload new models. This is done through the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=upload upload model] page.

Further help can found [[Uploading model|here]].

== Using the results ==

=== Why can't I download the results lhe file? ===
It should be noted that it is not possible to download files bigger than 1GB from <tt>HEPMDB</tt>. Unfortunately, file sizes are not indicated yet.
The consequence of this download limit is that you cannot combine too many lhe files into one before uploading.

== Making a model for <tt>HEPMDB</tt> ==
=== How do I use an SLHA input file? ===
If you wrote a model, it may be using an SLHA input file. On <tt>HEPMDB</tt>, there is an option for the user to upload his/her own SLHA file. In order to use that one, you should use the file <tt>../models/SLHA.txt</tt> in your model. Any SLHA file that the user uploads will be renamed and relocated accordingly.

= Presentations on <tt>HEPMDB</tt> =

==== Miniworkshop on High Energy Physics Model Database (HEPMDB)====
March 2 2012, Durham, IPPP [http://indico.cern.ch/conferenceDisplay.py?confId=179627]

==== CalcHEP and HEPMDB: practical introduction and tutorial ====
by Alexander Belyaev, Friday, 4 May 2012, CERN [https://indico.cern.ch/conferenceDisplay.py?confId=189668]

==== HEPMDB: practical introduction and tutorial ====
Alexander Belyaev, 16 August 2013, CERN [http://indico.cern.ch/conferenceDisplay.py?confId=267908]

FAQ

2015-07-27T13:21:42Z

Hepmdb:

__TOC__

== About HEPMDB ==

=== What is HEPMDB? ===

HEPMDB is a database that stores high energy physics models, and calculates theoretical cross sections for user defined processes in order to validate theory against experimental data. There are other projects similar to this, however HEPMDB is the only database that allows users to upload models, run processes and calculate cross sections on the site itself.

The model database can be accessed by everyone. However, in order to use HEPMDB's computational capabilities you will have to register first.

=== Current Capabilities ===

* Users can upload model files and model source files (i.e <tt>LanHEP</tt>, <tt>FeynRules</tt>) for various Matrix Element Generators inc. <tt>CalcHEP</tt>, <tt>MADGRAPH</tt>, <tt>WHIZARD</tt> etc.

* HEP simulations can be performed using any of the public models (currently 50+) uploaded to the site by registered users, or by your own privately uploaded model.

* Calculations are performed in the HPCx cluster interface, providing up to 12 cores per user. This allows for faster calculation and larger jobs than on a desktop or laptop.

* Model history is stored so that any modifications to the model itself can be tracked.

* Kinematical distributions of various properties can be plotted and stored in the Les Houches Event (.lhe) file format.

* Can search for and download existing models from HEPMDB.

* Option to leave reviews for other's models to aid development.

=== Future Prospects ===

The database is still in development, here are some of the possible prospects for the future development of HEPMDB.

* Addition of the <tt>LanHEP</tt> and <tt>FeynRules</tt> packages, and the <tt>CompHEP</tt> Matrix Element Generator.

* Allow users to upload their own Feynman rule or Matrix Element Generator packages.

* Compare BSM predictions with LHC data systematically in order to discriminate between the different theories.

* Extend database structure to deal with correlated signatures.

* Make format for model predictions consistent with LHC data format used by experimentalists.

* Install MicrOMEGAs package to evaluate dark matter relic density, and to provide scans of model parameter spaces.

* Possibly study events beyond parton level, up to detector simulation.

== Getting started ==

=== How do I register on HEPMDB? ===
To register, all you need are basic details such as name, email and affiliation. Your account will be reviewed and approved by one of our administrators. You will be notified by email once your account is approved.
Registration can be done on the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=register HEPMDB main site].
As usual, all fields marked with an asterisk are mandatory. Check for further help [[Registration|here]].

== General usage ==

=== What is the Calculate section? ===
This section allows you to use the models uploaded on HEPMDB and directly compute results using <tt>HEPMDB</tt> computers. Only once registered will you be able to use <tt>HEPMDB</tt> Calculate section.
More information on how to use this section is provided [[Calculate section|Here]].

=== Which programs can I use on <tt>HEPMDB</tt>? ===
Currently, three different programs can be used for computation on <tt>HEPMDB</tt>: <tt>CalcHEP</tt>, <tt>WHIZARD</tt> and <tt>MadGraph</tt>. Any model developed for these programs and uploaded on the <tt>HEPMDB</tt> website will be accessible.

=== Why should I use <tt>HEPMDB</tt>'s Calculate section? ===
There are many practical reasons for using the <tt>HEPMDB</tt> computing mainframe. Convenience may be the most obvious one; no installation is needed and it is simple to compare results between various matrix element generators. Also, <tt>HEPMDB</tt> has some integrated tools for plotting and analysing that are really quick to use.

Another reason is simply the efficiency; with 12 cores, <tt>HEPMDB</tt> is much faster than most local installations.

=== Where can I find some help on how to use the Calculate section? ===
These wiki pages will provide help. [[Calculate section|Here]] you can find a specific help page for the Calculate section, with information on the interface and descriptions of the different available programmes: CalcHEP, WIZARD and MadGraph.

== Becoming an author ==

=== Who is an author? ===
If you want to use the HEPMDB computation abilities, you will have to become an author. Authors are also granted the right to upload new models (and encouraged to do so). In the future, they will also be able to add model signatures.

=== How do you upload a model? ===
As soon as your account is approved, you can upload new models. This is done through the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=upload upload model] page.

Further help can found [[Uploading model|here]].

== Using the results ==

=== Why can't I download the results lhe file? ===
It should be noted that it is not possible to download files bigger than 1GB from <tt>HEPMDB</tt>. Unfortunately, file sizes are not indicated yet.
The consequence of this download limit is that you cannot combine too many lhe files into one before uploading.

== Making a model for <tt>HEPMDB</tt> ==
=== How do I use an SLHA input file? ===
If you wrote a model, it may be using an SLHA input file. On <tt>HEPMDB</tt>, there is an option for the user to upload his/her own SLHA file. In order to use that one, you should use the file <tt>../models/SLHA.txt</tt> in your model. Any SLHA file that the user uploads will be renamed and relocated accordingly.

= Presentations on <tt>HEPMDB</tt> =

==== Miniworkshop on High Energy Physics Model Database (HEPMDB)====
March 2 2012, Durham, IPPP [http://indico.cern.ch/conferenceDisplay.py?confId=179627]

==== CalcHEP and HEPMDB: practical introduction and tutorial ====
by Alexander Belyaev, Friday, 4 May 2012, CERN [https://indico.cern.ch/conferenceDisplay.py?confId=189668]

==== HEPMDB: practical introduction and tutorial ====
Alexander Belyaev, 16 August 2013, CERN [http://indico.cern.ch/conferenceDisplay.py?confId=267908]

FAQ

2015-07-27T13:13:07Z

Hepmdb: /* What is HEPMDB? */

__TOC__

== About HEPMDB ==

=== What is HEPMDB? ===

HEPMDB is a database that stores high energy physics models, and calculates theoretical cross sections for user defined processes in order to validate theory against experimental data. There are other projects similar to this, however HEPMDB is the only database that allows users to upload models, run processes and calculate cross sections on the site itself.

The model database can be accessed by everyone. However, in order to use HEPMDB's computational capabilities you will have to register first.

=== Current Capabilities ===

* Users can upload model file and model source files (i.e <tt>LanHEP</tt>, <tt>FeynRules</tt>) for various Matrix Element Generators inc. <tt>CalcHEP</tt>, <tt>MADGRAPH</tt>, <tt>WHIZARD</tt> etc.

* HEP processes can be performed in user's own submitted models or any of the already published models (many uploaded by other users).

* Calculations are performed in the HPCx cluster interface, providing up to 12 cores per user. This allows for faster calculation and larger jobs than on a desktop or laptop.

* Model history is stored so that any modifications to the model itself can be tracked.

* Kinematical distributions of various properties can be plotted and stored in the Lhe format.

* Can search for and download existing models from HEPMDB.

* Option to leave reviews for other's models to aid development.

=== Future Prospects ===

The database is still in development, here are some of the possible prospects for the future development of HEPMDB.

* Addition of the <tt>LanHEP</tt> and <tt>FeynRules</tt> packages, and the <tt>CompHEP</tt> Matrix Element Generator.

* Allow users to upload their own Feynman rule or Matrix Element Generator packages.

* Compare BSM predictions with LHC data systematically in order to discriminate between the different theories.

* Extend database structure to deal with correlated signatures.

* Make format for model predictions consistent with LHC data format used by experimentalists.

* Install MicrOMEGAs package to evaluate dark matter relic density, and to provide scans of model parameter spaces.

* Possibly study events beyond parton level, up to detector simulation.

== Getting started ==

=== How do I register on HEPMDB? ===
To register, all you need are basic details such as name, email and affiliation. Your account will be reviewed and approved by one of our administrators. You will be notified by email once your account is approved.
Registration can be done on the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=register HEPMDB main site].
As usual, all fields marked with an asterisk are mandatory. Check for further help [[Registration|here]].

== General usage ==

=== What is the Calculate section? ===
This section allows you to use the models uploaded on HEPMDB and directly compute results using <tt>HEPMDB</tt> computers. Only once registered will you be able to use <tt>HEPMDB</tt> Calculate section.
More information on how to use this section is provided [[Calculate section|Here]].

=== Which programs can I use on <tt>HEPMDB</tt>? ===
Currently, three different programs can be used for computation on <tt>HEPMDB</tt>: <tt>CalcHEP</tt>, <tt>WHIZARD</tt> and <tt>MadGraph</tt>. Any model developed for these programs and uploaded on the <tt>HEPMDB</tt> website will be accessible.

=== Why should I use <tt>HEPMDB</tt>'s Calculate section? ===
There are many practical reasons for using the <tt>HEPMDB</tt> computing mainframe. Convenience may be the most obvious one; no installation is needed and it is simple to compare results between various matrix element generators. Also, <tt>HEPMDB</tt> has some integrated tools for plotting and analysing that are really quick to use.

Another reason is simply the efficiency; with 12 cores, <tt>HEPMDB</tt> is much faster than most local installations.

=== Where can I find some help on how to use the Calculate section? ===
These wiki pages will provide help. [[Calculate section|Here]] you can find a specific help page for the Calculate section, with information on the interface and descriptions of the different available programmes: CalcHEP, WIZARD and MadGraph.

== Becoming an author ==

=== Who is an author? ===
If you want to use the HEPMDB computation abilities, you will have to become an author. Authors are also granted the right to upload new models (and encouraged to do so). In the future, they will also be able to add model signatures.

=== How do you upload a model? ===
As soon as your account is approved, you can upload new models. This is done through the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=upload upload model] page.

Further help can found [[Uploading model|here]].

== Using the results ==

=== Why can't I download the results lhe file? ===
It should be noted that it is not possible to download files bigger than 1GB from <tt>HEPMDB</tt>. Unfortunately, file sizes are not indicated yet.
The consequence of this download limit is that you cannot combine too many lhe files into one before uploading.

== Making a model for <tt>HEPMDB</tt> ==
=== How do I use an SLHA input file? ===
If you wrote a model, it may be using an SLHA input file. On <tt>HEPMDB</tt>, there is an option for the user to upload his/her own SLHA file. In order to use that one, you should use the file <tt>../models/SLHA.txt</tt> in your model. Any SLHA file that the user uploads will be renamed and relocated accordingly.

= Presentations on <tt>HEPMDB</tt> =

==== Miniworkshop on High Energy Physics Model Database (HEPMDB)====
March 2 2012, Durham, IPPP [http://indico.cern.ch/conferenceDisplay.py?confId=179627]

==== CalcHEP and HEPMDB: practical introduction and tutorial ====
by Alexander Belyaev, Friday, 4 May 2012, CERN [https://indico.cern.ch/conferenceDisplay.py?confId=189668]

==== HEPMDB: practical introduction and tutorial ====
Alexander Belyaev, 16 August 2013, CERN [http://indico.cern.ch/conferenceDisplay.py?confId=267908]

Staff of HEPMDB

2015-07-27T13:10:23Z

Hepmdb:

If you would like an information regarding HEPMDB or for any general enquiries please email '''hepmdb@googlegroups.com'''.

* '''Alexander Belyaev''' (University of Southampton)

* '''[[Maksym_Bondarenko|Maksym Bondarenko]]''' (University of Southampton)

* '''James Blandford''' (University of Southampton)

----

'''Southampton High Energy Physics''' (SHEP) group has a long term program to play a significant role in uncovering the next level of fundamental physics beyond the standard model (BSM).

SHEP activity covers the following strongly related areas of High Energy Physics:
* Collider phenomenology within and beyond the standard model
* Model building
* Lattice QCD
* Strongly coupled gauge theories
* Gravitation.

The group has 11 permanent academic members. It also includes about 30 postdocs and PhD students who are involved in the group research activity. In the last 3 years SHEP has published about 200 papers in the leading physics journals with the top impact parameter such as: Physical Review Letters, Physics Letters B, Physics Review D, European Physical Journal.

Our group played a leading role in the creation of the NExT Institute which now joins researchers from '''Southampton''', '''Rutherford Appleton Laboratory''', '''University of Royal Holloway''' and '''University of Sussex'''. NExT was established to promote a new kind of interaction within particle physics, by formally creating and supporting one-on-one relationships between each theorist and an individual experiment.
This novel approach is designed to help put the UK in a unique position to extract and interpret results from the LHC and in defining research programs in other areas such as neutrinos and dark matter.

It is worth stressing both the impressive scale of NExT activities as a whole (a total funding of about £3.5M since 2006 from as many as 20 institutions/agencies) and SHEP's leading role within it.
Prof Moretti is the Director and 4 of the 7 permanent NExT fellows/lecturers are based in Southampton (E. Accomando, A.Belyaev, P. Di Bari, R. Zwicky).

Staff of HEPMDB

2015-07-27T13:08:21Z

Hepmdb:

If you would like an information regarding HEPMDB or for any general enquiries please email '''hepmdb@googlegroups.com'''.

* '''Alexander Belyaev''' (University of Southampton)

* '''[[Maksym_Bondarenko|Maksym Bondarenko]]''' (University of Southampton)

* '''James Blandford''' (University of Southampton)

----

'''Southampton High Energy Physics''' (SHEP) group has a long term program to play a significant role in uncovering the next level of fundamental physics beyond the standard model (BSM).

SHEP activity covers the following strongly related areas of High Energy Physics:
* Collider phenomenology within and beyond the standard model
* Model building
* Lattice QCD
* Strongly coupled gauge theories
* Gravitation.

The group has 11 permanent academic members. It also includes about 30 postdocs and PhD students who are involved in the group research activity. In the last 3 years SHEP has published about 200 papers in the leading physics journals with the top impact parameter such as: Physical Review Letters, Physics Letters B, Physics Review D, European Physical Journal.

Our group played a leading role in creating of the NExT Institute which now joins researchers from '''Southampton''', '''Rutherford Appleton Laboratory''', '''University of Royal Holloway''' and '''University of Sussex'''. NExT was established to promote a new kind of interaction within particle physics, by formally creating and supporting one-on-one relationships between each theorist and an individual experiment.
This novel approach is designed to help put the UK in a unique position to extract and interpret results from the LHC and in defining research programs in other areas such as neutrinos and dark matter.

It is worth stressing both the impressive scale of NExT activities as a whole (a total funding of about £3.5M since 2006 from as many as 20 institutions/agencies) and SHEP's leading role within it.
Prof Moretti is the Director and 4 of the 7 permanent NExT fellows/lecturers are based in Southampton (E. Accomando, A.Belyaev, P. Di Bari, R. Zwicky).

Registration

2015-07-27T13:07:20Z

Hepmdb: /* Email */

Many tasks on <tt>HEPMDB</tt> require you to be registered. Registration can be done at the following address:
http://hepmdb.soton.ac.uk/index.php?mod=user&act=register

On this page, you will find a description of the various fields required for registration.

__TOC__

== Generalities ==
As for any registration form, you will have to provide your details for a certain number of fields. Each field marked with an asterix is mandatory. Once the form is completed, you will receive an email confirming that your registration request has been received. Registration must be accepted by the <tt>HEPMDB</tt> admin team before you can begin to use the database, it should be accepted by our team quite quickly. You will receive a second email when you are allowed to use <tt>HEPMDB</tt> at full capacity.

== Fields ==
=== First and last names ===
These two fields are mandatory. They will be used when sending emails to you (confirming that a HEPMDB job is done) and appear when you upload a model.

=== Email ===
Giving your email is mandatory. Providing this information is a simple way to check that this is a real registration. Your email is also required when using the computational capacities of <tt>HEPMDB</tt> as it will be used to alert you when a job has been completed.

=== Address, country and website ===
These fields are optional.

=== Password ===
This is self-explanatory. Enter your password twice in order to avoid a typing error.

=== Affiliation ===
For our statistics, we require this field to be filled in. Typical affiliations include your university and the name of your laboratory.

=== CAPTCHA ===
Please tick the box to prove you are a human. This helps us prevent bots from registering for an account.

Registration

2015-07-27T13:06:37Z

Hepmdb:

Many tasks on <tt>HEPMDB</tt> require you to be registered. Registration can be done at the following address:
http://hepmdb.soton.ac.uk/index.php?mod=user&act=register

On this page, you will find a description of the various fields required for registration.

__TOC__

== Generalities ==
As for any registration form, you will have to provide your details for a certain number of fields. Each field marked with an asterix is mandatory. Once the form is completed, you will receive an email confirming that your registration request has been received. Registration must be accepted by the <tt>HEPMDB</tt> admin team before you can begin to use the database, it should be accepted by our team quite quickly. You will receive a second email when you are allowed to use <tt>HEPMDB</tt> at full capacity.

== Fields ==
=== First and last names ===
These two fields are mandatory. They will be used when sending emails to you (confirming that a HEPMDB job is done) and appear when you upload a model.

=== Email ===
Giving your email is mandatory. Providing this information is a simple way to check that this is a real registration. Your email is also required When using the computational capacities of <tt>HEPMDB</tt> as it will be used to alert you when a job has been completed.

=== Address, country and website ===
These fields are optional.

=== Password ===
This is self-explanatory. Enter your password twice in order to avoid a typing error.

=== Affiliation ===
For our statistics, we require this field to be filled in. Typical affiliations include your university and the name of your laboratory.

=== CAPTCHA ===
Please tick the box to prove you are a human. This helps us prevent bots from registering for an account.

CalcHEP tutorial

2015-07-27T13:01:46Z

Hepmdb: /* Involving partons */

In order to familiarise yourself with <tt>CalcHEP</tt>, we will study two examples, one sightly more complicated than the other. Hopefully, by the end of this tutorial, you will be able to use the majority of the functions of <tt>CalcHEP</tt>.

Please note that this is not a reference manual. If you wish to look at the reference manual, it is available [[CalcHEP reference|here]].

__TOC__

== A simple leptonic process ==
Let's start with a simple process and try to compute the matrix elements using <tt>CalcHEP</tt>. In this section, we will study:
<center><tt>ee → μμττ</tt></center>

The process will be studied in the standard model framework.

=== Preparing <tt>HEPMDB</tt> ===
First, connect to <tt>HEPMDB</tt> and go to the <tt>Calculate</tt> section. In the left panel, under <tt>CalcHEP</tt>, check whether the <tt>Standard Model (CKM=1)</tt> line appears. If not, in the <tt>File</tt> menu, choose <tt>Import a model</tt>. When you find the line <tt>Standard Model (CKM=1)</tt> for <tt>CalcHEP</tt> (it should be model 43), select it and click <tt>Select</tt>. The model should now be accessible in your environment.

This model is the complete standard model without the CKM matrix. As a consequence, it is lighter and in situations where quark flavours don't matter, it gives the same results as the standard model.

=== A template batch file ===
Select the model and select <tt>Edit Batch File</tt> in the <tt>Selection</tt> menu. A new window will appear. You will be able to edit the batch file which is the file describing the process of interest. Click on the button <tt>Import Full Template</tt>.

You now have a template file with nearly every possible field already offered. You also have help in the comments. The comments are lines beginning with a #. They are ignored by <tt>CalcHEP</tt> and thanks to them, you can add any information you want for anybody reading the batch file.

=== Model information ===
The first three fields are information about the model.
# The first line states the model to be used. You should not touch it as this specifies the model in the <tt>CalcHEP</tt> local batch mode. There is no default for this setting so this line must be included. The model name should be exactly as it appears in the model selection menu.
# The second option is <tt>Model changed</tt>. This tells <tt>CalcHEP</tt> that model files have been changed.
# Finally, <tt>Gauge</tt> specifies which gauge is used, Feynman or unitary. Many models are built implicitly assuming that the gauge is Feynman's, so you should not change this field either.

=== Defining the process ===
We have several lines to define our process. Remove every <tt>Process</tt>, <tt>Decay</tt> and <tt>Composite</tt> field. You can now write:
<center><tt>Process: e,E -> m,M,l,L</tt></center>

In the standard model of <tt>CalcHEP</tt>, <tt>e</tt> refers to electrons, <tt>m</tt> to muons, <tt>l</tt> to taus and the capital letters to their anti-particle. The list of particle names and symbols to use can be viewed by selecting <tt>View Particles</tt> in the <tt>Selection</tt> drop-down menu. You cannot access it while editing the batch file however.

So we have set up an electron-positron scattering with a pair of muons and a pair of taus outgoing.
No further information is needed to describe the process itself.

=== Beams configuration ===
We now have to configure the beams. The next field is about the pdfs. While this is useful for protons or any composite particle scattering, we do not need it for electron-positron scattering. We can write:
<center><tt>pdf1: OFF</tt></center>
And the same thing for the second pdf.

Concerning the energy of the beam, let's set 100 GeV beams.
<center><tt>p1: 100</tt></center>
<center><tt>p2: 100</tt></center>

=== Changing model parameters ===
We now have the possibility to change some model parameters. Let's say you want to change the strength of the electromagnetic force. You would write:
<center><tt>Parameter: EE=0.31</tt></center>
with <tt>0.31</tt> being the new value of the electrical charge of the electron in natural units.
Some models are more flexible than others on that kind of point. But for our tutorial, we are not going to change the well known parameters.

Instead, we're going to scan the possible Higgs masses. For this, you can write:
<center><tt>Run parameter: Mh</tt></center>
<center><tt>Run begin: 100</tt></center>
<center><tt>Run step size: 10</tt></center>
<center><tt>Run n steps: 6</tt></center>
This means we're going to scan the following values for <tt>Mh</tt>: 100 Gev, 110 GeV, 120 GeV, 130 GeV, 140 GeV, 150 GeV.
This is of course a pretty useful possibility when studying a new model.

We then have the possibility to set some parameters about QCD but this will be studied in the next example.

=== Cuts ===
Various cuts are possible. For our simple tutorial, we are not going to study them. Please refer to the reference manual if you are interested in them.

=== Kinematics and regularization ===
To tell <tt>CalcHEP</tt> how to handle the phase space, you should fill the kinematic information.
Using this information, a nice parameterisation of the phase space is used.

In our case, the two incoming particles will give two bosons, each of them decaying into a lepton pair. Hence, our kinematics are written as:
<center><tt>Kinematics : 12 -> 34, 56</tt></center>
<center><tt>Kinematics : 34 -> 3 , 4</tt></center>
<center><tt>Kinematics : 56 -> 5 , 6</tt></center>

where the numbers refer to the particle in the process, in this case, 1 and 2 are the electron and positron, 3 and 4 are the muons etc.

To improve the precision of the computation, it is important to tell <tt>CalcHEP</tt> where the resonances are.
In our case, we have a resonance on the dimuon and ditau masses for the Z boson and for the Higgs.
So we will write:
<center><tt>Regularization momentum: 34</tt></center>
<center><tt>Regularization mass: MZ</tt></center>
<center><tt>Regularization width: wZ</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 34</tt></center>
<center><tt>Regularization mass: Mh</tt></center>
<center><tt>Regularization width: wh</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 56</tt></center>
<center><tt>Regularization mass: MZ</tt></center>
<center><tt>Regularization width: wZ</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 56</tt></center>
<center><tt>Regularization mass: Mh</tt></center>
<center><tt>Regularization width: wh</tt></center>
<center><tt>Regularization power: 2</tt></center>

=== Event generation ===
For event generation, we really have two main parameters:
#The number of events. We'll write: <tt>Number of events (per run step): 100000</tt>
#The output file name. <tt>Filename: tutorial_ee_mmll</tt>

=== Parallelization ===
When using the template file of <tt>HEPMDB</tt>, all parallelization parameters are good.

In order for the processes to run quickly and efficiently, it is recommended to set:
<center><tt>Max number of cpus: 24</tt></center>

This runs two processes on each of the 12 cores. Setting a higher number of cpus will overload the cluster, and the job will be killed.

For very large jobs, set:
<center><tt>Max number of cpus: 12</tt></center>

=== Vegas session ===
Finally, the Vegas session has some parameters. It will be used to compute the cross-section and to prepare the grid for event generation. Two sessions with 5 calls of 100,000 points is usually sufficient. With the number of calls there is a trade-off; the higher the number of calls means it will take longer to run the batch file on HEPMDB but reducing the number of calls leads to a decrease in accuracy of the cross sections. It is therefore worth experimenting with a couple of points in the batch interface of CalcHEP to see what optimization can be made.
<center><tt>nSess_1: 5</tt></center>
<center><tt>nCalls_1: 100000</tt></center>
<center><tt>nSess_2: 5</tt></center>
<center><tt>nCalls_2: 100000</tt></center>

=== Final words ===
The batch file is now complete and ready to run. Click <tt>Save Changes</tt> and return to the <tt>Selection</tt> drop-down menu, where you should select <tt>Run Batch File</tt>.

You can check the progress of your batch file by selecting <tt>Check Job Progress</tt> from the <tt>File</tt> drop-down menu, and a progress report will appear in the box at the bottom of the window. You can either click <tt>Cancel job</tt> to end the current job, or you can click <tt>Show Start</tt> to receive information on the estimated start time for the job (the time till it will reach the top of the queue and start running) and estimated finish time.

== Involving partons ==

For a more complex interaction involving partons, we study the collision of protons to create a specified final state. To make this easier to understand, we will look at the example given in the template batch file, and explain each section and its relevance. Hence we study:

<center><tt>p,p → W,b,B</tt></center>

This investigates the interaction of two protons on the parton level to create a W boson (without specifying positive or negative charge), a bottom quark and its anti-quark. Again this process is in the Standard Model framework.

=== Model Information ===

The batch file should be loaded according to the instructions in the previous example. Again the gauge should be set to <tt>Feynman</tt>, and <tt>Model Changed</tt> set to <tt>False</tt>. This tells the batch file that the model files have not been altered.

=== Defining the process ===

For this process, all of the definitions available in this section of the batch file need to be included. First, specify the main process.

<center><tt>Process: p,p → W,b,B </tt></center>

As the W boson is a gauge boson, we need to include a decay mode of this particle. We will look at its decay to an unspecified charged lepton and its corresponding neutrino. To do this, new variable names need to be input, we will use <tt>le</tt> for any charged lepton, and <tt>n</tt> for any neutrino. The decay is written as follows:

<center><tt>Decay: W → le,n</tt></center>

Almost all of the particles we have introduced are composites, i.e they represent several particles that can be involved in this particular type of interaction. When the batch file is run it calculates all possible processes for every combination of these particles, so it is important to include all composites. We write:

<center><tt>Composite: p=u,U,d,D,s,S,c,C,b,B,G</tt></center>
<center><tt>Composite: W=W+,W-</tt></center>
<center><tt>Composite: le=e,E,m,M</tt></center>
<center><tt>Composite: n=ne,Ne,nm,Nm</tt></center>

There is also the possibility that there will be a quark/gluon jet in the final state, so this must also be added to the <tt>Composite</tt> decriptions:

<center><tt>Composite: jet=u,U,d,D,s,S,c,C,b,B,G</tt></center>

These are all of the necessary descriptions of the process itself.

=== Beam Configuration and PDFs ===

As this process involves partons inside the colliding protons, a Parton Density Function must be specified for each proton. This affects the cross section results, and is necessary to include for all parton-level processes. There are several choices for the PDFs, we will use:

<center><tt>pdf1: cteq61 (proton) </tt></center>
<center><tt>pdf2: cteq61 (proton) </tt></center>

The remaining lines of this section are commented out because they are not necessary for this computation, so it is best to ignore them.

In <tt>Momentum Info</tt> for this process we will set the energy of the beams to match that of the most recent LHC energy, so each beam is set to 6500GeV.

<center><tt>p1: 6500</tt></center>
<center><tt>p2: 6500</tt></center>

=== Model Parameters ===

Next we can change the model parameters, but for this example we will keep them as the default model values.

We will again scan over the Higgs masses, as in the previous example. The batch template gives the following values, but you are free to alter these to suit your needs.

<center><tt>Run parameter: Mh</tt></center>
<center><tt>Run begin: 120</tt></center>
<center><tt>Run step size: 5</tt></center>
<center><tt>Run n steps: 3</tt></center>

The QCD running info gives the strong coupling at the energy scale of the interaction, which we must define in terms of the bottom and anti-bottom quarks. This is done by writing:

<center><tt>alpha Q : M45</tt></center>

This again means that it is in terms of the 4th and 5th particles of the interactions, in this case b,B, as required. All other parts of this section can remain commented out.

=== Cut Information ===

There are several cuts that should be applied to this process. This is to avoid including divergences in the cross section calculations. The cuts only apply to the production processes, and not to the products of the decay. The template batch file has provided the cuts necessary for this process, but we should understand what they mean. The first is:

<center><tt>Cut parameter: M(b,B)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 100</tt></center>
<center><tt>Cut max: </tt></center>

This means that there is a cut applied to the invariant mass of the bottom and anti-bottom quarks, where the minimum is taken at <tt>M(b,B)=100GeV</tt>. This is to avoid the low energy divergence that occurs below this invariant mass value. The next is:

<center><tt>Cut parameter: J(jet,jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 0.5</tt></center>
<center><tt>Cut max: </tt></center>

This enforces a cut on the jet cone angle, or the minimum angle of a resulting jet in the production. Then we have:

<center><tt>Cut parameter: T(jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 20</tt></center>
<center><tt>Cut max: </tt></center>

This defines the cut on the transverse momentum of the production jet to be greater than 20GeV.

<center><tt>Cut parameter: N(jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: -2.5</tt></center>
<center><tt>Cut max: 2.5</tt></center>

The final cut is to the pseudorapidity of the jet, this informs the range of the angle between the direction of emission of the jet and the x-y plane.

Each of these parameters are applied to the entire process by use of the colon. To specify a process for the cut : should be changed to :n:, where n is the process number at which to apply the cut. In this case it is fine to have all cuts apply to all processes.

=== Kinematics and Regularization ===

As before, the kinematical information is required in order to tell <tt>CalcHEP</tt> how to handle the phase space. Again, these can be commented out so that the default settings are used, however the kinematics required are:

<center><tt>Kinematics : 12 -> 3, 45</tt></center>
<center><tt>Kinematics : 45 -> 4 , 5</tt></center>

The first line represents the overall process of particles 1 and 2 combining to form particles 3, 4 and 5, where 4 and 5 are a combination of the bottom and anti-bottom quarks. The second line tells <tt>CalcHEP</tt> that these quarks then separate into the individual particles.

The regularization information must be in terms of the final state particles, in this case we want the momentum in terms of the quarks (particles 4 and 5) and the mass and width in terms of the Higgs properties. We also want this to apply only to the production process, and not the decay, using <tt>:1:</tt>. We specify the regularization as:

<center><tt>Regularization momentum:1: 45</tt></center>
<center><tt>Regularization mass:1: Mh</tt></center>
<center><tt>Regularization width:1: wh</tt></center>
<center><tt>Regularization power:1: 2</tt></center>

The regularization power should always be kept as squared.

=== Remaining Information ===

The rest of the batch file is explained in the previous example, and we use the same settings as before for <tt>Events Generation</tt>, <tt>Parallelization</tt>, <tt>Vegas</tt> and <tt>Event Generator</tt>.

=== Run the File ===

The batch file is now ready to run, set it running as instructed in the previous example. To check the progress of the job and whether it has finished, select the <tt>Check Job Progress</tt> option.

CalcHEP tutorial

2015-07-27T12:52:26Z

Hepmdb: /* A simple leptonic process */

In order to familiarise yourself with <tt>CalcHEP</tt>, we will study two examples, one sightly more complicated than the other. Hopefully, by the end of this tutorial, you will be able to use the majority of the functions of <tt>CalcHEP</tt>.

Please note that this is not a reference manual. If you wish to look at the reference manual, it is available [[CalcHEP reference|here]].

__TOC__

== A simple leptonic process ==
Let's start with a simple process and try to compute the matrix elements using <tt>CalcHEP</tt>. In this section, we will study:
<center><tt>ee → μμττ</tt></center>

The process will be studied in the standard model framework.

=== Preparing <tt>HEPMDB</tt> ===
First, connect to <tt>HEPMDB</tt> and go to the <tt>Calculate</tt> section. In the left panel, under <tt>CalcHEP</tt>, check whether the <tt>Standard Model (CKM=1)</tt> line appears. If not, in the <tt>File</tt> menu, choose <tt>Import a model</tt>. When you find the line <tt>Standard Model (CKM=1)</tt> for <tt>CalcHEP</tt> (it should be model 43), select it and click <tt>Select</tt>. The model should now be accessible in your environment.

This model is the complete standard model without the CKM matrix. As a consequence, it is lighter and in situations where quark flavours don't matter, it gives the same results as the standard model.

=== A template batch file ===
Select the model and select <tt>Edit Batch File</tt> in the <tt>Selection</tt> menu. A new window will appear. You will be able to edit the batch file which is the file describing the process of interest. Click on the button <tt>Import Full Template</tt>.

You now have a template file with nearly every possible field already offered. You also have help in the comments. The comments are lines beginning with a #. They are ignored by <tt>CalcHEP</tt> and thanks to them, you can add any information you want for anybody reading the batch file.

=== Model information ===
The first three fields are information about the model.
# The first line states the model to be used. You should not touch it as this specifies the model in the <tt>CalcHEP</tt> local batch mode. There is no default for this setting so this line must be included. The model name should be exactly as it appears in the model selection menu.
# The second option is <tt>Model changed</tt>. This tells <tt>CalcHEP</tt> that model files have been changed.
# Finally, <tt>Gauge</tt> specifies which gauge is used, Feynman or unitary. Many models are built implicitly assuming that the gauge is Feynman's, so you should not change this field either.

=== Defining the process ===
We have several lines to define our process. Remove every <tt>Process</tt>, <tt>Decay</tt> and <tt>Composite</tt> field. You can now write:
<center><tt>Process: e,E -> m,M,l,L</tt></center>

In the standard model of <tt>CalcHEP</tt>, <tt>e</tt> refers to electrons, <tt>m</tt> to muons, <tt>l</tt> to taus and the capital letters to their anti-particle. The list of particle names and symbols to use can be viewed by selecting <tt>View Particles</tt> in the <tt>Selection</tt> drop-down menu. You cannot access it while editing the batch file however.

So we have set up an electron-positron scattering with a pair of muons and a pair of taus outgoing.
No further information is needed to describe the process itself.

=== Beams configuration ===
We now have to configure the beams. The next field is about the pdfs. While this is useful for protons or any composite particle scattering, we do not need it for electron-positron scattering. We can write:
<center><tt>pdf1: OFF</tt></center>
And the same thing for the second pdf.

Concerning the energy of the beam, let's set 100 GeV beams.
<center><tt>p1: 100</tt></center>
<center><tt>p2: 100</tt></center>

=== Changing model parameters ===
We now have the possibility to change some model parameters. Let's say you want to change the strength of the electromagnetic force. You would write:
<center><tt>Parameter: EE=0.31</tt></center>
with <tt>0.31</tt> being the new value of the electrical charge of the electron in natural units.
Some models are more flexible than others on that kind of point. But for our tutorial, we are not going to change the well known parameters.

Instead, we're going to scan the possible Higgs masses. For this, you can write:
<center><tt>Run parameter: Mh</tt></center>
<center><tt>Run begin: 100</tt></center>
<center><tt>Run step size: 10</tt></center>
<center><tt>Run n steps: 6</tt></center>
This means we're going to scan the following values for <tt>Mh</tt>: 100 Gev, 110 GeV, 120 GeV, 130 GeV, 140 GeV, 150 GeV.
This is of course a pretty useful possibility when studying a new model.

We then have the possibility to set some parameters about QCD but this will be studied in the next example.

=== Cuts ===
Various cuts are possible. For our simple tutorial, we are not going to study them. Please refer to the reference manual if you are interested in them.

=== Kinematics and regularization ===
To tell <tt>CalcHEP</tt> how to handle the phase space, you should fill the kinematic information.
Using this information, a nice parameterisation of the phase space is used.

In our case, the two incoming particles will give two bosons, each of them decaying into a lepton pair. Hence, our kinematics are written as:
<center><tt>Kinematics : 12 -> 34, 56</tt></center>
<center><tt>Kinematics : 34 -> 3 , 4</tt></center>
<center><tt>Kinematics : 56 -> 5 , 6</tt></center>

where the numbers refer to the particle in the process, in this case, 1 and 2 are the electron and positron, 3 and 4 are the muons etc.

To improve the precision of the computation, it is important to tell <tt>CalcHEP</tt> where the resonances are.
In our case, we have a resonance on the dimuon and ditau masses for the Z boson and for the Higgs.
So we will write:
<center><tt>Regularization momentum: 34</tt></center>
<center><tt>Regularization mass: MZ</tt></center>
<center><tt>Regularization width: wZ</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 34</tt></center>
<center><tt>Regularization mass: Mh</tt></center>
<center><tt>Regularization width: wh</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 56</tt></center>
<center><tt>Regularization mass: MZ</tt></center>
<center><tt>Regularization width: wZ</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 56</tt></center>
<center><tt>Regularization mass: Mh</tt></center>
<center><tt>Regularization width: wh</tt></center>
<center><tt>Regularization power: 2</tt></center>

=== Event generation ===
For event generation, we really have two main parameters:
#The number of events. We'll write: <tt>Number of events (per run step): 100000</tt>
#The output file name. <tt>Filename: tutorial_ee_mmll</tt>

=== Parallelization ===
When using the template file of <tt>HEPMDB</tt>, all parallelization parameters are good.

In order for the processes to run quickly and efficiently, it is recommended to set:
<center><tt>Max number of cpus: 24</tt></center>

This runs two processes on each of the 12 cores. Setting a higher number of cpus will overload the cluster, and the job will be killed.

For very large jobs, set:
<center><tt>Max number of cpus: 12</tt></center>

=== Vegas session ===
Finally, the Vegas session has some parameters. It will be used to compute the cross-section and to prepare the grid for event generation. Two sessions with 5 calls of 100,000 points is usually sufficient. With the number of calls there is a trade-off; the higher the number of calls means it will take longer to run the batch file on HEPMDB but reducing the number of calls leads to a decrease in accuracy of the cross sections. It is therefore worth experimenting with a couple of points in the batch interface of CalcHEP to see what optimization can be made.
<center><tt>nSess_1: 5</tt></center>
<center><tt>nCalls_1: 100000</tt></center>
<center><tt>nSess_2: 5</tt></center>
<center><tt>nCalls_2: 100000</tt></center>

=== Final words ===
The batch file is now complete and ready to run. Click <tt>Save Changes</tt> and return to the <tt>Selection</tt> drop-down menu, where you should select <tt>Run Batch File</tt>.

You can check the progress of your batch file by selecting <tt>Check Job Progress</tt> from the <tt>File</tt> drop-down menu, and a progress report will appear in the box at the bottom of the window. You can either click <tt>Cancel job</tt> to end the current job, or you can click <tt>Show Start</tt> to receive information on the estimated start time for the job (the time till it will reach the top of the queue and start running) and estimated finish time.

== Involving partons ==

For a more complex interaction involving partons, we study the collision of protons to create a specified final state. To make this easier to understand, we will look at the example given in the template batch file, and explain each section and its relevance. Hence we study:

<center><tt>p,p → W,b,B</tt></center>

This investigates the interaction of two protons on the parton level to create a W boson (without specifying positive or negative charge), a bottom quark and its anti-quark. Again this process is in the Standard Model framework.

=== Model Information ===

The batch file should be loaded according to the instructions in the previous example. Again the gauge should be set to <tt>Feynman</tt>, and <tt>Model Changed</tt> set to <tt>False</tt>. This tells the batch file that the model files have not been altered.

=== Defining the process ===

For this process, all of the definitions available in this section of the batch file need to be included. First, specify the main process.

<center><tt>Process: p,p → W,b,B </tt></center>

As the W boson is a gauge boson, we need to include a decay mode of this particle. We will look at its decay to an unspecified charged lepton and its corresponding neutrino. To do this, new variable names need to be input, we will us <tt>le</tt> for any charged lepton, and <tt>n</tt> for any neutrino. The decay is written as follows:

<center><tt>Decay: W → le,n</tt></center>

Almost all of the particles we have introduced are composites, i.e they represent several particles that can be involved in this particular type of interaction. When the batch file is run it calculates all possible processes for every combination of these particles, so it is important to include all composites. We write:

<center><tt>Composite: p=u,U,d,D,s,S,c,C,b,B,G</tt></center>
<center><tt>Composite: W=W+,W-</tt></center>
<center><tt>Composite: le=e,E,m,M</tt></center>
<center><tt>Composite: n=ne,Ne,nm,Nm</tt></center>

There is also the possibility that there will be a quark/gluon jet in the final state, so this must also be added to the <tt>Composite</tt> decriptions:

<center><tt>Composite: jet=u,U,d,D,s,S,c,C,b,B,G</tt></center>

These are all of the necessary descriptions of the process itself.

=== Beam Configuration and PDFs ===

As this process involves partons inside the colliding protons, a Parton Density Function must be specified for each proton. This affects the cross section results, and is necessary to include for all parton-level processes. There are several choices for the PDFs, we will use:

<center><tt>pdf1: cteq61 (proton) </tt></center>
<center><tt>pdf2: cteq61 (proton) </tt></center>

The remaining lines of this section are commented out because they are not necessary for this computation, so it is best to ignore them.

In <tt>Momentum Info</tt> for this process we will set the energy of the beams to match that of the most recent LHC energy, so each beam is set to 4000GeV.

<center><tt>p1: 4000</tt></center>
<center><tt>p2: 4000</tt></center>

=== Model Parameters ===

Next we can change the model parameters, but for this example we will keep them as in the default model files.

We will again scan over the Higgs masses, as in the previous example. The batch template gives the following values, but you are free to alter these to suit your needs.

<center><tt>Run parameter: Mh</tt></center>
<center><tt>Run begin: 120</tt></center>
<center><tt>Run step size: 5</tt></center>
<center><tt>Run n steps: 3</tt></center>

The QCD running info gives the strong coupling at the energy scale of the interaction, which we must define in terms of the bottom and anti-bottom quarks. This is done by writing:

<center><tt>alpha Q : M45</tt></center>

This again means that it is in terms of the 4th and 5th particles of the interactions, in this case b,B, as required. All other parts of this section can remain commented out.

=== Cut Information ===

There are several cuts that should be applied to this process. This is to avoid including divergences in the cross section calculations. The cuts only apply to the production processes, and not to the products of the decay. The template batch file has provided the cuts necessary for this process, but we should understand what they mean. The first is:

<center><tt>Cut parameter: M(b,B)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 100</tt></center>
<center><tt>Cut max: </tt></center>

This means that there is a cut applied to the invariant mass of the bottom and anti-bottom quarks, where the minimum is taken at <tt>M(b,B)=100GeV</tt>. This is to avoid the low energy divergence that occurs below this invariant mass value. The next is:

<center><tt>Cut parameter: J(jet,jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 0.5</tt></center>
<center><tt>Cut max: </tt></center>

This enforces a cut on the jet cone angle, or the minimum angle of a resulting jet in the production. Then we have:

<center><tt>Cut parameter: T(jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 20</tt></center>
<center><tt>Cut max: </tt></center>

This defines the cut on the transverse momentum of the production jet to be greater than 20GeV.

<center><tt>Cut parameter: N(jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: -2.5</tt></center>
<center><tt>Cut max: 2.5</tt></center>

The final cut is to the pseudorapidity of the jet, this informs the range of the angle between the direction of emission of the jet and the x-y plane.

Each of these parameters are applied to the entire process by use of the colon. To specify a process for the cut : should be changed to :n:, where n is the process number at which to apply the cut. In this case it is fine to have all cuts apply to all processes.

=== Kinematics and Regularization ===

As before, the kinematical information is required in order to tell <tt>CalcHEP</tt> how to handle the phase space. Again, these can be commented out so that the default settings are used, however the kinematics required are:

<center><tt>Kinematics : 12 -> 3, 45</tt></center>
<center><tt>Kinematics : 45 -> 4 , 5</tt></center>

The first line represents the overall process of particles 1 and 2 combining to form particles 3, 4 and 5, where 4 and 5 are a combination of the bottom and anti-bottom quarks. The second line tells <tt>CalcHEP</tt> that these quarks then separate into the individual particles.

The regularization information must be in terms of the final state particles, in this case we want the momentum in terms of the quarks (particles 4 and 5) and the mass and width in terms of the Higgs properties. We also want this to apply only to the production process, and not the decay, using <tt>:1:</tt>. We specify the regularization as:

<center><tt>Regularization momentum:1: 45</tt></center>
<center><tt>Regularization mass:1: Mh</tt></center>
<center><tt>Regularization width:1: wh</tt></center>
<center><tt>Regularization power:1: 2</tt></center>

The regularization power should always be kept as squared.

=== Remaining Information ===

The rest of the batch file is explained in the previous example, and we use the same settings as before for <tt>Events Generation</tt>, <tt>Parallelization</tt>, <tt>Vegas</tt> and <tt>Event Generator</tt>.

=== Run the File ===

The batch file is now ready to run, set it running as instructed in the previous example. To check the progress of the job and whether it has finished, select the <tt>Check submitted job</tt> option.

CalcHEP tutorial

2015-07-27T12:32:56Z

Hepmdb:

In order to familiarise yourself with <tt>CalcHEP</tt>, we will study two examples, one sightly more complicated than the other. Hopefully, by the end of this tutorial, you will be able to use the majority of the functions of <tt>CalcHEP</tt>.

Please note that this is not a reference manual. If you wish to look at the reference manual, it is available [[CalcHEP reference|here]].

__TOC__

== A simple leptonic process ==
Let's start with a simple process and try to compute the matrix elements using <tt>CalcHEP</tt>. In this section, we will study:
<center><tt>ee → μμττ</tt></center>

The process will be studied in the standard model framework.

=== Preparing <tt>HEPMDB</tt> ===
First, connect to <tt>HEPMDB</tt> and go in the <tt>Calculate</tt> section. In the left panel, in the <tt>CalcHEP</tt> section, check whether the <tt>Standard Model (CKM=1)</tt> line appears. If not, in the <tt>CalcHEP</tt> menu, choose <tt>Import model</tt>. When you find the line <tt>Standard Model (CKM=1)</tt> for <tt>CalcHEP</tt> (it should be the model 43), select it and click <tt>Select</tt>. The model should now be accessible in your environment.

This model is the complete standard model without CKM matrix. As a consequence, it is lighter and in situation where quarks' flavours don't matter, it gives the same results as the standard model.

=== A template batch file ===
Select the model and select <tt>Edit Batch File</tt> in the <tt>CalcHEP</tt> menu. A new window will appear. You will be able to edit the batch file which is the file describing the process of interest. Click on the button <tt>Load batch template</tt>.

You now have a template file with nearly every possible field already offered. You also have help in the comments. The comments are lines beginning with a #. They are ignored by <tt>CalcHEP</tt> and thanks to them, you can add any information you want for anybody reading the batch file.

=== Model information ===
The first three fields are information about the model.
# The first line gives the model to use. You should not touch it as this specifies the model in the <tt>CalcHEP</tt> local batch mode. There is no default for this setting so this line must be included.
# The second option is <tt>Model changed</tt>. This tells <tt>CalcHEP</tt> that model files have been changed.
# Finally, <tt>Gauge</tt> specifies which gauge is used, Feynman or unitary. Many models are built implicitly assuming that the gauge is Feynman's, so you should not change this field either.

=== Defining the process ===
We have several lines to define our process. Remove every <tt>Process</tt>, <tt>Decay</tt> and <tt>Composite</tt> field. You can now write:
<center><tt>Process: e,E -> m,M,l,L</tt></center>

In the standard model of <tt>CalcHEP</tt>, <tt>e</tt> refers to electrons, <tt>m</tt> to muons, <tt>l</tt> to taus and the capital letters to their anti-particle. The list of particle names and symbols to use can be viewed by selecting <tt>View Particles</tt> in the <tt>CalcHEP</tt> drop-down menu. You cannot access it while editing the batch file however.

So we have set up an electron-positron scattering with a pair of muons and a pair of taus outgoing.
No further information is needed to describe the process itself.

=== Beams configuration ===
We now have to configure the beams. The next field is about the pdfs. While this is useful for proton or any composite particle scattering, we do not need it for electron-positron scattering. We can write:
<center><tt>pdf1: OFF</tt></center>
And the same thing for the second pdf.

Concerning the energy of the beam, let's set 100 GeV beams.
<center><tt>p1: 100</tt></center>
<center><tt>p2: 100</tt></center>

=== Changing model parameters ===
We now have the possibility to change some model parameters. Let's say you want to change the strength of the electromagnetic force. You would write:
<center><tt>Parameter: EE=0.31</tt></center>
with <tt>0.31</tt> being the new value of the electrical charge of the electron in natural units.
Some models are more flexible than others on that kind of point. But for our tutorial, we are not going to change the well known parameters.

Instead, we're going to scan the possible Higgs masses. For this, you can write:
<center><tt>Run parameter: Mh</tt></center>
<center><tt>Run begin: 100</tt></center>
<center><tt>Run step size: 10</tt></center>
<center><tt>Run n steps: 6</tt></center>
This means we're going to scan the following values for <tt>Mh</tt>: 100 Gev, 110 GeV, 120 GeV, 130 GeV, 140 GeV, 150 GeV.
This is of course a pretty useful possibility when studying a new model.

We then have the possibility to set some parameters about QCD but this will be studied in the next example.

=== Cuts ===
Various cuts are possible. For our simple tutorial, we are not going to study them. Please refer to the reference manual if you are interested in them.

=== Kinematics and regularization ===
To tell <tt>CalcHEP</tt> how to handle the phase space, you should fill the kinematic information.
Using this information, a nice parametrisation of the phase space is used.

In our case, the two ingoing particles will give two bosons, each of them decaying in a lepton pair. Hence, our kinematics are written as:
<center><tt>Kinematics : 12 -> 34, 56</tt></center>
<center><tt>Kinematics : 34 -> 3 , 4</tt></center>
<center><tt>Kinematics : 56 -> 5 , 6</tt></center>

where the numbers refer to the particle in the process, in this case, 12 are the electron and positron, 3 and 4 are the muons etc.

To improve the precision of the computation, it is important to tell <tt>CalcHEP</tt> where the resonances are.
In our case, we have resonance on the dimuon and ditau masses for the Z boson and for the Higgs.
So we will write:
<center><tt>Regularization momentum: 34</tt></center>
<center><tt>Regularization mass: MZ</tt></center>
<center><tt>Regularization width: wZ</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 34</tt></center>
<center><tt>Regularization mass: Mh</tt></center>
<center><tt>Regularization width: wh</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 56</tt></center>
<center><tt>Regularization mass: MZ</tt></center>
<center><tt>Regularization width: wZ</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 56</tt></center>
<center><tt>Regularization mass: Mh</tt></center>
<center><tt>Regularization width: wh</tt></center>
<center><tt>Regularization power: 2</tt></center>

=== Event generation ===
For event generation, we really have two main parameters:
#The number of events. We'll write: <tt>Number of events (per run step): 100000</tt>
#The output file name. <tt>Filename: tutorial_ee_mmll</tt>

=== Parallelization ===
When using the template file of <tt>HEPMDB</tt>, all parallelization parameters are good.

In order for the processes to run quickly and efficiently, it is recommended to set:
<center><tt>Max number of cpus: 24</tt></center>

This runs two processes on each of the 12 cores. Setting a higher number of cpus will overload the cluster, and the job will be killed.

For very large jobs, set:
<center><tt>Max number of cpus: 12</tt></center>

=== Vegas session ===
Finally, the Vegas session has some parameters. It will be used to compute the cross-section and to prepare the grid for event generation. Two sessions with 5 calls of 100,000 points is usually sufficient. With the number of calls there is a trade-off; the higher the number of calls means it will take longer to run the batch file on HEPMDB but reducing the number of calls leads to a decrease in accuracy of the cross sections. It is therefore worth experimenting with a couple of points in the batch interface of CalcHEP to see what optimization can be made.
<center><tt>nSess_1: 5</tt></center>
<center><tt>nCalls_1: 100000</tt></center>
<center><tt>nSess_2: 5</tt></center>
<center><tt>nCalls_2: 100000</tt></center>

=== Final words ===
The batch file is now complete and ready to run. Click <tt>Save</tt> and return to the <tt>CalcHEP</tt> drop-down menu, where you should select <tt>Run Batch File</tt>.

You can check the progress of your batch file by selecting <tt>Check Submitted Job</tt> from the <tt>CalcHEP</tt> drop-down menu, and a progress report will appear in the box at the bottom of the window. From here there are options to cancel a job or show its start and predicted end time. If you have selected <tt>Show Start</tt> the start time will appear in blue in the same window, if the start time have a minus sign then that it how long the job has been running for.

== Involving partons ==

For a more complex interaction involving partons, we study the collision of protons to create a specified final state. To make this easier to understand, we will look at the example given in the template batch file, and explain each section and its relevance. Hence we study:

<center><tt>p,p → W,b,B</tt></center>

This investigates the interaction of two protons on the parton level to create a W boson (without specifying positive or negative charge), a bottom quark and its anti-quark. Again this process is in the Standard Model framework.

=== Model Information ===

The batch file should be loaded according to the instructions in the previous example. Again the gauge should be set to <tt>Feynman</tt>, and <tt>Model Changed</tt> set to <tt>False</tt>. This tells the batch file that the model files have not been altered.

=== Defining the process ===

For this process, all of the definitions available in this section of the batch file need to be included. First, specify the main process.

<center><tt>Process: p,p → W,b,B </tt></center>

As the W boson is a gauge boson, we need to include a decay mode of this particle. We will look at its decay to an unspecified charged lepton and its corresponding neutrino. To do this, new variable names need to be input, we will us <tt>le</tt> for any charged lepton, and <tt>n</tt> for any neutrino. The decay is written as follows:

<center><tt>Decay: W → le,n</tt></center>

Almost all of the particles we have introduced are composites, i.e they represent several particles that can be involved in this particular type of interaction. When the batch file is run it calculates all possible processes for every combination of these particles, so it is important to include all composites. We write:

<center><tt>Composite: p=u,U,d,D,s,S,c,C,b,B,G</tt></center>
<center><tt>Composite: W=W+,W-</tt></center>
<center><tt>Composite: le=e,E,m,M</tt></center>
<center><tt>Composite: n=ne,Ne,nm,Nm</tt></center>

There is also the possibility that there will be a quark/gluon jet in the final state, so this must also be added to the <tt>Composite</tt> decriptions:

<center><tt>Composite: jet=u,U,d,D,s,S,c,C,b,B,G</tt></center>

These are all of the necessary descriptions of the process itself.

=== Beam Configuration and PDFs ===

As this process involves partons inside the colliding protons, a Parton Density Function must be specified for each proton. This affects the cross section results, and is necessary to include for all parton-level processes. There are several choices for the PDFs, we will use:

<center><tt>pdf1: cteq61 (proton) </tt></center>
<center><tt>pdf2: cteq61 (proton) </tt></center>

The remaining lines of this section are commented out because they are not necessary for this computation, so it is best to ignore them.

In <tt>Momentum Info</tt> for this process we will set the energy of the beams to match that of the most recent LHC energy, so each beam is set to 4000GeV.

<center><tt>p1: 4000</tt></center>
<center><tt>p2: 4000</tt></center>

=== Model Parameters ===

Next we can change the model parameters, but for this example we will keep them as in the default model files.

We will again scan over the Higgs masses, as in the previous example. The batch template gives the following values, but you are free to alter these to suit your needs.

<center><tt>Run parameter: Mh</tt></center>
<center><tt>Run begin: 120</tt></center>
<center><tt>Run step size: 5</tt></center>
<center><tt>Run n steps: 3</tt></center>

The QCD running info gives the strong coupling at the energy scale of the interaction, which we must define in terms of the bottom and anti-bottom quarks. This is done by writing:

<center><tt>alpha Q : M45</tt></center>

This again means that it is in terms of the 4th and 5th particles of the interactions, in this case b,B, as required. All other parts of this section can remain commented out.

=== Cut Information ===

There are several cuts that should be applied to this process. This is to avoid including divergences in the cross section calculations. The cuts only apply to the production processes, and not to the products of the decay. The template batch file has provided the cuts necessary for this process, but we should understand what they mean. The first is:

<center><tt>Cut parameter: M(b,B)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 100</tt></center>
<center><tt>Cut max: </tt></center>

This means that there is a cut applied to the invariant mass of the bottom and anti-bottom quarks, where the minimum is taken at <tt>M(b,B)=100GeV</tt>. This is to avoid the low energy divergence that occurs below this invariant mass value. The next is:

<center><tt>Cut parameter: J(jet,jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 0.5</tt></center>
<center><tt>Cut max: </tt></center>

This enforces a cut on the jet cone angle, or the minimum angle of a resulting jet in the production. Then we have:

<center><tt>Cut parameter: T(jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 20</tt></center>
<center><tt>Cut max: </tt></center>

This defines the cut on the transverse momentum of the production jet to be greater than 20GeV.

<center><tt>Cut parameter: N(jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: -2.5</tt></center>
<center><tt>Cut max: 2.5</tt></center>

The final cut is to the pseudorapidity of the jet, this informs the range of the angle between the direction of emission of the jet and the x-y plane.

Each of these parameters are applied to the entire process by use of the colon. To specify a process for the cut : should be changed to :n:, where n is the process number at which to apply the cut. In this case it is fine to have all cuts apply to all processes.

=== Kinematics and Regularization ===

As before, the kinematical information is required in order to tell <tt>CalcHEP</tt> how to handle the phase space. Again, these can be commented out so that the default settings are used, however the kinematics required are:

<center><tt>Kinematics : 12 -> 3, 45</tt></center>
<center><tt>Kinematics : 45 -> 4 , 5</tt></center>

The first line represents the overall process of particles 1 and 2 combining to form particles 3, 4 and 5, where 4 and 5 are a combination of the bottom and anti-bottom quarks. The second line tells <tt>CalcHEP</tt> that these quarks then separate into the individual particles.

The regularization information must be in terms of the final state particles, in this case we want the momentum in terms of the quarks (particles 4 and 5) and the mass and width in terms of the Higgs properties. We also want this to apply only to the production process, and not the decay, using <tt>:1:</tt>. We specify the regularization as:

<center><tt>Regularization momentum:1: 45</tt></center>
<center><tt>Regularization mass:1: Mh</tt></center>
<center><tt>Regularization width:1: wh</tt></center>
<center><tt>Regularization power:1: 2</tt></center>

The regularization power should always be kept as squared.

=== Remaining Information ===

The rest of the batch file is explained in the previous example, and we use the same settings as before for <tt>Events Generation</tt>, <tt>Parallelization</tt>, <tt>Vegas</tt> and <tt>Event Generator</tt>.

=== Run the File ===

The batch file is now ready to run, set it running as instructed in the previous example. To check the progress of the job and whether it has finished, select the <tt>Check submitted job</tt> option.

Calculate section

2015-07-27T11:26:42Z

Hepmdb: /* The top bar */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided into four parts:
# The top bar, containing the HEPMDB logo, the <tt>Show Iridis4 Queue</tt> and <tt>Go to Main Site</tt> buttons, and a drop down menu.
# The messages box, with general information on the last operations.
# The left menu, with the main functions and the program list.
# The calculation part, presenting results of computation.

=== The top bar ===
In the top bar, you will find:
* A <tt> Show Iridis4 Queue </tt> button that opens a window showing information on the total use of Iridis4 and the job queue for HEPMDB itself.
* A drop down menu.
* The <tt>Go to Main Site</tt> button which redirects you to the <tt>HEPMDB</tt> main page in the same tab.

The drop down menu contains a few useful items:
* <tt>User ID</tt>: This is very useful to reference if ever asking one of the developers about a problem with your account.
* <tt>Documentation</tt>: This takes you to these Wiki pages in a new tab.
* <tt>History</tt>: This opens a window with a full list of everything you have done on HEPMDB.
* <tt>Send a message to admin</tt>: This opens a window allowing you to send a message to an admin with your registered email.
* <tt>Reset Account</tt>: This will clear all your imported models and your .lhe and .nt files, and restore your account to its default settings.

=== The messages box ===
This part of the webpage displays information on any actions you have performed. For example, starting a job will display a message stating whether or not the job has been successfully submitted and the time of submission. The <tt>Check Job Progress</tt> button, located in the menus of CalcHEP, Whizard and Madgraph, will display any information on currently running jobs (like expected completion time) in the message box also.

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The calculation part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>File</tt> drop-down menu. You can import any model that has been uploaded to <tt>HEPMDB</tt> and shared publicly, or any you have uploaded and not shared.

When the model you wish to use is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit batch file</tt> option in the <tt>Selection</tt> drop down menu.

Besides writing the batch, you have four options in the editing window:
# <tt>Save Changes</tt>: This does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Import Full Template</tt>: This is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load Batch</tt>: This allows the user to load the batch file from a file.
# <tt>Save As</tt>: This option saves the current batch to a file. You still have to use the <tt>Save Changes</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
Once you have saved your batch file (making sure to have used the <tt>Save Changes</tt> button), you can now select <tt>Run Batch File</tt> from the <tt>Selection</tt> drop-down menu. You can check the status of the queued process via <tt>Check Job Progress</tt> in the <tt>File</tt> menu.

When you select <tt>Run Batch File</tt> a window should appear asking you to confirm the job submission. In this window it is possible to change the requested HPCx usage time (the current default is 10 minutes). Asking for a smaller amount of time will give your job a higher priority. However, it is important to note that if your job is still running at the end of the requested time it will be killed and returned to you with anything it managed in that time. Users are also limited to a request of 60 hours maximum.

When the computation is done <tt>HEPMDB</tt> will notify you by email. When you receive this email you can return to the <tt>Calculate Section</tt> of <tt>HEPMDB</tt> to view your results. If your results are not automatically displayed click again on the <tt>Check Job Progress</tt> button and they should be now be displayed in the main window. Any previous results can been reviewed using the history option found in the <tt>Tools</tt> menu.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2015-07-27T11:22:24Z

Hepmdb: /* Using CalcHEP */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided into four parts:
# The top bar, containing the HEPMDB logo, the <tt>Show Iridis4 Queue</tt> and <tt>Go to Main Site</tt> buttons, and a drop down menu.
# The messages box, with general information on the last operations.
# The left menu, with the main functions and the program list.
# The calculation part, presenting results of computation.

=== The top bar ===
In the upper menu, you will find:
* A <tt> Show Iridis4 Queue </tt> button that opens a window showing information on the total use of Iridis4 and the job queue for HEPMDB itself.
* A drop down menu.
* The <tt>Go to Main Site</tt> button which redirects you to the <tt>HEPMDB</tt> main page in the same tab.

The drop down menu contains a few useful items:
* <tt>User ID</tt>: This is very useful to reference if ever asking one of the developers about a problem with your account.
* <tt>Documentation</tt>: This takes you to these Wiki pages in a new tab.
* <tt>History</tt>: This opens a window with a full list of everything you have done on HEPMDB.
* <tt>Send a message to admin</tt>: This opens a window allowing you to send a message to an admin with your registered email.
* <tt>Reset Account</tt>: This will clear all your imported models and your .lhe and .nt files, and restore your account to its default settings.

=== The messages box ===
This part of the webpage displays information on any actions you have performed. For example, starting a job will display a message stating whether or not the job has been successfully submitted and the time of submission. The <tt>Check Job Progress</tt> button, located in the menus of CalcHEP, Whizard and Madgraph, will display any information on currently running jobs (like expected completion time) in the message box also.

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The calculation part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>File</tt> drop-down menu. You can import any model that has been uploaded to <tt>HEPMDB</tt> and shared publicly, or any you have uploaded and not shared.

When the model you wish to use is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit batch file</tt> option in the <tt>Selection</tt> drop down menu.

Besides writing the batch, you have four options in the editing window:
# <tt>Save Changes</tt>: This does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Import Full Template</tt>: This is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load Batch</tt>: This allows the user to load the batch file from a file.
# <tt>Save As</tt>: This option saves the current batch to a file. You still have to use the <tt>Save Changes</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
Once you have saved your batch file (making sure to have used the <tt>Save Changes</tt> button), you can now select <tt>Run Batch File</tt> from the <tt>Selection</tt> drop-down menu. You can check the status of the queued process via <tt>Check Job Progress</tt> in the <tt>File</tt> menu.

When you select <tt>Run Batch File</tt> a window should appear asking you to confirm the job submission. In this window it is possible to change the requested HPCx usage time (the current default is 10 minutes). Asking for a smaller amount of time will give your job a higher priority. However, it is important to note that if your job is still running at the end of the requested time it will be killed and returned to you with anything it managed in that time. Users are also limited to a request of 60 hours maximum.

When the computation is done <tt>HEPMDB</tt> will notify you by email. When you receive this email you can return to the <tt>Calculate Section</tt> of <tt>HEPMDB</tt> to view your results. If your results are not automatically displayed click again on the <tt>Check Job Progress</tt> button and they should be now be displayed in the main window. Any previous results can been reviewed using the history option found in the <tt>Tools</tt> menu.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2015-07-27T10:47:43Z

Hepmdb: /* The interface */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided into four parts:
# The top bar, containing the HEPMDB logo, the <tt>Show Iridis4 Queue</tt> and <tt>Go to Main Site</tt> buttons, and a drop down menu.
# The messages box, with general information on the last operations.
# The left menu, with the main functions and the program list.
# The calculation part, presenting results of computation.

=== The top bar ===
In the upper menu, you will find:
* A <tt> Show Iridis4 Queue </tt> button that opens a window showing information on the total use of Iridis4 and the job queue for HEPMDB itself.
* A drop down menu.
* The <tt>Go to Main Site</tt> button which redirects you to the <tt>HEPMDB</tt> main page in the same tab.

The drop down menu contains a few useful items:
* <tt>User ID</tt>: This is very useful to reference if ever asking one of the developers about a problem with your account.
* <tt>Documentation</tt>: This takes you to these Wiki pages in a new tab.
* <tt>History</tt>: This opens a window with a full list of everything you have done on HEPMDB.
* <tt>Send a message to admin</tt>: This opens a window allowing you to send a message to an admin with your registered email.
* <tt>Reset Account</tt>: This will clear all your imported models and your .lhe and .nt files, and restore your account to its default settings.

=== The messages box ===
This part of the webpage displays information on any actions you have performed. For example, starting a job will display a message stating whether or not the job has been successfully submitted and the time of submission. The <tt>Check Job Progress</tt> button, located in the menus of CalcHEP, Whizard and Madgraph, will display any information on currently running jobs (like expected completion time) in the message box also.

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The calculation part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Import Full Template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load Batch</tt>: this allows the user to load the batch file from a file.
# <tt>Save Changes</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save Changes</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and <tt>Menu</tt> drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2015-07-27T10:27:18Z

Hepmdb: /* The upper menu */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided in four parts:
# the upper bar, with general menus,
# the lower frame, with general information on the last operations,
# the left menu, with the main functions and the program list,
# the main part, presenting results of computation.

=== The upper menu ===
In the upper menu, you will find:
* A <tt> Show Iridis4 Queue </tt> button that opens a window showing information on the total use of Iridis4 and the job queue for HEPMDB itself.
* A drop down menu.
* The <tt>Go to Main Site</tt> button which redirects you to the <tt>HEPMDB</tt> main page in the same tab.

The drop down menu contains a few useful items:
* <tt>User ID</tt>: This is very useful to reference if ever asking one of the developers about a problem with your account.
* <tt>Documentation</tt>: This takes you to these Wiki pages in a new tab.
* <tt>History</tt>: This opens a window with a full list of everything you have done on HEPMDB.
* <tt>Send a message to admin</tt>: This opens a window allowing you to send a message to an admin with your registered email.
* <tt>Reset Account</tt>: This will clear all your imported models and your .lhe and .nt files, and restore your account to its default settings.

=== The lower frame ===
The lower frame displays information about the most recent commands. The result of any command will be displayed here, except the computations themselves.

When something has been queued, it is necessary to refresh the display explicitly (through the <tt>Check submitted jobs</tt> button).

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The main part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Import Full Template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load Batch</tt>: this allows the user to load the batch file from a file.
# <tt>Save Changes</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save Changes</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and <tt>Menu</tt> drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2015-07-27T09:47:59Z

Hepmdb: /* The batch file */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided in four parts:
# the upper bar, with general menus,
# the lower frame, with general information on the last operations,
# the left menu, with the main functions and the program list,
# the main part, presenting results of computation.

=== The upper menu ===
In the upper menu, you will find:
* A help button which opens this WIKI help page in a new tab
* The <tt>Go to HEPMDB</tt> button which opens the <tt>HEPMDB</tt> main page in a new tab
* The actual menu

Most of the menu commands are straight forward, although a selection have been explained in more detail here.
* <tt>Remove models</tt>: it removes all models that were imported. When a model has been updated, it is necessary to remove the old version this way. There is no option to remove models individually.
* <tt>Reset model list and clear results</tt>: This will reset everything to its default state. No results will be kept. You should make sure you have downloaded any results you need to keep before doing this.
* <tt>Show queue on HPCx</tt>: as <tt>HEPMDB</tt> is a shared resource, when you asked for a job, it is put in the queue. This button displays the whole queue.

=== The lower frame ===
The lower frame displays information about the most recent commands. The result of any command will be displayed here, except the computations themselves.

When something has been queued, it is necessary to refresh the display explicitly (through the <tt>Check submitted jobs</tt> button).

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The main part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Import Full Template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load Batch</tt>: this allows the user to load the batch file from a file.
# <tt>Save Changes</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save Changes</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and <tt>Menu</tt> drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

CalcHEP tutorial

2014-12-04T18:10:23Z

Hepmdb: /* Plots */

In order to familiarise yourself with <tt>CalcHEP</tt>, we will study two examples, one sightly more complicated than the other. Hopefully, by the end of this tutorial, you will be able to use majority of the functions of <tt>CalcHEP</tt>.

Please note that this is not a reference manual. If you wish to look at the reference manual, it is available [[CalcHEP reference|here]].

__TOC__

== A simple leptonic process ==
Let's start with a simple process and try to compute the matrix elements using <tt>CalcHEP</tt>. In this section, we will study:
<center><tt>ee → μμττ</tt></center>

The process will be studied in the standard model framework.

=== Preparing <tt>HEPMDB</tt> ===
First, connect to <tt>HEPMDB</tt> and go in the <tt>Calculate</tt> section. In the left panel, in the <tt>CalcHEP</tt> section, check whether the <tt>Standard Model (CKM=1)</tt> line appears. If not, in the <tt>CalcHEP</tt> menu, choose <tt>Import model</tt>. When you find the line <tt>Standard Model (CKM=1)</tt> for <tt>CalcHEP</tt> (it should be the model 43), select it and click <tt>Select</tt>. The model should now be accessible in your environment.

This model is the complete standard model without CKM matrix. As a consequence, it is lighter and in situation where quarks' flavours don't matter, it gives the same results as the standard model.

=== A template batch file ===
Select the model and select <tt>Edit Batch File</tt> in the <tt>CalcHEP</tt> menu. A new window will appear. You will be able to edit the batch file which is the file describing the process of interest. Click on the button <tt>Load batch template</tt>.

You now have a template file with nearly every possible field already offered. You also have help in the comments. The comments are lines beginning with a #. They are ignored by <tt>CalcHEP</tt> and thanks to them, you can add any information you want for anybody reading the batch file.

=== Model information ===
The first three fields are information about the model.
# The first line gives the model to use. You should not touch it as this specifies the model in the <tt>CalcHEP</tt> local batch mode. There is no default for this setting so this line must be included.
# The second option is <tt>Model changed</tt>. This tells <tt>CalcHEP</tt> that model files have been changed.
# Finally, <tt>Gauge</tt> specifies which gauge is used, Feynman or unitary. Many models are built implicitly assuming that the gauge is Feynman's, so you should not change this field either.

=== Defining the process ===
We have several lines to define our process. Remove every <tt>Process</tt>, <tt>Decay</tt> and <tt>Composite</tt> field. You can now write:
<center><tt>Process: e,E -> m,M,l,L</tt></center>

In the standard model of <tt>CalcHEP</tt>, <tt>e</tt> refers to electrons, <tt>m</tt> to muons, <tt>l</tt> to taus and the capital letters to their anti-particle. The list of particle names and symbols to use can be viewed by selecting <tt>View Particles</tt> in the <tt>CalcHEP</tt> drop-down menu. You cannot access it while editing the batch file however.

So we have set up an electron-positron scattering with a pair of muons and a pair of taus outgoing.
No further information is needed to describe the process itself.

=== Beams configuration ===
We now have to configure the beams. The next field is about the pdfs. While this is useful for proton or any composite particle scattering, we do not need it for electron-positron scattering. We can write:
<center><tt>pdf1: OFF</tt></center>
And the same thing for the second pdf.

Concerning the energy of the beam, let's set 100 GeV beams.
<center><tt>p1: 100</tt></center>
<center><tt>p2: 100</tt></center>

=== Changing model parameters ===
We now have the possibility to change some model parameters. Let's say you want to change the strength of the electromagnetic force. You would write:
<center><tt>Parameter: EE=0.31</tt></center>
with <tt>0.31</tt> being the new value of the electrical charge of the electron in natural units.
Some models are more flexible than others on that kind of point. But for our tutorial, we are not going to change the well known parameters.

Instead, we're going to scan the possible Higgs masses. For this, you can write:
<center><tt>Run parameter: Mh</tt></center>
<center><tt>Run begin: 100</tt></center>
<center><tt>Run step size: 10</tt></center>
<center><tt>Run n steps: 6</tt></center>
This means we're going to scan the following values for <tt>Mh</tt>: 100 Gev, 110 GeV, 120 GeV, 130 GeV, 140 GeV, 150 GeV.
This is of course a pretty useful possibility when studying a new model.

We then have the possibility to set some parameters about QCD but this will be studied in the next example.

=== Cuts ===
Various cuts are possible. For our simple tutorial, we are not going to study them. Please refer to the reference manual if you are interested in them.

=== Kinematics and regularization ===
To tell <tt>CalcHEP</tt> how to handle the phase space, you should fill the kinematic information.
Using this information, a nice parametrisation of the phase space is used.

In our case, the two ingoing particles will give two bosons, each of them decaying in a lepton pair. Hence, our kinematics are written as:
<center><tt>Kinematics : 12 -> 34, 56</tt></center>
<center><tt>Kinematics : 34 -> 3 , 4</tt></center>
<center><tt>Kinematics : 56 -> 5 , 6</tt></center>

where the numbers refer to the particle in the process, in this case, 12 are the electron and positron, 3 and 4 are the muons etc.

To improve the precision of the computation, it is important to tell <tt>CalcHEP</tt> where the resonances are.
In our case, we have resonance on the dimuon and ditau masses for the Z boson and for the Higgs.
So we will write:
<center><tt>Regularization momentum: 34</tt></center>
<center><tt>Regularization mass: MZ</tt></center>
<center><tt>Regularization width: wZ</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 34</tt></center>
<center><tt>Regularization mass: Mh</tt></center>
<center><tt>Regularization width: wh</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 56</tt></center>
<center><tt>Regularization mass: MZ</tt></center>
<center><tt>Regularization width: wZ</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 56</tt></center>
<center><tt>Regularization mass: Mh</tt></center>
<center><tt>Regularization width: wh</tt></center>
<center><tt>Regularization power: 2</tt></center>

=== Event generation ===
For event generation, we really have two main parameters:
#The number of events. We'll write: <tt>Number of events (per run step): 100000</tt>
#The output file name. <tt>Filename: tutorial_ee_mmll</tt>

=== Parallelization ===
When using the template file of <tt>HEPMDB</tt>, all parallelization parameters are good.

In order for the processes to run quickly and efficiently, it is recommended to set:
<center><tt>Max number of cpus: 24</tt></center>

This runs two processes on each of the 12 cores. Setting a higher number of cpus will overload the cluster, and the job will be killed.

For very large jobs, set:
<center><tt>Max number of cpus: 12</tt></center>

=== Vegas session ===
Finally, the Vegas session has some parameters. It will be used to compute the cross-section and to prepare the grid for event generation. Two sessions with 5 calls of 100,000 points is usually sufficient. With the number of calls there is a trade-off; the higher the number of calls means it will take longer to run the batch file on HEPMDB but reducing the number of calls leads to a decrease in accuracy of the cross sections. It is therefore worth experimenting with a couple of points in the batch interface of CalcHEP to see what optimization can be made.
<center><tt>nSess_1: 5</tt></center>
<center><tt>nCalls_1: 100000</tt></center>
<center><tt>nSess_2: 5</tt></center>
<center><tt>nCalls_2: 100000</tt></center>

=== Final words ===
The batch file is now complete and ready to run. Click <tt>Save</tt> and return to the <tt>CalcHEP</tt> drop-down menu, where you should select <tt>Run Batch File</tt>.

You can check the progress of your batch file by selecting <tt>Check Submitted Job</tt> from the <tt>CalcHEP</tt> drop-down menu, and a progress report will appear in the box at the bottom of the window. From here there are options to cancel a job or show its start and predicted end time. If you have selected <tt>Show Start</tt> the start time will appear in blue in the same window, if the start time have a minus sign then that it how long the job has been running for.

== Involving partons ==

For a more complex interaction involving partons, we study the collision of protons to create a specified final state. To make this easier to understand, we will look at the example given in the template batch file, and explain each section and its relevance. Hence we study:

<center><tt>p,p → W,b,B</tt></center>

This investigates the interaction of two protons on the parton level to create a W boson (without specifying positive or negative charge), a bottom quark and its anti-quark. Again this process is in the Standard Model framework.

=== Model Information ===

The batch file should be loaded according to the instructions in the previous example. Again the gauge should be set to <tt>Feynman</tt>, and <tt>Model Changed</tt> set to <tt>False</tt>. This tells the batch file that the model files have not been altered.

=== Defining the process ===

For this process, all of the definitions available in this section of the batch file need to be included. First, specify the main process.

<center><tt>Process: p,p → W,b,B </tt></center>

As the W boson is a gauge boson, we need to include a decay mode of this particle. We will look at its decay to an unspecified charged lepton and its corresponding neutrino. To do this, new variable names need to be input, we will us <tt>le</tt> for any charged lepton, and <tt>n</tt> for any neutrino. The decay is written as follows:

<center><tt>Decay: W → le,n</tt></center>

Almost all of the particles we have introduced are composites, i.e they represent several particles that can be involved in this particular type of interaction. When the batch file is run it calculates all possible processes for every combination of these particles, so it is important to include all composites. We write:

<center><tt>Composite: p=u,U,d,D,s,S,c,C,b,B,G</tt></center>
<center><tt>Composite: W=W+,W-</tt></center>
<center><tt>Composite: le=e,E,m,M</tt></center>
<center><tt>Composite: n=ne,Ne,nm,Nm</tt></center>

There is also the possibility that there will be a quark/gluon jet in the final state, so this must also be added to the <tt>Composite</tt> decriptions:

<center><tt>Composite: jet=u,U,d,D,s,S,c,C,b,B,G</tt></center>

These are all of the necessary descriptions of the process itself.

=== Beam Configuration and PDFs ===

As this process involves partons inside the colliding protons, a Parton Density Function must be specified for each proton. This affects the cross section results, and is necessary to include for all parton-level processes. There are several choices for the PDFs, we will use:

<center><tt>pdf1: cteq61 (proton) </tt></center>
<center><tt>pdf2: cteq61 (proton) </tt></center>

The remaining lines of this section are commented out because they are not necessary for this computation, so it is best to ignore them.

In <tt>Momentum Info</tt> for this process we will set the energy of the beams to match that of the most recent LHC energy, so each beam is set to 4000GeV.

<center><tt>p1: 4000</tt></center>
<center><tt>p2: 4000</tt></center>

=== Model Parameters ===

Next we can change the model parameters, but for this example we will keep them as in the default model files.

We will again scan over the Higgs masses, as in the previous example. The batch template gives the following values, but you are free to alter these to suit your needs.

<center><tt>Run parameter: Mh</tt></center>
<center><tt>Run begin: 120</tt></center>
<center><tt>Run step size: 5</tt></center>
<center><tt>Run n steps: 3</tt></center>

The QCD running info gives the strong coupling at the energy scale of the interaction, which we must define in terms of the bottom and anti-bottom quarks. This is done by writing:

<center><tt>alpha Q : M45</tt></center>

This again means that it is in terms of the 4th and 5th particles of the interactions, in this case b,B, as required. All other parts of this section can remain commented out.

=== Cut Information ===

There are several cuts that should be applied to this process. This is to avoid including divergences in the cross section calculations. The cuts only apply to the production processes, and not to the products of the decay. The template batch file has provided the cuts necessary for this process, but we should understand what they mean. The first is:

<center><tt>Cut parameter: M(b,B)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 100</tt></center>
<center><tt>Cut max: </tt></center>

This means that there is a cut applied to the invariant mass of the bottom and anti-bottom quarks, where the minimum is taken at <tt>M(b,B)=100GeV</tt>. This is to avoid the low energy divergence that occurs below this invariant mass value. The next is:

<center><tt>Cut parameter: J(jet,jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 0.5</tt></center>
<center><tt>Cut max: </tt></center>

This enforces a cut on the jet cone angle, or the minimum angle of a resulting jet in the production. Then we have:

<center><tt>Cut parameter: T(jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 20</tt></center>
<center><tt>Cut max: </tt></center>

This defines the cut on the transverse momentum of the production jet to be greater than 20GeV.

<center><tt>Cut parameter: N(jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: -2.5</tt></center>
<center><tt>Cut max: 2.5</tt></center>

The final cut is to the pseudorapidity of the jet, this informs the range of the angle between the direction of emission of the jet and the x-y plane.

Each of these parameters are applied to the entire process by use of the colon. To specify a process for the cut : should be changed to :n:, where n is the process number at which to apply the cut. In this case it is fine to have all cuts apply to all processes.

=== Kinematics and Regularization ===

As before, the kinematical information is required in order to tell <tt>CalcHEP</tt> how to handle the phase space. Again, these can be commented out so that the default settings are used, however the kinematics required are:

<center><tt>Kinematics : 12 -> 3, 45</tt></center>
<center><tt>Kinematics : 45 -> 4 , 5</tt></center>

The first line represents the overall process of particles 1 and 2 combining to form particles 3, 4 and 5, where 4 and 5 are a combination of the bottom and anti-bottom quarks. The second line tells <tt>CalcHEP</tt> that these quarks then separate into the individual particles.

The regularization information must be in terms of the final state particles, in this case we want the momentum in terms of the quarks (particles 4 and 5) and the mass and width in terms of the Higgs properties. We also want this to apply only to the production process, and not the decay, using <tt>:1:</tt>. We specify the regularization as:

<center><tt>Regularization momentum:1: 45</tt></center>
<center><tt>Regularization mass:1: Mh</tt></center>
<center><tt>Regularization width:1: wh</tt></center>
<center><tt>Regularization power:1: 2</tt></center>

The regularization power should always be kept as squared.

=== Remaining Information ===

The rest of the batch file is explained in the previous example, and we use the same settings as before for <tt>Events Generation</tt>, <tt>Parallelization</tt>, <tt>Vegas</tt> and <tt>Event Generator</tt>.

=== Run the File ===

The batch file is now ready to run, set it running as instructed in the previous example. To check the progress of the job and whether it has finished, select the <tt>Check submitted job</tt> option.

CalcHEP tutorial

2014-12-04T18:09:30Z

Hepmdb:

In order to familiarise yourself with <tt>CalcHEP</tt>, we will study two examples, one sightly more complicated than the other. Hopefully, by the end of this tutorial, you will be able to use majority of the functions of <tt>CalcHEP</tt>.

Please note that this is not a reference manual. If you wish to look at the reference manual, it is available [[CalcHEP reference|here]].

__TOC__

== A simple leptonic process ==
Let's start with a simple process and try to compute the matrix elements using <tt>CalcHEP</tt>. In this section, we will study:
<center><tt>ee → μμττ</tt></center>

The process will be studied in the standard model framework.

=== Preparing <tt>HEPMDB</tt> ===
First, connect to <tt>HEPMDB</tt> and go in the <tt>Calculate</tt> section. In the left panel, in the <tt>CalcHEP</tt> section, check whether the <tt>Standard Model (CKM=1)</tt> line appears. If not, in the <tt>CalcHEP</tt> menu, choose <tt>Import model</tt>. When you find the line <tt>Standard Model (CKM=1)</tt> for <tt>CalcHEP</tt> (it should be the model 43), select it and click <tt>Select</tt>. The model should now be accessible in your environment.

This model is the complete standard model without CKM matrix. As a consequence, it is lighter and in situation where quarks' flavours don't matter, it gives the same results as the standard model.

=== A template batch file ===
Select the model and select <tt>Edit Batch File</tt> in the <tt>CalcHEP</tt> menu. A new window will appear. You will be able to edit the batch file which is the file describing the process of interest. Click on the button <tt>Load batch template</tt>.

You now have a template file with nearly every possible field already offered. You also have help in the comments. The comments are lines beginning with a #. They are ignored by <tt>CalcHEP</tt> and thanks to them, you can add any information you want for anybody reading the batch file.

=== Model information ===
The first three fields are information about the model.
# The first line gives the model to use. You should not touch it as this specifies the model in the <tt>CalcHEP</tt> local batch mode. There is no default for this setting so this line must be included.
# The second option is <tt>Model changed</tt>. This tells <tt>CalcHEP</tt> that model files have been changed.
# Finally, <tt>Gauge</tt> specifies which gauge is used, Feynman or unitary. Many models are built implicitly assuming that the gauge is Feynman's, so you should not change this field either.

=== Defining the process ===
We have several lines to define our process. Remove every <tt>Process</tt>, <tt>Decay</tt> and <tt>Composite</tt> field. You can now write:
<center><tt>Process: e,E -> m,M,l,L</tt></center>

In the standard model of <tt>CalcHEP</tt>, <tt>e</tt> refers to electrons, <tt>m</tt> to muons, <tt>l</tt> to taus and the capital letters to their anti-particle. The list of particle names and symbols to use can be viewed by selecting <tt>View Particles</tt> in the <tt>CalcHEP</tt> drop-down menu. You cannot access it while editing the batch file however.

So we have set up an electron-positron scattering with a pair of muons and a pair of taus outgoing.
No further information is needed to describe the process itself.

=== Beams configuration ===
We now have to configure the beams. The next field is about the pdfs. While this is useful for proton or any composite particle scattering, we do not need it for electron-positron scattering. We can write:
<center><tt>pdf1: OFF</tt></center>
And the same thing for the second pdf.

Concerning the energy of the beam, let's set 100 GeV beams.
<center><tt>p1: 100</tt></center>
<center><tt>p2: 100</tt></center>

=== Changing model parameters ===
We now have the possibility to change some model parameters. Let's say you want to change the strength of the electromagnetic force. You would write:
<center><tt>Parameter: EE=0.31</tt></center>
with <tt>0.31</tt> being the new value of the electrical charge of the electron in natural units.
Some models are more flexible than others on that kind of point. But for our tutorial, we are not going to change the well known parameters.

Instead, we're going to scan the possible Higgs masses. For this, you can write:
<center><tt>Run parameter: Mh</tt></center>
<center><tt>Run begin: 100</tt></center>
<center><tt>Run step size: 10</tt></center>
<center><tt>Run n steps: 6</tt></center>
This means we're going to scan the following values for <tt>Mh</tt>: 100 Gev, 110 GeV, 120 GeV, 130 GeV, 140 GeV, 150 GeV.
This is of course a pretty useful possibility when studying a new model.

We then have the possibility to set some parameters about QCD but this will be studied in the next example.

=== Cuts ===
Various cuts are possible. For our simple tutorial, we are not going to study them. Please refer to the reference manual if you are interested in them.

=== Kinematics and regularization ===
To tell <tt>CalcHEP</tt> how to handle the phase space, you should fill the kinematic information.
Using this information, a nice parametrisation of the phase space is used.

In our case, the two ingoing particles will give two bosons, each of them decaying in a lepton pair. Hence, our kinematics are written as:
<center><tt>Kinematics : 12 -> 34, 56</tt></center>
<center><tt>Kinematics : 34 -> 3 , 4</tt></center>
<center><tt>Kinematics : 56 -> 5 , 6</tt></center>

where the numbers refer to the particle in the process, in this case, 12 are the electron and positron, 3 and 4 are the muons etc.

To improve the precision of the computation, it is important to tell <tt>CalcHEP</tt> where the resonances are.
In our case, we have resonance on the dimuon and ditau masses for the Z boson and for the Higgs.
So we will write:
<center><tt>Regularization momentum: 34</tt></center>
<center><tt>Regularization mass: MZ</tt></center>
<center><tt>Regularization width: wZ</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 34</tt></center>
<center><tt>Regularization mass: Mh</tt></center>
<center><tt>Regularization width: wh</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 56</tt></center>
<center><tt>Regularization mass: MZ</tt></center>
<center><tt>Regularization width: wZ</tt></center>
<center><tt>Regularization power: 2</tt></center>

<center><tt>Regularization momentum: 56</tt></center>
<center><tt>Regularization mass: Mh</tt></center>
<center><tt>Regularization width: wh</tt></center>
<center><tt>Regularization power: 2</tt></center>

=== Plots ===
<tt>CalcHEP</tt> has automated plot capacities. However, with <tt>HEPMDB</tt>, they are of little use. We will ignore them.

=== Event generation ===
For event generation, we really have two main parameters:
#The number of events. We'll write: <tt>Number of events (per run step): 100000</tt>
#The output file name. <tt>Filename: tutorial_ee_mmll</tt>

=== Parallelization ===
When using the template file of <tt>HEPMDB</tt>, all parallelization parameters are good.

In order for the processes to run quickly and efficiently, it is recommended to set:
<center><tt>Max number of cpus: 24</tt></center>

This runs two processes on each of the 12 cores. Setting a higher number of cpus will overload the cluster, and the job will be killed.

For very large jobs, set:
<center><tt>Max number of cpus: 12</tt></center>

=== Vegas session ===
Finally, the Vegas session has some parameters. It will be used to compute the cross-section and to prepare the grid for event generation. Two sessions with 5 calls of 100,000 points is usually sufficient. With the number of calls there is a trade-off; the higher the number of calls means it will take longer to run the batch file on HEPMDB but reducing the number of calls leads to a decrease in accuracy of the cross sections. It is therefore worth experimenting with a couple of points in the batch interface of CalcHEP to see what optimization can be made.
<center><tt>nSess_1: 5</tt></center>
<center><tt>nCalls_1: 100000</tt></center>
<center><tt>nSess_2: 5</tt></center>
<center><tt>nCalls_2: 100000</tt></center>

=== Final words ===
The batch file is now complete and ready to run. Click <tt>Save</tt> and return to the <tt>CalcHEP</tt> drop-down menu, where you should select <tt>Run Batch File</tt>.

You can check the progress of your batch file by selecting <tt>Check Submitted Job</tt> from the <tt>CalcHEP</tt> drop-down menu, and a progress report will appear in the box at the bottom of the window. From here there are options to cancel a job or show its start and predicted end time. If you have selected <tt>Show Start</tt> the start time will appear in blue in the same window, if the start time have a minus sign then that it how long the job has been running for.

== Involving partons ==

For a more complex interaction involving partons, we study the collision of protons to create a specified final state. To make this easier to understand, we will look at the example given in the template batch file, and explain each section and its relevance. Hence we study:

<center><tt>p,p → W,b,B</tt></center>

This investigates the interaction of two protons on the parton level to create a W boson (without specifying positive or negative charge), a bottom quark and its anti-quark. Again this process is in the Standard Model framework.

=== Model Information ===

The batch file should be loaded according to the instructions in the previous example. Again the gauge should be set to <tt>Feynman</tt>, and <tt>Model Changed</tt> set to <tt>False</tt>. This tells the batch file that the model files have not been altered.

=== Defining the process ===

For this process, all of the definitions available in this section of the batch file need to be included. First, specify the main process.

<center><tt>Process: p,p → W,b,B </tt></center>

As the W boson is a gauge boson, we need to include a decay mode of this particle. We will look at its decay to an unspecified charged lepton and its corresponding neutrino. To do this, new variable names need to be input, we will us <tt>le</tt> for any charged lepton, and <tt>n</tt> for any neutrino. The decay is written as follows:

<center><tt>Decay: W → le,n</tt></center>

Almost all of the particles we have introduced are composites, i.e they represent several particles that can be involved in this particular type of interaction. When the batch file is run it calculates all possible processes for every combination of these particles, so it is important to include all composites. We write:

<center><tt>Composite: p=u,U,d,D,s,S,c,C,b,B,G</tt></center>
<center><tt>Composite: W=W+,W-</tt></center>
<center><tt>Composite: le=e,E,m,M</tt></center>
<center><tt>Composite: n=ne,Ne,nm,Nm</tt></center>

There is also the possibility that there will be a quark/gluon jet in the final state, so this must also be added to the <tt>Composite</tt> decriptions:

<center><tt>Composite: jet=u,U,d,D,s,S,c,C,b,B,G</tt></center>

These are all of the necessary descriptions of the process itself.

=== Beam Configuration and PDFs ===

As this process involves partons inside the colliding protons, a Parton Density Function must be specified for each proton. This affects the cross section results, and is necessary to include for all parton-level processes. There are several choices for the PDFs, we will use:

<center><tt>pdf1: cteq61 (proton) </tt></center>
<center><tt>pdf2: cteq61 (proton) </tt></center>

The remaining lines of this section are commented out because they are not necessary for this computation, so it is best to ignore them.

In <tt>Momentum Info</tt> for this process we will set the energy of the beams to match that of the most recent LHC energy, so each beam is set to 4000GeV.

<center><tt>p1: 4000</tt></center>
<center><tt>p2: 4000</tt></center>

=== Model Parameters ===

Next we can change the model parameters, but for this example we will keep them as in the default model files.

We will again scan over the Higgs masses, as in the previous example. The batch template gives the following values, but you are free to alter these to suit your needs.

<center><tt>Run parameter: Mh</tt></center>
<center><tt>Run begin: 120</tt></center>
<center><tt>Run step size: 5</tt></center>
<center><tt>Run n steps: 3</tt></center>

The QCD running info gives the strong coupling at the energy scale of the interaction, which we must define in terms of the bottom and anti-bottom quarks. This is done by writing:

<center><tt>alpha Q : M45</tt></center>

This again means that it is in terms of the 4th and 5th particles of the interactions, in this case b,B, as required. All other parts of this section can remain commented out.

=== Cut Information ===

There are several cuts that should be applied to this process. This is to avoid including divergences in the cross section calculations. The cuts only apply to the production processes, and not to the products of the decay. The template batch file has provided the cuts necessary for this process, but we should understand what they mean. The first is:

<center><tt>Cut parameter: M(b,B)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 100</tt></center>
<center><tt>Cut max: </tt></center>

This means that there is a cut applied to the invariant mass of the bottom and anti-bottom quarks, where the minimum is taken at <tt>M(b,B)=100GeV</tt>. This is to avoid the low energy divergence that occurs below this invariant mass value. The next is:

<center><tt>Cut parameter: J(jet,jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 0.5</tt></center>
<center><tt>Cut max: </tt></center>

This enforces a cut on the jet cone angle, or the minimum angle of a resulting jet in the production. Then we have:

<center><tt>Cut parameter: T(jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: 20</tt></center>
<center><tt>Cut max: </tt></center>

This defines the cut on the transverse momentum of the production jet to be greater than 20GeV.

<center><tt>Cut parameter: N(jet)</tt></center>
<center><tt>Cut invert: False</tt></center>
<center><tt>Cut min: -2.5</tt></center>
<center><tt>Cut max: 2.5</tt></center>

The final cut is to the pseudorapidity of the jet, this informs the range of the angle between the direction of emission of the jet and the x-y plane.

Each of these parameters are applied to the entire process by use of the colon. To specify a process for the cut : should be changed to :n:, where n is the process number at which to apply the cut. In this case it is fine to have all cuts apply to all processes.

=== Kinematics and Regularization ===

As before, the kinematical information is required in order to tell <tt>CalcHEP</tt> how to handle the phase space. Again, these can be commented out so that the default settings are used, however the kinematics required are:

<center><tt>Kinematics : 12 -> 3, 45</tt></center>
<center><tt>Kinematics : 45 -> 4 , 5</tt></center>

The first line represents the overall process of particles 1 and 2 combining to form particles 3, 4 and 5, where 4 and 5 are a combination of the bottom and anti-bottom quarks. The second line tells <tt>CalcHEP</tt> that these quarks then separate into the individual particles.

The regularization information must be in terms of the final state particles, in this case we want the momentum in terms of the quarks (particles 4 and 5) and the mass and width in terms of the Higgs properties. We also want this to apply only to the production process, and not the decay, using <tt>:1:</tt>. We specify the regularization as:

<center><tt>Regularization momentum:1: 45</tt></center>
<center><tt>Regularization mass:1: Mh</tt></center>
<center><tt>Regularization width:1: wh</tt></center>
<center><tt>Regularization power:1: 2</tt></center>

The regularization power should always be kept as squared.

=== Remaining Information ===

The rest of the batch file is explained in the previous example, and we use the same settings as before for <tt>Events Generation</tt>, <tt>Parallelization</tt>, <tt>Vegas</tt> and <tt>Event Generator</tt>.

=== Run the File ===

The batch file is now ready to run, set it running as instructed in the previous example. To check the progress of the job and whether it has finished, select the <tt>Check submitted job</tt> option.

Staff of HEPMDB

2014-11-28T07:55:32Z

Hepmdb:

If you would like an information regarding HEPMDB or for any general enquiries please email '''hepmdb@googlegroups.com'''.

* '''Alexander Belyaev''' (University of Southampton)

* '''[[Maksym_Bondarenko|Maksym Bondarenko]]''' (University of Southampton)

* '''James Blandford''' (University of Southampton)

----

'''Southampton High Energy Physics''' (SHEP) group has a long term program to play a significant role in uncovering the next level of fundamental physics beyond the standard model (BSM).

SHEP activity covers the following strongly related areas of High Energy Physics:
* collider phenomenology within and beyond the standard model
* model building
* lattice QCD
* strongly coupled gauge theories
* gravitation.

The group has 11 permanent academic members. It also includes about 30 postdocs and PhD students who are involved in the group research activity. In the last 3 years SHEP has published about 200 papers in the leading physics journals with the top impact parameter such as: Physical Review Letters, Physics Letters B, Physics Review D, European Physical Journal.

Our group played a leading role in creating of the NExT Institute which now joins researchers from '''Southampton''', '''Rutherford Appleton Laboratory''', '''University of Royal Holloway''' and '''University of Sussex'''. NExT was established to promote a new kind of interaction within particle physics, by formally creating and supporting one-on-one relationships between each theorist and an individual experiment.
This novel approach is designed to help put the UK in a unique position to extract and interpret results from the LHC and in defining research programs in other areas such as neutrinos and dark matter.

It is worth stressing both the impressive scale of NExT activities as a whole (a total funding of about £3.5M since 2006 from as many as 20 institutions/agencies) and SHEP's leading role within it.
Prof Moretti is the Director and 4 of the 7 permanent NExT fellows/lecturers are based in Southampton (E. Accomando, A.Belyaev, P. Di Bari, R. Zwicky).

FAQ

2014-08-22T13:25:08Z

Hepmdb:

__TOC__

== About HEPMDB ==

=== What is HEPMDB? ===

HEPMDB is a database that stores high energy physics models, and calculates theoretical cross sections for user defined processes in order to validate theory against experimental data. There are other projects similar to this, however HEPMDB is the only database that allows users to upload models, run processes and calculate cross sections on the site itself.

The model database can be accessed by everyone. In order to use HEPMDB's computational capabilities you will have to register first.

=== Current Capabilities ===

* Users can upload model file and model source files (i.e <tt>LanHEP</tt>, <tt>FeynRules</tt>) for various Matrix Element Generators inc. <tt>CalcHEP</tt>, <tt>MADGRAPH</tt>, <tt>WHIZARD</tt> etc.

* HEP processes can be performed in user's own submitted models or any of the already published models (many uploaded by other users).

* Calculations are performed in the HPCx cluster interface, providing up to 12 cores per user. This allows for faster calculation and larger jobs than on a desktop or laptop.

* Model history is stored so that any modifications to the model itself can be tracked.

* Kinematical distributions of various properties can be plotted and stored in the Lhe format.

* Can search for and download existing models from HEPMDB.

* Option to leave reviews for other's models to aid development.

=== Future Prospects ===

The database is still in development, here are some of the possible prospects for the future development of HEPMDB.

* Addition of the <tt>LanHEP</tt> and <tt>FeynRules</tt> packages, and the <tt>CompHEP</tt> Matrix Element Generator.

* Allow users to upload their own Feynman rule or Matrix Element Generator packages.

* Compare BSM predictions with LHC data systematically in order to discriminate between the different theories.

* Extend database structure to deal with correlated signatures.

* Make format for model predictions consistent with LHC data format used by experimentalists.

* Install MicrOMEGAs package to evaluate dark matter relic density, and to provide scans of model parameter spaces.

* Possibly study events beyond parton level, up to detector simulation.

== Getting started ==

=== How do I register on HEPMDB? ===
To register, all you need are basic details such as name, email and affiliation. Your account will be reviewed and approved by one of our administrators. You will be notified by email once your account is approved.
Registration can be done on the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=register HEPMDB main site].
As usual, all fields marked with an asterisk are mandatory. Check for further help [[Registration|here]].

== General usage ==

=== What is the Calculate section? ===
This section allows you to use the models uploaded on HEPMDB and directly compute results using <tt>HEPMDB</tt> computers. Only once registered will you be able to use <tt>HEPMDB</tt> Calculate section.
More information on how to use this section is provided [[Calculate section|Here]].

=== Which programs can I use on <tt>HEPMDB</tt>? ===
Currently, three different programs can be used for computation on <tt>HEPMDB</tt>: <tt>CalcHEP</tt>, <tt>WHIZARD</tt> and <tt>MadGraph</tt>. Any model developed for these programs and uploaded on the <tt>HEPMDB</tt> website will be accessible.

=== Why should I use <tt>HEPMDB</tt>'s Calculate section? ===
There are many practical reasons for using the <tt>HEPMDB</tt> computing mainframe. Convenience may be the most obvious one; no installation is needed and it is simple to compare results between various matrix element generators. Also, <tt>HEPMDB</tt> has some integrated tools for plotting and analysing that are really quick to use.

Another reason is simply the efficiency; with 12 cores, <tt>HEPMDB</tt> is much faster than most local installations.

=== Where can I find some help on how to use the Calculate section? ===
These wiki pages will provide help. [[Calculate section|Here]] you can find a specific help page for the Calculate section, with information on the interface and descriptions of the different available programmes: CalcHEP, WIZARD and MadGraph.

== Becoming an author ==

=== Who is an author? ===
If you want to use the HEPMDB computation abilities, you will have to become an author. Authors are also granted the right to upload new models (and encouraged to do so). In the future, they will also be able to add model signatures.

=== How do you upload a model? ===
As soon as your account is approved, you can upload new models. This is done through the [http://hepmdb.soton.ac.uk/index.php?mod=user&act=upload upload model] page.

Further help can found [[Uploading model|here]].

== Using the results ==

=== Why can't I download the results lhe file? ===
It should be noted that it is not possible to download files bigger than 1GB from <tt>HEPMDB</tt>. Unfortunately, file sizes are not indicated yet.
The consequence of this download limit is that you cannot combine too many lhe files into one before uploading.

== Making a model for <tt>HEPMDB</tt> ==
=== How do I use an SLHA input file? ===
If you wrote a model, it may be using an SLHA input file. On <tt>HEPMDB</tt>, there is an option for the user to upload his/her own SLHA file. In order to use that one, you should use the file <tt>../models/SLHA.txt</tt> in your model. Any SLHA file that the user uploads will be renamed and relocated accordingly.

= Presentations on <tt>HEPMDB</tt> =

==== Miniworkshop on High Energy Physics Model Database (HEPMDB)====
March 2 2012, Durham, IPPP [http://indico.cern.ch/conferenceDisplay.py?confId=179627]

==== CalcHEP and HEPMDB: practical introduction and tutorial ====
by Alexander Belyaev, Friday, 4 May 2012, CERN [https://indico.cern.ch/conferenceDisplay.py?confId=189668]

==== HEPMDB: practical introduction and tutorial ====
Alexander Belyaev, 16 August 2013, CERN [http://indico.cern.ch/conferenceDisplay.py?confId=267908]

Registration

2014-08-22T12:37:31Z

Hepmdb: /* Generalities */

Many tasks on <tt>HEPMDB</tt> require you to be registered. Registration can be done at the following address:
http://hepmdb.soton.ac.uk/index.php?mod=user&act=register

On this page, you will find a description of the various fields required for registration.

__TOC__

== Generalities ==
As for any registration form, you will have to provides your details for a certain number of fields. Each field marked with an asterix is mandatory. Once the form is completed, you will receive an e-mail confirming that your registration request has been received. Registration must be accepted by the <tt>HEPMDB</tt> admin team before you can begin to use the database, it should be accepted by our team quite quickly. You will receive a second e-mail when you are allowed to use <tt>HEPMDB</tt> at full capacity.

== Fields ==
=== First and last names ===
These two fields are mandatory. They will be used when sending e-mails to you (confirming that a HEPMDB job is done) and appear when you upload a model.

=== Address, country and website ===
These fields are optional.

=== E-mail ===
Giving your e-mail is mandatory. Providing this information is a simple way to check that this is a real registration. Your email is also required When using the computational capacities of <tt>HEPMDB</tt> as it will be used to alert you when a job has been completed.

=== Password ===
This is self-explanatory. Enter your password twice in order to avoid a typing error.

=== Affiliation ===
For our statistics, we require this field to be filled in. Typical affiliations include your university and the name of your laboratory.

=== Anti-spam digits ===
With your e-mail, this is the second way to check that it is not a bot registering. The numbers are usually pretty readable. If you cannot read them, please reload the webpage and a new code will be offered.

Calculate section

2014-08-20T13:51:01Z

Hepmdb: /* Running */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided in four parts:
# the upper bar, with general menus,
# the lower frame, with general information on the last operations,
# the left menu, with the main functions and the program list,
# the main part, presenting results of computation.

=== The upper menu ===
In the upper menu, you will find:
* A help button which opens this WIKI help page in a new tab
* The <tt>Go to HEPMDB</tt> button which opens the <tt>HEPMDB</tt> main page in a new tab
* The actual menu

Most of the menu commands are straight forward, although a selection have been explained in more detail here.
* <tt>Remove models</tt>: it removes all models that were imported. When a model has been updated, it is necessary to remove the old version this way. There is no option to remove models individually.
* <tt>Reset model list and clear results</tt>: This will reset everything to its default state. No results will be kept. You should make sure you have downloaded any results you need to keep before doing this.
* <tt>Show queue on HPCx</tt>: as <tt>HEPMDB</tt> is a shared resource, when you asked for a job, it is put in the queue. This button displays the whole queue.

=== The lower frame ===
The lower frame displays information about the most recent commands. The result of any command will be displayed here, except the computations themselves.

When something has been queued, it is necessary to refresh the display explicitly (through the <tt>Check submitted jobs</tt> button).

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The main part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load from</tt>: this allows the user to load the batch file from a file.
# <tt>Save</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and <tt>Menu</tt> drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2014-08-20T13:49:27Z

Hepmdb: /* The batch file */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided in four parts:
# the upper bar, with general menus,
# the lower frame, with general information on the last operations,
# the left menu, with the main functions and the program list,
# the main part, presenting results of computation.

=== The upper menu ===
In the upper menu, you will find:
* A help button which opens this WIKI help page in a new tab
* The <tt>Go to HEPMDB</tt> button which opens the <tt>HEPMDB</tt> main page in a new tab
* The actual menu

Most of the menu commands are straight forward, although a selection have been explained in more detail here.
* <tt>Remove models</tt>: it removes all models that were imported. When a model has been updated, it is necessary to remove the old version this way. There is no option to remove models individually.
* <tt>Reset model list and clear results</tt>: This will reset everything to its default state. No results will be kept. You should make sure you have downloaded any results you need to keep before doing this.
* <tt>Show queue on HPCx</tt>: as <tt>HEPMDB</tt> is a shared resource, when you asked for a job, it is put in the queue. This button displays the whole queue.

=== The lower frame ===
The lower frame displays information about the most recent commands. The result of any command will be displayed here, except the computations themselves.

When something has been queued, it is necessary to refresh the display explicitly (through the <tt>Check submitted jobs</tt> button).

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The main part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load from</tt>: this allows the user to load the batch file from a file.
# <tt>Save</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Full Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and Menu drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2014-08-20T13:45:58Z

Hepmdb: /* Using MadGraph */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided in four parts:
# the upper bar, with general menus,
# the lower frame, with general information on the last operations,
# the left menu, with the main functions and the program list,
# the main part, presenting results of computation.

=== The upper menu ===
In the upper menu, you will find:
* A help button which opens this WIKI help page in a new tab
* The <tt>Go to HEPMDB</tt> button which opens the <tt>HEPMDB</tt> main page in a new tab
* The actual menu

Most of the menu commands are straight forward, although a selection have been explained in more detail here.
* <tt>Remove models</tt>: it removes all models that were imported. When a model has been updated, it is necessary to remove the old version this way. There is no option to remove models individually.
* <tt>Reset model list and clear results</tt>: This will reset everything to its default state. No results will be kept. You should make sure you have downloaded any results you need to keep before doing this.
* <tt>Show queue on HPCx</tt>: as <tt>HEPMDB</tt> is a shared resource, when you asked for a job, it is put in the queue. This button displays the whole queue.

=== The lower frame ===
The lower frame displays information about the most recent commands. The result of any command will be displayed here, except the computations themselves.

When something has been queued, it is necessary to refresh the display explicitly (through the <tt>Check submitted jobs</tt> button).

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The main part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit full batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load from</tt>: this allows the user to load the batch file from a file.
# <tt>Save</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Full Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and Menu drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2014-08-20T13:45:41Z

Hepmdb: /* Using WHIZARD */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided in four parts:
# the upper bar, with general menus,
# the lower frame, with general information on the last operations,
# the left menu, with the main functions and the program list,
# the main part, presenting results of computation.

=== The upper menu ===
In the upper menu, you will find:
* A help button which opens this WIKI help page in a new tab
* The <tt>Go to HEPMDB</tt> button which opens the <tt>HEPMDB</tt> main page in a new tab
* The actual menu

Most of the menu commands are straight forward, although a selection have been explained in more detail here.
* <tt>Remove models</tt>: it removes all models that were imported. When a model has been updated, it is necessary to remove the old version this way. There is no option to remove models individually.
* <tt>Reset model list and clear results</tt>: This will reset everything to its default state. No results will be kept. You should make sure you have downloaded any results you need to keep before doing this.
* <tt>Show queue on HPCx</tt>: as <tt>HEPMDB</tt> is a shared resource, when you asked for a job, it is put in the queue. This button displays the whole queue.

=== The lower frame ===
The lower frame displays information about the most recent commands. The result of any command will be displayed here, except the computations themselves.

When something has been queued, it is necessary to refresh the display explicitly (through the <tt>Check submitted jobs</tt> button).

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The main part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit full batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load from</tt>: this allows the user to load the batch file from a file.
# <tt>Save</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Full Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and Menu drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2014-08-20T13:45:23Z

Hepmdb: /* Using CalcHEP */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided in four parts:
# the upper bar, with general menus,
# the lower frame, with general information on the last operations,
# the left menu, with the main functions and the program list,
# the main part, presenting results of computation.

=== The upper menu ===
In the upper menu, you will find:
* A help button which opens this WIKI help page in a new tab
* The <tt>Go to HEPMDB</tt> button which opens the <tt>HEPMDB</tt> main page in a new tab
* The actual menu

Most of the menu commands are straight forward, although a selection have been explained in more detail here.
* <tt>Remove models</tt>: it removes all models that were imported. When a model has been updated, it is necessary to remove the old version this way. There is no option to remove models individually.
* <tt>Reset model list and clear results</tt>: This will reset everything to its default state. No results will be kept. You should make sure you have downloaded any results you need to keep before doing this.
* <tt>Show queue on HPCx</tt>: as <tt>HEPMDB</tt> is a shared resource, when you asked for a job, it is put in the queue. This button displays the whole queue.

=== The lower frame ===
The lower frame displays information about the most recent commands. The result of any command will be displayed here, except the computations themselves.

When something has been queued, it is necessary to refresh the display explicitly (through the <tt>Check submitted jobs</tt> button).

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The main part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit full batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load from</tt>: this allows the user to load the batch file from a file.
# <tt>Save</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Full Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and Menu drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2014-08-20T13:44:46Z

Hepmdb: /* Using CalcHEP */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided in four parts:
# the upper bar, with general menus,
# the lower frame, with general information on the last operations,
# the left menu, with the main functions and the program list,
# the main part, presenting results of computation.

=== The upper menu ===
In the upper menu, you will find:
* A help button which opens this WIKI help page in a new tab
* The <tt>Go to HEPMDB</tt> button which opens the <tt>HEPMDB</tt> main page in a new tab
* The actual menu

Most of the menu commands are straight forward, although a selection have been explained in more detail here.
* <tt>Remove models</tt>: it removes all models that were imported. When a model has been updated, it is necessary to remove the old version this way. There is no option to remove models individually.
* <tt>Reset model list and clear results</tt>: This will reset everything to its default state. No results will be kept. You should make sure you have downloaded any results you need to keep before doing this.
* <tt>Show queue on HPCx</tt>: as <tt>HEPMDB</tt> is a shared resource, when you asked for a job, it is put in the queue. This button displays the whole queue.

=== The lower frame ===
The lower frame displays information about the most recent commands. The result of any command will be displayed here, except the computations themselves.

When something has been queued, it is necessary to refresh the display explicitly (through the <tt>Check submitted jobs</tt> button).

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The main part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit full batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load from</tt>: this allows the user to load the batch file from a file.
# <tt>Save</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Full Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and Menu drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2014-08-20T13:43:53Z

Hepmdb: /* The left menu */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided in four parts:
# the upper bar, with general menus,
# the lower frame, with general information on the last operations,
# the left menu, with the main functions and the program list,
# the main part, presenting results of computation.

=== The upper menu ===
In the upper menu, you will find:
* A help button which opens this WIKI help page in a new tab
* The <tt>Go to HEPMDB</tt> button which opens the <tt>HEPMDB</tt> main page in a new tab
* The actual menu

Most of the menu commands are straight forward, although a selection have been explained in more detail here.
* <tt>Remove models</tt>: it removes all models that were imported. When a model has been updated, it is necessary to remove the old version this way. There is no option to remove models individually.
* <tt>Reset model list and clear results</tt>: This will reset everything to its default state. No results will be kept. You should make sure you have downloaded any results you need to keep before doing this.
* <tt>Show queue on HPCx</tt>: as <tt>HEPMDB</tt> is a shared resource, when you asked for a job, it is put in the queue. This button displays the whole queue.

=== The lower frame ===
The lower frame displays information about the most recent commands. The result of any command will be displayed here, except the computations themselves.

When something has been queued, it is necessary to refresh the display explicitly (through the <tt>Check submitted jobs</tt> button).

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the result files of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The main part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit full batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load from</tt>: this allows the user to load the batch file from a file.
# <tt>Save</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Full Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and Menu drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2014-08-20T13:42:31Z

Hepmdb: /* The left menu */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided in four parts:
# the upper bar, with general menus,
# the lower frame, with general information on the last operations,
# the left menu, with the main functions and the program list,
# the main part, presenting results of computation.

=== The upper menu ===
In the upper menu, you will find:
* A help button which opens this WIKI help page in a new tab
* The <tt>Go to HEPMDB</tt> button which opens the <tt>HEPMDB</tt> main page in a new tab
* The actual menu

Most of the menu commands are straight forward, although a selection have been explained in more detail here.
* <tt>Remove models</tt>: it removes all models that were imported. When a model has been updated, it is necessary to remove the old version this way. There is no option to remove models individually.
* <tt>Reset model list and clear results</tt>: This will reset everything to its default state. No results will be kept. You should make sure you have downloaded any results you need to keep before doing this.
* <tt>Show queue on HPCx</tt>: as <tt>HEPMDB</tt> is a shared resource, when you asked for a job, it is put in the queue. This button displays the whole queue.

=== The lower frame ===
The lower frame displays information about the most recent commands. The result of any command will be displayed here, except the computations themselves.

When something has been queued, it is necessary to refresh the display explicitly (through the <tt>Check submitted jobs</tt> button).

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. This is where the commands to prepare, run and view the results of a process are stored. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The main part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit full batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load from</tt>: this allows the user to load the batch file from a file.
# <tt>Save</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Full Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and Menu drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2014-08-20T13:40:19Z

Hepmdb: /* Choosing a model */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided in four parts:
# the upper bar, with general menus,
# the lower frame, with general information on the last operations,
# the left menu, with the main functions and the program list,
# the main part, presenting results of computation.

=== The upper menu ===
In the upper menu, you will find:
* A help button which opens this WIKI help page in a new tab
* The <tt>Go to HEPMDB</tt> button which opens the <tt>HEPMDB</tt> main page in a new tab
* The actual menu

Most of the menu commands are straight forward, although a selection have been explained in more detail here.
* <tt>Remove models</tt>: it removes all models that were imported. When a model has been updated, it is necessary to remove the old version this way. There is no option to remove models individually.
* <tt>Reset model list and clear results</tt>: This will reset everything to its default state. No results will be kept. You should make sure you have downloaded any results you need to keep before doing this.
* <tt>Show queue on HPCx</tt>: as <tt>HEPMDB</tt> is a shared resource, when you asked for a job, it is put in the queue. This button displays the whole queue.

=== The lower frame ===
The lower frame displays information about the most recent commands. The result of any command will be displayed here, except the computations themselves.

When something has been queued, it is necessary to refresh the display explicitly (through the <tt>Check submitted jobs</tt> button).

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The main part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, the first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit full batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load from</tt>: this allows the user to load the batch file from a file.
# <tt>Save</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Full Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and Menu drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

Calculate section

2014-08-20T13:37:56Z

Hepmdb: /* The upper menu */

The [http://hepmdb.soton.ac.uk/validate/ Calculate section] of <tt>HEPMDB</tt> is accessible only if you are [[FAQ#How to register on HEPMDB?|registered]]. This wiki page will enable you to use the <tt>HEPMDB</tt> computation frame in order to produce events and compute cross-sections using the various models on the website.

__TOC__

== The interface ==
The interface is divided in four parts:
# the upper bar, with general menus,
# the lower frame, with general information on the last operations,
# the left menu, with the main functions and the program list,
# the main part, presenting results of computation.

=== The upper menu ===
In the upper menu, you will find:
* A help button which opens this WIKI help page in a new tab
* The <tt>Go to HEPMDB</tt> button which opens the <tt>HEPMDB</tt> main page in a new tab
* The actual menu

Most of the menu commands are straight forward, although a selection have been explained in more detail here.
* <tt>Remove models</tt>: it removes all models that were imported. When a model has been updated, it is necessary to remove the old version this way. There is no option to remove models individually.
* <tt>Reset model list and clear results</tt>: This will reset everything to its default state. No results will be kept. You should make sure you have downloaded any results you need to keep before doing this.
* <tt>Show queue on HPCx</tt>: as <tt>HEPMDB</tt> is a shared resource, when you asked for a job, it is put in the queue. This button displays the whole queue.

=== The lower frame ===
The lower frame displays information about the most recent commands. The result of any command will be displayed here, except the computations themselves.

When something has been queued, it is necessary to refresh the display explicitly (through the <tt>Check submitted jobs</tt> button).

=== The left menu ===
This is one of the most important menus in <tt>HEPMDB</tt>. The menu is divided in three panels. Each panel correspond to a specific program for computing matrix elements. <tt>CalcHEP</tt> and <tt>WHIZARD</tt> work essentially the same way. There are some subtle differences for <tt>MadGraph</tt>.

=== The main part ===
When the computation is done, the results will be displayed here. In case of an error, the debugging information is also displayed here.

== Using <tt>CalcHEP</tt> ==
Here, we will review the basic steps for a <tt>CalcHEP</tt> computation.

You can find a complete tutorial specifically for <tt>CalcHEP</tt> [[CalcHEP tutorial|HERE]].

=== Choosing a model ===
When using <tt>CalcHEP</tt>, you first thing you have to do is make sure that the model you wish to use is imported. If it is imported, you will see it in the left panel. If it is not there, click on the <tt>Import model</tt> option of the <tt>CalcHEP</tt> drop-down menu. You can import any model uploaded to <tt>HEPMDB</tt> including any you have uploaded previously.

When your model is imported (when you can see it in the left panel) choose it by selecting it. You are now ready to work with that model.

=== The batch file ===
On <tt>HEPMDB</tt>, you use the batch mode of <tt>CalcHEP</tt>. The batch file can be edited through the <tt>Edit full batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is a very useful option which loads the template file. The template file contains every possible option as well as some commented out sections which describe various parts of the batch file. Simply change the variables/values so that it calculates what you require and save it.
# <tt>Load from</tt>: this allows the user to load the batch file from a file.
# <tt>Save</tt>: this does not save to a file! Instead, it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
When your batch file is ready, you can queue the process thanks to the <tt>Run Full Batch File</tt> button. You can check the status of the queued process via <tt>Check submitted job</tt>. When the computation is done, results will be displayed in the central panel. If not, use the <tt>Check submitted job</tt> button, located in the <tt>CalcHEP</tt> drop down menu.
Previous results can been found using the history option which is found in both the <tt>CalcHEP</tt> and Menu drop down.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>WHIZARD</tt> ==
This only covers basic help. More comprehensive help is to come.

=== Choosing a model ===
On <tt>HEPMDB</tt>, <tt>WHIZARD</tt> usage is very similar to <tt>CalcHEP</tt>'s. You first have to import a model and choose it. Note that the <tt>WHIZARD</tt> models available to use are a lot less numerous than those on <tt>CalcHEP</tt>. Please upload your own models if you need to. You can import the model via the <tt>Import model</tt> button then select it in the list in order to use it.

=== The batch file ===
The batch file can be edited through the <tt>Edit batch file</tt> option.

Besides writing the batch, you have four options in the editing window:
# <tt>Load batch template</tt>: this is very useful as it loads a template file that contains every possible option. You then change the variables/values to suit your calculation.
# <tt>Load from</tt>: this enables you to load a batch file from a file.
# <tt>Save</tt>: this does not save to a file! But it tells <tt>HEPMDB</tt> to use the written batch file for computation.
# <tt>Save As</tt>: this only saves to a file. You still have to use the <tt>Save</tt> button to tell <tt>HEPMDB</tt> to use the batch file.

=== Running ===
To run <tt>WHIZARD</tt>, select the <tt>Run Whizard</tt> option. You then have the choice between queuing or not. It is recommended that you choose to queue the calculation, especially for long computation as that allows you to close your internet browser while it is running.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.

== Using <tt>MadGraph</tt> ==
<tt>MadGraph</tt> works slightly differently. Once again, more comprehensive help should be available soon.
If the help you require is not available here, please search for <tt>MadGraph</tt> specific help on the internet.

=== <tt>MadGraph</tt> cards ===
<tt>MadGraph</tt> works with ''cards''. There are four different cards each having a particular role:
# <tt>proc_card_mg5.dat</tt>: this defines the processes to be processed.
# <tt>param_card.dat</tt>: This holds the parameters about the model (decays, branching ratios). Note that this file is overwritten by <tt>MadGraph</tt> after event generation.
# <tt>run_card.dat</tt>: in this file, you define the parameters for the run, for example the energy of the beam or which pdf to use.
# <tt>plot_card.dat</tt>: With <tt>MadGraph</tt> it is possible to automatically produce some plots. But with the <tt>HEPMDB</tt> toolkit and lhe file, this is of little use.

For all of these files, templates are available, so you do not have to know every parameter. Filling these files and checking the different parameters should be enough in most cases.

=== Running ===
For running, just use the <tt>Run Madgraph</tt> button. For now, there is no queuing system for <tt>MadGraph</tt> so you must stay connected to <tt>HEPMDB</tt> website while computing.

If the job time set by the user is under 2 hours, the calculation will be given priority on HEPMDB.