feat: external forcings converter

hydrolib/core/dflowfm/bc/models.py

@@ -8,6 +8,7 @@
         AstronomicCorrection, Constant, T3D.
 
 """
+
 import logging
 import re
 from pathlib import Path

hydrolib/core/dflowfm/ext/models.py

@@ -9,6 +9,7 @@
     validator_set_default_disk_only_file_model_when_none,
 )
 from hydrolib.core.dflowfm.bc.models import ForcingBase, ForcingData, ForcingModel
+from hydrolib.core.dflowfm.common.models import Operand
 from hydrolib.core.dflowfm.ini.models import (
     INIBasedModel,
     INIGeneral,
@@ -194,12 +195,24 @@ class MeteoForcingFileType(StrEnum):
     bcascii = "bcAscii"
     """str: Space-uniform time series in <*.bc> file."""
 
-    netcdf = "netcdf"
-    """str: NetCDF, either with gridded data, or multiple station time series."""
-
     uniform = "uniform"
     """str: Space-uniform time series in <*.tim> file."""
 
+    unimagdir = "uniMagDir"
+    """str: Space-uniform wind magnitude+direction in <*.tim> file."""
+
+    meteogridequi = "meteoGridEqui"
+    """str: Space- and time-varying wind and pressure on an equidistant grid in <*.amu/v/p> files."""
+
+    spiderweb = "spiderweb"
+    """str: Space- and time-varying cyclone wind and pressure in <*.spw> files."""
+
+    meteogridcurvi = "meteoGridCurvi"
+    """str: Space- and time-varying wind and pressure on a curvilinear grid in <*.grd+*.amu/v/p> files."""
+
+    netcdf = "netcdf"
+    """str: NetCDF, either with gridded data, or multiple station time series."""
+
     allowedvaluestext = "Possible values: bcAscii, netcdf, uniform."
 
 
@@ -246,6 +259,10 @@ class Comments(INIBasedModel.Comments):
         interpolationmethod: Optional[str] = Field(
             "Type of (spatial) interpolation.", alias="interpolationMethod"
         )
+        operand: Optional[str] = Field(
+            "How this data is combined with previous data for the same quantity (if any).",
+            alias="operand",
+        )
 
     comments: Comments = Comments()
 
@@ -264,6 +281,7 @@ class Comments(INIBasedModel.Comments):
     interpolationmethod: Optional[MeteoInterpolationMethod] = Field(
         alias="interpolationMethod"
     )
+    operand: Optional[Operand] = Field(Operand.override.value, alias="operand")
 
     def is_intermediate_link(self) -> bool:
         return True

hydrolib/core/dflowfm/mdu/legacy.py

@@ -0,0 +1,30 @@
+from typing import Literal
+
+from pydantic import Field
+
+from .models import FMModel, General
+
+
+class LegacyGeneralAsModel(General):
+    """
+    The `[Model]` section in a legacy MDU file.
+
+    This a small helper class to support legacy versions of .mdu files, where
+    the `[General]` section with metadata did not exist yet, and was called
+    `[Model]` instead.
+    """
+
+    _header: Literal["Model"] = "Model"
+    mduformatversion: str = Field("1.06", alias="MDUFormatVersion")
+
+
+class LegacyFMModel(FMModel):
+    """
+    Legacy version of an MDU file, specifically for: MDUFormatVersion <= 1.06.
+
+    This a small wrapper class to support legacy versions of .mdu files, where
+    the `[General]` section with metadata did not exist yet, and was called
+    `[Model]` instead.
+    """
+
+    model: LegacyGeneralAsModel = Field(default_factory=LegacyGeneralAsModel)

hydrolib/tools/__init__ .py

@@ -0,0 +1 @@
+