¶ Notion de projet et de modèle
Un modèle correspond à la description, par le biais d'objets de modélisation spécifiques, du territoire à modéliser.
Un projet appelle un ou plusieurs modèles et contient les paramètres généraux non liés à un seul modèle.
Le pilotage des calculs se fait au niveau du projet.
Les données associées à chaque projet et chaque modèle sont structurées en tables dans la base de données sous-jacente. A chaque projet correspond une base de données, structurée en différents schémas :
- un schéma par modèle,
- un schéma “project” regroupant les tables de gestion du projet, communes à tous les modèles hydrauliques du projet. Ce sont des tables généralement alphanumériques décrivant des données non géographiques telles que :
- le paramétrage des scénarios de consommation,
- le paramétrage des scénarios de calcul,
- le paramétrages des alarmes,
- les paramètres d’exploitation de résultats,
- etc.
les schémas ci-dessous illustrent les correspondance entre un système hydraulique et la base de données sous-jacente :
A noter que les modèles peuvent être connectés entre eux lors du calcul (via l'élément “model_connexion”)
¶ Gestion des projets
¶ Création d'un projet
La création d'un nouveau projet se fait via les menus suivants :
Expresseau → Nouveau projetExpresseau → Gérer les projetspuis boutonNouveau projet
La fenêtre de création s'affiche alors :
Lors de la création d'un nouveau projet, l'utilisateur défini :
- Un nom (sans majuscule ni espace),
- Un système de projection, qui sera appliqué à l'ensemble des modèles constituant le projet,
- Un répertoire de travail dans lequel seront notamment créé les fichiers de résultats de calcul. Ce chemin est également utilisé comme chemin relatif pour les fichiers externes appelés lors du lancement des calculs. Ce répertoire doit être situé sur le même disque que celui où sont lancés les calculs
L'application crée les tables associées au projet dans la base de données et charge les vues graphiques associées :
A ce stade, aucun modèle n'est associé au projet. Ils sont créés dans un second temps.
Un répertoire portant le nom du projet est créé dans le répertoire de travail ainsi qu'un fichier “projet.qgs” qui sera appelé lors de l'ouverture d'un projet.
Le fichier projet.qgs est mis à jour lors de l'enregistrement du projet sous QGIS, les mises en forme spécifiques ainsi que tables complémentaires appelées par l'utilisateur sont enregistrées et chargées à la prochaine ouverture du projet.
Si l'utilisateur souhaite choisir un autre répertoire que le .expresseau, un fichier nom_du_projet.path est crée dans le .expresseau. Il contient juste le chemin vers le vrai répertoire projet.
Il est également possible de déplacer un projet en créer le .path à la main.
¶ Ouverture d'un projet existant
Pour ouvrir un projet existant, utiliser le menu Expresseau → Gérer les projets.
Sélectionner le projet puis cliquer sur Ouvrir le projet.
L'ouverture d'un projet entraine le chargement de l'ensemble des tables associées et des outils de création et d'exploitation des modèles dans l'interface.
¶ Import/export d'un projet
¶ Import/export simple
Les fonctionnalités d'import / export permettent de sauvegarder et d'échanger un projet via un fichier .sql unique, contenant la structure et le contenu de la base de données associée.
Ces fonctionnalités sont accessibles via Expresseau → Gérer les projets via le bloc de boutons sur la droite : Exporter le projet et Importer un projet
Lors de l'export, l'utilisateur sélectionne le répertoire dans lequel le fichier *.sql sera créé.
Lors de l'import, l'utilisateur sélectionne le fichier *.sql à importer, et renseigne le nom du projet à créer (qui peut différer de celui du fichier importé) ainsi que le répertoire de travail.
Si dans le modèle source des fichiers externes appelés par le gestionnaire de scénario étaient situés dans un sous répertoire du répertoire de travail, ces fichiers seront recherchés par défaut dans le même sous répertoire du répertoire de travail défini lors de l'import.
¶ Import/export avec données associées
A l'heure actuelle, les données associées ne sont pas exportées/importées.
Il est conseillé de stocker ses données dans le répertoire “data” du projet .expresseau/monprojet et de zippé ces données pour les transmettre.
¶ Mise à jour d'un projet existant
La mise à jour du plugin peut nécessiter la modification de la structure de la base de données sous-jacente. Les projets présentant une structure de base de données non compatible avec la version du plugin installée ont leur numéro de version indiqué en rouge dans le gestionnaire de projet, et ne peuvent être ouverts.
La fonction de mise à jour permet de mettre à jour la structure de la base de données de ces projets afin de les rendre compatibles avec le plugin installé et de les ouvrir.
Cette fonction est accessible via Express'eau → Gérer les projets → Mettre à jour le projet
La mise à jour de la base de données est irréversible. Si besoin, exporter préalablement le modèle pour en conserver une sauvegarde dans la version antérieure.
¶ Copie d'un projet existant
Express'eau → Gérer les projets → Dupliquer le projet permet de dupliquer un projet, sous un autre nom.
¶ Gestion des modèles
Les fonctions de gestion des modèles sont disponibles lorsqu'un projet est ouvert.
Définir le modèle courant: définition du modèle actif, pour la création des objets de modélisation (également disponible via la barre d'outils),Ajouter un modèle: création et ajout d'un nouveau modèle au projet actif; l'application crée le schéma correspondant dans la base de données et charge les tables associées dans l'interface,Supprimer le modèle courant: suppression du modèle actif.
D'autres options sont disponibles dans le manager de projet :
Importer un model: import d'un modèle depuis un export sql d'un modèle ou d'un projet ou depuis un fichier EPANET (pour l'import de modèle EPANET, consulter cette page dédiée)Exporter un model: export d'un modèle au format sql ou vers un fichier EPANET.
Attention :
- Un maximum de 20 modèles distincts peut être créé dans un même projet (Attention : la base de données ne limite pas le nombre de modèles à 20 modèles mais les simulations échoueront s'il y a plus de 20 modèles dans la base)
- Les modèles ont le même système de projection que le projet; il est impossible d'importer un modèle défini dans un autre système de projection que celui du projet.
Les différents outils de construction et d'exploitation des modèles sont chargés lors de la création du premier modèle associé au projet ouvert.