# OpenGeoSys 6.4.4 released!

**URL:** <https://discourse.opengeosys.org/t/opengeosys-6-4-4-released/1138>\
**Category:** Announcements\
**Created:** [March 10, 2023, 4:27pm UTC](https://discourse.opengeosys.org/t/opengeosys-6-4-4-released/1138 "2023-03-10T16:27:38Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![bilke](https://discourse.opengeosys.org/user_avatar/discourse.opengeosys.org/bilke/32/868_2.png) [@bilke](https://discourse.opengeosys.org/u/bilke)\
**Post date:** [March 10, 2023, 4:27pm UTC](https://discourse.opengeosys.org/t/opengeosys-6-4-4-released/1138/1 "2023-03-10T16:27:38Z")

</div>

[![DOI](https://zenodo.org/badge/1701384.svg)](https://zenodo.org/badge/latestdoi/1701384)

We are happy to announce the release of **OpenGeoSys 6.4.4**!

## Links

- [Release page on www.opengeosys.org](https://www.opengeosys.org/releases/6.4.4/)
- [GitLab Release](https://gitlab.opengeosys.org/ogs/ogs/-/releases/6.4.4)
- [Zenodo Release](https://zenodo.org/record/7716938)
- [PyPI Release](https://pypi.org/project/ogs/6.4.4/)

# Highlights

Some notable additions in this release include the output of residuum vectors on submeshes (now for the TRM and TH2M processes only), restart for parallel simulations were made possible as well as CI coverage for the PETSc configuration was increased and the infrastructure for Jupyter notebooks was extended.

There were also some substantial efforts to enhance the documentation especially for the [project file](https://www.opengeosys.org/docs/userguide/blocks/intro/), [specific process configurations](https://www.opengeosys.org/docs/processes/thermal-processes/thm/) and [tools](https://www.opengeosys.org/docs/tools/getting-started/overview/) documentation.

Further CI improvements include the possibility to select subsets of test jobs via merge request labels to shorten feedback cycles and we added performance tracing of benchmarks via our [CDash](https://cdash.opengeosys.org/index.php?project=ogs)-platform.

We thank the following people who contributed to this release (in alphabetical order):

_Aqeel Chaudhry, Boyan Meng, Christian Silbermann, Christoph Lehmann, Dmitri Naumov, Falko Vehling, Feliks K. Kiszkurno, Florian Zill, Haibing Shao, Tao You, Jan Thiedau, Jörg Buchwald, Julian Heinze, Karsten Rink, Kata Kurgyis, Keita Yoshioka, Lars Bilke, Linda Günther, Matthes Kantzenbach, Mostafa Mollaali, Norbert Grunwald, Olaf Kolditz, Renchao Lu, Thomas Fischer, Thomas Nagel, Tobias Meisel, Tymofiy Gerasimov, Vahid Ziaei Rad, Wenqing Wang_

# Process’ changes

## LiquidFlow

- [!4203](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4203) Make process per default non-linear. One can enforce linear treatment in project file as follows:

## TH2M

- [!4362](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4362 "TH2M Benchmark Phase Appearance/ Disappearance (Bourgeat)") Added a Jupyter notebook version of the [Bourgeat test case](https://www.opengeosys.org/docs/benchmarks/th2m/phase_appearance/)
- [!4392](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4392 "[PL/TH2M] Set coordinates in SpatialPosition") Function-type parameters can be used for MPL property and constituitive relation parameters. Fixes the “coordinates not set for spatial position”-error.
- [!4485](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4485 "[TH2M] Output intrinsic permeability") Enabled output of extrapolated node wise intrinsic permeability.

## PhaseField

- [!4299](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4299 "K-regime Hydro Frac in PhaseField") Added a variational phase-field hydraulic fracture model in toughness dominated regime (K-regime).

## Component transport process / reactive transport process with coupling of Phreeqc

- [!4451](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4451) Added flow rates output for all components.
- [!4228](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4228) Use inclined elements in ComponentTransport.

## ThermoHydroMechanics

- [!4386](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4386 "THM-Freezing for temperature equation.") Implemented freezing terms for the energy equation.

## ThermoRichardsMechanics and ThermoHydroMechanics

- [!4363](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4363 "TRM: Add a constitutive setting using the extended OGS-MFront interface") Added a constitutive setting to the TRM process to make it possible to use either the existing mechanical material models or mechanical material models that use the new extended OGS-MFront interface.
- [!4410](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4410) Kelvin Vectors can now be formed from matrices, allowing the use of arbitrarily rotated anisotropic thermal expansivities if read in as a parameter property.

# Constitutive relations (material models)

- [!4296](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4296 "Extend the OGS-MFront interface") Extended the OGS-MFront interface beyond passing only stresses, strains and temperatures.
- [!4304](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4304 "[MPL] Merge thermal conductivity models / add geometric mean model") All saturation dependent thermal conductivity models have been merged into one (`SaturationWeightedThermalConductivity`) and can be accessed by specifying the mean type: `arithmetic_linear`, `arithmetic_squareroot` and geometric.
- [!4378](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4378 "[MPL] Add water IAPWS and Vogels density and viscosity models") IAPWS density and viscosity as well as Vogels viscosity model were added to MPL.
- [!4391](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4391 "[cmake] Switched to tfel rliv-4.0 branch.") Upgraded TFEL / MGIS to 4.0 branch.

# Generic features

- [!4393](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4393 "Draft: Submesh residuum output for TH2M and TRM processes") Added support to assemble and output residuum vectors on submeshes for the TRM and TH2M processes.

# Tools

- [!4327](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4327 "Added IP data to point cloud conversion tool") Added a tool writing integration point data from OGS output meshes to a new point cloud mesh whose nodes are the integration points of the input mesh.
- [!4360](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4360 "[SWMM] Adding elevation to Outfall- and Storage-entities") Fixed issue where elevation information wasn’t added for [OUTFALLS]- and [STORAGE]-entities.
- [!4452](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4452) Added a tool for converting any ascii raster formats OGS can read into \*.asc-format.
- [!4264](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4264) Added integration point data partitioning in partmesh.
- [!4294](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4294) Added a new tool to convert pvtu-files to vtu-files: pvtu2vtu.
- [!4352](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4352) Added partitioning and reading of non-IP field data.
- [!4492](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4492) Extended `checkMesh`- and `editMaterialID`-tools to optionally output all existing MaterialIDs for a mesh (previously it was just displaying the range).
- [!4513](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4513) [partmesh] Renumbered the bulk node IDs of the bulk mesh.

# Data Explorer

- [!4430](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4430 "[FileIO] XYZ raster reader") Reader for XYZ raster files added.

# Python & Jupyter

- [!4285](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4285 "Python wrapper for OGS commandline tools") Adds a simple wrapper around OGS CLI tools such that they can be easily used from Python. Available in the OGS wheels/via pip.
- [!4300](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4300 "Enable Python BCs in OGS Python wheels") Enables Python BCs and STs in the OGS Python wheels.
- [!4502](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4502), [!4512](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4512) Added support for markdown-based notebooks via [jupytext](https://jupytext.readthedocs.io/en/latest).

# Testing

- [!4408](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4408 "Added PROPERTIES argument to AddTest(), OgsTest() and NotebookTest() and more...") Refactored PyVista in notebooks testing logic: no more special treatment for headless systems. User is responsible for providing a window environment, e.g. via `xvfb-run`, which is shortly documented. Added documentation on how to shorten pipeline run times by modifying the corresponding files. Added pipeline variable `CTEST_INCLUDE_REGEX` which corresponds to the `-R` ctest argument.
- [!4421](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4421 "[ci] New job include-what-you-use") [ci] New job include-what-you-use.
- [!4437](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4437) Enabled large tests on PETSc configs in CI. Also added a CI variable `CTEST_ARGS` for temporarily selecting benchmarks in CI.

# Bug fixes

- [!4281](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4281 "Fixed ip data getter") Fixed IP data access to Kelvin vector valued data. The error was introduced in !4222.
- [!4302](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4302 "[PL/BC] Reimplement Robin-type BC") Reimplement Robin-BCs which were incorrect for 2D and 3D setups.
- [!4369](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4369 "Fix TRM restart") Fixed the restart feature of the TRM process, which was broken since [!4316](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4316 "Added reflection functionality for setting IP data").
- [!4397](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4397 "[PL/BC] Exclude ghost nodes from Dirichlet BCs") Fixed PhaseField’s BC for parallel simulations.
- [!4453](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4453) Corrected initial residuum computations when start time is negative.

# CMake

- [!4306](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4306 "[cmake] MSVCs Multi-ToolTask scheduler for build parallelism and better ccache.") Enabled MSVCs Multi-ToolTask scheduler for build parallelism and better multi-platform ccache setup.
- [!4408](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4408 "Added PROPERTIES argument to AddTest(), OgsTest() and NotebookTest() and more...") [Test properties](https://cmake.org/cmake/help/latest/manual/cmake-properties.7.html#test-properties) can now directly be set. Simplifies CMake logic a bit and is potentially more powerful.
- [!4417](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4417 "[cmake] Don't use GKlibSystem.cmake.") Don’t include GKlibSystem.cmake (it defined `NDEBUG` on Debug configs!) from METIS and fixed some compile errors in asserts.
- [!4423](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4423 "[cmake] Moved VTK from CPM to external dependencies.") Moved VTK from CPM to external dependencies.
- [!4473](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4473) fmt-library is now used as a regular library. Before it was used as a spdlog-bundled library.
- [!4494](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4494), [!4497](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4497) [cmake] Cache external dependencies in `$CPM_SOURCE_CACHE`.
- [!4365](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4365) Simplified CMake test infrastructure (replaced `MeshTest()` with regulard `AddTest()` and new `TESTER vtkdiff-mesh`).

# Infrastructure

- [!4266](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4266 "Precompiled headers") Enabled precompiled headers using CMake `target_precompile_headers` feature. Some improvement for release builds and around 30% improvement for debug builds.
- [!4329](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4329 "[ci] Refactor notebook testing") Refactored notebook testing.
- [!4370](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4370 "Upload wheels to GitLab registry") Added uploading OGS Python wheels to the GitLab registry.
- [!4401](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4401 "[CI] Better links for web / report previews") Better web site and report previews on merge requests.
- [!4443](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4443#01e65d7f4f711736efedcd98a80a21a60e7cd724 "[ci] Run ctest serially on Ubuntu1 for performance metrics") Run ctests serially on ubuntu1 for performance metrics collected via [CDash](https://cdash.opengeosys.org/index.php?project=ogs).
- [!4464](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4464) [ci] Pipeline refactoring:
  - Added scheduled pipeline for wheel build.
  - `ci::web only` pipeline: just add this label to the MR to limit CI to Jupyter notebook runs and web site creation.
  - Changed `ci skip`-label to `ci::skip`.
  - [!4465](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4465) `ci::linux only` and `ci::mac only` and `ci::win only` labels for running platform specific builds only.

- [!4491](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4491) [ci] Introduced MR label `ci_large` for enabling large tests.
- [!4502](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4502) Added a “Launch in BinderHub”-button to notebooks on the website: launches Jupyter Lab instance pre-configured with ogs via wheel, clones the current ogs repo in it and opens the respective notebook ready to run. Please note that startup times may be several minutes and the computing resource are limited (1 core, 2GB RAM). For improved performance we would need to setup own infrastructure. Also currently only works for serial ogs configs.
- [!4515](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4515) Updated Juwels modules for new 2023 stage.

# File I/O

- [!4375](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4375 "[ogs] Added -s parameter used for locating Python BC scripts.") [ogs] Added `-s` parameter used for locating Python BC scripts.
- [!4430](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4430 "[FileIO] XYZ raster reader") Reader for XYZ raster files added.
- [!4431](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4431 "Generate mesh output from GML input") Geometrical sets can be defined in the output section of the project file.

# Material Property Library (MPL)

- [!4445](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4445 "Draft: [MPL] Adding IAPWS model of thermal conductivity of water to MPL") Added IAPWS thermal conductivity model for water.

# Documentation

- [!4487](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4487),[!4498](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4498),[!4496](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4496) Added and extended documentation for many preprocessing- and mesh generation-tools.
- [!4442](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4442) Added a new ogs [beginner user guide](https://www.opengeosys.org/docs/userguide/basics/project_file_intro/).
- [!4438](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4438), [!4450](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4450) More [process documentation](https://www.opengeosys.org/docs/processes/thermal-processes/thm/).

# Version info

- [!4473](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4473) fmt 8.1.1
- [!4473](https://gitlab.opengeosys.org/ogs/ogs/-/merge_requests/4473) spdlog 1.10.0