smash documentation#

Date: Nov 08, 2025 Version: 1.1.3

smash is a computational software framework dedicated to Spatially distributed Modeling and ASsimilation for Hydrology, enabling the tackling of spatially distributed differentiable hydrological modeling, with learnable parameterization-regionalization. This platform enables the combination of vertical and lateral flow operators, either process-based conceptual or hybrid with neural networks, and performs high-dimensional non-linear optimization from multi-source data. It is designed to simulate discharge hydrographs and hydrological states at any spatial location within a basin and reproduce the hydrological response of contrasted catchments, both for operational forecasting of floods and low flows, by taking advantage of spatially distributed meteorological forcings, physiographic data, and hydrometric observations.

Getting Started

New to smash? Check out the getting started guides.

User Guide

The user guide provides in depth-information of the smash library.

API Reference

The reference guide contains a detailed description of the smash API.

Math / Num Documentation

This documentation contains a detailed description of the smash model operators and associated mathematical and numerical tools.