Skip to content

Input Files and Formatting

Jump to bottom
Pearl Sandick edited this page Oct 4, 2019 · 11 revisions

As described in Running MADHHAT, MADHAT can run with two, three, or four arguments. Dwarf Set Files and Dark Matter Model Files are described in detail below. Arguments to the MADHAT executable include the following:

  • [dwarfset.dat] is a file containing the parameters for the dwarfs the user would like to analyze and must be located in the directory Input. This file must contain, at a minimum, the ID numbers for the dwarfs to be considered. It may also contain J-factors for each dwarf and J-factor errors. Note that errors are not necessary, and if omitted, errors on output quantities PhiPP and sigv will print as zeros. Similarly, if the file only contains dwarf ID numbers, PhiPP will also print as zero. There are ten pre-defined dwarf set files included in the MADHAT package, plus a template file, SetTemplate.dat.
  • [beta] is a number between zero and one that specifies the confidence level (e.g., 0.95 for 95% C.L.).
  • [model.in] is a file containing a list of dark matter masses and integrated photon spectra, each of which must be floating point numbers, and must be located in the directory Input. There are four files of this type included in the MADHAT package: DMbb.in, DMWW.in, DMmumu.in, and DMtautau.in, which are basic model files for dark matter annihilation to pairs of b quarks, W bosons, muons, and taus, respectively. We also include a template/test file, dmtest.in.
  • The dark matter mass and integrated photon spectrum for a single model point may also be specified directly as arguments to the executable (Run Option B). In this case, both quantities must be positive floating point numbers.

Dwarf Set Files

PMFs for 58 dwarfs and dwarf candidates determined with Fermi-LAT Pass 8R3 are included in the MADHAT 1.0 distribution. There are ten pre-defined dwarf sets, including selected dwarfs and J-factors for each, located in the directory Input:
Set1.dat ref
Set1a.dat
Set1b.dat
Set1c.dat
Set2.dat ref
Set3.dat ref
Set4.dat ref, ref
Set5.dat ref
Set6.dat ref
Set7.dat ref

To define a new dwarf set or enter new J-factor values, use the template SetTemplate.dat, which is a space-separated table of the following form:

############################################################
# MADHAT (Model-Agnostic Dark Halo Analysis Tool) 
# Dwarf Set: Template
#
# ID: Identify the Dwarf Galaxy to be analyzed
# J: Log10 of the J-factor, for J-factors specified in units of [GeV^2 cm^-5]
# +dJ: positive error in Log10(J)
# -dJ: negative error in Log10(J)
###########################################################
# ID    J       +dJ    -dJ
6	    20.76    	.24   	.30
10	   21.51	    .31	   .24
14	   20.99    1.08	   .37
23.  	20.57	    .36	   .21
24	   20.58    	.48   	.35
35.  	21.37    	.34	   .28
38	   20.54   	2.15	   .39
46	   21.63	    .44	   .28

where ID indicates the dwarf ID number (see Dwarf ID Numbers below), J is the Log10 of the J-factor, for J-factors specified in units of [GeV^2 cm^-5], and +/-dJ is the error in Log10(J). For example, for dwarf ID 10:
Log10(J)=21.51
Log10(J+dJ)=21.51+0.31
Log10(J-dJ)=21.51-0.24

A dwarf set file must contain, at a minimum, the ID numbers for the dwarfs to be considered. It may also contain J-factors for each dwarf and J-factor errors. Note that errors are not necessary, and if omitted, errors on PhiPP will print as zeros. Similarly, if the file only contains dwarf ID numbers, PhiPP will also print as zero. There are ten dwarfset.dat files included in the MADHAT package, plus a template file, SetTemplate.dat.

Note that all input files must end with a line of data (no additional newlines). Please reserve filenames SetN.dat, where N are integers, for dwarf sets defined in future versions of MADHAT.

Dark Matter Model Files

The input file model.in must be located in the Input directory, and should have the following format:

############################################################
# MADHAT (Model-Agnostic Dark Halo Analysis Tool) 
# Dark Matter Model File: dmtest
#
# mass: DM mass in GeV
# spectrum: photon energy spectrum integrated from 1 to 100 GeV
###########################################################
# mass (GeV)   spectrum (1-100 GeV)
10      0.8734
50      7.7765
100     13.6097
500     33.6607

where the mass is a floating point number that specifies the dark matter mass in GeV and energy spectrum (1-100 GeV) is a floating point number that specifies the integrated photon energy spectrum between 1 and 100 GeV. This file can be of arbitraty length, and must end with a line of data (no additional newlines). The MADHAT package includes the dmtest.in template file, as well as four dark matter model files for two-body annihilation to b quarks, W bosons, muon pairs, and tau pairs.

Clone this wiki locally