The watlab package is a Python interface for the C++-based hydraulical simulation sandbox. It is intended mainly for scholars.
Project description
Watlab is Python-API dedicated to hydraulics simulations. The Python-API allows you to drive the different solvers available in the toolbox. The following prerequisites are mandatory to use Watlab:
- A working version of Python
- Some basic knowledge on Python scripting
- A mesh made with GMSH (see also our website).
Get Watlab
Watlab is supported on Python 3.11 or later.
Watlab installation is complicated by its (weak) dependency to the libgdal package. On Linux and MacOS, installation is included in the resterio installer. On Windows, one needs to install GDAL first.
If necessary, you can download the installers here:
- Download Watlab 1.0.0;
- Download gdal 3.4.3 for Windows (for Win_AMD64; for another version, see here).
Install GDAL before you install watlab :
python -m pip install GDAL-3.4.3-cp311-cp311-wind_amd64.whl
python -m pip install watlab
Run Watlab (for the impatients)
In order to test your Watlab instance, create a folder somewhere in your computer (say in ~/usr/myWatlab/
) and unzip this archive.
Open the Conda prompt and activate your newly created watlab
environment:
conda activate watlab
Then run the script with
python .\watlab-first-script.python
If you see the following pictures then it worked!
License
This source code is not yet placed under open source licence. Meanwhile, this code is the property of Prof. Sandra Soares-Frazão. GPL-3 open source copyright to come.
Please copy the following text in your LICENCE file while using Watlab as a subpackage of your work.
Watlab - Copyright (C) <1998 – 2024> <Université catholique de Louvain (UCLouvain), Belgique>
This program (Watlab) is free software: you can redistribute it and/or modify it under the terms
of the GNU General Public License as published by the Free Software Foundation, either version 3
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program (see COPYING file). If not,
see <http://www.gnu.org/licenses/>.
Development team
The development team is composed of the members of the GCE lab of Hydraulics, from UCLouvain. The contributors are:
- Nathan Delpierre
- Pierre-Yves Gousenbourger
- Robin Meurice
- Charles Ryckmans
- Sandra Soares-Frazão (first contributor)
- Catherine Swartenbroeckx
- Sylvie Van Emelen
- Mirjana Velickovic
- Jiangtao Yang
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.