Difference between revisions of "Elmer"

From ONELAB
Jump to: navigation, search
(Introduction)
(Getting started)
 
(23 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, you need a working installation of the code on your system.
+
To test ONELAB models working with Elmer, you shall need a working installation of the code.
To can be done easily if you install the generic ONELAB virtual machine on your system  
+
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]].
 
by following [[ONELAB virtual machine|these instructions]].
When done, log in into the virtual machine (username: "olvm", passwd: olvm)
 
and proceed with the installation of Elmer, and the download of benchmark ONELAB models.
 
Instructions to do so are given in the next section.
 
  
= 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>.
  
The Virtual machine is configured so that Gmsh and Elmer can be installed straightforwardly  by issuing simple commands in a terminal.
+
Information about the individual models are given in the next section.
Proceed as follows.
+
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].
  
;Step 1 - Download installation scripts
+
== ONELAB models ==
:Open a terminal by clicking on the "terminal" icon in the launcher panel and issue the command
 
:<code>install_scripts.sh</code>
 
 
 
;Step 2 - Install Gmsh and Onelab
 
:Then the command
 
:<code>install_gmsh.sh</code>
 
:downloads the nightly-build of Gmsh from http://geuz.org/gmsh, install it, and place a Gmsh icon on the Desktop.
 
 
 
;Step 3 - Install Elmer
 
:The command
 
:<code>install_elmer.sh</code>
 
:downloads the source code of Elmer and compile it on the virtual machine. This may take several minutes.
 
 
 
After these 3 steps, you have a woking installation of Gmsh and Elmer on the virtual machine.
 
 
 
;Step 4 - Download model examples
 
:The model examples detailed in the next section are downloaded in a directory named <code>ELMERMODELS</code> with the command
 
:<code>getElmerModels.sh</code>.
 
 
 
= ONELAB models =  
 
  
 
[[Cryotherapy|Cryotherapy]] : Thermal analysis of the cryogenic treatment of warts
 
[[Cryotherapy|Cryotherapy]] : Thermal analysis of the cryogenic treatment of warts

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