Installation and Use of Mage
This part aims at showing a potential user of Mage how to install this software on a PC (Windows), and how to use it simply. Our experience is not very important, but we expect that this page will be able to make potential users save time.
Installation of Mage
Use of Mage
The graphical interface
Mage is an improved version of Fluvia. One of the main changing is the graphical interface. Indeed, the use of Mage is controlled by a simple window, which is activated by clicking on Mage5Edit in the directory Mage.
From this window, one can create all the files which are necessary for the simulation, one can start a run, and one can draw graphics and exploit results.
The Project Directory
Before starting filling in the different data files with the graphical
interface, it is recommanded to create a project directory. The user can
give the name of its choice.
Then, the user can activate the graphical interface by clicking on Mage5Edit in the directory Mage. Then, on this window, one has to click on Fichier, then on Configuration. The following window will appear :
In the areas Repertoire des données and Nom du fichier répertoire , the user should substitute the names of the directory and the file with the new names corresponding to his project.
Thus, by clicking on the different buttons of the graphical interface, the files will be directly created in the good directory.
Principle of the running of Mage
Before seeing how to generate the different files which are used for
the simulation, it is interesting to know how Mage runs.
Here are the different steps :
1 - Talweg processes the geometry.
2 - Then, Fluvia initializes the simulation by calculating the water line for the steady rate of flow.
3 - Thirdly, DonMag converts the datas of the problem and the outputs obtained with Fluvia into compatible inputs for Mage.
4 - Then, Mage solves the transient problem.
5 - And finally, the results treatment is done with Graphe.
It clearly turns out that Mage is a complement of Fluvia for the transient
rates of flow.
Fluvia is necessary to calculate the steady water line, at the beginning of the problem. But, for a problem of compatibility, before starting the transient simulation, Mage calculates the steady water line again.
It is also possible to restart a simulation from a step picked up from a previous run. (cf User Manual)
Mage requires many files in order to perform a simulation. Certain are
directly filled in by the user thanks to the graphical interface, and some
others are created during the pre processing by Talweg, DonMag, ... We
have distinguished two kinds of files : those which are obligatory and
those which are optional.
Here is the list of these files. For each one we have indicated which button of the graphical interface corresponds to.
For further informations about the way of filling in these different files, the user should look at the user manual. This is the way to reach it : mage/documents/Doc_utilisateur_Mage5/ . In this directory, one has to click on the file Mage5_doc_utilisateur. It can be runned on Netscape.
The post processing is controlled by the graphical interface. The user can generate some different graphics : hydrogram Q(t), limnigram H(t), water level H(z), ...
This paragraph allows us to give a potential user of Mage several advice, derived from the different problem we encoutered.