Difference between revisions of "Onelab/Mobile"

From ONELAB
Jump to: navigation, search
 
(51 intermediate revisions by 2 users not shown)
Line 1: Line 1:
  
−
Please report bugs and suggestions for Onelab/Mobile to mobile @ onelab . info (without spaces).
+
Onelab/Mobile is available for iOS (iPhone and iPad) and Android:
−
 
+
* [https://itunes.apple.com/us/app/onelab/id845930897 Download Onelab/Mobile for iPhone and iPad on the App Store]
−
= Short user guide =
+
* [https://play.google.com/store/apps/details?id=org.geuz.onelab Download Onelab/Mobile for Android devices on Google Play]
−
 
+
Onelab/Mobile contains [[Gmsh]] and [[GetDP]] and runs all computations locally on your mobile device.
−
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 ==
 
== 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'''.
+
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'''.
−
 
 
−
== 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 [http://onelab.info/files/inductor Inductor] example). You can then use [http://support.apple.com/kb/HT4094 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 [https://play.google.com/store/search?q=file%20explorer&c=apps 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).
+
<gallery widths=133px heights=200px perrow=3>
 +
Image:iPhone_1.png|List of models on iPhone; select a model to open it.
 +
Image:iPhone_2.png|Press '''Run''' to launch a computation with the default set of parameters.
 +
Image:iPhone_3.png|Press '''Parameters''' to see and/or modify the parameters.
 +
</gallery>
  
−
== iOS ==
+
== Modifying a model ==
  
−
# Download '''Onelab.ipa'''
+
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'''.  
−
# Send us your [https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html##//apple_ref/doc/uid/TP40012582-CH30-SW46 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.
 
−
# Install the Onelab/Mobile application through iTunes by [https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/TestingYouriOSApp/TestingYouriOSApp.html#//apple_ref/doc/uid/TP40012582-CH8-SW6 double-cliking on '''Onelab.ipa'''].
 
  
−
== Android ==
+
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'''.
  
−
# [https://developer.android.com/tools/publishing/publishing_overview.html#unknown-sources Allow the installation of non-Market apps] on your Android device (> Settings > Security > Unknown sources)
+
== Sharing a model ==
−
# Install the application:
 
−
## either download '''Onelab.apk''', upload it on your SD card and use a [https://play.google.com/store/search?q=file%20explorer&c=apps file explorer] to open it
 
−
## or use the Android SDK tool '''adb''' and install the file: <source lang="bash">adb install Onelab.apk</source>
 
−
## or use your web browser and directly download '''Onelab.apk''' on your device and install it
 
  
−
= Compiling Onelab/Mobile =
+
To share a model by email, long-press on the model description and select '''Email model files'''.
  
−
= iOS =
+
== Installing a new model ==
  
−
You need a Mac with Xcode >= 4 and the iOS SDK >= 7.0 to compile the Onelab/Mobile application. The app depends on several external frameworks (Gmsh, GetDP, PETSc) ; scripts in the Gmsh SVN repository show the steps required to build these frameworks for the [https://geuz.org/trac/gmsh/browser/trunk/contrib/mobile/utils/onelab_iossimulator_build.sh simulator] and the
+
To install a new model:
−
[https://geuz.org/trac/gmsh/browser/trunk/contrib/mobile/utils/onelab_ios_build.sh actual device] (login=gmsh, passwd=gmsh).
+
<ol>
−
 
+
<li>Put all the model files (.pro, .geo) in a directory, which should also contain a file named '''infos.xml''' with the model information:
−
= Android =
+
<source lang="xml">
−
 
+
<?xml version="1.0" encoding="utf-8"?>
−
You need the Android SDK with level >= 14, as well as the Android NDK to compile the libraries that Onelab/Mobile depends on. Scripts will be made available in the near future.
+
<models>
−
 
+
  <model>
−
<!--
+
    <title>Your model title</title>
−
 
+
    <summary>Your model summary</summary>
−
''This procedure has been tested only on a Linux distribution''
+
    <file type="pro">your_main_pro_file.pro</file>
−
<br />
+
    <preview type="png">your_128x128_pixel_screenshot.png</preview>
−
Requirement:
+
    <url>http://your_model_website.com</url>
−
*
+
  </model>
−
== Compile the libraries ==
+
</models>
−
Most of the Android powered device run on an ARMv7 architecture. <br />
 
−
Here is the way to compile Gmsh library for this architecture. <br />
 
−
To do this, you need a toolchain (e.g [http://code.google.com/p/android-cmake/ android-cmake])<br />
 
−
<source lang="bash">
 
−
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
 
 
</source>
 
</source>
 +
(See e.g. [http://onelab.info/files/inductor Inductor] or [http://onelab.info/files/waveguides Waveguides].)
 +
<li>[https://en.wikipedia.org/wiki/Zip_%28file_format%29 Zip] the directory.
 +
<li>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).
 +
</ol>
 +
The new models will be extracted alongside the app's built-in models.
  
−
== Create the project ==
+
== Installing beta versions of Onelab/Mobile ==
−
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).
+
Please send an email to mobile@onelab.info if you want to become a Onelab/Mobile beta-tester.
−
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:
+
== Compiling Onelab/Mobile ==
−
* 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<br />
 
−
<code>
 
−
 
 
−
Gmsh/
 
−
    Gmsh
 
−
    Headers/
 
−
        *.h
 
−
</code>
 
−
 
 
−
Then you can create the project:
 
−
<source lang="bash">
 
−
make androidProject
 
−
</source>
 
−
Then you can open the project with [https://developer.android.com/sdk/installing/bundle.html Eclipse] or with [https://developer.android.com/sdk/installing/studio.html Android Studio]
 
−
You can also compile using the command line:
 
−
<source lang="bash">
 
−
android update project --name Onelab --path . --target targetID
 
−
ant release
 
−
</source>
 
  
−
-->
+
The Onelab/Mobile source code is available in the [http://gitlab.onelab.info/gmsh/gmsh/tree/master/contrib/mobile/ contrib/mobile directory of the Gmsh source code repository]. Build scripts are provided for [http://gitlab.onelab.info/gmsh/gmsh/tree/master/contrib/mobile/utils/ios_build.sh iOS] (requires a Mac with Xcode >= 6) and [http://gitlab.onelab.info/gmsh/gmsh/tree/master/contrib/mobile/utils/android_build.sh Android] (requires Android SDK >= 14 and the Android NDK).

Latest revision as of 14:55, 13 April 2017

Onelab/Mobile is available for iOS (iPhone and iPad) and Android:

Onelab/Mobile contains Gmsh and GetDP and runs all computations locally on your mobile device.

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.

  • List of models on iPhone; select a model to open it.

  • Press Run to launch a computation with the default set of parameters.

  • Press Parameters to see and/or modify the parameters.

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:

  1. 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. Inductor or Waveguides.)

  2. Zip the directory.
  3. 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.

Installing beta versions of Onelab/Mobile

Please send an email to mobile@onelab.info if you want to become a Onelab/Mobile beta-tester.

Compiling Onelab/Mobile

The Onelab/Mobile source code is available in the contrib/mobile directory of the Gmsh source code repository. Build scripts are provided for iOS (requires a Mac with Xcode >= 6) and Android (requires Android SDK >= 14 and the Android NDK).

Retrieved from "http://onelab.info/onelab_wiki/index.php?title=Onelab/Mobile&oldid=8229"