Frequently Asked Questions:
Where can I get the software from?
You can get the latests version from the EDF website here
In that page there also links to the external optional modules that can be used with Code_Saturne
Which modules do I need to download?
The main modules required for Code_Saturne
|| Base Functions and Types library
| Preprocessor (ecs)
|| Pre-processing module.
|| Finite Volume Mesh library
|| Mathematical Expression Interpreter
| Kernel and GUI (ncs)
|| Main package: Navier-Stokes solver and GUI
It is possible to run the code without the graphical interface. This is useful when running the code remotely in machines where there is no X display. The additional modules are:
| Module ||Version||Description|
|Libxml2 ||2.6.19 or above || XML C parser and toolkit (needed for the graphical interface); usually already present on Linux systems|
|Python ||2.4 to 2.7||Dynamic object-oriented programming language (version 2.5 or above needed for the graphical user interface; usually already present on Linux systems |
|Qt4 ||4.4 to 4.7||Cross-platform application and UI framework (needed for the graphical interface); usually already present or available through package manager on Linux systems|
|SIP||4.12.3 or above||Code generator and Python module (needed for the graphical interface); usually already present or available through package manager on Linux systems|
|PyQt ||4.8.3 or above|| Python bindings for Qt4 (needed for the graphical interface); usually already present or available through package manager on Linux systems|
|METIS ||4.0.3 or 5.0||Graph and mesh/hypergraph partitioning packages (recommended for optimal performance with parallel calculations, either or both may be used) |
|SCOTCH||5.1.10 or above|
|CGNS ||2.5 or 3.1 ||CFD General Notation System (useful to read and write meshes and results; supported by several commercial meshing tools)|
|MED ||2.3.6, 3.0.3 or above|| Model for Exchange of Data. For the use with meshes produced by the SALOME plaform http://www.salome-platform.org or for output usable by the solids code Code_Aster http://www.codeaster.org |
|HDF5 ||1.8|| Suite that makes possible the management of extremely large and complex data collections (necessary for MED files, recommended for CGNS).|
|Open-MPI ||1.1 and above || Message Passing Interface implementations. Needed for parallel calculations. Choose one or you can use any other installed in your system.|
|MPICH2 ||1.0 and above |
Is my architecture supported?
has been tested in different architectures namely, Linux, Solaris, AIX, IBM Blue Gene, Cray XT, Mac OSX, and FreeBSD
. The sources are written in FORTRAN 90 and C, and the graphical interface in Python.
For FreeBSD have a look at fresh ports here
For Mac OSX read here
How can I automatically install everything?
Download and the
(where x.y.z is the version) package and untar it by typing:
tar xvfz ncs-x.y.tar.gz
This will create a directory with the kernel source
and a directory called
. In the Install directory you will find the installation scripts You can use the
script to install all the packages automatically. You will need to edit the file
with the correct paths for the C and FORTRAN compilers and the paths to all the modules. See the README file for more information.
Installation failed, what do I do?
If the automatic installation fails, you will have to compile the package that fails separately. Normally you will need to type:
with the required options for the specific package. You can see a list of options by typing
. See the README file for more info.A detailed installation manual is also available in the documentation section of the download page.
I have Ubuntu and when compiling I get:
error: stdio.h: No such file or directory or
error: X11/Xlib.h: No such file or directory
In the basic installation of Ubuntu, the compilers are available but you also need the headers which are included in the dev pacages. Type:
sudo apt-get install build-essential
to install them. If you want the graphical interface and need compile python with Tix support, you will also need the xlib dev packages:
sudo apt-get install xlibs-dev
How can i check my installation?
Once installed, an executable script named code _saturne should be available in the installation directory's
to create a test directory structure,
to test the GUI,
code_saturne compile -t -f
to check that the code may compile and link user subroutines.
Installation of the
fvm package fails and asks for recompile fwith the
If you use
flag and still get the error at compilation time, try
flag in the configuration step.
How do I use it?
The first thing you need to do is to ensure the main script is found. Type:
where $CS_HOME is the path to where you installed the kernel. You can add this line to your
file so that all the variables needed are loaded at the start of your session.
An alternative solution is to use:
Where can i find information?
After your environment is correctly set up, type
to get a list of available help options. By adding a topic after the command, you will get the help information on that topic, so if you type
code_saturne info -g user
you will get the pdf version of the users manual.