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 are:
Module Version Description
BFT 1.1.5 Base Functions and Types library
Preprocessor (ecs) 2.0.2 Pre-processing module.
FVM 0.15.3 Finite Volume Mesh library
MEI 1.0.3 Mathematical Expression Interpreter
Kernel and GUI (ncs) 2.0.2 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 VersionDescription
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.7Dynamic 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.7Cross-platform application and UI framework (needed for the graphical interface); usually already present or available through package manager on Linux systems
SIP4.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.0Graph and mesh/hypergraph partitioning packages (recommended for optimal performance with parallel calculations, either or both may be used)
SCOTCH5.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 or for output usable by the solids code Code_Aster
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?

Code_Saturne 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 ncs-x.y.x.tar.gz (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 ncs-x.y.z and a directory called Install. 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 setup 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:
./configure --options
 make install

with the required options for the specific package. You can see a list of options by typing ./configure --help. 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 bin subdirectory. Run code_saturne create to create a test directory structure, code_saturne gui 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 -fPIC flag.

If you use -fPIC flag and still get the error at compilation time, try --disable-shared 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:

export PATH=$CS_HOME/bin:$PATH

where $CS_HOME is the path to where you installed the kernel. You can add this line to your .profile file so that all the variables needed are loaded at the start of your session.

An alternative solution is to use:

alias code_saturne=$CS_HOME/bin/code_saturne

Where can i find information?

After your environment is correctly set up, type code_saturne info 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.

Current Tags:
create new tag
, view all tags
Topic revision: r16 - 2011-07-21 - 22:04:33 - YvanFournier
Saturne Web
26 Oct 2020
Test Cases

tip Saturne Tip of the Day
No graphical interface
To not use the graphical interface, create the cases with the noihm flag, i.e. cree sat STUDY CASE ... Read on Read more


Code_Saturne collaborative website
@ the University of Manchester
Copyright & by the contributing authors. Unless noted otherwise, all material on this web site is the property of the contributing authors.