Keep in mind that only a very simplified simulation can be performed with the graphical user interface.
Below is a list of all the zones of the dialog and which information to enter in them.
Enter the path to Polyphemus (for example ~/Polyphemus-1.1/). You can also push the button to open a path selecting dialog. This is the advised method as it is less error prone.
Please note that programs "preprocessing/ground/luc-usgs", "preprocessing/ground/roughness", "preprocessing/meteo/MM5-meteo", "preprocessing/meteo/Kz_TM", and "driver/polair3d" must be compiled before you launch a computation.
You can use the raw data from the Eulerian test-case for Polyphemus.
Note that you may have to modify the values given in the section "[MM5]" of "configuration/MM5-meteo.cfg". To check the value given (projection type, time step, number of time steps, etc.), use Polyphemus/utils/MM5_var_list.
Enter the dates in format YYYY-MM-DD_HH-II-SS where YYYY is the four-digit year, MM the two-digit month (between 01 and 12), DD the two-digit day (between 01 and 31), HH the two digit hour(between 00 and 23), II the two-digit minutes (between 00 and 59) and SS the two-digit seconds (between 00 and 59). Note that the hour, minute and second are optional and have a defalut value of 0.
There are two dates given (both in that format): the beginning date and the end date for the simulation. The end date is excluded and the simulation will stop ten minutes before this date.
You can choose between two parameterizations for vertical diffusion (for more details on those parameterizations, see AtmoData scientific documentation, available at http://www.enpc.fr/cerea/polyphemus/doc/AtmoData-1.1-scientific_doc-1.pdf):
The "File" menu of the MenuBar allows you to do several things:
The "Edit" menu of the MenuBar offers several options:
The "Computation" menu of the MenuBar offers several options:
The "Image" menu of the MenuBar offers several options:
First you need to complete the dialog, that is to say enter the domain considered the date, the path to raw data...
To do so, you can use a configuration file from a previous simulation or the one which is distributed with polyphemus_display.py (file configuration.cfg). Note that the configuration file considered is not one of the configuration files needed by the programs of Polyphemus.
Once all information required are given, you can launch the preprocessing phase. It is by far the longest computation, so you should consider whether it needs being recomputed or not. Keep in mind that the results of a preprocessing are stored and are only cleared when you push the button "Preprocessing". So as long as you keep the same domain and the same date, you do not need to perform preprocessing over again. For example if you only change the species involved, the initial quantity or if you change the parameterization of vertical diffusion from Troen & Mahrt to Louis, you can launch the simulation directly.
Before launching the simulation, you may have to modify the point source file, to do so you can use the item of the MenuBar called "edit/Edit source file". You can set several sources, each in a section "[source]". Source type can be "continuous" or "puff".
To launch the simulation, push the button "Simulation". Results of previous computations are then cleared and replaced. Computation should only take a few minutes. Then an image is displayed: it is a map of concentration for the first time step and the first vertical level.
You can then modify the time step and the level for which the map is shown by changing the values in the line edits below the image or, for the time step, by pushing the buttons "<<" or ">>".
If you want to keep the results, move them elsewhere and keep with them the file saved with "File/Save configuration file" so you know what parameters you used to obtain those results and which domain and species were considered. You can also keep in the same directory the point source file and maybe the levels file.
With the graphical user interface you can only visualize the results. If you want to use other postprocessing abilities of Polyphemus, you can store the results somewhere and use AtmoPy as usual.
Ctrl + A | About |
Ctrl + E | Clear |
Ctrl + H | Help |
Ctrl + L | Edit levels file |
Ctrl + M | Save current image |
Ctrl + O | Load configuration file |
Ctrl + P | Preprocessing |
Ctrl + Q | Quit |
Ctrl + R | Edit source file |
Ctrl + S | Save configuration file |
Ctrl + T | Simulation |
Ctrl + Page Up | Forward |
Ctrl + Page Down | Backward |