xarray-selafin¶

An xarray backend for SELAFIN/SERAFIN file formats used by TELEMAC and other hydraulic solvers.

xarray-selafin provides seamless integration between xarray and the SELAFIN binary format, enabling lazy loading, slicing, and standard xarray operations on hydraulic simulation results.

Features¶

• Lazy loading by default -- only reads data when accessed
• Full read/write support for 2D and 3D SELAFIN files
• Bilingual variable support (French and English)
• Dask-compatible for parallel and out-of-core computation
• Layer extraction from 3D to 2D datasets
• Round-trip fidelity -- read, modify, and write back without data loss

Quick Example¶

import xarray as xr

ds = xr.open_dataset("simulation.slf", engine="selafin")
print(ds)

<xarray.Dataset> Size: 226kB
Dimensions:  (time: 17, node: 648)
Coordinates:
  * time     (time) datetime64[us] 136B 1900-01-01 ... 1900-01-02T20:26:40
    x        (node) float32 3kB ...
    y        (node) float32 3kB ...
Dimensions without coordinates: node
Data variables:
    U        (time, node) float32 44kB ...
    V        (time, node) float32 44kB ...
    H        (time, node) float32 44kB ...
    S        (time, node) float32 44kB ...
    B        (time, node) float32 44kB ...

Navigation¶