From 0a9c57f4b8db1eaba9eff5cdaeef1eac78a30f83 Mon Sep 17 00:00:00 2001
From: Tobias Meisel <tobias.meisel@ufz.de>
Date: Tue, 21 Jan 2025 11:25:15 +0100
Subject: [PATCH] [Project] Release notes for 0.5.0 completed

---
 docs/releases/index.md          |  1 +
 docs/releases/ogstools-0.5.0.md | 50 +++++++++++++++++++++++++++++++++
 docs/releases/ogstools-0.x.md   | 18 +-----------
 3 files changed, 52 insertions(+), 17 deletions(-)
 create mode 100644 docs/releases/ogstools-0.5.0.md

diff --git a/docs/releases/index.md b/docs/releases/index.md
index 85ae674ae..c61acc3ad 100644
--- a/docs/releases/index.md
+++ b/docs/releases/index.md
@@ -5,6 +5,7 @@
 maxdepth: 3
 ---
 0.x (upcoming release)  <ogstools-0.x>
+0.5.0 <ogstools-0.5.0>
 0.4.0 <ogstools-0.4.0>
 0.3.1 <ogstools-0.3.1>
 0.3.0 <ogstools-0.3.0>
diff --git a/docs/releases/ogstools-0.5.0.md b/docs/releases/ogstools-0.5.0.md
new file mode 100644
index 000000000..7625a11c1
--- /dev/null
+++ b/docs/releases/ogstools-0.5.0.md
@@ -0,0 +1,50 @@
+# OGSTools 0.5.0 Release Notes
+
+- Recommended OGS Version: 6.5.4
+
+## API breaking changes
+
+- MeshSeries.data --> MeshSeries.values
+- MeshSeries.clear --> MeshSeries.clear_cache
+- In aggregate functions func str is replaced by callables (e.g. numpy.min)
+- meshlib.gmsh_meshing.remesh_with_triangle --> meshlib.gmsh_meshing.remesh_with_triangles
+- msh2vtu python interface was replaced with meshes_from_gmsh
+  - CLI tool msh2vtu is not affected by this
+  - parameter keep_ids was removed (in our OGS world there is no reason to keep the gmsh data names and the wrong data types in the meshes, which would happen if k was used)
+  - parameter log_level was changed to log (True or False)
+
+## Bugfixes
+
+- Failed sub library imports led to incomplete and unhandled package import
+- MeshSeries was unable to handle xdmf with just one timestep correctly
+- MeshSeries kept the hdf5 file handle open - parallel read access was not possible
+- OMP_NUM_THREADS was not working on Windows
+- Feflow mesh did not allow mixed celltypes
+- plot functions had sometimes different color schemes in the color bar
+- Tortuosity was not a medium property
+- BHE mesh (z coordinate negative)
+
+## Features
+
+- MeshSeries gets copy() method.
+- MeshSeries gets transform() method, that applies an arbitrary transformation function to all time steps.
+- MeshSeries get extract() method to select points or cells via ids
+- MeshSeries can be sliced to get new MeshSeries with the selected subset of timesteps
+- MeshSeries gets a modify function that applies arbitrary function to all timestep - meshes.
+- difference() between two meshes is now possible even with different topologies
+- Project write_input, path can be specified
+
+## Infrastructure
+
+- Python 3.13 support (CI testing)
+- Testing of all supported Python version 3.10-3.13 (pip and conda)
+- Testing with pinned dependencies in regression tests and with open dependencies in maintenance tests
+- msh2vtu - complete overhaul
+
+## Examples
+
+- All examples use `import ogstools as ot`. To not be confused with ogs python bindings
+
+# Footnotes
+
+- All related Merge requests are tagged with 0.5.0 Release https://gitlab.opengeosys.org/ogs/tools/ogstools/-/merge_requests?scope=all&state=merged&milestone_title=0.5.0%20Release
diff --git a/docs/releases/ogstools-0.x.md b/docs/releases/ogstools-0.x.md
index e02780d64..5d4b72498 100644
--- a/docs/releases/ogstools-0.x.md
+++ b/docs/releases/ogstools-0.x.md
@@ -4,24 +4,8 @@ This is not released yet!
 
 ## API breaking changes
 
-- MeshSeries.data --> MeshSeries.values
-- MeshSeries.clear --> MeshSeries.clear_cache
-- meshlib.gmsh_meshing.remesh_with_triangle --> meshlib.gmsh_meshing.remesh_with_triangles
-- msh2vtu python interface was replaced with meshes_from_gmsh
-  - CLI tool msh2vtu is not affected by this
-  - parameter keep_ids was removed (in our OGS world there is no reason to keep the gmsh data names and the wrong data types in the meshes, which would happen if k was used)
-  - parameter log_level was changed to log (True or False)
+## Bugfixes
 
 ## Features
 
-- MeshSeries gets copy() method.
-- MeshSeries gets transform() method, that applies an arbitrary transformation function to all time steps.
-- MeshSeries get extract() method to select points or cells via ids
-- MeshSeries can be sliced to get new MeshSeries with the selected subset of timesteps
-- difference() between two meshes is now possible even with different topologies
-
 ## Infrastructure
-
-- Python 3.13 support (CI testing)
-- Testing of all supported Python version 3.10-3.13 (pip and conda)
-- Testing with pinned dependencies in regression tests and with open dependencies in maintenance tests
-- 
GitLab