Difference between revisions of "Onelab/Mobile"

From ONELAB
Jump to: navigation, search
(Compiling Onelab/Mobile)
Line 3: Line 3:
 
* [https://itunes.apple.com/us/app/onelab/id845930897 Download Onelab/Mobile for iPhone and iPad on the App Store]
 
* [https://itunes.apple.com/us/app/onelab/id845930897 Download Onelab/Mobile for iPhone and iPad on the App Store]
 
* [https://play.google.com/store/apps/details?id=org.geuz.onelab Download Onelab/Mobile for Android devices on Google Play]
 
* [https://play.google.com/store/apps/details?id=org.geuz.onelab Download Onelab/Mobile for Android devices on Google Play]
Onelab/Mobile 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.
+
Onelab/Mobile contains [[Gmsh]] and [[GetDP]] and runs all computations locally on your mobile device.
 
 
Please report bugs and suggestions for Onelab/Mobile to mobile @ onelab . info.
 
  
 
== Running pre-packaged models ==
 
== Running pre-packaged models ==
Line 19: Line 17:
 
== Installing new models ==
 
== Installing new models ==
  
In order to install a new model, you need to bundle it inside a directory with extension '''.bundle'''. The directory should contain a file named '''infos.xml''' with the model information (see e.g. the [http://onelab.info/files/inductor Inductor] example).
+
New models must be packaged as ZIP archives. The ZIP archive  of the  
  
On iOS, you can then use [http://support.apple.com/kb/HT4094 file sharing] in iTunes to install the model on your device. On Android, you can simply copy the directory.
+
To install a new model, you must first bundle its inside a directory, which should contain a file named '''infos.xml''' with the model information:
 +
<syntaxhighlight lang="xml" enclose="div">
 +
<?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>
 +
</syntaxhighlight>
 +
(See e.g. [http://onelab.info/files/inductor Inductor] or [http://onelab.info/files/inductor Waveguides] for examples.)
 +
 
 +
The model directory should be compressed as a ZIP archive. It can then be opened directly on your device (e.g. through iCloud or Safari on iOS, or through Google Drive, Dropbox, etc. on Android).
  
 
== Installing beta versions of Onelab/Mobile ==
 
== Installing 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).
+
Please send an email to mobile@onelab.info if you want to become a Onelab/Info beta-tester.
 
 
=== iOS ===
 
 
 
# Download the latest [http://geuz.org/gmsh/beta/Onelab.ipa Onelab.ipa]
 
# 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 testing.
 
# Install the Onelab/Mobile application [https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/TestingYouriOSApp/TestingYouriOSApp.html#//apple_ref/doc/uid/TP40012582-CH8-SW6  through iTunes]  by double-cliking on '''Onelab.ipa'''.
 
 
 
=== Android ===
 
 
 
# [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)
 
# Install the application:
 
#* either download [http://geuz.org/gmsh/beta/Onelab.apk Onelab.apk] directly on your device using a web browser and install it
 
#* or download [http://geuz.org/gmsh/beta/Onelab.apk Onelab.apk] on your computer, copy 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''' to install the file: <code>adb install Onelab.apk</code>
 
  
 
== Compiling Onelab/Mobile ==
 
== Compiling Onelab/Mobile ==
  
=== iOS ===
+
The Onelab/Mobile source code is available in the [https://geuz.org/trac/gmsh/browser/trunk/contrib/mobile/ Gmsh SVN repository] {{#tip-info: Login and password: gmsh}}. Automated build scripts are provided for [https://geuz.org/trac/gmsh/browser/trunk/contrib/mobile/utils/ios_build.sh iOS] (requires a Mac with Xcode >= 6) and  
 
+
  [https://geuz.org/trac/gmsh/browser/trunk/contrib/mobile/utils/android_build.sh Android] (requires Android SDK >= 14 and the Android NDK).
You will need a Mac with Xcode >= 5. The app depends on several external frameworks (Gmsh, GetDP, PETSc, SLEPc, BLAS, LAPACK) ; a script in the Gmsh SVN repository shows the steps required to
 
[https://geuz.org/trac/gmsh/browser/trunk/contrib/mobile/utils/ios_build.sh build these frameworks and the app] {{#tip-info: Login and password: gmsh}}.
 
 
 
=== Android ===
 
 
 
You will need the Android SDK with level >= 14 and the Android NDK. The app depends on several external frameworks (Gmsh, GetDP, PETSc, SLEPc, BLAS, LAPACK) ; a script in the Gmsh SVN repository shows the steps required to [https://geuz.org/trac/gmsh/browser/trunk/contrib/mobile/utils/android_build.sh build these frameworks and the app] {{#tip-info: Login and password: gmsh}}.
 

Revision as of 19:39, 26 September 2015

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 pre-packaged models

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

New models must be packaged as ZIP archives. The ZIP archive of the

To install a new model, you must first bundle its inside a directory, which should contain a file named infos.xml with the model information: <syntaxhighlight lang="xml" enclose="div"> <?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> </syntaxhighlight> (See e.g. Inductor or Waveguides for examples.)

The model directory should be compressed as a ZIP archive. It can then be opened directly on your device (e.g. through iCloud or Safari on iOS, or through Google Drive, Dropbox, etc. on Android).

Installing beta versions of Onelab/Mobile

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

Compiling Onelab/Mobile

The Onelab/Mobile source code is available in the Gmsh SVN repository {{#tip-info: Login and password: gmsh}}. Automated build scripts are provided for iOS (requires a Mac with Xcode >= 6) and

Android (requires Android SDK >= 14 and the Android NDK).