h5yaml 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

h5yaml/yaml_h5.py

@@ -1,11 +1,22 @@
 #
-# This file is part of h5_yaml
-#    https://github.com/rmvanhees/h5_yaml.git
+# This file is part of Python package: `h5yaml`
 #
-# Copyright (c) 2025 SRON
-#    All Rights Reserved
+#     https://github.com/rmvanhees/pyxarr.git
 #
-# License:  BSD-3-Clause
+# Copyright (c) 2025 - R.M. van Hees (SRON)
+#    All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 #
 """Create HDF5/netCDF4 formatted file from a YAML configuration file using h5py."""
 
@@ -14,52 +25,14 @@ from __future__ import annotations
 __all__ = ["H5Yaml"]
 
 import logging
-from importlib.resources import files
 from pathlib import Path
 
 import h5py
 import numpy as np
 
-from h5yaml.conf_from_yaml import conf_from_yaml
-from h5yaml.lib.chunksizes import guess_chunks
-
-
-# - helper function ------------------------------------
-def adjust_attr(attr_key: str, attr_val: np.ndarray, attr_dtype: str) -> np.ndarray:
-    """..."""
-    if attr_key in ("valid_min", "valid_max", "valid_range"):
-        match attr_dtype:
-            case "i1":
-                res = np.int8(attr_val)
-            case "i2":
-                res = np.int16(attr_val)
-            case "i4":
-                res = np.int32(attr_val)
-            case "i8":
-                res = np.int64(attr_val)
-            case "u1":
-                res = np.uint8(attr_val)
-            case "u2":
-                res = np.uint16(attr_val)
-            case "u4":
-                res = np.uint32(attr_val)
-            case "u8":
-                res = np.uint64(attr_val)
-            case "f2":
-                res = np.float16(attr_val)
-            case "f4":
-                res = np.float32(attr_val)
-            case "f8":
-                res = np.float64(attr_val)
-            case _:
-                res = attr_val
-
-        return res
-
-    if attr_key == "flag_values":
-        return np.array(attr_val, dtype="u1")
-
-    return attr_val
+from .conf_from_yaml import conf_from_yaml
+from .lib.adjust_attr import adjust_attr
+from .lib.chunksizes import guess_chunks
 
 
 # - class definition -----------------------------------
@@ -103,9 +76,7 @@ class H5Yaml:
                 dset = fid.create_dataset(
                     key,
                     shape=(0,),
-                    dtype=(
-                        h5py.string_dtype() if val["_dtype"] == "str" else val["_dtype"]
-                    ),
+                    dtype="T" if val["_dtype"] == "str" else val["_dtype"],
                     chunks=ds_chunk if isinstance(ds_chunk, tuple) else tuple(ds_chunk),
                     maxshape=(None,),
                     fillvalue=fillvalue,
@@ -114,7 +85,7 @@ class H5Yaml:
                 dset = fid.create_dataset(
                     key,
                     shape=(val["_size"],),
-                    dtype=val["_dtype"],
+                    dtype="T" if val["_dtype"] == "str" else val["_dtype"],
                 )
                 if "_values" in val:
                     dset[:] = val["_values"]
@@ -128,7 +99,7 @@ class H5Yaml:
             )
             for attr, attr_val in val.items():
                 if not attr.startswith("_"):
-                    dset.attrs[attr] = adjust_attr(attr, attr_val, val["_dtype"])
+                    dset.attrs[attr] = adjust_attr(val["_dtype"], attr, attr_val)
 
     def __compounds(self: H5Yaml, fid: h5py.File) -> dict[str, str | int | float]:
         """Add compound datatypes to HDF5 product."""
@@ -184,7 +155,7 @@ class H5Yaml:
                 ds_dtype = fid[val["_dtype"]]
                 dtype_size = fid[val["_dtype"]].dtype.itemsize
             else:
-                ds_dtype = val["_dtype"]
+                ds_dtype = "T" if val["_dtype"] == "str" else val["_dtype"]
                 dtype_size = np.dtype(val["_dtype"]).itemsize
 
             fillvalue = None
@@ -203,7 +174,7 @@ class H5Yaml:
                 )
                 for attr, attr_val in val.items():
                     if not attr.startswith("_"):
-                        dset.attrs[attr] = adjust_attr(attr, attr_val, val["_dtype"])
+                        dset.attrs[attr] = adjust_attr(val["_dtype"], attr, attr_val)
                 continue
 
             n_udim = 0
@@ -217,7 +188,7 @@ class H5Yaml:
 
             # currently, we can not handle more than one unlimited dimension
             if n_udim > 1:
-                raise ValueError("more than one unlimited dimension")
+                raise ValueError(f"{key} has more than one unlimited dimension")
 
             # obtain chunk-size settings
             ds_chunk = (
@@ -273,7 +244,7 @@ class H5Yaml:
 
             for attr, attr_val in val.items():
                 if not attr.startswith("_"):
-                    dset.attrs[attr] = adjust_attr(attr, attr_val, val["_dtype"])
+                    dset.attrs[attr] = adjust_attr(val["_dtype"], attr, attr_val)
 
             if compounds is not None and val["_dtype"] in compounds:
                 if compounds[val["_dtype"]]["units"]:
@@ -286,6 +257,15 @@ class H5Yaml:
         """Return definition of the HDF5/netCDF4 product."""
         return self._h5_def
 
+    def diskless(self: H5Yaml) -> h5py.File:
+        """Create a HDF5/netCDF4 file in memory."""
+        fid = h5py.File.in_memory()
+        if "groups" in self.h5_def:
+            self.__groups(fid)
+        self.__dimensions(fid)
+        self.__variables(fid, self.__compounds(fid))
+        return fid
+
     def create(self: H5Yaml, l1a_name: Path | str) -> None:
         """Create a HDF5/netCDF4 file (overwrite if exist).
 
@@ -303,14 +283,3 @@ class H5Yaml:
                 self.__variables(fid, self.__compounds(fid))
         except PermissionError as exc:
             raise RuntimeError(f"failed create {l1a_name}") from exc
-
-
-# - test module -------------------------
-def tests() -> None:
-    """..."""
-    print("Calling H5Yaml")
-    H5Yaml(files("h5yaml.Data") / "h5_testing.yaml").create("test_yaml.h5")
-
-
-if __name__ == "__main__":
-    tests()

h5yaml/yaml_nc.py

@@ -1,11 +1,22 @@
 #
-# This file is part of h5_yaml:
-#    https://github.com/rmvanhees/h5_yaml.git
+# This file is part of Python package: `h5yaml`
 #
-# Copyright (c) 2025 SRON
-#    All Rights Reserved
+#     https://github.com/rmvanhees/pyxarr.git
 #
-# License:  BSD-3-Clause
+# Copyright (c) 2025 - R.M. van Hees (SRON)
+#    All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 #
 """Create HDF5/netCDF4 formatted file from a YAML configuration file using netCDF4."""
 
@@ -14,7 +25,6 @@ from __future__ import annotations
 __all__ = ["NcYaml"]
 
 import logging
-from importlib.resources import files
 from pathlib import PurePosixPath
 from typing import TYPE_CHECKING
 
@@ -23,8 +33,9 @@ import numpy as np
 # pylint: disable=no-name-in-module
 from netCDF4 import Dataset
 
-from h5yaml.conf_from_yaml import conf_from_yaml
-from h5yaml.lib.chunksizes import guess_chunks
+from .conf_from_yaml import conf_from_yaml
+from .lib.adjust_attr import adjust_attr
+from .lib.chunksizes import guess_chunks
 
 if TYPE_CHECKING:
     from pathlib import Path
@@ -34,20 +45,20 @@ if TYPE_CHECKING:
 class NcYaml:
     """Class to create a HDF5/netCDF4 formated file from a YAML configuration file."""
 
-    def __init__(self: NcYaml, h5_yaml_fl: Path) -> None:
+    def __init__(self: NcYaml, nc_yaml_fl: Path) -> None:
         """Construct a NcYaml instance."""
         self.logger = logging.getLogger("h5yaml.NcYaml")
 
         try:
-            self._h5_def = conf_from_yaml(h5_yaml_fl)
+            self._nc_def = conf_from_yaml(nc_yaml_fl)
         except RuntimeError as exc:
             raise RuntimeError from exc
 
-        self.yaml_dir = h5_yaml_fl.parent
+        self.yaml_dir = nc_yaml_fl.parent
 
     def __groups(self: NcYaml, fid: Dataset) -> None:
         """Create groups in HDF5 product."""
-        for key in self.h5_def["groups"]:
+        for key in self.nc_def["groups"]:
             pkey = PurePosixPath(key)
             if pkey.is_absolute():
                 _ = fid[pkey.parent].createGroup(pkey.name)
@@ -56,14 +67,14 @@ class NcYaml:
 
     def __dimensions(self: NcYaml, fid: Dataset) -> None:
         """Add dimensions to HDF5 product."""
-        for key, value in self.h5_def["dimensions"].items():
+        for key, value in self.nc_def["dimensions"].items():
             pkey = PurePosixPath(key)
             if pkey.is_absolute():
                 _ = fid[pkey.parent].createDimension(pkey.name, value["_size"])
             else:
                 _ = fid.createDimension(key, value["_size"])
 
-            if "long_name" not in value:
+            if len(value) <= 2:
                 continue
 
             fillvalue = None
@@ -88,17 +99,29 @@ class NcYaml:
                     fill_value=fillvalue,
                     contiguous=value["_size"] != 0,
                 )
-            dset.setncatts({k: v for k, v in value.items() if not k.startswith("_")})
+            if value["_size"] > 0:
+                if "_values" in value:
+                    dset[:] = np.array(value["_values"])
+                elif "_range" in value:
+                    dset[:] = np.arange(*value["_range"], dtype=value["_dtype"])
+
+            dset.setncatts(
+                {
+                    k: adjust_attr(value["_dtype"], k, v)
+                    for k, v in value.items()
+                    if not k.startswith("_")
+                }
+            )
 
     def __compounds(self: NcYaml, fid: Dataset) -> dict[str, str | int | float]:
         """Add compound datatypes to HDF5 product."""
-        if "compounds" not in self.h5_def:
+        if "compounds" not in self.nc_def:
             return {}
 
         compounds = {}
-        if isinstance(self.h5_def["compounds"], list):
-            file_list = self.h5_def["compounds"].copy()
-            self.h5_def["compounds"] = {}
+        if isinstance(self.nc_def["compounds"], list):
+            file_list = self.nc_def["compounds"].copy()
+            self.nc_def["compounds"] = {}
             for name in file_list:
                 if not (yaml_fl := self.yaml_dir / name).is_file():
                     continue
@@ -107,9 +130,9 @@ class NcYaml:
                 except RuntimeError as exc:
                     raise RuntimeError from exc
                 for key, value in res.items():
-                    self.h5_def["compounds"][key] = value
+                    self.nc_def["compounds"][key] = value
 
-        for key, value in self.h5_def["compounds"].items():
+        for key, value in self.nc_def["compounds"].items():
             compounds[key] = {
                 "dtype": [],
                 "units": [],
@@ -142,7 +165,11 @@ class NcYaml:
            Definition of the compound(s) in the product
 
         """
-        for key, val in self.h5_def["variables"].items():
+        for key, val in self.nc_def["variables"].items():
+            pkey = PurePosixPath(key)
+            var_grp = fid[pkey.parent] if pkey.is_absolute() else fid
+            var_name = pkey.name if pkey.is_absolute() else key
+
             if val["_dtype"] in fid.cmptypes:
                 ds_dtype = fid.cmptypes[val["_dtype"]].dtype
                 sz_dtype = ds_dtype.itemsize
@@ -156,6 +183,23 @@ class NcYaml:
                     np.nan if val["_FillValue"] == "NaN" else int(val["_FillValue"])
                 )
 
+            # check for scalar dataset
+            if val["_dims"][0] == "scalar":
+                dset = var_grp.createVariable(
+                    var_name,
+                    val["_dtype"],
+                    fill_value=fillvalue,
+                    contiguous=True,
+                )
+                dset.setncatts(
+                    {
+                        k: adjust_attr(val["_dtype"], k, v)
+                        for k, v in val.items()
+                        if not k.startswith("_")
+                    }
+                )
+                continue
+
             compression = None
             complevel = 0
             # currently only gzip compression is supported
@@ -187,9 +231,6 @@ class NcYaml:
                 val["_chunks"] if "_chunks" in val else guess_chunks(ds_shape, sz_dtype)
             )
 
-            pkey = PurePosixPath(key)
-            var_grp = fid[pkey.parent] if pkey.is_absolute() else fid
-            var_name = pkey.name if pkey.is_absolute() else key
             if val["_dtype"] in fid.cmptypes:
                 val["_dtype"] = fid.cmptypes[val["_dtype"]]
 
@@ -213,7 +254,7 @@ class NcYaml:
 
                 dset = var_grp.createVariable(
                     var_name,
-                    val["_dtype"],
+                    str if val["_dtype"] == "str" else val["_dtype"],
                     dimensions=var_dims,
                     fill_value=fillvalue,
                     contiguous=False,
@@ -223,7 +264,13 @@ class NcYaml:
                         ds_chunk if isinstance(ds_chunk, tuple) else tuple(ds_chunk)
                     ),
                 )
-            dset.setncatts({k: v for k, v in val.items() if not k.startswith("_")})
+            dset.setncatts(
+                {
+                    k: adjust_attr(val["_dtype"], k, v)
+                    for k, v in val.items()
+                    if not k.startswith("_")
+                }
+            )
 
             if compounds is not None and val["_dtype"] in compounds:
                 if compounds[val["_dtype"]]["units"]:
@@ -232,9 +279,17 @@ class NcYaml:
                     dset.attrs["long_name"] = compounds[val["_dtype"]]["names"]
 
     @property
-    def h5_def(self: NcYaml) -> dict:
+    def nc_def(self: NcYaml) -> dict:
         """Return definition of the HDF5/netCDF4 product."""
-        return self._h5_def
+        return self._nc_def
+
+    def diskless(self: NcYaml) -> Dataset:
+        """Create a HDF5/netCDF4 file in memory."""
+        fid = Dataset("diskless_test.nc", "w", diskless=True, persistent=False)
+        self.__groups(fid)
+        self.__dimensions(fid)
+        self.__variables(fid, self.__compounds(fid))
+        return fid
 
     def create(self: NcYaml, l1a_name: Path | str) -> None:
         """Create a HDF5/netCDF4 file (overwrite if exist).
@@ -251,15 +306,4 @@ class NcYaml:
                 self.__dimensions(fid)
                 self.__variables(fid, self.__compounds(fid))
         except PermissionError as exc:
-            raise RuntimeError(f"failed create {l1a_name}") from exc
-
-
-# - test module -------------------------
-def tests() -> None:
-    """..."""
-    print("Calling NcYaml")
-    NcYaml(files("h5yaml.Data") / "nc_testing.yaml").create("test_yaml.nc")
-
-
-if __name__ == "__main__":
-    tests()
+            raise RuntimeError(f"failed to create {l1a_name}") from exc

{h5yaml-0.1.0.dist-info → h5yaml-0.2.0.dist-info}/METADATA

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: h5yaml
-Version: 0.1.0
+Version: 0.2.0
 Summary: Use YAML configuration file to generate HDF5/netCDF4 formated files.
 Project-URL: Homepage, https://github.com/rmvanhees/h5_yaml
 Project-URL: Source, https://github.com/rmvanhees/h5_yaml
 Project-URL: Issues, https://github.com/rmvanhees/h5_yaml/issues
 Author-email: Richard van Hees <r.m.van.hees@sron.nl>
-License-Expression: BSD-3-Clause
+License-Expression: Apache-2.0
 License-File: LICENSE
-Keywords: HDF5,YAML,netCDF4
+Keywords: CF metadata,HDF5,YAML,netCDF4
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Science/Research
@@ -19,12 +19,15 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
 Requires-Python: >=3.10
-Requires-Dist: h5py>=3.13
+Requires-Dist: h5py>=3.14
 Requires-Dist: netcdf4>=1.7
-Requires-Dist: numpy>=2.2
+Requires-Dist: numpy>=2.0
 Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: pytest-cov>=7.0; extra == 'test'
 Description-Content-Type: text/markdown
 
 # H5YAML
@@ -183,5 +186,5 @@ The code is developed by R.M. van Hees (SRON)
 
 ## License
 
-* Copyright: SRON (https://www.sron.nl).
-* License: BSD-3-clause
+* Copyright: Richard van Hees (SRON) (https://www.sron.nl).
+* License: Apache-2.0

h5yaml-0.2.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+h5yaml/__init__.py,sha256=NdNciPgYnbq-aVM6QqNGNZtdL72rTGLAMrDy0Yw7ckk,751
+h5yaml/conf_from_yaml.py,sha256=-2ar_gUmc5qvD1KlcctnpPY8G5c4TTXOF2tfrgcT9m4,1560
+h5yaml/yaml_h5.py,sha256=jVZAL5Cu6dqgdn25cgVBP3g7yx2wdE-cmCbkaOmQKZ4,10153
+h5yaml/yaml_nc.py,sha256=M6g4ZTPMlPmGZjyn3mLFnoQpmynGwgA0HtlUXSGNvvw,10963
+h5yaml/Data/h5_compound.yaml,sha256=z3dMCJDRAw14boRp0zT74bz_oFi21yu8coUoKOW-d2Q,1131
+h5yaml/Data/h5_testing.yaml,sha256=NhXeXjdblh3bv1hPjCl5DvIhEXo3EpD4mlgaZDElsJc,5626
+h5yaml/Data/h5_unsupported.yaml,sha256=v4HYhiTikFt6UoEUJBnmSse_WeHbmBgqF2e1bCJEfLw,1502
+h5yaml/Data/nc_testing.yaml,sha256=zuXcYrcuCankndt5e4nRPj2-xed97IA9yvfpn89XQgw,5451
+h5yaml/lib/__init__.py,sha256=NdNciPgYnbq-aVM6QqNGNZtdL72rTGLAMrDy0Yw7ckk,751
+h5yaml/lib/adjust_attr.py,sha256=4dHEGwwIa3a3hihyuSX8jCsC08fYcz_9XWA1pBwiwfc,2284
+h5yaml/lib/chunksizes.py,sha256=R1kdaKWF0Hol_maZ0tPDoUyWIH5RatP7d2J1yBA8bkk,1949
+h5yaml-0.2.0.dist-info/METADATA,sha256=IZxpXl9fI3Z7pa1DoRumjxPZXn8N_ykkJEdaUNnFJlw,7280
+h5yaml-0.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+h5yaml-0.2.0.dist-info/licenses/LICENSE,sha256=rLarIZOYK5jHuUjMnFbgdI_Tb_4_HAAKSOOIhwiWlE4,11356
+h5yaml-0.2.0.dist-info/RECORD,,

h5yaml-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright (c) 2025 - R.M. van Hees (SRON)
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.