Spatial Coupler

Design

Initial Use Case

Terms

The following are some terms used to discuss the spatial interface and layer semantics. These are just loose, conceptual terms at the moment, and are subject to refinement, removal, etc. They are, for now, simply useful to think about and design with.

Catchment: Computational response unit of the framework, with 2D geometry (polygon) and unique identity provided by HY Features Hydrofabric.

Spatial Source: A geo-spatial data set (e.g. grid) that must provide inputs to a Catchment.

Spatial Catchment: Spatially discretized Catchment with a clear definition of the discretization/grid type (See BMI grid types)

Use Case Diagram

A basic use case required to be supported by the spatial coupling semantics is diagrammed below. A more complete description of this diagram will be added to this document.

flowchart TD

L1["[ N ] Layer Number
( N ) Priority"]

 subgraph A["[1] Gridded Forcing Engine BMI - one per PE"]
        A3["Bounding Box"]
        direction LR
        A1["Var_1
        Var_2"]
        A2["Collect vars after layer update (1)"]
        A1 --> A2
    end
    subgraph B["[2] Gridded NOAA-OWP Regional (2) - one per PE"]
        B1["Bounding Box"]
        B2["Collect vars after layer update (1)"]
    end
    A3 --> B1
    A2 --> |"Grid Index Transform (2)"| B

    C["[3] Catchment Formulations (3)"]

    B2 --> |"Mean Aggregation Transform (1)
            Regridding Transform (future work for gridded formulations)"| C

     D["[3] Routing"]

    C --> |"Point Identity/Index Map?
            Write output to disk, sync read"| D

Loading