\contentsline {section}{\numberline {1}Introduction}{11}{section.1}
\contentsline {section}{\numberline {2}Practical information about {\fontfamily {ppl}\fontshape {it}\selectfont Code\_Saturne}}{12}{section.2}
\contentsline {subsection}{\numberline {2.1}System Environment for {\fontfamily {ppl}\fontshape {it}\selectfont Code\_Saturne}}{12}{subsection.2.1}
\contentsline {subsubsection}{\numberline {2.1.1}Preliminary settings}{12}{subsubsection.2.1.1}
\contentsline {subsubsection}{\numberline {2.1.2}Standard architecture of the directories}{12}{subsubsection.2.1.2}
\contentsline {subsubsection}{\numberline {2.1.3}{\fontfamily {ppl}\fontshape {it}\selectfont Code\_Saturne}\ Kernel library files}{15}{subsubsection.2.1.3}
\contentsline {subsection}{\numberline {2.2}Setting up and running of a calculation}{16}{subsection.2.2}
\contentsline {subsubsection}{\numberline {2.2.1}Step by step calculation}{16}{subsubsection.2.2.1}
\contentsline {subsubsection}{\numberline {2.2.2}Temporary execution directory}{18}{subsubsection.2.2.2}
\contentsline {subsubsection}{\numberline {2.2.3}Execution modes}{18}{subsubsection.2.2.3}
\contentsline {subsubsection}{\numberline {2.2.4}Interactive modification of the target time step}{19}{subsubsection.2.2.4}
\contentsline {subsection}{\numberline {2.3}Case preparer}{19}{subsection.2.3}
\contentsline {subsection}{\numberline {2.4}Pre-processing}{20}{subsection.2.4}
\contentsline {subsubsection}{\numberline {2.4.1}Usable meshes}{20}{subsubsection.2.4.1}
\contentsline {subsubsection}{\numberline {2.4.2}Preprocessor command line options}{21}{subsubsection.2.4.2}
\contentsline {subsection}{\numberline {2.5}Kernel command line options}{22}{subsection.2.5}
\contentsline {subsection}{\numberline {2.6}Parameters in the launch script}{24}{subsection.2.6}
\contentsline {subsection}{\numberline {2.7}Graphical User Interface}{27}{subsection.2.7}
\contentsline {section}{\numberline {3}Main variables}{28}{section.3}
\contentsline {subsection}{\numberline {3.1}Array sizes}{29}{subsection.3.1}
\contentsline {subsection}{\numberline {3.2}Geometric variables}{31}{subsection.3.2}
\contentsline {subsection}{\numberline {3.3}Physical variables}{32}{subsection.3.3}
\contentsline {subsection}{\numberline {3.4}Variables related to the numerical methods}{36}{subsection.3.4}
\contentsline {subsection}{\numberline {3.5}User arrays}{40}{subsection.3.5}
\contentsline {subsection}{\numberline {3.6}Developer arrays}{40}{subsection.3.6}
\contentsline {subsection}{\numberline {3.7}Parallelism and periodicity}{40}{subsection.3.7}
\contentsline {subsection}{\numberline {3.8}Geometric and particulate arrays related to lagrangian modelling}{43}{subsection.3.8}
\contentsline {subsection}{\numberline {3.9}Variables saved to allow calculation restarts}{46}{subsection.3.9}
\contentsline {section}{\numberline {4}User subroutines}{48}{section.4}
\contentsline {subsection}{\numberline {4.1}Preliminary comments}{48}{subsection.4.1}
\contentsline {subsection}{\numberline {4.2}Initialisation of the main key words: \textmd {\texttt {usini1}}}{49}{subsection.4.2}
\contentsline {subsection}{\numberline {4.3}Management of boundary conditions: \textmd {\texttt {usclim}}}{49}{subsection.4.3}
\contentsline {subsubsection}{\numberline {4.3.1}Coding of standard boundary conditions}{50}{subsubsection.4.3.1}
\contentsline {subsubsection}{\numberline {4.3.2}Coding of non-standard boundary conditions}{52}{subsubsection.4.3.2}
\contentsline {subsubsection}{\numberline {4.3.3}Checking of the boundary conditions}{53}{subsubsection.4.3.3}
\contentsline {subsubsection}{\numberline {4.3.4}Sorting of the boundary faces}{54}{subsubsection.4.3.4}
\contentsline {subsection}{\numberline {4.4}Management of the boundary conditions with LES: \texttt {usvort}}{54}{subsection.4.4}
\contentsline {subsection}{\numberline {4.5}Management of the variable physical properties: \textmd {\texttt {usphyv}}}{57}{subsection.4.5}
\contentsline {subsection}{\numberline {4.6}Non-standard initialisation of the variables: \textmd {\texttt {usiniv}}}{57}{subsection.4.6}
\contentsline {subsection}{\numberline {4.7}Non-standard management of the chronological record files: \textmd {\texttt {ushist}}}{58}{subsection.4.7}
\contentsline {subsection}{\numberline {4.8}User source terms in Navier-Stokes: \textmd {\texttt {ustsns}}}{59}{subsection.4.8}
\contentsline {subsection}{\numberline {4.9}User source terms for $k$ and $\varepsilon $: \textmd {\texttt {ustske}}}{60}{subsection.4.9}
\contentsline {subsection}{\numberline {4.10}User source terms for $R_{ij}$ and $\varepsilon $: \textmd {\texttt {ustsri}}}{61}{subsection.4.10}
\contentsline {subsection}{\numberline {4.11}User source terms for $\varphi $ and $\overline {f}$: \textmd {\texttt {ustsv2}}}{61}{subsection.4.11}
\contentsline {subsection}{\numberline {4.12}User source terms for $k$ and $\omega $: \textmd {\texttt {ustskw}}}{61}{subsection.4.12}
\contentsline {subsection}{\numberline {4.13}User source terms for the user scalars: \textmd {\texttt {ustssc}}}{61}{subsection.4.13}
\contentsline {subsection}{\numberline {4.14}Management of the pressure drops: \textmd {\texttt {uskpdc}}}{62}{subsection.4.14}
\contentsline {subsection}{\numberline {4.15}Management of the mass sources: \textmd {\texttt {ustsma}}}{62}{subsection.4.15}
\contentsline {subsection}{\numberline {4.16}Thermal module in a 1D wall}{63}{subsection.4.16}
\contentsline {subsection}{\numberline {4.17}Modification of the turbulent viscosity: \textmd {\texttt {usvist}}}{65}{subsection.4.17}
\contentsline {subsection}{\numberline {4.18}Modification of the friction velocity: \textmd {\texttt {usruet}}}{65}{subsection.4.18}
\contentsline {subsection}{\numberline {4.19}Modification of the ``constant'' of the dynamic LES model: \textmd {\texttt {ussmag}}}{65}{subsection.4.19}
\contentsline {subsection}{\numberline {4.20}Temperature-enthalpy and enthalpy-temperature conversions: \textmd {\texttt {usthht}}}{66}{subsection.4.20}
\contentsline {subsection}{\numberline {4.21}Modification of the mesh geometry: \textmd {\texttt {usmodg}}}{66}{subsection.4.21}
\contentsline {subsection}{\numberline {4.22}Management of the post-treatment intermediary outputs: \textmd {\texttt {usnpst}}}{67}{subsection.4.22}
\contentsline {subsection}{\numberline {4.23}Management by the Preprocessor of the outputs in {\em EnSight} format: \textmd {\texttt {useevo}}}{68}{subsection.4.23}
\contentsline {subsection}{\numberline {4.24}Management of the outputs in {\em EnSight} format without the Preprocessor: \textmd {\texttt {usensi}} }{69}{subsection.4.24}
\contentsline {subsection}{\numberline {4.25}Management of the outputs in {\em Rubens} format: \textmd {\texttt {usrubm}}}{69}{subsection.4.25}
\contentsline {subsection}{\numberline {4.26}Definition of sections for outputs in the form of lists of faces: \textmd {\texttt {uslfac}}}{69}{subsection.4.26}
\contentsline {subsection}{\numberline {4.27}Definition of the data to post-treat on the sections: \textmd {\texttt {usvfac}}}{69}{subsection.4.27}
\contentsline {subsection}{\numberline {4.28}Definition of post-treatments and mesh zones: \textmd {\texttt {usdpst}}}{70}{subsection.4.28}
\contentsline {subsection}{\numberline {4.29}Modification of the mesh zones to post-treat: \textmd {\texttt {usmpst}}}{72}{subsection.4.29}
\contentsline {subsection}{\numberline {4.30}Definition of the variables to post-treat: \textmd {\texttt {usvpst}}}{72}{subsection.4.30}
\contentsline {subsection}{\numberline {4.31}Modification of the variables at the end of a time step: \textmd {\texttt {usproj}}}{73}{subsection.4.31}
\contentsline {subsection}{\numberline {4.32}Radiative thermal transfers in semi-transparent gray media}{74}{subsection.4.32}
\contentsline {subsubsection}{\numberline {4.32.1}Initialisation of the radiation main key words: \textmd {\texttt {usray1}}}{74}{subsubsection.4.32.1}
\contentsline {subsubsection}{\numberline {4.32.2}Management of the radiation boundary conditions: \textmd {\texttt {usray2}}}{74}{subsubsection.4.32.2}
\contentsline {subsubsection}{\numberline {4.32.3}Absorption coefficient of the medium, boundary conditions for the luminance and calcualtion of the net radiative flux: \textmd {\texttt {usray3}}}{76}{subsubsection.4.32.3}
\contentsline {subsubsection}{\numberline {4.32.4}Encapsulation of the temperature-enthalpy conversion: \textmd {\texttt {usray4}}}{76}{subsubsection.4.32.4}
\contentsline {subsection}{\numberline {4.33}Utilisation of a specific physics: \textmd {\texttt {usppmo}}}{76}{subsection.4.33}
\contentsline {subsection}{\numberline {4.34}Management of the boundary conditions related to pulverised coal and gas combustion: \textmd {\texttt {usebuc, usd3pc, uslwcc, uscpcl et uscplc}} }{83}{subsection.4.34}
\contentsline {subsection}{\numberline {4.35}Initialisation of the variables related to pulverised coal and gas combustion: \textmd {\texttt {usebui, usd3pi, uslwci and uscpiv}}}{84}{subsection.4.35}
\contentsline {subsection}{\numberline {4.36}Initialisation of the options of the variables related to pulverised coal and gas combustion: \textmd {\texttt {usebu1, usd3p1, uslwc1, uscpi1 and uscpl1}}}{85}{subsection.4.36}
\contentsline {subsection}{\numberline {4.37}Management of Boundary Conditions of the electric arc: \texttt {uselcl}}{87}{subsection.4.37}
\contentsline {subsection}{\numberline {4.38}Initialisation of the variables in the electric module}{88}{subsection.4.38}
\contentsline {subsection}{\numberline {4.39} Initialisation of the variable options in the electric module}{88}{subsection.4.39}
\contentsline {subsection}{\numberline {4.40}Management of variable physical properties in the electric module}{89}{subsection.4.40}
\contentsline {subsection}{\numberline {4.41}Management of the {\em EnSight} output in the electric module\nobreakspace {}: \texttt {uselen}}{90}{subsection.4.41}
\contentsline {subsection}{\numberline {4.42}Compressible module}{90}{subsection.4.42}
\contentsline {subsubsection}{\numberline {4.42.1} Initialisation of the options of the variables related to the compressible module: \textmd {\texttt {uscfx1}} and \textmd {\texttt {uscfx2}}}{90}{subsubsection.4.42.1}
\contentsline {subsubsection}{\numberline {4.42.2}Management of the boundary conditions related to the compressible module: \textmd {\texttt {uscfcl}}}{91}{subsubsection.4.42.2}
\contentsline {subsubsection}{\numberline {4.42.3}Ininitialisation of the variables related to the compressible module: \textmd {\texttt {uscfxi}}}{91}{subsubsection.4.42.3}
\contentsline {subsubsection}{\numberline {4.42.4}Compressible module thermodynamics: \textmd {\texttt {uscfth}}}{91}{subsubsection.4.42.4}
\contentsline {subsubsection}{\numberline {4.42.5}Management of the variable physical properties in the compressible module: \textmd {\texttt {uscfpv}}}{91}{subsubsection.4.42.5}
\contentsline {subsection}{\numberline {4.43}Lagrangian modelling of multiphasic flows with dipersed inclusions}{92}{subsection.4.43}
\contentsline {subsubsection}{\numberline {4.43.1}Initialisation of the main key words in the lagrangian modelling: \textmd {\texttt {uslag1}}}{92}{subsubsection.4.43.1}
\contentsline {subsubsection}{\numberline {4.43.2}Management of the boundary conditions related to the particles: \textmd {\texttt {uslag2}} and \textmd {\texttt {uslain}}}{93}{subsubsection.4.43.2}
\contentsline {subsubsection}{\numberline {4.43.3}Treatment of the particle/boundary interaction: \textmd {\texttt {uslabo}}}{96}{subsubsection.4.43.3}
\contentsline {subsubsection}{\numberline {4.43.4}Option of particle cloning/fusion: \textmd {\texttt {uslaru}}}{97}{subsubsection.4.43.4}
\contentsline {subsubsection}{\numberline {4.43.5}Manipulation of particulate variables at the end of an iteration and user volumetric statistics: \textmd {\texttt {uslast}} and \textmd {\texttt {uslaen}}}{98}{subsubsection.4.43.5}
\contentsline {subsubsection}{\numberline {4.43.6}User stochastic differential equations: \textmd {\texttt {uslaed}}}{98}{subsubsection.4.43.6}
\contentsline {subsubsection}{\numberline {4.43.7}Particle relaxation time: \textmd {\texttt {uslatp}}}{99}{subsubsection.4.43.7}
\contentsline {subsubsection}{\numberline {4.43.8}Particle thermal characteristic time: \textmd {\texttt {uslatc}}}{99}{subsubsection.4.43.8}
\contentsline {section}{\numberline {5}Key word list}{100}{section.5}
\contentsline {subsection}{\numberline {5.1}Inputs-outputs}{100}{subsection.5.1}
\contentsline {subsubsection}{\numberline {5.1.1}''Calculation'' files}{101}{subsubsection.5.1.1}
\contentsline {subsubsection}{\numberline {5.1.2}Post-processing for {\em EnSight} or other tools}{105}{subsubsection.5.1.2}
\contentsline {subsubsection}{\numberline {5.1.3}Chronological records of the variables on specific points}{107}{subsubsection.5.1.3}
\contentsline {subsubsection}{\numberline {5.1.4}Time averages}{109}{subsubsection.5.1.4}
\contentsline {subsubsection}{\numberline {5.1.5}Others}{110}{subsubsection.5.1.5}
\contentsline {subsection}{\numberline {5.2}Numerical options}{112}{subsection.5.2}
\contentsline {subsubsection}{\numberline {5.2.1}Calculation management}{112}{subsubsection.5.2.1}
\contentsline {subsubsection}{\numberline {5.2.2}Scalar unknowns}{113}{subsubsection.5.2.2}
\contentsline {subsubsection}{\numberline {5.2.3}Definition of the equations}{115}{subsubsection.5.2.3}
\contentsline {subsubsection}{\numberline {5.2.4}Definition of the time advancement}{116}{subsubsection.5.2.4}
\contentsline {subsubsection}{\numberline {5.2.5}Turbulence}{117}{subsubsection.5.2.5}
\contentsline {subsubsection}{\numberline {5.2.6}Time scheme}{122}{subsubsection.5.2.6}
\contentsline {subsubsection}{\numberline {5.2.7}Gradient reconstruction}{127}{subsubsection.5.2.7}
\contentsline {subsubsection}{\numberline {5.2.8}Solution of the linear systems}{128}{subsubsection.5.2.8}
\contentsline {subsubsection}{\numberline {5.2.9}Convective scheme}{129}{subsubsection.5.2.9}
\contentsline {subsubsection}{\numberline {5.2.10}Pressure-continuity step}{130}{subsubsection.5.2.10}
\contentsline {subsubsection}{\numberline {5.2.11}Error estimators for Navier-Stokes}{131}{subsubsection.5.2.11}
\contentsline {subsubsection}{\numberline {5.2.12}Calculation of the distance to the wall}{133}{subsubsection.5.2.12}
\contentsline {subsubsection}{\numberline {5.2.13}Others}{135}{subsubsection.5.2.13}
\contentsline {subsection}{\numberline {5.3}Numerical, physical and modelling parameters}{136}{subsection.5.3}
\contentsline {subsubsection}{\numberline {5.3.1}Numeric Parameters}{136}{subsubsection.5.3.1}
\contentsline {subsubsection}{\numberline {5.3.2}Physical parameters}{137}{subsubsection.5.3.2}
\contentsline {subsubsection}{\numberline {5.3.3}Physical variables}{137}{subsubsection.5.3.3}
\contentsline {subsubsection}{\numberline {5.3.4}Modelling parameters}{141}{subsubsection.5.3.4}
\contentsline {subsection}{\numberline {5.4}Thermal radiative transfers: global settings}{145}{subsection.5.4}
\contentsline {subsection}{\numberline {5.5}Electric module (Joule effect and electric arc): specificities}{149}{subsection.5.5}
\contentsline {subsection}{\numberline {5.6}Compressible module: specificities}{150}{subsection.5.6}
\contentsline {subsection}{\numberline {5.7}Lagrangian multiphase flows}{151}{subsection.5.7}
\contentsline {subsubsection}{\numberline {5.7.1}Global settings}{151}{subsubsection.5.7.1}
\contentsline {subsubsection}{\numberline {5.7.2}Specific physics models associated with the particles}{153}{subsubsection.5.7.2}
\contentsline {subsubsection}{\numberline {5.7.3}Options for two-way coupling}{154}{subsubsection.5.7.3}
\contentsline {subsubsection}{\numberline {5.7.4}Numerical modelling}{154}{subsubsection.5.7.4}
\contentsline {subsubsection}{\numberline {5.7.5}Volume statistics}{155}{subsubsection.5.7.5}
\contentsline {subsubsection}{\numberline {5.7.6}Display of trajectories and particle movements}{156}{subsubsection.5.7.6}
\contentsline {subsubsection}{\numberline {5.7.7}Display of the particle/boundary interactions and the statistics at the boundaries}{158}{subsubsection.5.7.7}
\contentsline {section}{\numberline {6}Bibliography}{161}{section.6}
\contentsline {section}{\numberline {7}Appendix 1 : automatic validation procedure}{162}{section.7}
\contentsline {subsection}{\numberline {7.1}Introduction}{162}{subsection.7.1}
\contentsline {subsection}{\numberline {7.2}Practical informations on the procedure}{162}{subsection.7.2}
\contentsline {subsection}{\numberline {7.3}Directories architecture}{162}{subsection.7.3}
\contentsline {subsection}{\numberline {7.4}Validation base}{163}{subsection.7.4}
\contentsline {subsubsection}{\numberline {7.4.1}Elementary tests : gradient calculations}{163}{subsubsection.7.4.1}
\contentsline {subsubsection}{\numberline {7.4.2}Laplacien calculation}{163}{subsubsection.7.4.2}
\contentsline {subsection}{\numberline {7.5}Architecture description}{163}{subsection.7.5}
\contentsline {subsubsection}{\numberline {7.5.1}Python files in the modules directory}{163}{subsubsection.7.5.1}
\contentsline {subsubsection}{\numberline {7.5.2}XML file description}{164}{subsubsection.7.5.2}
\contentsline {subsubsection}{\numberline {7.5.3}To add a new study}{165}{subsubsection.7.5.3}
\contentsline {subsubsection}{\numberline {7.5.4}Report files}{165}{subsubsection.7.5.4}