\section{THE DRAGON PACKAGE}\label{sect:DragonExportPackage}

The following archive is required to install DRAGON:

\begin{verbatim}
Version5_evn.tgz
\end{verbatim}

\vskip 0.08cm

Information is recovered from the archive using
\begin{verbatim}
tar xvfz Version5_evn.tgz
\end{verbatim}

\noindent The {\tt tar xvfz} operations will create a directory named {\tt Version5\_evn}. Another directory named {\tt
libraries} should also be created at the same level to hold cross section libraries. Directory {\tt libraries} is
generally a symbolic link to an existing location. The complete setup is depicted in \Fig{tree2}.

\begin{figure}[h!]  
\begin{center} 
\epsfxsize=10cm \centerline{ \epsffile{distributionTree.eps}}
\parbox{16cm}{\caption{Distribution content.}\label{fig:tree2}}    
\end{center}  
\end{figure}

Directory {\tt Version5} contains the information required to install and configure
DRAGON. It is a copy of the {\sl Subversion Working Copy} used by the developers of the
code. Inside {\tt Version5\_evn} is a file named {\tt readme} that contain the
information required to configure DRAGON on your system. This configuration
process has the effect to add a few directories and binary files to the
{\tt Version5\_evn} directory.

\vskip 0.08cm

Starting with version 5.0.5, it is possible to perform a basic installation on a Unix-based system
using makefiles. {\sl Note:} On AIX and Solaris OS, you must replace {\tt make} with {\tt gmake} (the
GNU variant of {\tt make} utility). To install Dragon, simply do
\begin{verbatim}
cd ~/Version5_evn/Dragon/
make
make clean
\end{verbatim}

To speed up the build, run make with multiple jobs using the \texttt{-jN} option.  For example, to run 8 parallel jobs:
\begin{verbatim}
make -j8
make clean
\end{verbatim}

\noindent To build an OpenMP-enabled version, simply write
\begin{verbatim}
make openmp=1
\end{verbatim}

\noindent To build an HDF5-enabled version, simply write
\begin{verbatim}
make hdf5=1
\end{verbatim}

\noindent To execute the Dragon non-regression tests, do
\begin{verbatim}
make tests
\end{verbatim}

\vskip 0.08cm

On Windows, Version5 components an be build in two possible ways:
\begin{itemize}
\item  A native build is possible, provided that {\sl Microsoft Visual Studio} and {\sl Intel Visual Fortran} are available.
A script named {\tt instver5.bat} is available to create executables ({\tt .exe}) from a MS-DOS command
window. Follow the following steps:
\begin{itemize}
\item Click {\sl Start}, point to {\sl All Programs}, {\sl Intel(R) Software Development Tools}, {\sl Intel(R) Visual Fortran
Compiler Professional} and finally {\sl Fortran Build Environment for applications running on IA-32}. The Visual Studio Command Prompt
automatically sets the correct paths of both C and Fortran compilers, together with their associated libraries.
\item In the command window, type:
\begin{verbatim}
md %homepath%\Version5_evn\
\script\instver5
\end{verbatim}
\end{itemize}
\item  A ``Unix-type" build is possible, provided that Cygwin\cite{cygwin} or {\sl Windows Subsystem for Linux} (WSL)\cite{wsl} is
properly installed on your PC. Cygwin and WSL are native implementations of a {\sl Unix shell}. After installation of Cygwin or WSL, you
obtain a native Unix terminal window where all Version5 components can be executed. The DRAGON installation must proceed in the shell.
\end{itemize}

\vskip 0.08cm

Directory {\tt libraries} contains open-source Draglibs that can be used to
test your implementation. This directory must me installed as shown in \Fig{tree2}
{\sl before} following the instructions of the {\tt readme} file for executing
multigroup tests. The script named
{\tt tdraglib.access} is automatically executed by the {\tt rdragon} script when
no other {\tt *.access} script is provided. The {\tt tdraglib.access} script creates
a symbolic link between the draglib {\tt draglibJef2p2} and file {\tt DLIB\_J2}
used in the {\tt tdraglib.x2m} and {\tt trowland.x2m} non-regression tests.

\vskip 0.08cm

The content of the {\tt readme} file follows:

\listfile{readme}