%``ScannerS: Constraining the phase diagram of a complex scalar singlet at the LHC,''
Eur.\ Phys.\ J.\ C {\bf 73} (2013) 2428
[arXiv:1301.2599].
%%CITATION = ARXIV:1301.2599;%%
------------------------
2) Basic usage (xSM2) --
------------------------
2.1) input
To use the xSM2 class you need to:
- run $ ./ScannerS --model xSM2 (This will generate a xSM2.in file, alternatively you can copy the one in the examples folder).
- Edit xSM2.in to set the ranges for the parameters (masses, VeVs, couplings).
2.2) Printing the Output (ScannerSUserxSM2.cpp)
For a minimal run, for example, you just need to edit the xSM2::UserInitCalcs() and xSM2::what2print().
- In UserInitCalcs, you need to use the function setprint(int,int) to indicate how many values you want to print per point.
- In what2print, you need to indicate what those values are. You can for example output the VEVs, Masses, Mixings and couplings generated. You do so by adding them to points2print[store_vector_index][] vector.
If you want ot calculate and print anything besides the potential parameters, etc..., you can use the extra_data vector.
- In UserInitCalcs, resize the vector to the size you want (and use setprint() accordingly).
- In what2print, add them to the points2print[store_vector_index][] vector.
2.3) Rejecting points (ScannerSUserxSM2.cpp)
The xSM2 class already has both xSM2::CheckStability() and xSM2::CheckGlobal() implemented in the ScanerSUserxSM".cpp file, so points that fail those tests will automaticly be discarded. You can add any additional tests you want to the xSM2::UserAnalysis() function (as well as calculate any additional data for the print).
To compile the code with MicrOmegas, you need to set in the makefile the variable (otherwise leave blank):
MicromegasOn=ON
Furthermore you need to create a new project in the MicrOmegas installation directory and drop inside the ScannerS files and sub-directories (ScannerScore). Only after this step will you be able to compile the code since the makefile links MicrOmegas sources which are assumed to be one directory up (also check the MicrOmegas version in use in the ScannerS makefile and use the same version).
3.2) Superiso (http://superiso.in2p3.fr/)
To link Superiso you just need to indicate the correct path to the library in the makefile (if not in the standard search paths). Check the examples & the Superiso documentation for available functions
3.3) SusHi (http://sushi.hepforge.org/)
To link SusHi you need to indicate the correct path to the library in the makefile (if not in the standard search paths). SusHi is currently called to compute total cross-sections through a wrapped function & input file generating C++ functions. In the future other wrapped functions will be made available. Also check the examples.
Both HiggsBounds and HiggsSignals can be linked by indicating the correct path to the library in the makefile (if not in the standard search paths). All functions are available to be called (check declarations in ScannerScore/ExtInterfaces/HBWrap.h and ScannerScore/ExtInterfaces/HSWrap.h).
3.5) hdecay (arXiv:hep-ph/9704448)
Hdecay can be linked by indicating the correct path to the library in the makefile, and Wrapers were implement in ScannerScore/ExtInterfaces/ (HdecayWrap.h, HdecayWrap.f and HdecayWrapCppFuncs.cpp). Note however that this interface is not yet completely stable, so use it at your own risk.
---------------------
4) Examples (xSM2) --
---------------------
In the examples folder you can find two working analysis for this model. One in the broken phase (mixall) and one in the dark matter phase (DM). To run these examples copy the ScannerSUserxSM2.cpp file to the ScannerS working directory and run.
These examples not only print the basic potential information, but also use Hdecay to compute the branching ratios for the new particles. These are then used to impose limits on the potential using HiggsBounds and HiggsSignals.
In the DM phase, we also use micrOmegas to compute the relic density. In order to do so you will need to make a project folder in the micrOmegas directory and copy the calchep, lib and work folders into it as well as the full ScannerS program.
-----------------------
5) Command line help --
-----------------------
This is a copy of the command line help you get if you run:
$ ./ScannerS --help
**** HELP *****************************************
To compile and run the program do:
$ make
$ ./ScannerS -i input_file_name
To clean the compilation do
$ make clean
To run the program in verbose mode, uncomment the following line in the makefile:
#MODE=-DVERBOSE
by removing the hash, i.e.
MODE=-DVERBOSE
Other runtime options are :
-i input_file_name
**************************************
Specify the Mathematica produced input file name where to read the potential from.
-o output_file_name [this is optional]
**************************************
Redirect cout to write the results of the scan to the the output file specified. Otherwise the file model.out is created.
--nscan number_of_points_to_generate [this is optional]
**************************************
Specify the number of points to be generated. If not provided, 1 point will be generated.
--seed seed_value [this is optional]
**************************************
Specify the seed for the pseudo-random number generator. If not provided, 0 will be used.
--log log_file_name [this is optional]
**************************************
Redirect clog to write the information printed on screen for the user, to the the log file specified.
--err err_file_name [this is optional]
**************************************
Redirect cerr to write the errors printed on screen for the user, to the the error file specified.
--model model_name [this is optional]
**************************************
Generates an input file to the specified type (currently xSM2 and 2HDM).
NOTE: The default output file is created with the name model.out
Compile in verbose mode: If you want to recompile the code in verbose mode with very detailed info of each point that was attempted, follow these steps:
$make clean
$make MODE=-DVERBOSE
**** END OF HELP *****************************************