Difference between revisions of "Elmer"

From ONELAB
Jump to: navigation, search
(→‎BEAM)
(→‎Getting started)
 
(37 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
= Introduction =
+
== 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, a working installation of the software on your system is required.  
+
To test ONELAB models working with Elmer, you shall need a working installation of the code.
−
As a one-size-fits-all solution for all interfaced clients,  
+
The easiest way to do so, is to install the [[ONELAB virtual machine|ONELAB virtual machine]] on your system  
−
a specific virtual machine, called [[ONELAB virtual machine|OLVM]],
+
by following [[ONELAB virtual machine|these instructions]].
−
has been designed to have ONELAB models and client software installed on it with minimal user interaction.
 
−
You first need to install the empty virtual machine on your system by following [[ONELAB virtual machine|these instructions]].
 
−
When done, you can proceed with the installation of Elmer, and the download of benchmark ONELAB models, by following the instructions below.
 
  
−
= Installation =
+
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 <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.
 +
* 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>.
  
−
Everything is configured in the Virtual machine so that the installation of Gmsh and Elmer is done by issuing simple commands in a terminal.
+
Information about the individual models are given in the next section.
−
Open a terminal by clicking on the "terminal" icon in the launcher panel and issue the command
+
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].
−
:<code>install_scripts.sh</code>
 
−
at the prompt. This will download the needed installation scripts.
 
  
−
Then, the command
+
== ONELAB models ==
−
:<code>install_gmsh.sh</code>
 
−
will download the nightly-build of Gmsh from http://geuz.org/gmsh, install it, and place a Gmsh icon on the Desktop.
 
  
−
When done, issue the command
+
[[Cryotherapy|Cryotherapy]] : Thermal analysis of the cryogenic treatment of warts
−
:<code>install_elmer.sh</code>
 
−
which will download the source code of Elmer and compile it on the virtual machine. This may take several minutes.
 
  
−
Now, you have a woking installation of Gmsh and Elmer on the virtual machine. A number of Elmer model examples can be downloaded by issuing the command
+
[[Beam3D|Beam3D]] : Didactical model of a 3D cantilever elastic beam
−
:<code>getElmerModels.sh</code>
 
−
After all, you have a directory "ELMERMODELS" in your home directory with a number of Elmer models, which are now presented with more details.
 
  
−
= ONELAB models =
+
[[Laser|Laser]] : Thermal analysis of laser skin stimulation
  
−
== CRYO  ==
+
[[Patch|Drug patch]] : Analysis of drug diffusion from a patch into the skin
−
 
 
−
[[File:CryoEngineering.png|CryoEngineering.png|300px|thumb|right|Cryo-engineering metamodel]]
 
−
 
 
−
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 the 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 computed optimum application time <code>tmin</code> is shown in the ONELAB window in the highlighted box.
 
−
 
 
−
Launch Gmsh and open <code>ELMERMODELS/CRYO/cryo.py</code> from the "File" menu.
 
−
 
 
−
== BEAM ==
 
−
 
 
−
This model is the didactical analysis of a clamped beam (static 3D elasticity). The dimensions of the beam and the material parameter can be modified interactively in the ONELAB window, as well as a number of modeling parameters. Diagrams of the internal moments can be generated by checking the box <code>Compute MT diagrams</code>.
 
−
 
 
−
Launch Gmsh and open <code>ELMERMODELS/BEAM/beam.py</code> from the "File" menu.
 
−
 
 
−
== PATCH ==
 
−
 
 
−
[[File:Patch.png|Patch.png|300px|thumb|left|Drug patch metamodel]]
 
−
 
 
−
 
 
−
This metamodel is toolkit for drug patch conception.
 
−
The user can determine the geometry of the patch and initial drug concentrations.
 
−
A number of drugs are pre-tabulated with their diffusivities.
 
−
Elmer solves a convection-diffusion equation and post processing tools display the rate at which drug is transmitted to the skin.
 
−
 
 
−
== LASER ==
 
−
 
 
−
Download and inflate the archive [http://onelab.info/files/elmerfem/LASER.zip LASER.zip] in a work directory. Right-click on the icon <code>laser.ol</code> and open the file with <code>gmsh</code>. Alternatively, start <code>gmsh</code> and click <code>File > Open > laser.ol</code> from the menu.
 
−
 
 
−
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 knowledge of the temperature distribution in time and across the skin is needed. The metamodel allows selecting various laser types (Gaussian, flat-top) and various stimulus characteristics (imposed flux or controlled temperature). Each simulation generates a graphical result file <code>plot.pdf</code> that is directly interpretable by clinicians.
 
  
  

Latest revision as of 11: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"