TELEMAC-MASCARET

Runs TELEMAC-MASCARET 2D shallow-water simulations with validated forcing, bathymetry, and SELAFIN output parsing tools.

155|6|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation --skill telemac-mascaret-lzwei196
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: TELEMAC-MASCARET
Source: https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation/tree/main/models/TELEMAC_MASCARET
Command: npx skills add https://github.com/lzwei196/KISS-Knowledge-Infrastructure-for-Scientific-Simulation --skill telemac-mascaret-lzwei196

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, scipy, rasterio, and includes scripts (resource) and references (resource) components.

What problem does it solve? Setting up and running TELEMAC-MASCARET hydrodynamic simulations requires deep operational knowledge of SELAFIN binary formats, CAS steering files, unit conventions, and failure modes that are scattered across manuals and source code. This Skill packages that expertise so an AI agent can prepare inputs, execute the telemac2d solver, parse results, and recover from known errors without inventing approximations. ## Core Features & Use Cases - End-to-end pipeline tooling: Four Python tools convert meteorological/tidal forcing, interpolate bathymetry onto meshes, execute the TELEMAC binary, and parse SELAFIN results into CSV time series. - Diagnostic recovery: 18 symptom-diagnosis-remedy triplets cover known failure modes such as Manning/Strickler friction confusion, bathymetry sign inversion, WGS84 coordinate traps, and CFL violations. - Validation against cited standards: Outputs like water depth H and free surface S are graded against literature-cited RMSE and bias bands rather than intuition. - Use Case: A coastal engineer asks the agent to model tidal flooding in an estuary; the Skill guides mesh preparation, forcing conversion, telemac2d execution, and validation of water levels against gauge observations. ## Quick Start Ask the agent to run the TELEMAC-MASCARET bump test case and parse the resulting SELAFIN output into a CSV time series of water depth and velocity.

Frequently Asked Questions about TELEMAC-MASCARET

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a TELEMAC-2D simulation with this Skill?

Run preflight_check.py first to verify the binary and environment, then prepare the mesh, forcing, and CAS steering file, and execute via tools/run_telemac.py. Results are parsed from the SELAFIN file with tools/parse_selafin.py into CSV time series.

How do I convert bathymetry data for a TELEMAC mesh?

Use tools/convert_bathymetry.py with an XYZ, CSV, or GeoTIFF source to interpolate bottom elevation onto mesh nodes. Remember TELEMAC expects elevation positive upward, so use --negate when converting depth soundings.

What is the difference between Manning and Strickler friction in TELEMAC?

LAW OF BOTTOM FRICTION = 3 selects Strickler (K, around 40) while = 4 selects Manning (n, around 0.025), with K = 1/n. Supplying a Manning value under the Strickler law causes extreme friction and wrong water levels.

Why does my TELEMAC simulation crash on the first timestep?

Common causes are WGS84 degree coordinates instead of a metric projection, gravity set in CGS units, or a time step violating the CFL condition. Check diagnostics/triplets.yaml for the matching symptom and remedy before debugging further.

Can TELEMAC-2D model 3D flow or sediment transport?

No, telemac2d solves depth-averaged shallow-water equations only. Vertical flow structure requires telemac3d, sediment morphodynamics requires gaia, and spectral waves require tomawac, all outside this Skill's validated scope.