Usage of OpenFLUID applications

OpenFLUID simulations can be run either using the command line interface (openfluid program), the graphical user interface (openfluid-builder program), or using the R environment through the ROpenFLUID package.
All these programs and packages use the same input dataset format (See Formats of input datasets), and propose all concepts and features of the OpenFLUID software environment, as they share the same OpenFLUID software framework. A simulation input dataset can be executed using any of the following OpenFLUID software programs.

Graphical User Interface - OpenFLUID-Builder

The OpenFLUID-Builder user interface proposes a graphical environment to prepare, parameterize, execute and exploits simulations with OpenFLUID. It is a good starting point for beginners who discover the OpenFLUID concepts and environment. Once OpenFLUID installed, it can be run either from the program menu of your system or from a console using the openfluid-builder command.

screenshot_builder_model_html.png
Screenshot of the model view in OpenFLUID-Builder


screenshot_builder_map_html.png
Screenshot of the spatial domain map view in OpenFLUID-Builder

OpenFLUID-Builder functionalities can be extended by Builder-extensions which are graphical plugins for this user interface. By default, OpenFLUID is provided with two Builder-extensions: a graph viewer representing the spatial domain as a connected graph, and a spatial data importer to create a spatial domain from standard GIS data file formats (such as Shapefiles) or from a WFS service (Web Feature Service) available from a local or an internet server.

Command-line interface

The OpenFLUID command line interface allows to run OpenFLUID simulations from a terminal, using the openfluid command. This usage is particularly useful for running multiple simulations in batch or on compute systems such as compute clusters.
To run the simulation, execute the openfluid command with adapted command line options. You can run a simulation by giving the input dataset path and the results output path:

openfluid -i </path/to/dataset> -o </path/to/results>

You can also run a simulation from an OpenFLUID project, using the -w or --project command line option, followed by the path to the project path. In this case, the project must be a valid OpenFLUID project, usually created using the OpenFLUID-Builder user interface, or by hand.

See Command line options or run openfluid --help to get the list of available options.

screenshot_cmdline.png
OpenFLUID simulation using command line

From within the GNU R environment - ROpenFLUID

OpenFLUID can be used from within the GNU R environment with the ROpenFLUID package. This package allows to load an input dataset, parameterize and run a simulation, exploits simulation results.
It is really useful for taking benefit of all R features and packages for sensitivity analysis, optimization, uncertainty propagation analysis, and more.

Example of a simulation launch in R using the ROpenFLUID package:

library('ROpenFLUID')
ofsim = OpenFLUID.loadDataset('/path/to/dataset')
OpenFLUID.runSimulation(ofsim)
data = OpenFLUID.loadResult(ofsim,'TestUnits',15,'var.name')

More details are available in the specific ROpenFLUID documentation, available on the OpenFLUID web site.

 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines