Updated Fri Mar 2 00:17:56 2001

Tutorial

  1. Define the factory basics
  2. Add action "LoadMesh"
  3. Add action "WriteMesh"
  4. Add action "Solver"
  5. Save your factory
  6. Load factory in MapEditor
  7. Create "LoadMesh", "Solver" and "WriteMesh" action boxes
  8. Create command box
  9. Establish connexions
  10. Run simulation in specification mode

  11. Specify servers and generate

  12. Reload your computationnal path in execution mode
  13. Choose execution platforms
  14. Run the real simulation

Define factory basics

[manual]
Start the FactoryEditor :


Set factory name and description :

Define used types :

Add action "LoadMesh"

[manual]
Add the action and set its name and description :

There are no input ports for this action.
Define output ports:

Define parameters:

Add action "WriteMesh"

Add the action and set its name and description :

Define input ports :

There are no output ports.
Define parameters:

Add action "Solver"

Add the action and set its name and description :

Define input ports :

Define output ports:

Define parameters:

Save your factory

[manual]
Save the factory in file "Test.factory.xml".

Load factory in MapEditor

[manual]
Start the MapEditor :

Switch MapEditor to "Specification" mode, then load your factory descrription from "Test.factory.xml".

Create "LoadMesh", "Solver" and "WriteMesh" action boxes

[manual]
Create a "LoadMesh" action box, and set it's internal parameters. Set the "Filename" parameter as global shared :

Create a "Solver" action box, and set it's internal parameters :

Create a "WriteMesh" action box. Set the "Filename" parameter as global shared to fix the same Filename value as in LoadMesh :

Create command box

[manual]
Create a command action box, name it "EditFilename" and set it's internal ordrer to an editor command ('xterm -e vi Filename' should work almost anywhere):

Establish connexions

[manual]
Connect LoadMesh output port MeshOut to Solver input port MeshIn.
Connect Solver output port MeshOut to WriteMesh input port MeshIn.
Connect WriteMesh output port Trigger to EditFilename input port.

On WriteMesh output port, activate the UseTrigger checkbox.

Run simulation in specification mode, save your map

[manual]
Switch to "Auto Fire" mode, run your specification and look at the listing to check if it behaves as you wish it should.
Then save your map in "Test.map".

At this stage, the user should give its specification files to the integrator :
  • the "Test.factory.xml" file as a specification file
  • the "Test.map" as a use case file
The user should keep its "Test.map" file, because it'll be directly used for steering the simulation once the integrator will have provided a proper implementation.

Specify servers and generate

[manual]
Launch the FactoryEditor, load the "Test.factory.xml" factory specification, and complete the "Server" tab of each action notebook with the name of the FactoryObjects (see FactoryACtion documentation) that will be needed to realize the implementation.
For each "LoadMesh", "WriteMesh" and "Solver" action, specify you'll need the "FactoryObjectTest" server :

Save your updated factory description, and generate the C++ wrapper :


You should now switch to the FactoryAction tutorial to complete the implementation of the specified FactoryAction.
Let's assume we're back in user's role, with a finished implementation. Our integrator gave us a FactoryActionTest, and we started it.

Reload your computationnal path in execution mode

[manual]
Leave MapEditor in "Execution" mode, then load your factory description from the running FactoryActionTest.
Load your saved map "Test.map".

Choose execution platforms

[manual]
For each of the "LoadMesh", "WriteMesh" and "Solver" action boxes, you'll need to specify the host on which you'll want your simulation to run.
See with your integrator if he's set the automatic activation or not, and act accordingly (see manual).
Save your updated computationnal path in "Test.map".

Run the real simulation

[manual]
Switch to "Auto Fire" mode, and run your computation !