Getting started with CAELinux

le:///opt/caelinux/docs/GettingStarted.html

Getting started with CAELinux 2011

J. Cugnoni, www.caelinux.com, 12.10.2011

Content:
1. Welcome & License terms 2. Introduction tutorial 3. Softwares included in CAELinux 2011 4. Installing & upgrading CAELinux

Welcome & License terms:

First of all, we would like to thank you for your interest in CAELinux which we hope will fulll your needs in Computer Aided Engineering. This Linux distribution is based on the excellent basis provided by Ubuntu 10.04.3 64bit OS and includes an always increasing number of open source modeling, simulation & design software. Most of the content (~95%) of CAELinux is provided under the well known free / open-source licenses GPL or LGPL (Gnu Public Licenses) which allows you to freely use (private & commercial) and redistribute these software packages. But as it is nearly impossible to check the licenses of all included packages, it is your responsibility to verify the licensing terms of the software that you are using. The authors of the distribution are not responsible for these licensing aspects and this distribution and all the included softwares are provided without any warranty. CAELinux is developed by passionate open-source loving engineers and scientists with the goal of popularizing the use of free / open-source codes in basic and applied research.

Introduction
The predened login and passwords in CAELinux are: Normal user account: user: caelinux password: caelinux

Admin / Root user account : in Ubuntu, there is no 'root' account, to run administrative tasks, just use the "sudo" command and enter your own user password to validate For a very quick introduction to CAELinux capabilities, you should follow the Installation Manual and the rst Videos Tutorials. Ubuntu Installation manual (PDF): See: /opt/caelinux/docs/HowToInstallUbuntu.pdf Note: manual partitioning is recommended, you need at least 20Gb for root '/' partition

Video Tutorials: Linear static stress analysis of a piston (Salome_Meca / Code-Aster) PDF tutorial (recommended): /opt/caelinux/docs/tutorials/piston/Piston_tutorial.pdf Video tutorial: /opt/caelinux/docs/tutorials/piston/PistonTutorial.htm (based on an older version) Online video tutorial: http://www.youtube.com/watch?v=dQBHNKnSzIQ (recent version of Salome)

Simple 3D uid dynamics analysis of a Y-shaped pipe (Salome & OpenFOAM) Geometry: /opt/caelinux/docs/tutorials/pipe/PipeGeom.htm Meshing: /opt/caelinux/docs/tutorials/pipe/PipeMesh.htm CFD solution: /opt/caelinux/docs/tutorials/pipe/PipeOpenFOAM.m4v Simple 3D uid dynamics analysis of a Y-shaped pipe (Salome & Code-Saturne) Geometry: /opt/caelinux/docs/tutorials/pipe/PipeGeom.htm Meshing: /opt/caelinux/docs/tutorials/pipe/PipeMesh.htm CFD solution: /opt/caelinux/docs/tutorials/pipe/PipeSaturne.m4v

Online tutorials and wiki CAELinux.org wiki contains a large number of additionnal tutorials and documents to help you master all these simulation codes. Check out the following pages for more information: http://www.caelinux.org/wiki/index.php/Main_Page http://caelinux.org/wiki/index.php/CAELinux2011_Tutorials http://www.caelinux.org/wiki/index.php/Doc:CAETutorials http://www.caelinux.org/wiki/index.php/Contrib:Main

Software included in CAELinux 2011

Here is a non exhaustive list of CAE software packages included in CAELinux as well as some key informations to get started. Some of the software can

1 of 5

11/12/12 10:28

Getting started with CAELinux

le:///opt/caelinux/docs/GettingStarted.html

be started from Desktop shortcuts or from the CAE start menu, but most of the console based tools will require that you use our special shell called 'Command line tools' (in CAE start menu).

2 of 5

11/12/12 10:28

Getting started with CAELinux

le:///opt/caelinux/docs/GettingStarted.html

Software Salome-Meca 2011

Use 3D CAD,Meshing Post Processing, Multiphysics FE analysis 3D CAD, Meshing Post Processing

How to start Salome_Meca in CAELinux menu

Installation directory /opt/SALOMEMECA-2011.2LGPL-x86_64 /opt/SALOMEMECA-2011.2LGPL-x86_64 /SALOME OpenMP version: /opt/SALOMEMECA-2011.2LGPL-x86_64 /aster MPI version: /opt/aster110 /opt/Impact

Documentation - HTML doc accessible inside the application - Tutorials in /opt/caelinux/docs

Salome v6.3

Salome_Meca in CAELinux menu Can be used from within Salome_Meca (OpenMP/Intel compiler version)

- HTML doc accessible inside the application - Tutorials in /opt/caelinux/docs

Code Aster v11.0 (64 bit, MPI)

multiphysics FE analysis

or with the Code-Aster wizard & the ASTK / Ecas interfaces (MPI version)

- documentation available from within EFICAS. - English doc (automatic translations) are available online at http://www.code-aster.org /V2/doc/default/en/?lang=en - Tutorials in /opt/caelinux/docs and on the wikis at caelinux.org - Documentation available from the interface - Examples in installation directory

Impact 0.7.06.37 OpenFOAM v2.0.1 (64 bit, MPI)

explicit FE dynamics

use shortcut in CAELinux start menu use 'CAE terminal' from CAE start menu or use Discretizer::Setup to setup your simulation

multipurpose CFD oriented solvers

/opt/openfoam201 - Examples & tutorials in /opt/openfoam170

Elmer SVN march 2011 ElmerFront, ElmerGUI, multiphysics FE package ElmerPost (64 bit, MPI)

use the shortcuts from CAELinux menu or start 'ElmerFront' or 'ElmerGUI' from CAE terminal

System package

- Documentation and Examples at http://www.csc./english/pages/elmer - misc mesh converter from Salome (not necessary anymore): /opt/caelinux/unv2gmsh.py or /opt/caelinux/unv2ElmerUNV.py - Documentation in /usr/local/CalculiX/ - Examples & misc tools in /opt/Calculix - mesh converter from Salome: /opt/Calculix/MEDABA/medaba10-64bit (from MED to INP) or /opt/helpers/unv2abaqus.py (from UNV to INP)

Calculix 2.3

(64 bit)

pre-post & FE solver, Abaqus-like syntax

from CAE Terminal: start 'ccx_2.3' for Calculix solver & 'cgx' for pre-post GUI

System package

Code-Saturne 2.0.2 3D CFD solver (64 bit, MPI, with Syrthes coupling) Scriptable & general purpose geometry modelling, meshing and post processing CFD oriented mesher for 3D tetrahedral meshing with prismatic boundary layer

from Code-Saturne Terminal use the dierent utilities (code_saturne --help) from the CAELinux menu: use Code-Saturne wizard and then SaturneGUI use shortcut in CAELinux menu or type 'gmsh' from terminal run from CAELinux menu or from terminal: 'engrid'

- Documentation in installation directory, use 'code_saturne info --help' command to display help /opt/saturne-2.0.2 - tutorial in /opt/caelinux/docs - coupling with heat transfer code Syrthes possible through MPI (although not tested)

GMSH 2.5

System package

- tutorials & demos on http://geuz.org/gmsh/

enGrid 1.2rc1 ( 64 bit)

System package

- tutorial at http://engits.eu

Gerris ow solver 2D / 3D CFD solvers SVN based on automatic octree ( latest 64 bit, mesh renement MPI) MBDyn 1.3.15 - multibody dynamics - comes with a Blender interface - animation of results with easyanim non-linear explicit dynamics General purpose FE solver for multiphysics applications MATLAB compatible mathematical programming

use from terminal : gerris2D, gerris3D, gfsview

System package

- examples & tests at http://gfs.sourceforge.net

use from 'CAE Terminal' : start 'mbdyn'

/opt/mbdyn

(64 bit) Dynela

- Documentation & examples in installation directory - use 'mbdyn2easyanim.sh' & 'EasyAnimm' for visualization - Documentation & examples in installation directory - Documentation & examples on the web :

start manually from terminal

/opt/dynela

Doln / Fenics

use from terminal

System package http://www.fenics.org

Octave + qtoctave

from application menu, or type 'octave' in any console

System package

- Help available from within the octave shell, with the 'help' command - Help, examples, demos available from within the Scilab GUI

Scilab

Matlab/Simulink-like from application menu, or type System package mathematical 'scilab' in any console programming environment

3 of 5

11/12/12 10:28

Getting started with CAELinux

le:///opt/caelinux/docs/GettingStarted.html

wxMaxima

Maple like symbolic computing environment

from shortcuts on in application menu, or type 'wxmaxima' in any console

System package

- Help, examples, demos available from within the wxMaxima GUI - Help available from within the RKWard interface

R and RKWard

Mathematical modelling & from CAE softwares/Math start menu System package statistics (similar to or from a console with 'rkward' S-Plus) from CAELinux menu or

Paraview 3.8

general purpose 3D visualization software

from 'OpenFOAM terminal': start 'paraview.sh' or 'paraFoam' from Application menu

/opt/paraview380

- Basic help in OpenFOAM documentation

QCAD, FreeCAD, SagCad

2D & 3D CAD programs

System packages

- Structured mesh generator for OpenFOAM - OpenFOAM GUI for job Discretizer & Discretizer::Setup denition and Snappyhexmesh generation Netgen 4.9.12 Tetgen OpenDX 3D mesh generator 3D mesh generator 3D visualization

from CAELinux menu

/opt/discretizer

- on the web http://www.discretizer.org/

from CAELinux menu or terminal: run 'netgen'

System package

- on the web http://sourceforge.net/projects /netgen-mesher/ - on the web http://tetgen.berlios.de/ - from application

from CAE terminal: run 'tetgen' /opt/tetgen From Applications menu or run System package 'dx' in a shell From CAELinux menu /opt/itksnap

3D biomedical image ITK-Snap 1.6 processing and J.Cugnoni version segmentation ImageJ Scientic image processing & analysis

- on the web http://www.itksnap.org

From CAELinux menu From terminal

System package

- on the web http://rsbweb.nih.gov/ij/

Aero / foil Airfoil & Airplane simulation: simulation / optimization xfoil, javafoil, avl, tools datcom

/opt/aero-foils or CAELinux menu

- in installation directories

Several usefull tools, documents and examples are provided in /opt/caelinux directory: - CreateJob.py : GUI to create a Code-Aster FE analysis from template & Salome MED mesh - SaturneStudy.py: GUI to create a Code-Saturne CFD analysis from a Salome MED mesh other useful tools - Unv2X, unv2abaqus, unv2gmsh...: a set of python scripts to facilitate mesh conversion from UNV (Salome for example) to other solvers like Calculix, Elmer or OpenFOAM. - GenEnsightCase.py: a python script to generate an Ensight .case le from an Ensight ouput directory generated by Code-Aster. - /opt/caelinux/docs/tutorials contains some interesting tutorials on combined use of Salome & Code-Aster Due to space limitations, many interesting software could not be included. Here is a short list of suggested packages that you can add after installation of CAELinux to hard disk: Mathematical modeling: Sage (get DEB from http://www.sagemath.org/), OpenModelica (install from Synaptics) Other recommended software that could not be included on the DVD CAD: Dassault DraftSight (free, closed source 2D drafting, see http://www.3ds.com/products/draftsight/download-draftsight/) Acoustics: Agros2D (from Synaptics, but need to force install manually), Acousto (see http://acousto.sourceforge.net/) Molecular dynamics/Ab-initio: Gromacs (from Synaptics), LAMMPS (http://lammps.sandia.gov/), Amber (http://ambermd.org/), NAMD (www.ks.uiuc.edu/Research/namd/) , Quantum Espresso (http://www.quantum-espresso.org), Plumed (https://sites.google.com/site/plumedweb/) Phase eld simulation: OpenPhase (http://www.openphase.de/) And many other FEM, CFD and experimental data & image processing tools ...

Installing & upgrading CAELinux

Thanks to the very simple Ubuntu LiveCD installer, you can very quickly turn your LiveDVD CAELinux environment to a full featured hard disk install which will let you customize and update your system as you may want. We will not detail the installation steps here, but we highly recommend that you read the documentation on Ubuntu website (https://help.ubuntu.com/10.04/index.html) or /opt/caelinux/docs/HowToInstallUbuntu.pdf . To install CAELinux 2011 on hard disk, you will need at least 20Gb of free space on an ext3 or ext4 partition and preferably 2Gb on a Linux Swap partition (use Ubuntu disk partitioning tool to resize or create your partitions & don't forget to BACKUP your data FIRST). After installation, you will be able to customize your OS, install new packages & update your system (kernel, 3D drivers etc...) with the very ecient Ubuntu administrative tools (in Menu->System). From there, you will be able to congure all the aspects of the system and directly install & update softwares from Internet with the Synaptics software package manager. Hardware support: 3D Drivers

4 of 5

11/12/12 10:28

Getting started with CAELinux

le:///opt/caelinux/docs/GettingStarted.html

Ubuntu 10.04 includes open source 3D drivers for most of the recent graphic cards and thus should give you a decent 3D acceleration out of the box. However, for a better hardware support / performance, you may need to install specic "proprietary" drivers (hardware 3D acceleration, Wi). Specic proprietary drivers are not preinstalled but may be proposed by Ubuntu after installation: go to Menu->System->Administrative Tools->Hardware Drivers to activate proprietary drivers for your card. If Ubuntu does not oer you specic drivers, you may nd a solution on Ubuntu.com forums and wiki.

Troubleshooting If you encounter problems with the liveDVD, you can try the following: Boot in an alternate mode: in the boot menu of the liveDVD, choose one of the alternate mode like ForceVesa graphic mode for example. If the system hangs during installation or during a normal use in LiveDVD mode, try to check your DVD on another computer, DVD media are very sensitive and have a lot of incompatibility problems If you experience any OS related problem, you will certainly nd a solution on Ubuntu.com forums or wiki; remember that there are millions of Ubuntu users over the world, and that the community is very active and responsive !!

For any other question regarding CAELinux or one of the included software, you can visit our forums at http://www.caelinux.com Supporting the development of CAELinux CAELinux is a collection of a large number of Open Source programs, so rst of all, we should all be very grateful to the many developers that have spent a lot of their time in the development of these great software packages. CAELinux is developed by passionate developers without any external nancial support. If you like CAELinux, we really encourage you to support the development of both CAELinux and Ubuntu / Debian packages with a donation (even small). For more information about donation to the CAELinux developers, just visit our website: http://www.caelinux.com Additionally, the documentation / translation / tutorials are essential to help beginners in their learning process. If you feel like contributing to CAELinux Documentation or if you are developing a small utility that would be useful to all of us, you should participate and share your experience in the CAELinux Wiki at : http://www.caelinux.org And remember, making Open Source software grow and improve is a dynamic process, where the most critical point is probably to create an active community of users and developers: in this sense any question / interaction is vital to the development of open source codes!! The CAELinux websites are here to create this common "share point" where developers & users can interact. So if you like CAELinux, the most important contribution that you could bring is probably to keep its community alive by posting/answering questions on the forums or the wiki, and by spreading the distribution among your friends and colleagues.

5 of 5

11/12/12 10:28