CLUMPY  Version 2011.09_corr2
Introduction
________________________________________

I. What is CLUMPY?
This code is dedicated to the calculation of the J-factor from any DM distribution, i.e.:

• smooth DM halo in our Galaxy;
• sub-clump DM distribution in the Galaxy;
• any DM halo object (e.g. dwarf spheroidal galaxies in our Galaxy);
• sub-clumps DM distribution in any host halo.

and hopefully, more to come in the future (extragalactic, Sommerfeld enhancement, charged particles...)

II. Main ingredients

The focus of the code is on the astrophysical term (see below). For the various pieces of information required to do such calculations, we refer to:

• geometry.h - defines the geometry and coordinate transformations of the problem;
• inlines.h and misc.h - definitions and useful low-level functions;
• integr.h and integr_los.h - integration functions and algorithms;
• janalysis.h - J-term analyses (astrophysics);
• params.h - contains the user-defined input parameters;
• profiles.h and clumps.h - DM profiles and relationships for the clump distributions respectively;
• spectra.h - term (particle physics);
• stat.h - statistical operations (mean, variance) on several clump properties.
Remarks:
The .h contain the function definitions and the doxygen documentation, whereas the .cc contains the code, written in C/C++.

III. -ray flux and the J-factor: definitions and conversions

Studies of DM annihilations or decay involves both particle physics and astrophysics. The obvious difference of scales between the two fields and habits among the two communities have given rise to a plethora of notations and unit choices throughout the literature. This makes comparisons between studies particularly difficult. Below, we provide some explanatory elements and conversion factors to ease comparison between the different works published on the subject.

In CLUMPY, we define the differential -ray flux as integrated over the solid angle (in the direction , see here) as

Annihilating DM
The particle physics term (spectra.h) is

with is the velocity average annihilation cross-section, is the mass of the WIMP candidate, and is the -ray spectrum produced per annihilation. The astrophysics term is

with the dark matter density. The solid angle is simply related to the integration angle by

In our work, the units of these quantities are as follows:
• ;
• ;
• .

First of all, note that the location of the factor appearing in is arbitrary. We included it in the particle physics factor, but in other works, it can appear in the astrophysical factor J. Therefore, to compare the astrophysical factors between several studies, one must first ensure to correct the value of J by if needed. The conversion factor (once the issue is resolved) from our J units to that traditionally found in the literature are:

Before comparing any number, one must also ensure that the solid angle over which the integration is performed is the same. In most works, a angular resolution is chosen, corresponding to sr. However this is not always the case, as in the present study where we explore several angular resolutions.

Decaying DM
In that case, e.g., Bertone et al. (2007), the particle physics term is given by

with is the dark matter decay rate, and is the mass of the DM candidate. The astrophysics term is

In CLUMPY, the unit of is .

Instrument response
Note that in the above integrations, it is assumed that the instrument is 'perfect'. To take into account the PSF (instrumental response) in a skymap, the best route is to calculate the value at a resolution much better than the PSF, and post-process the result by convolving it with the appropriate instrument response. This is not included in CLUMPY.