Structure of the code base

First level hierarchy

  • 3rdparty, third party code, to be filed with the dependencies archive’s content

  • cmake, cmake scripts

  • debian, debian packaging

  • doc, project’s developper documentation

  • Python, Python files hierarchy

  • qml, QML files used with Qt Quick framework

  • resources, GUI assets (images, fonts, etc.)

  • tests, test files hierarchy

  • tools, various developping utilities

  • Tympan, C++ files hierarchy

  • web, web resources

C++ code hierarchy (i.e. the Tympan directory)

Tympan
 \_ core
  _ geometric_methods
   \_ AcousticRaytracer
    _ ConvexHullFinder
  _ gui
   \_ app (former `TympanApp`)
    _ gl (former `DataManagerGraphics`)
    _ tools
    _ widgets (former `DataManagerIHM`)
  _ models
   \_ business - application model (former `DataManagerMetier`)
    _ common - common representations (former `CommonTools`)
    _ solver - problem and result models for the solver
  _ solvers
   \_ 9613
     \_ 9613Solver
      _ DefaultSolver
  _ CMakeLists.txt - used to define compiling rules for the folder

  • core may not include from other Tympan directories

  • models may only include from core

  • gui may only include from core and model/site

  • solvers may only include from core, model/solver and model/results

    • Under solvers are stored common classes for all solver families

    • Under 9613 are stored common classes for 9613 family solver

    • Under 9613Solver are stored specific classes for 9613Solver

    • Under DefaultSolver are stored specific classes for DefaultSolver

Python code hierarchy (i.e. the Python directory)

File hierarchy

Python
 \_ bin
  _ include
  _ tests
  _ tympan
   \_ __pycache__
    _ altimetry
    _ models

Python namespaces

  • tympan.altimetry

  • tympan.models

Web code hierarchy

File hierarchy

web
 \_ css
  _ js
   \_ tests

Test code hierarchy

Like the C++ part, the Python part has unit tests. There are 74 tests (06/2022) running with C++ tests in the classic pipeline.
In the test folder of the python part we also find:

  • data folder : folder used to store resources for tests

  • CMakeLists.txt : used to define compiling rules for the folder

  • utils.py : paths configuration for test in Python

For more information, see Testing

Executables

Usage

There are a number of methods for using TYMPAN.
From a typical user point of view:

  • starts the GUI (binary)

  • used by the GUI to start computation for a site XML file (python)

  • used by the GUI to computate altimetry for a site XML file (python)

  • used by the python library to start computation for a solver model (python thin wrapper around solvers code)

From a developer’s point of view:
There are a number of scripts that have been developed to simplify use and debugging by a developer (or an advanced user).
Available here : Link to TYMPAN scripts repository

  • 1_xxxxx_install.bat : Used to generate the build and install folders of TYMPAN (debug or release depending on the script).

  • 2_xxxxx_Tests_unitaires.bat : Used to launch unit tests (debug or release depending on the script).

  • 3_xxxxx_Build_Doc.bat : Used to generate the doc.

  • 4_xxxxx_Launch_Tympan_GUI.bat : Used to launches TYMPAN with the graphical interface (debug or release depending on the script).

  • 5_Debug_Tympan_Mode_Interactive : Used to launch the python calculation with pdb (very useful for debugging).

Embedded Python and Tympan release generation

The TYMPAN project embeds a version of python as well as all the python packages necessary for the proper functioning of the software.
However, in the case of a package or python version upgrade, this folder must be generated correctly.
Here is the procedure.

Reminder

If the installation procedure was correctly followed, there should have a folder containing python and a virtual environment corresponding to the version of python installed.
Reminder of commands:
# Create virtual environment
cd dists\python
C:\Python312\python.exe -m venv venv312tympan

# Activate virtual environment
C:\dists\python\venv312tympan\Scripts\activate.bat

In this virtual environment, the packages listed in the requirements file had to be installed using the following commands:

pip install -U pip
pip install -U -r requirements-open-source.txt
pip install -U -r requirements-bundle.txt
pip install -U -r requirements-dev.txt
However these commands modify only the virtual environment and in no case the python installed locally.
The python file embedded in TYMPAN corresponds to the python installed in which the necessary packages have been installed. We will therefore see the exact procedure.

Generate Python embedded in TYMPAN

As said previously, to build a complete TYMPAN version (which can be delivered) you must therefore embed python. However, it is not enough to copy the python folder, you must first have installed the necessary packages in the sources folder. Here’s the procedure to follow :

  • To be sure that the version is clean,it is recommended first reinstalling the version of python that will be used. (Python release link)

  • Copy C:\Python312 into %DELIVERY_FOLDER%, which is :

    • For Production bundle : C:\Livraison_bd_Tympan_Tykal

    • For Production open-source : C:\Livraison_Tympan_open_source

    • For Development bundle : C:\Livraison_bd_Tympan_Tykal_dev

    • For Development open-source : C:\Livraison_Tympan_dev_open_source

  • Install the packages necessary for bundle or open-source distribution in the python folder that we have just copied (different from virtual environment and the system Python under C:\Python312).

# Either install packages for bundle configuration
%DELIVERY_FOLDER%\Python312\python.exe -m pip install -U -r C:\projects\code_tympan\requirements-open-source.txt
%DELIVERY_FOLDER%\Python312\python.exe -m pip install -U -r C:\projects\code_tympan\requirements-bundle.txt
%DELIVERY_FOLDER%\Python312\python.exe -m pip install -U -r C:\projects\TYKAL\requirements-tykal.txt
%DELIVERY_FOLDER%\Python312\python.exe -m pip install -U -r C:\projects\TYBox\requirements-tybox.txt

# Or install packages for open-source configuration
%DELIVERY_FOLDER%\Python312\python.exe -m pip install -U -r C:\projects\code_tympan\requirements-open-source.txt

You can check that the installation went correctly by using pip on the embedded Python folder in %DELIVERY_FOLDER%.

# Use pip to list installed packages
%DELIVERY_FOLDER%\Python312\python.exe -m pip list