Skip to content

tutorials
tutorials

Mobile app

Last edited by Christophe Geuzaine
Page history

The ONELAB mobile app is available for iOS (iPhone and iPad) and Android:

The mobile app runs all computations locally on your mobile device. It contains full-featured versions of Gmsh and GetDP, including common dependencies (PETSC, OpenCASCADE).

Running a pre-packaged model

The list of available models appears when you launch the app. Selecting a model will load it. You can then press Run to launch a simulation with the default set of parameters. When available, additional information about a model can be obtained by long-pressing on the model description and selecting Visit model website.

Modifying a model

To run a model with different parameters, press Parameters and modify any of the presets. Then press Run again: all the simulation steps will be performed with the new parameter values. To restore the preset parameters values, press Reset.

Advanced users can also directly edit the model input files: long-press on the model description and select Edit model files. To free up space, temporary model files (meshes, solution files) can be removed by long-pressing on the model description and selecting Clear results. To completey remove a model, long-press on the model description and select Remove.

Sharing a model

To share a model by email, long-press on the model description and select '''Email model files'''.

Installing a new model

To install a new model:

  • Put all the model files (.pro, .geo) in a directory, which should also contain a file named infos.xml with the model information:
<?xml version="1.0" encoding="utf-8"?>
<models>
  <model>
    <title>Your model title</title>
    <summary>Your model summary</summary>
    <file type="pro">your_main_pro_file.pro</file>
    <preview type="png">your_128x128_pixel_screenshot.png</preview>
    <url>http://your_model_website.com</url>
  </model>
</models>

See e.g. the Waveguides model.

  • Zip the directory.

  • Open the .zip file on your device (e.g. through iCloud, Dropbox or Google Drive; or by emailing it to yourself and opening the attachment; or by putting it on a web server and downloading the file on the device with Safari or Chrome).

The new models will be extracted alongside the app's built-in models.

Compiling Onelab/Mobile

The source code of the ONELAB mobile app is available in the contrib/mobile directory of the Gmsh source code repository. Build scripts are provided for iOS and Android.