ICESym Quick Start Guide

Ezequiel López, Juan Marcelo Gimenez, Norberto Nigro

22/01/2010

Introduction
ICESym (Internal Combustion Engine Simulator) is a simulation software made of two independents com-
ponents. The first component is the numerical solver called ICESym-1D, and is written in three languages
(Cython, C++ and Fortran) that work together (see ICESym-1D Programmer’s Guide). The second compo-
nent is a Graphical User Interface called ICESym-GUI, and it allows at user to make simulations test easily
and fast. Both can work separately, but togheter they also, and any change must take place simultaneously in
both programs to maintain consistency, and thus allowing to run simulations from ICESym-GUI.

Download and Compile

The user only needs run the bash script called ”ICESym [namedistro].sh”, put in console:

./ICESym_ubuntu
./ICESym_fedora

In Ubuntu was tested in Ubuntu 9.04, and in Fedora was tested in Fedora 10.
Only in Fedora is necessary include the actual user in the sudoers file:

nano /etc/sudoers

and append the line:

[user] ALL=(ALL) ALL

where [user] must be replaced with your user name.

This script install from the distro’s repository all necesaries libraries and packages. Moreover, creates in the
user path the folder ”icesym” that will contain the code downloaded from googlecodes http://code.google.
com/p/icesym/.
The message ”Installation Completed” indicates that the installation was succesfull.

Example CompBiCyl - A engine with two cylinders

In this tutorial we will use the two components of ICESym. First, we will open the GUI to see the engine
structure. Put in terminal:

1
 cd ~/icesym/ICESym-GUI/
python SimulatorGUI.py

It displays the GUI’s main window. We go to open the simulation: select File-Open and in the File Dialog Box,
choose ”compBiCyl.py”. This action loads on the GUI the diagram of the simulation. The user must see the
main window such as the figure 1.

Figure 1: Main Window PreProcess CompBiCyl

For example, if the user want to see the parameters in some cylinder (or another component) only must do
double click over the object figure. It action opens the component form to modify some attributes.
Now, we go to run the simulation. Here exists two posibilities: run from ICESym-GUI or run from ICESym-1D.
The easiest is run from GUI (Simulation-Run). The other posibility isn’t hard, but requires some extra action,
copy the file to other path:
cp ~/icesym/ICESym-GUI/saves/compBiCyl.py ~/icesym/ICESym-1D/src/

Now, we can run the simulation since ICESym-1D, do (copy-paste line by line):

cd ~/icesym/ICESym-1D/src/
python main.py
Choise the Script with the data for the TEST (without ’.py’): compBiCyl

After the simulation is finished, the user can see the results in ICESym-GUI.
cd ~/icesym/ICESym-GUI/
python SimulatorGUI.py

select File-Open and in the File Dialog Box, choose ”compBiCyl.py”, and Simulation-PostProcess. It action
opens the PostProcess main window.

2
 Figure 2: RPM Plot Formulary

Here the user can view a lot of information. For example, to see the power indicated in each rpm, the user must
choice: Graphics - RPM Plots, and complete the formulary with the data in figure 2.
If all is correct, be obtained a plot such as figure 3.
Using this example, the user can modify all theirs attributes in PreProcess and PostProcess and see diferents
results. Moreover, this example can be used how basis for a new engine simulation, with diferents numbers and
type of components

3
Figure 3: Main Window PostProcess with Power’s plot