DRAGON Documentation: Index Page

1.0.0

For updated versions please refer to our HepForge page: http://dragon.hepforge.org

Introduction

The CR propagation equation from a continuos distribution of sources can be written in the general form

\[ \frac{\partial N^i}{\partial t} - {\nabla}\cdot \left( D\,{\nabla} -v_{c}\right)N^{i} + \frac{\partial}{\partial p} \left(\dot{p}-\frac{p}{3}{\nabla}\cdot{v}_{c}\right) N^i -\frac{\partial}{\partial p} p^2 D_{pp} \frac{\partial}{\partial p} \frac{N^i}{p^2} = Q^{i}(p,r,z) + \sum_{j>i}c\beta n_{\rm gas}(r,z) \sigma_{ji}N^{j} - c\beta n_{\rm gas}\sigma_{\rm in}(E_{k})N^{i} \]

Here $N^i(p,r,z)$ is the number density of the $i$-th atomic species; $p$ is its momentum; $\beta$ its velocity in units of the speed of light $c$; $\sigma_{in}$ is the total inelastic cross section onto the ISM gas, whose density is $n_{\rm gas}$; $\sigma_{ij}$ is the production cross-section of a nuclear species $j$ by the fragmentation of the $i$-th one; $D$ is the spatial diffusion coefficient; $v_{c}$ is the convection velocity. The last term on the l.h.s. describes diffusive reacceleration of CRs in the turbulent galactic magnetic field.

DRAGON adopts a second-order Cranck-Nicholson scheme with Operator Splitting and time overrelaxation to solve the diffusion equation. This provides fast a solution that is enough accurate for the average user. Occasionally, users may want to have very accurate solutions to their problem. To enable this feature, users may get close to the accurate solution by using the fast method, and then switch to a more accurate solution scheme, featuring the Alternating-Direction-Implicit (ADI) Cranck-Nicholson scheme.

Some parts of DRAGON are built following GALPROP, v50p. The first reason is that it is a waste of time to reimplement standard parts, like energy losses, in which nothing new has to be found. The second reason is that it is essential to be able to compare our predictions with that of the Galprop code, and this can be done only by following the details of its implementation. Therefore, we kept in the code some features and models used in Galprop, like nuclear cross-sections, the gas distribution, the convergence "technique". However, each of these models is accompanied by other models, which can be selected by setting the appropriate switch. This is done very easily using the well known C++ structure of abstract/derived classes. The code is then very flexible and easy to manage and to modify or update.

The code was built having in mind a few motivations:

Installation

DRAGON comes with one library and one executable. The library contains the whole structure that is used to solve the CR propagation equation, and can be linked against other programs exploiting DRAGON classes. The executable is the result of coupling the DRAGON library with a driver routine, which reads user's input and solves the transport equation.

Step 1: Download and unpack the code.

DRAGON can be found here.

Then just tar xfz DRAGON.tar.gz

Step 2: Run the configure macro.

configure needs some input from the user. User must tell configure where some external libraries are located. DRAGON requires GSL libraries and the CFITSIO library. It also optionally requires DarkSUSY, if user wants to propagate DM originated cosmic rays.

A typical command line is:

./configure --with-gsl-path=<PATH_TO_GSL_EXEC> --with-cfitsio-include=<PATH_TO_CFITSIO_INCLUDE_FILES> --with-cfitsio-library=<PATH_TO_CFITSIO_LIBRARY> FFLAGS='-fPIC'

This will preset DRAGON to propagate astrophysically generated cosmic rays. If user wants instead to propagate DM originated cosmic rays, then he should configure with the following command line:

./configure --with-gsl-path=<PATH_TO_GSL_EXEC> --with-cfitsio-include=<PATH_TO_CFITSIO_INCLUDE_FILES> --with-cfitsio-library=<PATH_TO_CFITSIO_LIBRARY> FFLAGS='-fPIC' --with-ds-include=<PATH_TO_DARKSUSY_INCLUDE_FILES> --with-ds-library=<PATH_TO_DARKSUSY_LIBRARY_FILES>

In this case DRAGON will only propagate DM originated cosmic rays. The default installation path is in the same folder as the source code is (the program automatically creates the bin/ and lib/ subfolders). It can be set via --prefix=<NEW_INSTALLATION_PATH>

Step 3: Compile the code.

Just run make and make install. The executable will be in $PREFIX/bin.

Step 4: Enjoy DRAGON.

Run $PREFIX/bin/DRAGON <argument_list>

Examples

 All Classes Namespaces Files Functions Variables Enumerations Enumerator
Generated on Mon Sep 27 12:59:56 2010 for DRAGON by  doxygen 1.6.3