\subsection{The {\tt NAP:} module}\label{sect:NAPData}

The \moc{NAP:} module supplies the main transport-diffusion equivalence options to DRAGON and DONJON. It can be
used to perform the pin power reconstruction.\cite{Chambon2014,Fliscounakis2011} The calling specifications are:

\begin{DataStructure}{Structure \dstr{NAP:}}
\dusa{COMPO} \moc{:=} \moc{NAP:} \dusa{COMPO} \dusa{TRKNAM} \dusa{FLUNAM} \moc{::} \dstr{descnap1} \\
\dusa{MAP} \moc{:=} \moc{NAP:} \dusa{MAP} \dusa{TRKNAM} \dusa{FLUNAM} \dusa{MATEX} \dusa{MAPPIN} \dusa{MACFPIN} \moc{::} \dstr{descnap2} \\
\dusa{GEONEW} \moc{:=} \moc{NAP:} \dusa{GEOOLD} \dusa{COMPO} \moc{::} \dstr{descnap3} \\
\end{DataStructure}

\noindent
where
\begin{ListeDeDescription}{mmmmmmmm}

\item[\dusa{COMPO}] {\tt character*12} name of the \dds{multicompo} data
structure ({\tt L\_COMPO} signature) where the detailed subregion properties will be stored.

\item[\dusa{TRKNAM}] {\tt character*12} name of the read-only \dds{tracking} data
structure ({\tt L\_TRACK} signature) containing the tracking. 

\item[\dusa{FLUNAM}] {\tt character*12} name of the read-only \dds{fluxunk} data
structure ({\tt L\_FLUX} signature) containing a transport solution.

\item[\dusa{MAP}] {\tt character*12} name of the \dds{map} data
structure ({\tt L\_MAP} signature) containing fuel regions description, global and
local parameter information (burnup, fuel/coolant temperatures, coolant density, etc).
Keyword \moc{PPR} is expected in \dstr{descnap2}.

\item[\dusa{MATEX}] {\tt character*12} name of the read-only \dds{matex} data
structure ({\tt L\_MATEX} signature). The object corresponds to the heterogeneously splited geometry. Keyword \moc{PPR} is expected in \dstr{descnap2}.

\item[\dusa{MAPPIN}] {\tt character*12} name of the \dds{map} data
structure ({\tt L\_MAP} signature) containing fuel regions description, global and
local parameter information (burnup, fuel/coolant temperatures, coolant density, etc). The object corresponds to the pin by pin splited geometry. 
Keyword \moc{PPR} is expected in \dstr{descnap2}.

\item[\dusa{MACFPIN}] {\tt character*12} name of the read-only \dds{macrolib} data
structure ({\tt L\_MACROLIB} signature) containing a cross-section for the fuel at pin level. Keyword \moc{PPR} is expected in \dstr{descnap2}.

\item[\dusa{GEONEW}] {\tt character*12} name of the created \dds{geometry} data
structure ({\tt L\_GEOM} signature) containing the detailed core geometry definition at heterogeneous assembly level.

\item[\dusa{GEOOLD}] {\tt character*12} name of the read-only \dds{geometry} data
structure ({\tt L\_GEOM} signature) containing the core geometry definition with homogeneous assembly (only 1 mesh per assembly mandatory).

\item[\dstr{descnap1}] structure containing the input data to this module to compute additional properties for subregions
(see \Sect{descnap1}).

\item[\dstr{descnap2}] structure containing the input data to this module to perform pin power reconstruction
(see \Sect{descnap2}).

\item[\dstr{descnap3}] structure containing the input data to this module to automatically define the core geometry with heterogeneous assembly
(see \Sect{descnap3}).

\end{ListeDeDescription}

\clearpage
\subsubsection{Additional properties calculations}\label{sect:descnap1}

\begin{DataStructure}{Structure \dstr{descnap1}}
$[$ \moc{EDIT} \dusa{iprint} $]$ \\
\moc{PROJECTION}\\
 \moc{DPIN} \dusa{namepin} \\
$[$ \moc{IFX} \dusa{ifx} $]$ \\
$\{$ $[[$ \moc{SET} \dusa{pname} \dusa{pvalue} $]]$ $\}$ \\
;
\end{DataStructure}

\noindent where

\begin{ListeDeDescription}{mmmmmmmm}

\item[\moc{EDIT}] keyword used to modify the print level \dusa{iprint}.

\item[\dusa{iprint}] integer index used to control  the printing in module {\tt NAP:}.
=0 for no print; =1 for minimum printing (default value); larger values of \dusa{iprint}
will produce increasing amounts of output.

\item[\moc{PROJECTION}] keyword to specify that additional properties for subregions will be computed and stored in the \dds{multicompo} data-structure \dusa{COMPO}.

\item[\moc{DPIN}] keyword to specify \dusa{namepin}. 

\item[\dusa{namepin}] name of the directory containing the pin-wise homogenized cross-sections. 

\item[\moc{IFX}] keyword to specify \dusa{ifx}. 

\item[\dusa{ifx}] number used to create the name of the flux record representing $\psi_{m,p}^{d,\infty}$. This flux represents the results of calculation in an infinite domain computed in diffusion with cross-sections homogenized either homogeneously or heterogeneously. One record is associated with each type of homogenization when the \dds{multicompo} is created. Thus \dds{multicompo} can be "enriched" several times, each time using a different homogenization of the assembly at the end of the transport calculations. The following format is used for the flux record name (\verb+RECNAME+): \\
\verb+WRITE(RECNAME,'5HFINF_,I3.3') IFX+\\
Thus, for example for \dusa{ifx}=2, \verb+RECNAME+ would be \verb+FINF_002+.

\item[\moc{SET}] keyword to specify assembly calculations at which $\psi_{m,p}^{d,\infty}$ have been calculated. Repeated as many times as there are parameters in the \dds{multicompo}.

\item[\dusa{pname}] name of the parameter in the \dds{multicompo}. 

\item[\dusa{pvalue}] value of the parameter in the \dds{multicompo}. 

\end{ListeDeDescription}

\clearpage

\subsubsection{Pin power reconstruction}\label{sect:descnap2}

\begin{DataStructure}{Structure \dstr{descnap2}}
$[$ \moc{EDIT} \dusa{iprint} $]$ \\
\moc{PPR}\\
\moc{NBPIN} \dusa{npin} \moc{NZASS} \dusa{nzass}  \moc{DIM} \dusa{spin}  \dusa{sgap} \\
\moc{METH}  %$\{$  \\
     \moc{GPPR} \dusa{ifx} %$\}$
%$\{$ \moc{SLGUT} $[[$ \dusa{ncompo} \dusa{nameslg} $]]$ $\}$
%$\{$ \moc{SLGGP} $[[$ \dusa{ncompo} \dusa{namesgp} $]]$ $\}$
\\
$[$ \moc{POWER} \dusa{pow} $]$ \\
;
\end{DataStructure}

\noindent where

\begin{ListeDeDescription}{mmmmmmmm}

\item[\moc{EDIT}] keyword used to modify the print level \dusa{iprint}.

\item[\dusa{iprint}] index used to control the printing of this module. The
\dusa{iprint} parameter is important for adjusting the amount of data that is
printed by this calculation step:

\begin{itemize}

\item \dusa{iprint}=0 results in no output;

\item \dusa{iprint}=1 ...

\end{itemize}

\item[\moc{PPR}] keyword to perform pin power reconstruction and stored results in the \dds{map} data-structure \dusa{MAP}.

\item[\moc{NBPIN}] keyword to specify \dusa{npin}. 

\item[\dusa{npin}] number of pin per side of assembly (ex. for a 17x17 assembly, \dusa{npin} =17). 

\item[\moc{NZASS}] keyword to specify \dusa{nzass}. 

\item[\dusa{nzass}] number of mesh in Z direction along assemblies. 

\item[\moc{DIM}] keyword to specify \dusa{spin}. 

\item[\dusa{spin}] pin lattice-pitch (cm). 

\item[\dusa{sgap}] water gap size (cm). 

\item[\moc{METH}] keyword to select the type of methodology used for pin power reconstruction.

\item[\moc{GPPR}] keyword to select the generalized pin power reconstruction from an heterogeneous assembly definition (several mixtures per assembly). Note that if there is only one mixture (homogeneous assembly) this method is actually the regular pin power reconstruction.

\item[\dusa{ifx}] number used to create the named of the flux record representing $\psi_{m,p}^{d,\infty}$. See Sect. \ref{sect:descnap1} for more details.

\item[\moc{POWER}] keyword used to normalize the flux. If this keyword is not used, the flux directly computed by the \moc{FLUD:} is used to perform the pin-power reconstruction,  then normalization has to be performed by the user indepently. 

\item[\dusa{pow}] power used to normalize the flux (MW). 

\end{ListeDeDescription}

\goodbreak

\subsubsection{Heterogeneous assembly geometry definition}\label{sect:descnap3}

\begin{DataStructure}{Structure \dstr{descnap3}}
$[$ \moc{EDIT} \dusa{iprint} $]$ \\
\moc{DIRGEO} \dusa{namedir} \\
\moc{MIXASS} \dusa{nmix} (\dusa{imix}(i), i=1,\dusa{nmix})  \\
$[$ \moc{SLPITX-ASS} (\dusa{ispx}(i), i=1,\dusa{nxass}) $]$ \\
$[$ \moc{SLPITY-ASS} (\dusa{ispy}(i), i=1,\dusa{nyass}) $]$ \\
$[$ \moc{MAX-MIX-GEO} \dusa{nmxgeo} $]$ \\
;
\end{DataStructure}

\noindent where

\begin{ListeDeDescription}{mmmmmmmm}

\item[\moc{EDIT}] keyword used to modify the print level \dusa{iprint}.

\item[\dusa{iprint}] index used to control the printing of this module. The
\dusa{iprint} parameter is important for adjusting the amount of data that is
printed by this calculation step:

\begin{itemize}

\item \dusa{iprint}=0 results in no output;

\item \dusa{iprint}=1 ...

\end{itemize}

\item[\moc{DIRGEO}] keyword to specify \dusa{namedir}. 

\item[\dusa{namedir}] name of the directory containing the heterogeneously homogenized cross-sections. 

\item[\moc{MIXASS}] keyword to specify mixtures corresponding to assembly in the coarse geometry. 

\item[\dusa{nmix}] number of type of assembly. 

\item[\dusa{imix}] mixture number of the assemblies.

\item[\moc{SLPITX-ASS}] keyword to specify the mesh splitting at assembly level. 

\item[\dusa{ispx}] split along x-direction for each mesh of the heterogeneous assembly. 

\item[\dusa{nxass}] number of mesh of the heterogeneous assembly along x-direction. 

\item[\moc{SLPITY-ASS}] keyword to specify the mesh splitting at assembly level. 

\item[\dusa{ispy}] split along y-direction for each mesh of the heterogeneous assembly. 

\item[\dusa{nyass}] number of mesh of the heterogeneous assembly along y-direction. 

\item[\moc{MAX-MIX-GEO}] keyword to specify the number of mixtures in the original core geometry (i.e. before the core geometry is splited by the \moc{NAP:} module). This keyword is mandatory if there is a reflector in the geometry otherwise the numbers for fuel mixtures will not match between the split core geometry (\dds{geometry}) and the split fuel geometry (\dds{geometry} embedded in \dds{map}).

\item[\dusa{nmxgeo}] number of mixtures in the original core geometry. 

\end{ListeDeDescription}

{\bf Note: The included geometry in the \dusa{COMPO} has to be unfolded, even if the transport calculations are done on a 1/8th assembly. Moreover no split can be defined in the geometry, one mesh ONLY per heterogeneous mixture  is mandatory.} 

\eject
