EncDotNet.S100 documentation
EncDotNet.S100 reads, validates and portrays IHO S-100 nautical data in .NET. It includes:
- .NET libraries that read each supported product, run its portrayal catalogue and render the result to an image or an interactive map.
- SoundCharts, a desktop viewer for macOS, Windows and Linux.
s100, a command-line tool that inspects, validates, renders and converts datasets, checks routes, predicts tides, and serves datasets as map tiles, S-100 feeds and MCP tools. It's also published as a container image.- An MCP server that gives AI agents access to datasets, in SoundCharts or
from
s100.
Get started
Getting started has a quickstart for each of these:
- Open a dataset in the desktop app
- Read and render a dataset from .NET
- Render a dataset from the command line
- Serve charts to a web map or GIS
Supported products
| Standard | Subject | Encoding | Portrayal | Validation pack | Library |
|---|---|---|---|---|---|
| S-101 | Electronic Navigational Charts | ISO 8211 | Lua (Part 9A) | ✅ | Datasets.S101 |
| S-102 | Bathymetric Surfaces | HDF5 | Coverage (Lua) | ✅ | Datasets.S102 |
| S-104 | Water Level Information | HDF5 | Coverage | ✅ | Datasets.S104 |
| S-111 | Surface Currents | HDF5 | Coverage arrows | ✅ | Datasets.S111 |
| S-122 | Marine Protected Areas | GML | XSLT | ✅ | Datasets.S122 |
| S-124 | Navigational Warnings | GML | XSLT | ✅ | Datasets.S124 |
| S-125 | Marine Aids to Navigation | GML | XSLT | ✅ | Datasets.S125 |
| S-127 | Marine Resources & Services | GML | XSLT | ✅ | Datasets.S127 |
| S-128 | Catalogue of Nautical Products | GML | XSLT | ✅ | Datasets.S128 |
| S-129 | Under Keel Clearance Management | GML | XSLT | ✅ | Datasets.S129 |
| S-131 | Marine Harbour Infrastructure | GML | Lua (Part 9A) | ✅ | Datasets.S131 |
| S-201 | Aids to Navigation Information (IALA) | GML | XSLT | ✅ | Datasets.S201 |
| S-411 | Sea Ice Information | GML | XSLT | ✅ | Datasets.S411 |
| S-412 (draft) | Marine Weather Warnings | GML | XSLT | ✅ | Datasets.S412 |
| S-421 | Route Plans | GML | XSLT | ✅ | Datasets.S421 |
| S-401 (IEHG) | Inland ENC | ISO 8211 | Lua (Part 9A) | — | Specifications/content/S401 |
| S-57 (legacy) | Electronic Navigational Charts (Ed 3.1) | ISO 8211 | via S-101 pipeline | ✅ (delegated) | Datasets.S57 |
How the pieces fit
Each dataset goes through the same stages. A product-specific reader decodes the file, the product's portrayal catalogue turns its features into drawing instructions, and a renderer draws them. The viewer, the CLI and the library all use this pipeline.
flowchart LR
A[Dataset file<br/>ISO 8211 / HDF5 / GML] --> B[Reader]
B --> C[Portrayal<br/>Lua or XSLT]
C --> D[Drawing instructions]
D --> E[Renderer<br/>Skia / Mapsui]
Guides
Working with data
- Loading datasets: files, folders, ZIPs, exchange sets and S-101 updates.
- Reading product data: each product's features, typed models, grids and time series.
- Reading protected exchange sets: S-100 Part 15 permits, decryption and signatures.
- Custom catalogues and validation: use your own catalogues, and validate datasets.
- Bringing S-57 into the pipeline: read S-57 cells through the S-101 portrayal.
- Converting S-101 to S-57: write S-101 data as S-57 cells for testing and S-57-only tools, following S-65 Annex C.
- S-57 and ISO 8211 libraries: read S-57 cells, update cells and exchange sets, and ISO 8211 files, with EncDotNet.
- SoundCharts for ArcGIS: show S-100 charts in ArcGIS Pro, with the add-in built on these libraries.
- Route checks and under-keel clearance: what each route finding means, UKC and confidence, and the RTZ and S-421 route formats.
Tasks
- Render S-102 to PNG
- Inspect S-124 warnings
- Compose S-101 and S-102
- Find when the tide is above a height
- Find slack water in a pass
- Serve charts to a web map or GIS: XYZ tiles, WMTS and WMS from a folder of charts, for MapLibre, Leaflet and QGIS.
- Show wind and waves on the chart: GRIB2 and NetCDF forecasts, CAP warnings, NDBC buoys and own-ship wind, which aren't for navigation.
- Run s100 in Docker: serve tiles from a mounted folder, prebuilt tiles on a small computer, and the MCP tools over standard input and output or HTTP.
Rendering and integration
- Add S-100 data to a Mapsui app: interactive maps in Avalonia and other Mapsui hosts.
- Render images and map tiles: tiles and images without a map, and rendering your own display lists.
- Observability: logs, traces and metrics.
- MCP server: the tools exposed to AI agents.
Reference
- API reference
- Top APIs: the main entry points in each package.
- Typed data models: typed views over feature attributes.
- Command-line rendering: every
s100command and option. - S-100 feed format and local collection manifests: the JSON formats the viewer's Library reads.
- What's new
Contributing
- Contribution guide
- C# coding style
- Documentation style
- Design notes, in
docs/design/, record the rationale behind shipped subsystems. Start with S-98 interoperability and dynamic feature sources.