doc:user:tutorials:premiertest
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
doc:user:tutorials:premiertest [2014/08/07 22:45] – joris | doc:user:tutorials:premiertest [2016/07/11 15:04] (current) – [Making a film with the results] boemer | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ~~NOTOC~~ |
+ | ====== | ||
- | ===== Introduction ===== | ||
- | To start Metafor, several options are available : | + | ===== Preliminary remarks ===== |
+ | |||
+ | <note important> | ||
- | * Double-click the program icon (highly recommended). The GUI will then appear and most controls can be performed with the mouse. | ||
- | * Open a DOS window (Start button - type cmd in the search box - click on cmd.exe) or a Unix shell. Go then to the Metafor directory ('' | ||
- | When an error occurs while reading a module, you MUST restart Metafor. Therefore, developing a test case is most often done by clicking on the icon then using the up arrow to recall the last command. | ||
- | When the data set is not in the same directory as Metafor (or one of its * subdirectories) and the console mode is used, the environment variable '' | ||
===== Running a test with the GUI ===== | ===== Running a test with the GUI ===== | ||
- | ==== Description ==== | + | ==== Description |
- | + | Double-click the "Run Metafor" | |
- | To check that all is going well, a first test should be run using the GUI. | + | |
- | + | ||
- | Double-click the "Run Metafor " icon on your desktop. The GUI opens: | + | |
{{ doc: | {{ doc: | ||
- | - The title bar. It contains the version number of your executable | + | - The title bar. It contains the version number of your Metafor |
- The menu bar. It is useful for managing interface options (File menu / GUI Options) and 3D active display windows (Windows menu). | - The menu bar. It is useful for managing interface options (File menu / GUI Options) and 3D active display windows (Windows menu). | ||
- | - The toolbar. It gathers the most commonly used commands, such as the "meta ()" | + | - The toolbar. It gathers the most commonly used commands, such as the '' |
- | - The python command line : it allows the user to enter Metafor commands by hand or to use Metafor as a simple python interpreter. | + | - The python command line: it allows the user to enter Metafor commands by hand or to use Metafor as a simple python interpreter. |
- | - The history command window : it allows a quick access to past commands. A contextual menu allows the user to manage the history. | + | - The history command window: quick access to copy/paste older commands. A contextual menu allows the user to manage the history. |
- | - The output python window. It is a contextual menu which allows to print or set different layout options. | + | - The output python window, which displays the text output of the program. |
- | - The "python path". It lists all available python modules that can be imported. | + | - The "Python PATH", which lists all available python modules that can be imported. |
- | - The " | + | - The " |
- | - The links. | + | - The links. |
- | - The " | + | - The " |
- | + | ||
- | + | ||
- | + | ||
==== Loading a Module ==== | ==== Loading a Module ==== | ||
Line 41: | Line 32: | ||
{{ doc: | {{ doc: | ||
- | Each Metafor | + | A test case of Metafor |
- | Therefore, the first step usually consists in loading | + | Therefore, the first step usually consists in loading |
- | To load a module | + | To load a module |
Alternatively, | Alternatively, | ||
Line 51: | Line 42: | ||
load(' | load(' | ||
- | in the python command line. This command loads the module angleReZoner.py, | + | in the python command line. This command loads the module |
- | This command | + | Metafor |
- | In command line, this is done with the command | + | If the module to be loaded |
- | setDir(r' | + | ==== Starting the time integration ==== |
- | If the module which must be loaded is not in the " | + | Click on the blue " |
- | + | ||
- | In command line, this is done with the command '' | + | |
- | + | ||
- | rebase(r' | + | |
- | + | ||
- | ==== Starting the integration ==== | + | |
- | + | ||
- | It is very easy to start an integration, | + | |
meta() | meta() | ||
- | This command calls the function '' | + | This command calls the function '' |
- | Then, the integration opens a 3D graphics window, which will be refreshed during computation. | + | Then, the time integration |
It is possible to close the display windows, and reopen them using the " | It is possible to close the display windows, and reopen them using the " | ||
- | When the integration | + | When the time integration |
- | + | ||
Line 86: | Line 67: | ||
{{ doc: | {{ doc: | ||
- | To load results, the corresponding module must be loaded first, as was done before starting the integration. | + | To load previously-computed |
Then, if the workspace used is the default one, Metafor automatically sets its working directory to it. Otherwise, it must be changed manually, using the workspace window. | Then, if the workspace used is the default one, Metafor automatically sets its working directory to it. Otherwise, it must be changed manually, using the workspace window. | ||
- | Once the right folder is selected, simply locate the FAC files (extension '' | + | Once the right folder is selected, simply locate the "FAC" |
- | To load other results, repeat the operation with another | + | To load other results, repeat the operation with other FAC files. The display window is updated automatically. |
\\ | \\ | ||
\\ | \\ | ||
Line 104: | Line 85: | ||
{{ doc: | {{ doc: | ||
- | For various reasons (power cut, abrupt closure of Metafore...), a simulation may have ended earlier than expected. However, it can be restarted from an intermediate FAC, usually the last one that was written before the breakdown (therefore, several saving points should be planned before running long computations). | + | For various reasons (power cut, abrupt closure of Metafor...), a simulation may have ended earlier than expected. However, it can be restarted from an intermediate FAC, usually the last one that was written before the breakdown (therefore, several saving points should be planned before running long computations). |
This is rather straightforward : | This is rather straightforward : | ||
Line 140: | Line 121: | ||
To show results in a pleasant way, an " | To show results in a pleasant way, an " | ||
- | * First, increase the number of times that results will be saved on disk. (command '' | + | * First, increase the number of times that results will be saved to disk. (command '' |
* Run the test. | * Run the test. | ||
* Load the last FAC file. Set up the scale of displayed scalar values according to their final value. Do the same for vectors, if needed. Then save the graphical options (" | * Load the last FAC file. Set up the scale of displayed scalar values according to their final value. Do the same for vectors, if needed. Then save the graphical options (" | ||
Line 150: | Line 131: | ||
===== Metafor in command line ===== | ===== Metafor in command line ===== | ||
+ | {{: | ||
Should you need to run Metafor in command line, open a command line ('' | Should you need to run Metafor in command line, open a command line ('' | ||
- | * '' | + | * '' |
- | * '' | + | * '' |
* '' | * '' | ||
- | * '' | + | * '' |
- | In interactive mode, after '' | + | In interactive mode, after '' |
To run a test : | To run a test : | ||
Line 170: | Line 152: | ||
To exit the command line, use CTRL-Z on Windows, CTRL-D on Linux/Unix. | To exit the command line, use CTRL-Z on Windows, CTRL-D on Linux/Unix. | ||
- | |||
- | \\ | ||
\\ | \\ | ||
doc/user/tutorials/premiertest.1407444304.txt.gz · Last modified: 2016/03/30 15:22 (external edit)