Onelab/Mobile

Please report bugs and suggestions for Onelab/Mobile to mobile @ onelab . info (without spaces).

Contents

Short user guide

Onelab/Mobile is available for iOS 7 (iPhone and iPad) and Android 4. It currently contains Gmsh and GetDP and runs all computations locally on your mobile device. Future versions will add support for remote calculations in the cloud.

Running a pre-packaged model

A list of available models appears when you launch Onelab/Mobile. Selecting a model will load it. You can then select Run to launch a simulation with the default set of parameters. To change parameters, select Parameters.

Installing new models on iOS

In order to install a new model on iOS, you need to bundle it inside a directory with extension .onelab. The directory should contain a file named info.xml containing the model information (see e.g. the Inductor example). You can then use file sharing in iTunes to install the model on your device. It will appear in the list of available models the next time you restart the application.

Installing new models on Android

On Android, you can simply open .geo or .pro files from a file explorer.

Installing unpublished/beta versions of Onelab/Mobile

Follow the instructions below if you want to install a version of Onelab/Mobile that is not published officially on the App Store (for iOS) or the Google Play store (for Android).

iOS

1. Download Onelab.ipa
2. Send us your device ID by email at mobile @ onelab . info ; we will add your device to the list of the devices allowed for Onelab/Mobile beta development.
3. Install the Onelab/Mobile application through iTunes by double-cliking on Onelab.ipa.

Android

1. Allow the installation of non-Market apps on your Android device (> Settings > Security > Unknown sources)
2. Install the application:
   1. either download Onelab.apk, upload it on your SD card and use a file explorer to open it
   2. or use the Android SDK tool adb and install the file:

      adb install Onelab.apk

   3. or use your web browser and directly download Onelab.apk on your device and install it

iOS

You will need a Mac with Xcode >= 4 and the iOS SDK >= 7.0. The Onelab/Mobile application depends on several external frameworks (Gmsh, GetDP, PETSc). Scripts in the Gmsh SVN source tree show the steps required to build these frameworks for the gmsh/contrib/mobile/utils/onelab_iossimulator_build.sh simulator and for the actual gmsh/contrib/mobile/utils/onelab_iossimulator_build.sh device.

Android

This procedure has been tested only on a Linux distribution
Requirement:

• You need to have Android SDK with a level >= 14
• You also need Android NDK to compile libraries

Compile the libraries

Most of the Android powered device run on an ARMv7 architecture.
Here is the way to compile Gmsh library for this architecture.
To do this, you need a toolchain (e.g android-cmake)

mkdir buildAndroid
cd buildAndroid
cmake -DCMAKE_TOOLCHAIN_FILE=/path/to/android.toolchain.cmake -DDEFAULT=0 -DENABLE_LIB=1 -DENABLE_BLAS_LAPACK=1 -DENABLE_MESH=1 -DENABLE_ONELAB=1 -DENABLE_POST=1 ../
make androidGmsh

Create the project

The project need multiples libraries:

• Gmsh
• GetDP
• ONELAB (see below)
• PETSc
• BLAS & LAPACK

The ONELAB library is a small library to interface the application (Java) with Gmsh (Native library). You can build it from gmsh-svn (it's in /contrib/mobile/)

To use the automated cmake procedure you have to create a directory (e.g. Gmsh) with:

• The library with directory name and without any extension (e.g. Gmsh)
• The headers (they can be obtain with "make getHeaders")

The final directory for Gmsh looks like

Gmsh/
   Gmsh
   Headers/
       *.h

Then you can create the project:

make androidProject

Then you can open the project with Eclipse or with Android Studio You can also compile using the command line:

android update project --name Onelab --path . --target targetID
ant release