%
%     This file is part of the Code_Saturne Preprocessor, element of the
%     Code_Saturne CFD tool.
%
%     Copyright (C) 1998-2007 EDF S.A., France
%
%     contact: saturne-support@edf.fr
%
%     The Code_Saturne Preprocessor is free software; you can redistribute it
%     and/or modify it under the terms of the GNU General Public License
%     as published by the Free Software Foundation; either version 2 of
%     the License, or (at your option) any later version.
%
%     The Code_Saturne Preprocessor is distributed in the hope that it will be
%     useful, but WITHOUT ANY WARRANTY; without even the implied warranty
%     of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
%     GNU General Public License for more details.
%
%     You should have received a copy of the GNU General Public License
%     along with the Code_Saturne Preprocessor; if not, write to the
%     Free Software Foundation, Inc.,
%     51 Franklin St, Fifth Floor,
%     Boston, MA  02110-1301  USA
%

\section{Cas d'utilisation du \pcs\label{cha:cas}}


\subsection{Acteurs\label{sec:acteur}}


La seule entité externe qui peut interagir directement avec
le \pcs est l'utilisateur. On précise ci-dessous le rôle qu'il
joue par rapport au \pcs.

L'utilisateur doit nécessairement spécifier au \pcs les fichiers
de \maillage qui devront être traités.
Si plusieurs fichiers de \maillage sont spécifiés,
il doit indiquer s'il est nécessaire
de les recoller.

L'utilisateur reçoit en échange les fichiers destinés au \noy,
ainsi éventuellement que des fichiers de post-traitement.


\subsection{Cas d'utilisation\label{sec:cas}}


Il s'agit dans cette section de répertorier les services rendus
par le \pcs.


\paragraph{Cas d'utilisation 1 : Lecture des données des \maillages}

  Le cas d'utilisation est déclenché par l'utilisateur qui doit spécifier
  les noms des fichiers de maillage à lire (ainsi que leur format si
  l'extension n'est pas connue).

  Plusieurs formats de fichier de maillage sont reconnus, comme indiqué
  dans le manuel d'utilisation.
  Chaque \maillage lu est stocké dans une représentation interne au \pcs.

  La lecture du \maillage proprement dite est dissociée de la mise
  en forme des données du \maillage dans la représentation interne au \pcs.
  La prise en compte dans le \CS d'un nouveau format de fichier de maillage
  peut dès lors facilement s'intégrer dans le \pcs \refpar{sec:echange}.

  Les données à lire peuvent provenir de plusieurs fichiers, dont les formats
  peuvent être différents. Les maillages sont alors concaténés.

\paragraph{Cas d'utilisation 2 : Concaténation de \maillages}

  Puisque chaque \maillage lu est converti dans la représentation interne
  au \pcs, des \maillages issus de fichiers ayant des formats
  différents peuvent être concaténés.

  La concaténation de plusieurs \maillages ne suppose aucune opération
  sur le \maillage résultant de la concaténation.

  Ce cas d'utilisation est une extension du premier cas d'utilisation.

\paragraph{Cas d'utilisation 3 : Recollement de \maillages ou périodicité}

  Le recollement permet de souder des \maillages concaténés, en découpant
  des faces de bord non conformes en sous-faces correspondant à leurs
  intersections, puis en fusionnant les sous-faces issues de ce découpage
  (et donc conformes) en vis-à-vis.

  Si les \maillages à recoller partagent des interfaces conformes,
  le recollement revient à fusionner les \soms ayant les mêmes coordonnées,
  ainsi que les \facs s'appuyant sur ces \soms.

  Le recollement périodique est une extension du recollement de
  maillages consistant à dupliquer les faces sélectionnées, de leur
  appliquer la transformation géométrique correspondant au pas périodique,
  puis d'effectuer un recollement entre les faces d'origine et les
  faces dupliquées, en reproduisant le découpage des faces recollées
  sur les faces dont elles sont issues. Les faces temporaires dupliquées
  puis translatées ne participant pas recollement sont supprimées.

  C'est en général l'utilisateur qui déclenche ce cas d'utilisation,
  \footnote{%
   En présence de plusieurs fichiers de maillage, le \pcs pourrait réaliser
   systématiquement le recollement de \maillages mêmes si les \maillages
   sont déjà conformes. Mais le recollement de faces appartenant à des parois
   minces n'étant pas désiré, et les tolérances à appliquer au recollement
   pouvant varier selon les zones, il est préférable qu'il soit déclenché par
   l'utilisateur, qui sait si le recollement est nécessaire.}
  sauf lorsque le maillage contient des informations sur le recollement
  (cas des maillages \igghexa).

\paragraph{Cas d'utilisation 4 : Vérification de maillage}

  Certains contrôles de cohérence peuvent être effectués par le \pcs.

\paragraph{Cas d'utilisation 5 : Écriture du \maillage pour le post-traitement}

  La description géométrique du \maillage est écrite sur fichier pour la
  vérification avec un outil de post-traitement.
  Ce cas d'utilisation est une extension du cas précédent.

  Trois formats de fichier de post-traitement sont possibles~:
  \ensightg, \med, ou \CGNS.
  Il est possible d'effectuer les sorties dans plusieurs formats
  simultanément.

\paragraph{Cas d'utilisation 6 : Écriture des données spécifiques au \noy}

  Les données spécifiques au \noy sont écrites par le \pcs, pour le \noy.

  On rappelle que le rôle du \pcs vis-à-vis du \noy consiste
  justement à lui fournir les données du \maillage
  dans une représentation spécifique.
  Ces données spécifiques sont décrites au \S~\ref{sec:saturne}.


\begin{figfloat}
\begin{center}
\includegraphics*[width=12.0cm]
  {\repgraphics/uml_cas_utilisateur.\extgraphics}
\captionfloat{Cas d'utilisation\label{fig:cas.util}}
\end{center}
\end{figfloat}


\passepage


