diff --git a/doc/users/Tuto1/data/Bief_1.ST b/doc/users/Tuto1/data/Bief_1.ST index 021c35eaea772b603ad2619620b74527d391686c..291d40f2337ac5f19f55faca846b303051fc9523 100644 --- a/doc/users/Tuto1/data/Bief_1.ST +++ b/doc/users/Tuto1/data/Bief_1.ST @@ -431,3 +431,12 @@ 36270.0000 21.3000 17.0100 rd 36270.0000 23.0000 19.5000 999.9990 999.9990 999.9990 + 39 0 0 7 36271.0000 S1bis + 36271.0000 0.0000 20.0000 + 36271.0000 1.8000 17.0100 rg + 36271.0000 3.0000 13.0800 + 36271.0000 11.5000 13.0500 + 36271.0000 20.0000 13.0800 + 36271.0000 21.3000 17.0100 rd + 36271.0000 23.0000 19.5000 + 999.9990 999.9990 999.9990 diff --git a/doc/users/Tuto1/img/frictions2.png b/doc/users/Tuto1/img/frictions2.png index d28d2eb50a7c910e25a4d82fdc19e4f02d4ebc1f..e5fd52999cede4e9001d893865c1c3519b1a99a5 100644 Binary files a/doc/users/Tuto1/img/frictions2.png and b/doc/users/Tuto1/img/frictions2.png differ diff --git a/doc/users/Tuto1/img/hs.png b/doc/users/Tuto1/img/hs.png index 96326e7c6a644089571e0da5a2a033c792f0873c..f095ee4bcbfb6a5241ffddf39f3beca3d52f0cfa 100644 Binary files a/doc/users/Tuto1/img/hs.png and b/doc/users/Tuto1/img/hs.png differ diff --git a/doc/users/Tuto1/img/maillage.png b/doc/users/Tuto1/img/maillage.png index f76f62336f2943f49b4d3c6e8a336ef68e9d85fd..c36138b6d697a03c4902cd67e6d46ab43ba7f04a 100644 Binary files a/doc/users/Tuto1/img/maillage.png and b/doc/users/Tuto1/img/maillage.png differ diff --git a/doc/users/Tuto1/pas-a-pas.tex b/doc/users/Tuto1/pas-a-pas.tex index cefa116969c229fa4925f51193eefe1b21221304..9b3d80d6b044e886401aa1c0439bf02c6dcc64ae 100644 --- a/doc/users/Tuto1/pas-a-pas.tex +++ b/doc/users/Tuto1/pas-a-pas.tex @@ -80,7 +80,7 @@ RiverLy, Hydraulique des rivi \begin{center} \begin{tabular}{lll} -Autors : & Pierre-Antoine Rouby & pierre-antoine.rouby@inrae.fr\tabularnewline +Auteurs : & Pierre-Antoine Rouby & pierre-antoine.rouby@inrae.fr\tabularnewline & Théophile TERRAZ & theophile.terraz@inrae.fr\tabularnewline & Lionel Pénard & lionel.penard@inrae.fr\tabularnewline @@ -127,16 +127,16 @@ Choisissez un nom, par exemple \textit{Hogneau}, et validez. \includegraphics[width=15cm]{img/NEWSTUDY.png} \par\end{center} -Pendant que vous travaillez sur votre étude, noubliez pas de sauvegarder régulièrement, à l'aide du bouton \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/save.png} de la fenêtre principale. +Pendant que vous travaillez sur votre étude, n'oubliez pas de sauvegarder régulièrement, à l'aide du bouton \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/save.png} de la fenêtre principale. \section{Créer la structure de la rivière} -Cliquez sur \texttt{[Réseau] => [Modifier le réseau]} ou sur l'icône \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/network.png} pour créer la structure de votre rivière. +Cliquez sur \texttt{[Réseau] => [Éditer le réseau]} ou sur l'icône \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/network.png} pour créer la structure de votre rivière. Nous voici dans la fenêtre \textit{Réseau}. Dans cette fenêtre, nous allons définir un graphe orienté qui représente les biefs de notre réseau fluvial : les arêtes sont les biefs, les n½uds sont soit des conditions limites amont, soit des conditions limites aval, soit des jonctions entre biefs. Un bief par défaut existe dans la nouvelle étude. -Pour les besoins de ce tutoriel, nous allons le suprimer : -cliquez sur le bouton \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/del.png} pour entrer dans le mode \textit{Supression} puis cliquez sur les n½uds. +Pour les besoins de ce tutoriel, nous allons le supprimer : +cliquez sur le bouton \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/del.png} pour entrer dans le mode \textit{Suppression} puis cliquez sur les n½uds. Nous voilà repartis sur une fenêtre vierge. Appuyez sur le bouton \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/add.png} pour entrer dans le mode \textit{Ajout}. Créez deux n½uds en cliquant dans la zone grise de la fenêtre, et créez un lien en cliquant à nouveau sur chaque n½ud. Appuyez à nouveau sur \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/add.png} pour quitter le mode \textit{Ajout}. @@ -151,9 +151,9 @@ La fen Fermez la fenêtre \textit{Réseau}. -\section{Éditer la géometrie de la rivière} +\section{Éditer la géométrie de la rivière} -Cliquez sur \texttt{[Géometrie] => [Modifier la géometrie]} ou sur l'icône \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/geometry.png} pour définir la géométrie du bief sélectionné. +Cliquez sur \texttt{[Géométrie] => [Éditer la géométrie]} ou sur l'icône \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/geometry.png} pour définir la géométrie du bief sélectionné. Pour Importer une géométrie depuis un fichier, cliquez sur le bouton \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/import.png}. Sélectionnez le fichier \texttt{Data/Bief\_1.st}. Vous devriez voir : @@ -185,7 +185,7 @@ Vous pouvez ensuite enlever cette ligne avec \texttt{[clic molette]}. Vous pouvez maintenant fermer la fenêtre d'édition de la section en travers. Revenons à la fenêtre \textit{Géométrie}. -Le jeu de sections importé est inégalement espacé, ce qui peut entrainer des difficultés de calcul. +Le jeu de sections importé est inégalement espacé, ce qui peut entraîner des difficultés de calcul. Nous allons utiliser l'outil de maillage pour interpoler des nouvelles sections entre les sections trop espacées. Cliquez sur \includegraphics[width=0.5cm]{"../../../src/View/ui/ressources/meshing.png"}. Dans la fenêtre \textit{Maillage}, vous avez accès à quelques options basiques. @@ -194,26 +194,26 @@ L'option \textit{Lignes directrices pour le calcul des distances} permet de sp La distance sera la moyenne des deux distances entre les points de chaque sections qui portent ces lignes directrices. Pour ne choisir qu'une seule ligne, rentrez simplement deux fois la même valeur. Il existe toujours au moins deux lignes directrices : les deux extrémités des sections, nommés \textit{un} et \textit{np}, même si les points correspondants ne portent pas de nom. -Les options \textit{Paramètres} permettent de définit l'interval souhaité entre les nouvelles sections, et la méthode d'interpolation. +Les options \textit{Paramètres} permettent de définir l'interval souhaité entre les nouvelles sections, et la méthode d'interpolation. Choisissez les options suivantes, et cliquez sur \texttt{[OK]} : \begin{center} \includegraphics[width=15cm]{img/maillage.png} \par\end{center} -L'option d'interpolation \textit{Spline} modifie les longueurs longitudinales. -Les absices en long (Pk) des sections sont donc obsolètes. -Pour les recalculer, cliquez sur \texttt{[Mise à jour des PK]} dans la fenêtre \textit{Géométrie}. -Vous êtes maintenant dans la fenêtre \textit{Mise à jour des PK}. -Vous pouvez choisir la section d'origine pour le calcul des PK, ainsi que la valeur du PK à cette section. -Le choix des deux lignes directrices sert à calculer les distances entre sections, comme dans la fenêtre \textit{Maillage}. -L'orientation vous permet de choisir dans quelle direction les PK seront croissants. -Cette option n'a pas d'impact sur les résultats du calcul hydraulique. -Choisissez les options suivantes, et cliquez sur \texttt{[OK]} : - -\begin{center} -\includegraphics[width=15cm]{img/mjpk.png} -\par\end{center} +% L'option d'interpolation \textit{Spline} modifie les longueurs longitudinales. +% Les abscices en long (Pk) des sections sont donc obsolètes. +% Pour les recalculer, cliquez sur \texttt{[Mise à jour des PK]} dans la fenêtre \textit{Géométrie}. +% Vous êtes maintenant dans la fenêtre \textit{Mise à jour des PK}. +% Vous pouvez choisir la section d'origine pour le calcul des PK, ainsi que la valeur du PK à cette section. +% Le choix des deux lignes directrices sert à calculer les distances entre sections, comme dans la fenêtre \textit{Maillage}. +% L'orientation vous permet de choisir dans quelle direction les PK seront croissants. +% Cette option n'a pas d'impact sur les résultats du calcul hydraulique. +% Choisissez les options suivantes, et cliquez sur \texttt{[OK]} : +% +% \begin{center} +% \includegraphics[width=15cm]{img/mjpk.png} +% \par\end{center} La fenêtre \textit{Géométrie} doit maintenant ressembler à ça : @@ -237,35 +237,44 @@ S Ici, nous définirons le débit mesuré lors de la crue de février 2002. Vous pouvez nommer cette condition limite "crue2002". Sélectionner la cellule \textit{Type} et utiliser la combo box pour mettre une loi \textit{Q(t)} : débit en fonction du temps. -Sélectionnez la cellule \textit{Noeud} et attribuez cette condition au noeud amont. -Les noms des noeuds sont rappelés dans le panneau de droite, avec une vue du réseau. +Sélectionnez la cellule \textit{N½ud} et attribuez cette condition au n½ud amont. +Les noms des n½uds sont rappelés dans le panneau de droite, avec une vue du réseau. Sélectionnez maintenant la ligne entière et cliquez sur le bouton d'édition \includegraphics[width=0.5cm]{"../../../src/View/ui/ressources/edit.png"}. -Vous avez ouvert la fenêtre \textit{Modifier les conditions aux limites}. +Vous avez ouvert la fenêtre \textit{Éditer les conditions aux limites}. Dans un éditeur de texte, ouvrez le fichier \texttt{data/Fevrier\_2002.txt}. -Copiez le contenu du fichier (par exemple avec \textit{ctrl+a} puis \textit{ctrl+c}) et collez-le dans le panneau de gauche de la fenêtre \textit{Modifier les conditions aux limites} avec \textit{ctrl+v}. +Copiez le contenu du fichier (par exemple avec \textit{ctrl+a} puis \textit{ctrl+c}) et collez-le dans le panneau de gauche de la fenêtre \textit{Éditer les conditions aux limites} avec \textit{ctrl+v}. Vous pouvez maintenant voir la courbe de débit : \begin{center} \includegraphics[width=15cm]{img/fev2002.png} \par\end{center} -Fermer cette fenêtre. -Revenez sur la fenêtre \textit{Conditions aux limites}. -Ajoutez une nouvelle ligne, donnez lui un nom, donnez lui le type \textit{Q(Z)} (courbe de tarage) et associez-la au noeud aval du réseau. -Cette condition limite se trouve au niveau d'un seuil. -A cet endroit, l'écoulement passe d'un régime fluvial à un régime torentiel. -Nous allons donc calculer une courbe de tarage qui correspond au régime critique de l'écoulement au niveau du seuil. -Sélectionnez la condition limite et ouvrez la fenêtre \textit{Modifier les conditions aux limites} : (\includegraphics[width=0.5cm]{"../../../src/View/ui/ressources/edit.png"}). -Dans la fenêtre \textit{Modifier les conditions aux limites} cliquez sur \texttt{[Générer régime critique]} pour générer cette courbe. -Cliquez enduite sur \texttt{[Rendre croissant]} pour suprimer les points de la courbe qui ne sont pas strictement croissants. -Vous pouvez fermer les fenêtres \textit{Modifier les conditions aux limites} et \textit{Conditions aux limites}. +Fermer cette fenêtre. Revenez sur la fenêtre \textit{Conditions aux limites}. +Ajouter une nouvelle ligne, lui donner un nom, lui donner le type \textit{Z(T)} et l'associer au n½ud aval du réseau. +Ouvrez la fenêtre d'édition des conditions aux limites (\includegraphics[width=0.5cm]{"../../../src/View/ui/ressources/edit.png"}). +Ajoutez deux lignes. Dans la première, entrez le temps : 0.00.00 et Z : 15.000. +Dans la seconde, saisissez le temps : 1.00.00 et Z : 15.000. +Cela crée une côte constante de l'eau en aval. +Pour le calcul, le solveur extrapolera continûment l'élévation de l'eau si le temps de la simulation dépasse le dernier point de la courbe. +Vous pouvez fermer les fenêtres \textit{Éditer les conditions aux limites} et \textit{Conditions aux limites}. + +% Fermer cette fenêtre. +% Revenez sur la fenêtre \textit{Conditions aux limites}. +% Ajoutez une nouvelle ligne, donnez lui un nom, donnez lui le type \textit{Q(Z)} (courbe de tarage) et associez-la au noeud aval du réseau. +% Cette condition limite se trouve au niveau d'un seuil. +% A cet endroit, l'écoulement passe d'un régime fluvial à un régime torentiel. +% Nous allons donc calculer une courbe de tarage qui correspond au régime critique de l'écoulement au niveau du seuil. +% Sélectionnez la condition limite et ouvrez la fenêtre \textit{Éditer les conditions aux limites} : (\includegraphics[width=0.5cm]{"../../../src/View/ui/ressources/edit.png"}). +% Dans la fenêtre \textit{Éditer les conditions aux limites} cliquez sur \texttt{[Générer régime critique]} pour générer cette courbe. +% Cliquez ensuite sur \texttt{[Rendre croissant]} pour suprimer les points de la courbe qui ne sont pas strictement croissants. +% Vous pouvez fermer les fenêtres \textit{Éditer les conditions aux limites} et \textit{Conditions aux limites}. \section{Créer les conditions initiales} -Dans la fenêtre principale, cliquez sur \texttt{[Hydraulique] => [Conditions initiales]} ou sur le racourci \includegraphics[width=0.5cm]{"../../../src/View/ui/ressources/boundary_condition.png"}. -Pour démarer, le code de calcul hydraulique a besoin de connaitre le débit et la cote de la surface libre de la rivière en tout point à l'instant initial. +Dans la fenêtre principale, cliquez sur \texttt{[Hydraulique] => [Conditions initiales]} ou sur le raccourci \includegraphics[width=0.5cm]{"../../../src/View/ui/ressources/boundary_condition.png"}. +Pour démarrer, le code de calcul hydraulique a besoin de connaître le débit et la cote de la surface libre de la rivière en tout point à l'instant initial. Si vous ne connaissez pas ces conditions initiales, vous pouvez utiliser les boutons \texttt{[Générer une profondeur uniforme]}, \texttt{[Générer un débit uniforme]} ou \texttt{[Générer une cote uniforme]} pour laisser Pamhyr2 estimer une condition initiale à l'aide de la formule de Manning-Strickler. -Cliquez sur \texttt{[Générer un débit uniforme]} et saisissez un débit de $4 m^3/s$ dans la fenêtre contextuelle, et cochez \texttt{[Générer une profondeur]} pour générer une condition initiale de hauteur d'eau basée sur la formule de Manning-Strickler pour le débit donné. +Cliquez sur \texttt{[Générer un débit uniforme]} et saisissez un débit de 4 m$^3$/s dans la fenêtre contextuelle, et cochez \texttt{[Générer une profondeur]} pour générer une condition initiale de hauteur d'eau basée sur la formule de Manning-Strickler pour le débit donné. Vous devriez voir : @@ -273,8 +282,8 @@ Vous devriez voir : \includegraphics[width=15cm]{img/ic.png} \par\end{center} -Vous pouvez également utiliser \texttt{[Générer une cote uniforme]} et saisir une cote de $21 m$ à l'amont et à l'aval avec un débit nul. -Cela revient à créer une bassine et à laisser le solveur la vider pour trouver un écoulement initial satisfaisant. +% Vous pouvez également utiliser \texttt{[Générer une cote uniforme]} et saisir une cote de 21 m à l'amont et à l'aval avec un débit nul. +% Cela revient à créer une bassine et à laisser le solveur la vider pour trouver un écoulement initial satisfaisant. Lors des prochaines simulations, vous pouvez utiliser l'état final de la simulation précédente comme état initial. Pour cela, cliquez sur \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/import.png} et retrouvez le résultat sous forme de fichier \textit{.BIN}. @@ -318,10 +327,11 @@ Vous pouvez maintenant fermer la fen Parfois, il peut y avoir des sections en travers dans lesquelles les équations de Saint-Venant ne peuvent pas être utilisées pour modéliser l'écoulement de l'eau. Dans ce cas, nous devons définir une autre loi pour relier la côte de l'eau et le débit. C'est le cas, par exemple, au niveau des ponts lorsque la hauteur d'eau est trop élevée et que l'écoulement passe en charge. -Pamhyr2 permet de définir différents ouvrages hydrauliques avec des lois paramétrisables. +Pamhyr2 permet de définir différents ouvrages hydrauliques avec des lois paramétrables. Dans notre cas, nous allons devoir modéliser deux ponts par des ouvrages hydrauliques. Dans la fenêtre principale, cliquez sur \texttt{[Hydraulique] => [Ouvrages hydrauliques]} pour ouvrir la fenêtre des ouvrages hydrauliques. -Cliquez deux fois sur le bouton \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/add.png} pour créer deux ouvrages hydrauliques. +Cliquez trois fois sur le bouton \includegraphics[width=0.5cm]{"../../../src/View/ui/ressources/add.png"} pour créer trois ouvrages hydrauliques. +% Cliquez deux fois sur le bouton \includegraphics[width=0.5cm]{"../../../src/View/ui/ressources/add.png"} pour créer deux ouvrages hydrauliques. Chaque structure peut avoir un nom et doit avoir un bief et un PK. Définissez-les comme suit : @@ -329,9 +339,17 @@ D \includegraphics[width=15cm]{img/hs.png} \par\end{center} +Sélectionnez le seuil aval et cliquez sur \includegraphics[width=0.5cm]{"../../../src/View/ui/ressources/edit.png"} pour modifier les lois de cet ouvrage. Les ouvrages hydrauliques sont composés d'ouvrages hydrauliques élémentaires. Vous pouvez combiner les lois de plusieurs ouvrages hydrauliques élémentaires pour créer votre ouvrage. Pour ce seuil, nous n'avons besoin que d'un ouvrage hydraulique élémentaire de type déversoir. Cliquez sur \includegraphics[width=0.5cm]{"../../../src/View/ui/ressources/add.png"} pour ajouter un nouvel ouvrage hydraulique élémentaire, donnez-lui le type \textit{seuil} et configurez-le comme suit : + +\begin{center} +\includegraphics[width=15cm]{img/Seuil.png} +\par\end{center} + +Retournez à la fenêtre \textit{Ouvrages hydrauliques}. + Sélectionnez le pont RD101 et cliquez sur \includegraphics[width=0.5cm]{"../../../src/View/ui/ressources/edit.png"} pour éditer les lois de cet ouvrage. -Les ouvrages hydrauliques sont composés d'ouvrages hydrauliques élémentaires. -Vous pouvez combiner les lois de plusieurs ouvrages hydrauliques élémentaires pour créer votre ouvrage. +% Les ouvrages hydrauliques sont composés d'ouvrages hydrauliques élémentaires. +% Vous pouvez combiner les lois de plusieurs ouvrages hydrauliques élémentaires pour créer votre ouvrage. Un pont peut être modélisé comme une combinaison d'un orifice pour l'écoulement sous le pont et d'un déversoir pour l'écoulement au-dessus du pont. Créez deux ouvrages hydrauliques élémentaires à l'aide du bouton \includegraphics[width=0.5cm]{../../../src/View/ui/ressources/add.png} et définissez-les comme suit :