From 7dfcc480ba1e19bd3232349fc733caef94034292 Mon Sep 17 00:00:00 2001 From: stainer_t Date: Mon, 8 Sep 2025 13:48:49 +0200 Subject: Initial commit from Polytechnique Montreal --- doc/IGE344/SectDEVINI.tex | 233 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 233 insertions(+) create mode 100644 doc/IGE344/SectDEVINI.tex (limited to 'doc/IGE344/SectDEVINI.tex') diff --git a/doc/IGE344/SectDEVINI.tex b/doc/IGE344/SectDEVINI.tex new file mode 100644 index 0000000..af9158d --- /dev/null +++ b/doc/IGE344/SectDEVINI.tex @@ -0,0 +1,233 @@ +\subsection{The \moc{DEVINI:} module}\label{sect:dev} + +\vskip 0.2cm +The \moc{DEVINI:} module is used for the modeling of reactivity mecanisms, based +on the devices specifications which are read from the input data file. The module will +create a new \dds{device} object that will store the devices specifications and +parameters (see \Sect{device}). Note that only the rod-type (i.e. solid) devices are +considered using the \moc{DEVINI:} module; the liquid zone controllers can be added +subsequently, using the \moc{LZC:} module (see \Sect{lzc}). A rod-type device is a +reactivity controller rod (or plate), such as: a zone control rod (ZCR), a shutoff rod (SOR), +etc. Several devices parameters can be modified using the \moc{DSET:} module (see \Sect{dset}).\\ + +A device specification includes several controller rod parameters, such as: a rod position, +rod insertion level, direction of movement, etc. The devices positions can not overlap in +the reactor core; they are referred using \dusa{3-D}-Cartesian coordinates. The insertion +level of rods can be set according to their nominal positions or they can be displaced +\dusa{in} or \dusa{out} of core. The rods can also be divided into the several user-defined +groups so that they can be manipulated, displaced or moved simultaneously.\\ + +\noindent +The \moc{DEVINI:} module specification is: + +\begin{DataStructure}{Structure \moc{DEVINI:}} +\dusa{DEVICE} \dusa{MATEX} \moc{:=} \moc{DEVINI:} +\dusa{MATEX} \moc{::} \dstr{descdev} +\end{DataStructure} + +\noindent where + +\begin{ListeDeDescription}{mmmmmmmm} + +\item[\dusa{DEVICE}] \texttt{character*12} name of the \dds{device} object +that will be created by the module; it will contain the devices information. + +\item[\dusa{MATEX}] \texttt{character*12} name of the \dds{matex} object +that will be updated by the module. The rod-devices material mixtures are +appended to the previous material index and the rod-devices indices are +also modified, accordingly. + +\item[\dstr{descdev}] structure describing the input data to the +\moc{DEVINI:} module. + +\end{ListeDeDescription} + +\vskip 0.2cm + +\subsubsection{Input data to the \moc{DEVINI:} module}\label{sect:devstr} + +The \moc{DEVINI:} module allows the definition of rod-type devices made of one or many (up to 10) parts, +as depicted in Fig.~\ref{fig:rod}. + +\begin{figure}[h!] + \begin{center} + \includegraphics[scale=0.7]{Figures/rod.eps} +\caption{Presentation of fully- and partially-inserted 3-part control rods.}\label{fig:rod} + \end{center} +\end{figure} + +\begin{DataStructure}{Structure \dstr{descdev}} +$[$ \moc{EDIT} \dusa{iprint} $]$\\ +\moc{NUM-ROD} \dusa{nrod} $[~\{$ \moc{FADE} $|$ \moc{MOVE} $\}~]$ \\ +( \dstr{dev-rod}, i = 1, \dusa{nrod} ) \\ +$[$ \moc{CREATE} \moc{ROD-GR} \dusa{ngrp} ( \dstr{rod-group}, i = 1, \dusa{ngrp} ) $]$ \\ +; +\end{DataStructure} + +\noindent where +\begin{ListeDeDescription}{mmmmmmmm} + +\item[\moc{EDIT}] keyword used to set \dusa{iprint}. + +\item[\dusa{iprint}] integer index used to control the printing on screen: += 0 for no print; = 1 for minimum printing (default value); larger values +produce increasing amounts of output. + +\item[\moc{NUM-ROD}] keyword used to specify \dusa{nrod}. + +\item[\dusa{nrod}] integer total number of the reactor rod-type devices. +This number must be greater than 0. + +\item[\moc{FADE}] fading rod keyword. A fraction of the fully inserted rod vanishes (default option). + +\item[\moc{MOVE}] moving rod keyword. The complete rod is moving (DONJON3-type movement). + +\item[\moc{CREATE}] keyword used to create the rod-groups of devices. +The creation of groups is optional. + +\item[\moc{ROD-GR}] keyword used to set \dusa{ngrp}. + +\item[\dusa{ngrp}] integer total number of the rod groups to be created. +This number must be greater than 0. + +\item[\dstr{dev-rod}] structure describing the input data for each individual rod. + +\item[\dstr{rod-group}] structure describing the input data for each group of rods. + +\end{ListeDeDescription} + +\vskip 0.2cm + +\subsubsection{Description of dev-rod input structure}\label{sect:devrodstr} + +A rod position is referred by its \dusa{3-D} Cartesian coordinates only. +Note that the devices positions can not overlap. The input order of data +must be respected. + +\begin{DataStructure}{Structure \dstr{dev-rod}} + +\moc{ROD} \dusa{id} \\ +~~\moc{ROD-NAME} \dusa{NAME} \\ +~~\moc{AXIS} $\{$ \moc{X} $|$ \moc{Y} $|$ \moc{Z} $\}$ \\ +~~\moc{FROM} $\{$ \moc{H+} $|$ \moc{H-} $\}$ \\ +~~$[$ \moc{LEVEL} \dusa{value} $]$ \\ +~~$[$ \moc{SPEED} \dusa{speed} $]$ \\ +~~$[$ \moc{TIME} \dusa{time} $]$ \\ +~~$[[$ \moc{MAXPOS} (\dusa{pos}(i), i = 1, 6) \moc{DMIX} \dusa{mix1} \dusa{mix2} $]]$ \\ +\moc{ENDROD} +\end{DataStructure} + +\noindent where +\begin{ListeDeDescription}{mmmmmmmm} + +\item[\moc{ROD}] keyword used to specify the rod \dusa{id} number. + +\item[\dusa{id}] integer identification number of the current rod. Each +rod-type device must be assigned a unique \dusa{id} number, given in +an ascending order ranging from 1 to \dusa{nrod}. + +\item[\moc{ROD-NAME}] keyword used to specify the rod \dusa{NAME}. + +\item[\dusa{NAME}] \texttt{character*12} name of the current rod. In general, +this name is composed by the rod specific type (e.g. SOR, ZCR, etc.) followed +by its sequential number (e.g. 01, 02, etc.). + +\item[\moc{AXIS}] keyword used to specify the rod movement axis. +A rod can be displaced along only one of the axis. + +\item[\moc{X}] keyword used to specify that a rod is displaced along X axis. + +\item[\moc{Y}] keyword used to specify that a rod is displaced along Y axis. + +\item[\moc{Z}] keyword used to specify that a rod is displaced along Z axis. + +\item[\moc{FROM}] keyword used to specify the insertion side of geometry. +The rod-devices can be inserted into the reactor core from only one side of +geometry. For example, some vertically moving devices can be inserted only +from the top, whereas other only from the bottom. + +\item[\moc{H+}] keyword used to specify that a rod will be inserted into +reactor core from the highest position (e.g. from the top for vertically moving +rod-device). + +\item[\moc{H-}] keyword used to specify that a rod will be inserted into +reactor core from the lowest position (e.g. from the bottom for vertically +moving rod-device). + +\item[\moc{LEVEL}] keyword used to specify the actual rod insertion +level \dusa{value}. By default, the rod insertion level is left undefined. + +\item[\dusa{value}] real positive value of the rod insertion level. This +value is used to compute the actual rod position in the reactor core. +The rod insertion level is minimal (\dusa{value} = 0.0) when the rod is +completely withdrawn, and it is maximal (\dusa{value} = 1.0) when the +rod is fully inserted. For the partially inserted rod the insertion level +must be: 0.0 $<$ \dusa{value} $<$ 1.0 + +\item[\moc{SPEED}] keyword used to specify \dusa{speed}. By default, the speed is left undefined. + +\item[\dusa{speed}] real positive value of the rod movement speed, +given in cm/s. This value is needed only for the reactor regulating purpose. + +\item[\moc{TIME}] keyword used to specify \dusa{time}. By default, the insertion time is left undefined. + +\item[\dusa{time}] real value of time for the rod insertion (or extraction), +given in sec. This value is needed only for the reactor regulating purpose. + +\item[\moc{MAXPOS}] keyword used to specify the full-inserted +coordinates of a rod part. The sequence of \moc{MAXPOS} and \moc{DMIX} data structures is +repeated for each part making the rod. + +\item[\dusa{pos}] real array containing 3-D Cartesian coordinates of the +full-inserted rod. This is the limiting rod position in the reactor core, which +may or may not be the same as the actual rod position. These coordinates +must be given in the order: X$-$, X$+$, Y$-$, Y$+$, Z$-$, and Z$+$. + +\item[\moc{DMIX}] keyword used to specify \dusa{mix1} and \dusa{mix2}. + +\item[\dusa{mix1}] first of two integer rod mixture indices. Index \dusa{mix1} corresponds to the perturbed +cross sections. + +\item[\dusa{mix2}] second of two integer rod mixture indices. Index \dusa{mix2} corresponds to the reference +cross sections. Indices \dusa{mix1} and \dusa{mix2} will be used to compute +the incremental cross sections in the \moc{NEWMAC:} module. + +\item[\moc{ENDROD}] keyword used to end the rod description. + +\end{ListeDeDescription} + +\subsubsection{Description of rod-group input structure}\label{sect:rodgroupstr} + +The partition of devices into groups is very useful when the same action is +to be applied to several rods, e.g. setting of new parameters (using the +\moc{DSET:} module) or rods moving (using the \moc{MOVDEV:} module). + +\begin{DataStructure}{Structure \dstr{rod-group}} + +\moc{GROUP-ID} \dusa{igrp} $\{$ \moc{ROD-ID} +$[[$ \dusa{id} $]]$ $|$ \moc{ALL} $\}$ \\ + +\end{DataStructure} + +\noindent where +\begin{ListeDeDescription}{mmmmmmmm} + +\item[\moc{GROUP-ID}] keyword used to set \dusa{igrp} number. + +\item[\dusa{igrp}] integer identification number of a group to be created. +Each rods group must be assigned a unique identification number, given +in ascending order ranging from 1 to \dusa{ngrp}. + +\item[\moc{ROD-ID}] keyword used to set the rod \dusa{id} numbers. + +\item[\dusa{id}] integer identification numbers of rods which belong +to the same group \dusa{igrp}. A particular rod (or several rods) may +belong to different groups, but it could not be repeated inside the same +group. The total number of rods in any group must be between +1 and \dusa{nrod}. + +\item[\moc{ALL}] keyword used to specify that all rods +will belong to the same group \dusa{igrp}. + +\end{ListeDeDescription} +\clearpage -- cgit v1.2.3