wolfhece-core

Data models of the WOLF toolkit (HECE, University of Liege): the data-only side of wolfhece, importable without a GUI toolkit, without OpenGL and without any native library.

wolfhece builds its wx/OpenGL classes on these models and re-exports them; wolfgpu depends on this package only.

Install

GDAL 3.10.2 is pinned. PyPI has no binary wheel of GDAL for Windows, so the core depends there on hece-gdal (the wheels of Christoph Gohlke republished on PyPI by HECE) and on GDAL elsewhere. Do not install the GDAL distribution next to hece-gdal: both provide osgeo and pip does not detect the conflict. The HECE index https://wolf.hece.uliege.be/simple/ also serves the same wheel as GDAL==3.10.2.

pip install wolfhece-core            # models
pip install wolfhece-core[gis]       # + geopandas / fiona (shapefile, geopackage, GeoDataFrame)
pip install wolfhece-core[mesh3d]    # + pyvista / pygltflib (PolyData, glTF)
pip install wolfhece-core[dxf]       # + ezdxf
pip install wolfhece-core[all]

Development, next to a checkout of HECEPython:

pip install -e . --no-deps --config-settings editable_mode=compat

Version and release

The core follows the version numbering of wolfhece: wolfhece X.Y.Z depends on wolfhece-core X.Y.Z and both are released together, the core first. The version is declared once in pyproject.toml and mirrored in wolfhece_core/version.py (WolfCoreVersion, exposed as wolfhece_core.__version__); tests/test_version.py checks that they agree.

release.py (same flow as HECEPython/release.py) syncs the version, builds the wheel, checks it with pkginfo, uploads it to PyPI (~/.pypirc section [pypi]) then to the GitLab package registry (section [gitlabcore], to add to ~/.pypirc with the project id of wolfhece-core: repository = https://gitlab.uliege.be/api/v4/projects/<id>/packages/pypi), increments the patch number for the next release and syncs again. Then tag X.Y.Z on GitLab and commit the two updated files. Options: --no-upload (build only), --no-increment, --python <exe>.

Conventions

• Model classes carry the Model suffix (WolfArrayModel, prev_sim2DModel); the names without suffix are the GUI classes of wolfhece.
• Companion objects are created through _make_* factories that the GUI subclasses override.
• Messages are English; a GUI installs its translator with wolfhece_core.i18n.set_translator.
• Nothing here may import wx, OpenGL, wolf_libs or any other closed component.

Layout

The historical module names of wolfhece (wolf_array, PyVertexvectors, PyParams, mesh2d.wolf2dprev...) are not kept here: the core is organised by theme and wolfhece keeps the historical names as re-exports of these modules.

Origin

Extracted from HECEPython (wolfhece 3.0.0) on 13 October 2026, with the history of the files since their current paths (replayed with git log --first-parent -p).

Licence

Proprietary, University of Liege (HECE) - see LICENSE. External contributions require a contribution agreement.