Skip to content

Input Files and Formatting

Jump to bottom
Pearl Sandick edited this page Apr 2, 2020 · 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 [Geringer-Sameth, Koushiappas, & Walker (2013) and Simon et al. (2015) as collected in Albert et al. (2017)]
Set1a.dat
Set1b.dat
Set1c.dat
Set2.dat [Evans, Sanders, & Geringer-Sameth (2016)]
Set3.dat [Hayashi et al. (2016)]
Set4.dat [Ichikawa et al. (2017) and (2018)]
Set5.dat [Boddy et al. (2017)]
Set6.dat [Pace & Strigari (2018)]
Set7.dat [Petac, Ullio, & Valli (2018)]

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
# Ref:
#
# ID: ID of dwarf galaxy to be analyzed
# J: log10 of the J-factor [GeV^2 cm^-5] for the dwarf galaxy
# +dJ: positive error in log10(J)
# -dJ: negative error in log10(J)
###########################################################
# ID          J       +dJ    -dJ
46	    19.41     .39    .40

where ID indicates the dwarf ID number (see Dwarf ID Numbers), 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 46 (Segue 1):
Log10(J)=19.41
Log10(J+dJ)=19.41+0.39
Log10(J-dJ)=19.41-0.40

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.

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 (b bbar from PPPC4DMID)
# Ref: M. Cirelli et al. [arXiv:1012.4515]; P. Ciafaloni et al. [arXiv:1009.0224]
#
# 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 dark matter annihilation to unpolarized two-body final states of b quarks, W bosons, muon pairs, and tau pairs, as calculated with PPPC4DMID.

Clone this wiki locally