Difference between revisions of "Elmer"

From ONELAB
Jump to: navigation, search
(→‎Getting started)
 
(73 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
== Getting started ==
 +
 
[http://www.csc.fi/english/pages/elmer Elmer] is an open source (GPL) computational tool for multi-physics problems.  
 
[http://www.csc.fi/english/pages/elmer Elmer] is an open source (GPL) computational tool for multi-physics problems.  
 
It is developed by CSC in collaboration with Finnish universities, research laboratories and industry.
 
It is developed by CSC in collaboration with Finnish universities, research laboratories and industry.
 +
To test ONELAB models working with Elmer, you shall need a working installation of the code.
 +
The easiest way to do so, is to install the [[ONELAB virtual machine|ONELAB virtual machine]] on your system
 +
by following [[ONELAB virtual machine|these instructions]].
  
−
= Getting started with the Virtual Machine =
+
The ONELAB Virtual machine is distributed with Gmsh and Elmer preinstalled.
−
 
+
When done with the installation, log in (username: olvm, passwd: olvm)  
−
;Step 1 - '''Install Virtual Box'''
+
and proceed by downloading benchmark ONELAB models. You have to be online.
−
:If you don't have a virtualization utility already installed on your system, go to the [https://www.virtualbox.org Oracle VirtualBox website] to download a binary package suitable for your host operating system. Follow the [https://www.virtualbox.org/manual/ch01.html#intro-installing documentation] to install the software components and to start the VirtualBox Manager.
+
* Open a terminal from the left menu bar.
−
<!--
+
* Issue the command <code>getElmerModels.sh -test</code> at the prompt. The model examples listed in the next section are then downloaded in the directory <code>ELMERMODELS</code>. Always execute this command in a new terminal. This command overwrite an eventual already existing <code>ELMERMODELS</code> directory. Valuable data in the latter directory should therefore be copied elsewhere before executing the command.  
−
In the VirtualBox Manager, check that a "Host only Network" vboxnet0 is present and properly configured with an active DHCP server
+
* The option <code>-test</code> asks for an automatic check on the downloaded models, which are solved immediately after being downloaded. The result the check is given in the file <code>ELMERMODELS/report.txt</code>.
−
(under Windows: VirtualBox > File > Settings > Network ; under OSX VirtualBox > Preferences > Network)
 
−
From a terminal on the host, check the network connectivity with the VM by a "ssh vm@amzyan.local"; enter the same "vm" password.
 
−
-->
 
−
 
 
−
;Step 2 - '''Download the Virtual Machine ONELAB_VM'''
 
−
:[http://sites.uclouvain.be/immc/mema/alain/ubuntuPLOS-i386-latest.ova Virtual Machine]
 
−
:[http://sites.uclouvain.be/immc/mema/alain/ubuntuPLOSi386-latest.ova.sha1 SHA1 checksum]
 
−
 
 
−
;Step 3 - '''Import the Virtual Machine in Virtual Box'''
 
−
:In the VirtualBox Manager, import the downloaded OVA file by following the [https://www.virtualbox.org/manual/ch01.html#ovf instructions]. A new VM entry - named ONELAB_VM appears in the left panel.
 
−
 
 
−
;Step 4 - '''Start the Virtual Machine'''
 
−
:Start the VM by double clicking its entry in the VirtualBox Manager. Enter "plos" for login and "plos" again for password (without quotes)
 
−
 
 
−
;Step 5 -
 
−
:Open the Firefox browser of the Virtual Machine, reload this page and proceed from within the Virtual Machine.
 
−
 
 
−
<!-- Do not delete
 
−
[[ONELAB metamodels with Elmer]]
 
−
[[Fluid Dynamics]]
 
−
First take a look at this [[Tutorial|tutorial]] to see how ONELAB can be installed.
 
−
-->
 
−
 
 
−
== CRYO  ==
 
−
 
 
−
Download and inflate the archive [http://onelab.info/files/elmerfem/cryo.zip cryo.zip] in a work directory.  
 
−
Then right-click on the icon <code>cryo.ol</code> and opent it with <code>gmsh</code>. Alternatively, start <code>gmsh</code> and click File-> Open-> cryo.ol from the menu.
 
−
 
 
−
The physical background is the cryogenic treatment of warts by application of a cryogenic fluid. The idea is to maximize the destruction of wart tissue cells while minimizing damages to healthy skin tissue. A damage function depending on temperature distribution and exposure time is built to represent this trade-off. The purpose of the modeling is to determine the application time that minimizes this damage function.
 
−
 
 
−
Various geometrical and modeling parameters can be interactively modified in the ONELAB window.
 
−
After execution, a plot of the damage function vs. time is displayed and the optimum application time <code>tmin</code> is shown to the ONELAB window.
 
−
 
 
−
[[File:CryoEngineering.png|CryoEngineering.png|300px|thumb|right|Cryo-engineering metamodel]]
 
  
 +
Information about the individual models are given in the next section.
 +
For beginners, a detailed tutorial that leading through the successive steps of a first session with the ONELAB-laser model is available [http://onelab.info/files/laser/laser_tuto.pdf here].
  
−
== BEAM ==
+
== ONELAB models ==
  
−
Download and inflate the archive [http://onelab.info/files/elmerfem/beam.zip beam.zip] in a work directory.
+
[[Cryotherapy|Cryotherapy]] : Thermal analysis of the cryogenic treatment of warts
  
−
== LASER ==
+
[[Beam3D|Beam3D]] : Didactical model of a 3D cantilever elastic beam
  
−
Download and inflate the archive [http://onelab.info/files/elmerfem/laser.zip laser.zip] in a work directory. Then right-click on the icon <code>cryo.ol</code> and opent it with <code>gmsh</code>. Alternatively, start <code>gmsh</code> and click File-> Open-> laser.ol from the menu.
+
[[Laser|Laser]] : Thermal analysis of laser skin stimulation
  
−
The physical background of this model is the laser stimulation of skin in order to measure the density of [http://en.wikipedia.org/wiki/Nociceptionreceptors nociceptive] receptors. For a correct interpretation of the experimental data, an accurate nowledge of the temperature distribution in time and across the skin is needed. The metamodel allows selecting various laser types (Gaussian, flat-top) and various stimus characteristics (imposed flux or controlled temperature). Each simulation generates a Gnuplot graphical output that is directly interpretable by clinicians.
+
[[Patch|Drug patch]] : Analysis of drug diffusion from a patch into the skin
  
  

Latest revision as of 12:57, 23 January 2015

Getting started

Elmer is an open source (GPL) computational tool for multi-physics problems. It is developed by CSC in collaboration with Finnish universities, research laboratories and industry. To test ONELAB models working with Elmer, you shall need a working installation of the code. The easiest way to do so, is to install the ONELAB virtual machine on your system by following these instructions.

The ONELAB Virtual machine is distributed with Gmsh and Elmer preinstalled. When done with the installation, log in (username: olvm, passwd: olvm) and proceed by downloading benchmark ONELAB models. You have to be online.

  • Open a terminal from the left menu bar.
  • Issue the command getElmerModels.sh -test at the prompt. The model examples listed in the next section are then downloaded in the directory ELMERMODELS. Always execute this command in a new terminal. This command overwrite an eventual already existing ELMERMODELS directory. Valuable data in the latter directory should therefore be copied elsewhere before executing the command.
  • The option -test asks for an automatic check on the downloaded models, which are solved immediately after being downloaded. The result the check is given in the file ELMERMODELS/report.txt.

Information about the individual models are given in the next section. For beginners, a detailed tutorial that leading through the successive steps of a first session with the ONELAB-laser model is available here.

ONELAB models

Cryotherapy : Thermal analysis of the cryogenic treatment of warts

Beam3D : Didactical model of a 3D cantilever elastic beam

Laser : Thermal analysis of laser skin stimulation

Drug patch : Analysis of drug diffusion from a patch into the skin


Retrieved from "http://onelab.info/onelab_wiki/index.php?title=Elmer&oldid=7622"