What's new
This page lists notable changes to the libraries, tools and documentation, by month. For package versions and release assets, see GitHub releases.
November 2026
One MCP
sampletool, with charted depth.samplereplacessample_coverageandsample_coverage_along: it takes aquantity(depth,water_level,currentorweather, or aspecto pin one product) at a point or along a polyline, withspacingMetersto add points between the vertices.depthis the charted depth the route check reads: S-102 first, otherwise the finest S-101, S-401 or translated S-57 cell, with its kind, source feature, an area's depth range and the water mask; with a time, also the water level and the available depth, ascheck_routecomputes clearance. A polyline's depth profile names its shoalest sample. Breaking changes: the two old tools are gone, andSampleCoverageToolandSampleCoverageAlongToolare replaced bySampleTool, which needs the host'sRouteCheckSourceCache.ChartedDepthgainsDepthRangeMaximumMeters. See the MCP server.Navigability over an area. The MCP tool
get_navigability_gridsays where a boat can go over a whole box: each cell is navigable, shoal, hazard, land, uncharted or without depth, from the finest chart cell and S-102, ascheck_routeresolves them. The reply is a summary (counts, the shoalest navigable cell, the largest connected area, and whether two positions join); the grid goes to a NumPy or raw file, with an optional PNG. The engine isNavigabilityGridinEncDotNet.S100.Navigation, andIChartedDepthSourcecan now fill a whole grid at once.Departure windows from tidal gates and currents.
check_route'swindow.constraintsadds a timing check: tidal gates (slack within N minutes at a current station, a current limit, or fair only), limits on the current against each leg, the latest and earliest arrival, and the water level at the arrival. WithapplyCurrents, speeds are through the water and the check's ETAs and running times include the predicted current along the track. It returns each departure's running time and constraints, and the windows that meet them all with the best departure in each. Currents come from current-station predictions (--tide-predictions). In Navigation:TimingCheck,PassageTimingSettingsandIRouteCurrentSource(RouteCheckSources.Currents).MCP toolsets. Every MCP tool now belongs to a toolset, such as
query,routes,tidesorlibrary, and a server can offer only some of them, so an agent's context holds only the tools its task needs.s100 mcp serve --toolsetsand SoundCharts'--mcp-toolsetstake toolset names or a profile (route-planning,visual-check), and SoundCharts has a switch per toolset under Settings > Integrations. Hosts that compose their own tools declare each one's toolset withMcpToolsets.Assign;S100McpServerOptions.Toolsetsselects them. See Choose toolsets.check_routetakes grouped arguments. Its 25 flat arguments are now nine:routeId,polyline,greatCircle,departure, and the groupsvessel(draft, squat, required UKC, safety contour and depth, speed),window(the departure sweep:from,to,stepMinutes;{}sweeps the S-104 range, replacingincludeWindow),weather(wind and wave limits, andcyclones),limits(corridor, track clearance, nearby distance, berth radius, area kinds off) andsamples(spacingMeters,include,max). Errors name the argument by its path, such asvessel.draftMeters. This is a breaking change for MCP clients. TheVesselArgumentstype is meant for the route tools to share.--sourceands100 sources.s100 identify --source ndbc.realtimepicks from a live data source, alone or with datasets: it's started for the area around the point, and left out with a warning if it has no data within--source-timeout.s100 mcp serve --sourceadds sources at startup, ands100 sourceslists them with their options and what each still needs. Options follow the id (nmea.weather:Input=udp:10110); keys come from environment variables only.s100 render --layer … --bbox … --sourcedraws live sources over a composite, through a newPngS100DatasetRenderer.RenderAsync(layers, overlays, …)overload.Live sources in
s100 mcp serve.list_data_sourcesandadd_data_sourceadd NDBC observations, own-ship weather from NMEA or AIS targets to the session's catalog, where they answer the query tools and render like datasets. A source runs for the area set withset_viewport, within its range. Keys come from environment variables, never arguments.--live-feedswith--collectionsadds the live feeds subscribed to in SoundCharts' Library.Live sources are queryable in a catalog. A
DynamicSourceProcessornow projects to aLoadedDataset(LiveSourceDatasetData) whose features the query tools read as they are when asked, so a live source added to a headless catalog answersidentify_featuresand the other queries like a file. The MCP tools and--sourcethat add one come next.AIS targets are a library source.
S100Sources.AisStream(ais.aisstream, withAisFeedOptions) joins NDBC observations and NMEA weather inSourceRegistry.CreateDefault(), so any host can add it.SourceRegistry.AddDataSource(registration, replace: true)lets a host put its own wrapper in place of a built-in source, andSourceOptionsForm.MissingRequiredsays which required option, such as a key, is unset.tiles serveserves a PMTiles archive whole. When it serves a.pmtilesarchive,tiles servealso serves the file atarchive.pmtileswith range requests, so you can check an archive with MapLibre'spmtiles://protocol before publishing it. The TileJSON (s100.pmtilesUrl), the--ready-jsonline (pmtiles) and the start-up text name the URL.AIS targets are a live feed. Add AIS targets with Add a live feed in the Datasets panel instead of turning on a Settings switch, and without restarting; if the switch was on, they're added for you. Selecting a target shows a vessel section and a Take helm action in the Pick report, the Vessels tab appears while AIS targets are added, and removing them stops pirate mode.
AisDynamicFeatureSourcecan defer its subscription until it's started (deferSubscription), and follows the area throughIAreaFilteredDynamicSource.Pick actions and a vessel section. A host can offer actions on a picked feature, such as "Take helm", through
PickActionRegistry; eachPickActiondecides from the pick'sPickContext, which now carries the feature's sections. A live source's vessel features get aVesselSection(name, MMSI, course, speed, heading, length and beam), which MCP'sidentify_featuresanddescribe_featureinclude. SoundCharts shows a pick's actions as buttons, and offers "Take helm" on any picked vessel with an MMSI.Feeds say when they need a key. A live feed that can't start without a setting, such as AIS targets without an aisstream.io key or own-ship weather without an NMEA input, is listed with Key needed or Needs settings on its row (the tooltip says where to set it) instead of failing to load, and starts once the setting is saved in the Library.
Own ship is picked like any feature. Picking own ship shows it in Object information like a chart feature or an AIS target, first in the list (it's drawn on top), with its size and motion in a vessel section, rather than in a separate "live" block above the list. The separate block is gone, since every live feed is now a dataset.
Tide and current stations are live feeds. Tide stations · predicted and Current stations · predicted move from their Layer stack rows to the Library's Live feeds, and show as Datasets rows under Predictions; a row that was on is subscribed for you. Picking a station still shows its card with the predicted curve. MCP's
set_tide_displaysubscribes and unsubscribes them. For developers, aDynamicFeatureDescriptioncan now carry pickSections.Live feed settings in the Library. Select a live feed in the Library's Live feeds collection to set it up: the aisstream.io key and zoom threshold for AIS targets (moved from Settings › Vessels, with a key you'd entered carried over), or the input for own-ship weather (NMEA), which no longer needs an environment variable. Keys go to the computer's secret store. Saving restarts the feed. For developers,
[SourceOption]marks the options a host shows,SourceOptionsFormreads and builds them, andSourceRegistration.ActivationFromOptionslets the options set when a source runs.Live feeds live in the Library. The Library's Add menu lists live feeds such as NDBC observations and AIS targets under Live feeds; choosing one subscribes to it, in a Live feeds collection, and puts it on the map. Removing a feed's row in the Datasets panel takes it off the map until SoundCharts next starts; removing it from the Library unsubscribes. Feeds you'd added before move into the Library, and the Datasets panel's plug button is gone.
LiveFeedSourceis the new collection source kind.Live feed rows say what they're doing. In the Datasets panel, a live feed such as NDBC observations shows its status instead of a product name: waiting for zoom, paused while hidden, live with the time of its last update, stale or not connecting (with the error in the tooltip). Its row is labelled with what it shows, such as Observations, and has no move buttons or Validation tab. Add a live feed is also offered when the panel is empty.
IHostedDatasetProcessorgainsLastUpdatedandLastError, andSourceRegistrationgainsGroupandStaleAfter; NDBC now waits for a view narrower than 25° through its activation range.Faster
tiles servewith S-102. Tiles that include S-102 bathymetry now render in tens of milliseconds a block instead of around 14 seconds, and the first tile at each zoom level no longer lowers every chart again. A WMTS layer that holds every dataset, such aschartfrom--layers-by productover S-57 and S-102, now shares the tiles of thes100layer instead of rendering its own. With--verbose, the server prints where each block's time went.The drawn chart as JSON.
s100 render --format jsonnow writes what the renderer draws rather than a summary of the display list: every line edge, area ring, pattern fill, symbol and label with its full geometry in longitude and latitude, resolved colours, sizes in display pixels, font fields, offsets, rotation, drawing priority, viewing groups, scale limits, and the anchor each symbol and label is placed at. Line suppression, pattern clipping and multi-part splitting are already applied, so a GIS or vector renderer in another process can draw the chart the way the viewer does. The document has aschemaVersion(now 2) and its entries are inops, which replacesinstructions. See Display-list output.An overview below the minimum zoom. With
--overview,s100 tiles servedraws each dataset's coverage outline and name where the chart's zoom levels end, on XYZ and WMTS tiles and WMS GetMap, and the WMS and WMTS capabilities reach zoom 0, so a GIS layer no longer disappears when zoomed out. Without it, tiles below the minimum zoom stay empty, as before. See Overview below the minimum zoom.Several WMTS layers from one
tiles serve. With--layers-by product,s100 tiles servealso serves its datasets as a WMTS layer per product (chartfor S-57, S-101 and S-102;S104,S111,S124, … for the rest), each with its own time steps and extent, so a GIS client can show the chart, water levels and currents as separate layers from one server. With--manage-datasets, a client can put the datasets it adds in a layer it names. Each layer also has its own TileJSON, listed intiles.json, and the dataset metadata says which layer each dataset is in. Thes100layer is unchanged, and without the option the server is as before. Each layer's styles link the same legends ass100's. See WMTS layers.Legends for GIS clients. When it renders datasets,
s100 tiles servedraws the key of each style as a PNG, from the rows the viewer's Legend tab shows: WMSGetLegendGraphic, linked from aLegendURLon each WMS and WMTS style, so ArcGIS Pro and QGIS show the S-102 shades, S-111 speed bands and the rest next to the layer. Each style's key is in its palette and with its mariner settings. The grouping of sub-layer legends into product sections moved from the viewer intoEncDotNet.S100.Core(ProductLegends), andEncDotNet.S100.Renderers.Skiadraws the image (LegendSheetRenderer). See Legends.WMS and WMTS agree on the zoom level.
s100 tiles serveWMS GetMap draws the zoom level a WMTS client such as ArcGIS Pro shows at the same scale: the finest one no finer than the view, rather than the nearest. At 1:23,374, for example, both draw zoom 14, so WMS no longer shows soundings and other features that WMTS hides there. The layer'sMaxScaleDenominatoris now the minimum zoom's scale. See WMS.Add and remove datasets while serving. With
--manage-datasets,s100 tiles serveadds and removes datasets on aPOSTorDELETEofdatasets, without restarting. The new set serves once it's portrayed, and the TileJSON, WMTS, WMS and dataset metadata documents and the data revision follow it. Tiles are cached under the datasets that reach them, so adding a cell renders only its own tiles. Without the option nothing changes. See Add and remove datasets.Navigational warnings by validity in served tiles.
s100 tiles servedraws only the S-124 warnings in force at the time a client asks for, witht, WMSTIMEor the WMTSTimedimension, as the viewer's map does at its view time: ended, cancelled and not-yet-in-force warnings are left out. Without a time every warning draws, as before. Seetiles serve.Dataset metadata from
tiles serve. When it renders datasets,s100 tiles servedescribes each one as JSON underdatasets, andtiles.jsonpoints to it ins100.datasetsUrl: the file, product and edition, producer, the dataset's own bounds and coverage polygon, its time steps and issue time, and its data dynamicity with the viewer's label. A GIS client can zoom to one dataset instead of the union of all of them, without opening the datasets itself. See Dataset metadata.The data revision of served tiles. When
s100 tiles serverenders datasets, it publishes the fingerprint of the data and settings ass100.revisionin the TileJSON, asupdateSequencein the WMS and WMTS capabilities and in anS100-Revisionheader on/healthz. It changes when--refreshreloads changed datasets, so a GIS client can put it in its tile URLs to bust its own tile cache. Seetiles serve.Print from WMS at layout DPI.
s100 tiles serveWMS GetMap reads theDPI,MAP_RESOLUTIONandFORMAT_OPTIONS=dpi:Nparameters that ArcGIS Pro and QGIS send when they export a layout. A 300 DPI map shows the same features as the screen, with symbols and text at the same printed size, drawn directly at the print resolution, and may be larger than 4096 pixels. Requests without them are drawn as before. See WMS.Mariner settings in served and exported tiles.
s100 tiles serveands100 tiles exporttake the viewer's mariner settings as options: the display category, safety contour and depth, shallow and deep contours, four shades, soundings, shallow-water dangers, plain boundaries, simplified symbols, full light lines, ignoring SCAMIN and the depth unit. Atiles serveclient can also register more sets of settings undersettings/{hash}and ask for each as the WMTS or WMS style{palette}-{hash}, so one server serves the chart as several mariners set it. Without them the tiles are as before. See Mariner settings.Observed, predicted or forecast. The viewer labels S-104 water levels and S-111 currents by how they were produced, from S-104
dataDynamicityand S-111typeOfCurrentData: Observed, Predicted · astronomical tide only, not a forecast, Analysis, Hindcast or Forecast, run {time}, the run from the dataset's issue time. Object information shows it in a Data row and the Legend after the section's source. A dataset that doesn't say gets no label. SoundCharts for ArcGIS uses the same words. Processors report it asITimeAwareDatasetProcessor.DataDynamicity.s100as a container image.ghcr.io/philliphoff/s100runss100on Linux x64 and arm64 with nothing else to install. It runs as a non-root user, reads datasets from/data, and keeps tiles in/cacheand the tide station catalogue and MCP Library in/state. Releases publish the version tags andlatest; nightly builds publishnightly.tiles serve,feed serveandmcp serve --transport httpanswerGET /healthzwithout a token, and the news100 healthcommand checks it, for health checks in an image with no shell.S100_NO_UPDATE_CHECKturns off the update check. See Run s100 in Docker.Serve and export a folder of charts.
s100 tiles serveands100 tiles exporttake a folder and render every dataset in it and its subfolders: S-57 cells, an S-57ENC_ROOTwith itsCATALOG.031, S-100 exchange sets and loose datasets.--onlykeeps some product specifications. A folder is a built tile set only when it holds atiles.jsonor numbered{z}/{x}subfolders. A cell copied into a served folder, or removed from it, is picked up at the next check.--bboxportrays less.s100 tiles exportands100 tiles serveleave out datasets that can't draw in the--bboxtiles before portraying them, so a small area of a large folder needs much less memory. The tiles written are the same.Re-export a served archive.
tiles exportwrites a PMTiles or MBTiles archive beside the old one and moves it into place when it's finished, sotiles servekeeps serving the old tiles during an export, and a failed export leaves the old archive as it was. A Compose example renders tiles in advance for a small computer; see Serve prebuilt tiles.MCP over HTTP.
s100 mcp serve --transport httpserves the MCP tools athttp://127.0.0.1:8300/mcp, so agents on other computers or in other containers can connect. On an address other than loopback it requires a bearer token, it refuses requests from web pages on other origins, and it leaves out the tools that open files by path or change the Library unless you pass--allow-changes. See MCP over HTTP.A start-up line for programs.
s100 tiles serve --ready-jsonprints one line of JSON when the server is listening, with the bound port, the token and the tile, TileJSON, WMTS, WMS and health check URLs, so a program that starts it with--port 0needn't read the start-up text. See Run under a supervising process.Serve charts to a web map or GIS. A new task page walks through
tiles servewith QGIS, MapLibre and Leaflet; see Serve charts to a web map or GIS.A display plane for vessels.
S98DisplayPlane.Vessels(75) sits between the mariner's data and ECDIS alerts, so AIS targets drawn as a dataset stay above the chart. It's a stopgap until the layer order is derived from information categories. The Layer stack lists it as Vessels.Own-ship weather in the Datasets panel. With
SOUNDCHARTS_NMEA_INPUTset, SoundCharts adds Own-ship weather (NMEA) to the Datasets panel at each start, instead of a Layer stack row; the barb still follows the own ship while it's shown.API keys in the secret store. SoundCharts saves the aisstream.io key in the computer's secret store (Credential Manager, the macOS Keychain or the Linux Secret Service) instead of
settings.json, which keeps only a reference; a key already insettings.jsonmoves there at the next start. Sources mark secret options with[Secret], andSourceCreationContext.ResolveSecretreads the environment variable, then the store.Data sources in the Datasets panel. SoundCharts lists a live source with your datasets: Add a data source in the Datasets panel adds it, and you show, hide, reorder and remove it like a file. Sources you add are added again the next time SoundCharts starts. NDBC observations are the first: they've moved from the Layer stack to the Datasets panel, and if you had them turned on they're added for you. A source runs only while it's shown, and fetches only the area in view.
Sources that aren't files. A
SourceRegistrationdescribes a live feed or polled service: its id, name, spec, options and when a host runs it, andCreatebuilds its processor from the saved options, loggers, a clock and an HTTP client factory.SourceRegistry.Defaultholds the NDBC observations (ndbc.realtime) and own-ship weather from NMEA (nmea.weather). A host starts, pauses and points the processor at the area in view throughIHostedDatasetProcessor, and disposing it stops the source.NmeaInput.Parseturns an input spec such asudp:10110ortcp://host:10110into an NMEA input.Vessel symbology as a portrayal. Own-ship and AIS targets are drawn by
VesselPortrayal, a code-defined portrayal of S-100 Part 9 drawing instructions, so they render headless and in any backend, not only on the Mapsui map. The symbology is the same: course vector and arrowhead, and a disc or the true-scale outline with the antenna cross. The outline is now a line without the translucent fill, as S-52 draws it, and it switches with the disc at the same scale at every latitude.InstructionBuildergainsPointAtandPathfor augmented geometry.OwnShipRendererandAisVesselRendererare obsolete.Live sources as datasets.
DynamicSourceProcessorwraps anyIDynamicFeatureSourceand itsIDynamicFeaturePortrayalas a dataset processor, so a live source can be picked, described, rendered headless and ordered by S-98 plane like a file, and is drawn again when it changes. The NDBC observations and own-ship weather from NMEA work through it, under the newSpecName.NdbcandSpecName.Nmeaformat names. SoundCharts still draws them as overlays for now.Datasets that change after loading. A processor that implements
ILiveDatasetProcessorraisesChangedwhen its data changes, such as a feed polled on a timer, and the Mapsui map session draws the dataset again: it waits 250 ms for more changes, picks up new available times for the timeline, and renders with the presentation the dataset was last drawn with. Failures are reported throughDatasetRenderFailedwith the newMapSessionRenderKind.LiveRefresh.Station series and warnings are pick sections. An S-104 or S-111 station's time series is now a
StationSeriesSection, and an S-124 warning part's message aNavigationalWarningSection, both inFeatureInfo.Sections. SoundCharts chooses a station's chart from the series' channels rather than the product name, so a station from another source with a water level height, or a current speed and direction, gets the same chart, and a series with other channels shows its rows.FeatureInfo.StationSeriesandFeatureInfo.NavigationalWarningare obsolete and read the sections.GeoPackage tiles.
s100 tiles export -o chart.gpkgwrites the tiles as an OGC GeoPackage 1.4 tile pyramid in Web Mercator, a single file that QGIS, ArcGIS Pro, GDAL and field apps such as QField open offline.s100 tiles serveserves a GeoPackage too, including Web Mercator ones that GDAL writes. See Tiles export.GeoTIFF export.
s100 tiles export -o chart.tifwrites one Cloud-Optimized GeoTIFF in Web Mercator for tools that take a single georeferenced image: the maximum zoom at full resolution, lower zooms as overviews. See Tiles export.s100 tiles serveis a WMS service.tiles servenow also answers OGC WMS 1.3.0 (and 1.1.1) requests atwms. GetMap draws any area in EPSG:3857, EPSG:4326 or CRS:84 from the served tiles. GetFeatureInfo reports the features and coverage values at a clicked point, ass100 identifydoes, in HTML, GeoJSON or plain text, so the QGIS Identify Features tool works on the chart. See WMS.Pick sections. Object Information content that isn't attribute rows now comes through one extension point.
FeatureInfo.Sectionsholds a feature's sections;IPickContributors registered inPickContributorRegistryadd them for any product or source, and each kind is registered inPickSectionKindRegistryso MCP can serialize it. The ice egg code is the first:IceEggCodeContributorgives an egg code to an S-411 sea-ice or lake-ice feature, or to a feature from any other source that carries S-411 concentration codes.identify_features,pick_featuresanddescribe_featurenow report a feature'ssections, so agents get the egg code too.FeatureInfo.EggCodeis obsolete, andGmlDatasetProcessorBase.BuildEggCodeis gone.Tide stations in SoundCharts. A Tide stations · predicted row under Other chart overlays draws NOAA's tide stations from 1:500,000 as S-104 gauges with a dashed frame: rising, falling or turning at the view time, with the height from 1:150,000 and the name from 1:50,000. Stations are thinned to 40 px and hidden where S-104 covers them. Their key is a section in the Legend tab. A station's Object Information card has the predicted height now, the curve 12 hours each side of the view time, the last high or low and the next four, the reference station and offsets of a subordinate station, whether depths use it, and the "not a forecast" note. The station list's date and Refresh sit under the tide predictions setting, and it's downloaded from NOAA on first use. The MCP tools
get_tide_displayandset_tide_displayread and set it, andpick_featureswithselectnow shows live overlay features such as a station.Current stations in SoundCharts. A Current stations · predicted row draws NOAA's tidal current stations from 1:500,000: S-111's arrow in its speed band's colour rising from a dashed station frame, with the speed, or a slack bar and the turn time. Stations are hidden where S-111 covers them, and the Legend tab has their speed bands. A station's card has the current now, the speed 12 hours each side of the view time, the slacks and maxima, the flood and ebb directions and the depth; currents are for display only, not route checks.
set_tide_displayturns them on withcurrentStations.Predicted water level on the chart and the Timeline. The DEPTHS pill says when depths are adjusted by a prediction ("+ water level 14:20 · predicted", or "partly predicted" beside S-104), its flyout lists the predicted stations, offers Use tide predictions where no S-104 meets the view, and says when NOAA has revised the station list. The adjusted-area edge and the new seam where S-104 hands over to predictions are clipped to the loaded charts' water, and a picked station outlines its cell. With predictions on, the Timeline and its time HUD show even with nothing timed loaded: a Tide predictions lane follows the station nearest the map centre, and All loaded shows the next 48 hours.
get_depth_basisreportspredictedand the stations.s100 tiles serveis a WMTS service. Besides its XYZ URLs and TileJSON,tiles servenow answers OGC WMTS 1.0.0 requests: a capabilities document atwmts/1.0.0/WMTSCapabilities.xml, and GetTile in the KVP and RESTful encodings, with palettes as styles and S-104 and S-111 time steps as aTimedimension. QGIS, ArcGIS Pro and GDAL can add the tiles from that one URL. See WMTS.Tide predictions from the shell and for agents.
s100 tides stationslists tide stations near a point,s100 tides predictpredicts a station's heights or highs and lows as a table, CSV, JSON or an S-104 file, ands100 tides updatedownloads NOAA's stations into an offline catalogue. The MCP toolslist_tide_stationsandpredict_tidedo the same for agents, in SoundCharts ands100 mcp serve, and with tide predictions on,sample_coveragefills S-104 gaps with a prediction whosesourcenames the station and carries the caveat. Seetides predictand Find when the tide is above a height.Tidal current predictions from the shell and for agents.
s100 tides currents stationslists current stations near a point, ands100 tides currents predictpredicts a station's speeds and directions or its slacks and maxima as a table, CSV, JSON or an S-111 file. The MCP toolslist_current_stationsandpredict_currentdo the same for agents, and with tide predictions on,sample_coveragefills S-111 gaps with a predicted current. Seetides currents predictand Find slack water in a pass.Tidal current predictions.
EncDotNet.S100.Tidespredicts tidal currents:CurrentPredictorfor a harmonic current station (major axis, or both axes for a rotary current) andSubordinateCurrentPredictorfor a subordinate one by NOAA's method. Each gives the current at a time, a velocity series, and slack waters and maximum floods and ebbs, matching NOAA's own 2026 predictions to a minute and a few mm/s. TheEncDotNet.S100.Tides.Stationscatalogue now holds NOAA's current stations too, per depth bin, with subordinate stations' differences and ratios. See the Tides README.Current predictions as S-111.
EncDotNet.S100.Datasets.S111writes station series as S-111 Edition 2.0.0 files (data coding format 8), andS111CurrentPredictionsturns a station's current predictions into one, marked as a non-authoritative astronomical prediction (producerZZ01). See the S-111 README.Tide predictions as S-104.
EncDotNet.S100.Datasets.S104writes station series as S-104 Edition 2.0.0 files (data coding format 8), andS104TidePredictionsturns a station's harmonic predictions into one, on the station's chart datum. Predicted files carry the producer codeZZ01and say they're astronomical predictions, not an official product and not for navigation. They read back throughS104DatasetReaderunchanged and pass the S-104 validation pack. The HDF5 tree they're built from,Hdf5WriteGroup, andPureHdfWriterare the project's first HDF5 writers. See the S-104 README.Tide predictions. The new
EncDotNet.S100.Tidespackage predicts the astronomical tide at a station from its harmonic constituents: the height at a time, a series at a fixed step without allocating per sample, and the high and low waters in a period. It knows NOAA's 37 standard constituents and the 83 further ones NOAA lists at some stations, and gives heights on mean sea level or a chart datum such as MLLW. Against NOAA's published predictions at five stations it agrees to under a millimetre RMS. See the package README.Tide stations. The new
EncDotNet.S100.Tides.Stationspackage is the catalogue the predictions come from. It reads NOAA CO-OPS's tide stations, harmonic constants, datums and subordinate-station offsets, keeps them in a JSON file that works offline, finds stations near a point or in a box, and predicts a station on a chart datum such as MLLW or LAT with its provenance ("from Seattle 9447130, with offsets"). A cheap check says when NOAA has newer data, such as a new tidal datum epoch. The same JSON format lets you bring your own stations.EncDotNet.S100.TidesgainsSubordinateTidePredictor, which predicts a subordinate station by NOAA's method; its highs and lows match NOAA's at three Puget Sound stations to under a minute and a millimetre. See the package README.Relief shading strength. The S-102 Relief shading switch in Display controls gains a Strength control while it is on: Subtle, Medium (the default) or Strong. It is kept with the display settings and saved with display combinations, and the MCP tool
set_bathymetry_displaytakesreliefStrength. At Dusk and Night, slopes facing the light are lightened less (half and 30 %), so they don't glare on a dark display. The newEcdisDisplaySettings.LayerOptionscarries map-wide layer settings that are more than on or off.Relief shading is marked on the map. While S-102 relief shading is on and S-102 is in view, the status bar's
DEPTHSpill readsCharted · Relief, and its popup says relief is on, as a display aid that leaves depth colours and values unchanged, with an Off button. The S-102 legend ends with a Relief shading (display aid) row.Neighbouring S-102 cells join up. Where two loaded S-102 cells meet, the dashed "limit of S-102 data" line no longer runs through the water between them, and SoundCharts no longer shows a light seam along the join. The limit line stays wherever S-102 data ends and S-101 takes over. A new S-98 rule, R-102-102-A, does this. It reads where each cell has data from the new
CoveragePortrayalResult.DataArea.Legend tab. SoundCharts' right dock gains a tab strip, Object information · Legend, and the legends of what the map draws move to the Legend tab: one collapsible section per product or overlay (weather fields, tropical cyclones, fronts, AML), in draw order, with In view | All loaded, a filter and Collapse all. Swatches sit on the chart background of the current palette. Open it with View > Legend (Ctrl+Shift+L) or the Legend link under a Layer stack entry, which replaces the entry's inline legend. It never opens by itself, and a pick switches the dock back to Object information. When the dock is too narrow for the tab labels, the tabs show icons only.
Route check in the Legend tab. While Check route is on, the route check's legend (UKC at ETA, findings, storm at ETA) is the top section of the Legend tab. The compact card at the map's bottom left shows the same rows while the tab isn't shown, and hides when it is. The MCP tool
set_legendopens or closes the tab, sets In view and expands or collapses a section; it andget_legendreplaceget_map_legendandset_map_legend, which are removed.Hover to find in the Legend tab. Resting the pointer on a Legend row, or moving keyboard focus to it, rings the features that row describes on the map, in the pick highlight's accent: a catalogue symbol (S-101, S-57), a front, a warning area or an AML class, up to 100 features drawn in the current view. A band of a colour or arrow ramp (S-102 depths, a weather field, S-111 speeds) tints its area in view instead (#1433). The rings and tint clear when you leave the row or move the map. The MCP tool
set_legendtakesfindRowto ring a row and returns what is ringed, or tinted, asfind.S-102 relief shading. An optional hillshade over the S-102 depth bands shows the shape of the seabed (dredged pits, sand waves, berth toes) in high-resolution bathymetry. It lights the depth surface from the north-west and darkens or lightens each band colour by slope, so the bands and the safety contour keep their meaning. It isn't part of the S-102 portrayal, so it's off by default. In SoundCharts, switch it on in the new Bathymetry section of Display controls, shown while an S-102 dataset is loaded, or with the
get_bathymetry_displayandset_bathymetry_displayMCP tools.s100 render --show-layer s102.reliefdraws it.ReliefShadingandS102Reliefare the library types, andStyledCoverageLayer.ReliefShadecarries the shading to the coverage renderers. Zoomed out, SoundCharts draws the shaded surface with mipmaps (SmoothRasterStyle), so the shading averages out smoothly instead of turning into a speckled pattern. The shaded surface goes to the map as an image, without a PNG round trip, so relief costs about the same as the flat surface: on six 1 m BSH cells, portrayal takes 7.1 s with relief against 9.2 s without (it was 16.8 s).Additional Military Layers portrayal. The new
EncDotNet.S100.Datasets.Amlpackage draws NATO AML cells with SoundCharts' own portrayal (not the restricted official one): dash-dot lines on a halo, unfilled areas with inward ticks, framed point symbols and italic labels, in air, operational, seabed and environmental colour families for Day, Dusk and Night. It covers the RAL air and operational classes, which the AML 3.0 air trials share; airspace shows its limits as a stacked fraction. Styles are data in modules, and the legend is built from them. A new S-98 plane,S98DisplayPlane.AdditionalMilitaryLayers(45), sits between the chart overlays and the cautions. Text instructions gainFontSlantfor italic labels. See the Datasets.Aml README.Additional Military Layers display controls. SoundCharts' display panel gains an Additional Military Layers section while an AML cell is loaded: a switch per AML product with its cell count, Follow AML scale bands (on by default) and a Legend flyout built from the AML styles. With the bands followed, each AML cell shows out to its scale band's coarsest display scale, and a finer band of the same product wins where its cells cover a coarser cell (
AmlScaleBandVisibility). A corner chip says CLB isn't used for depth checks while CLB is drawn. The switches are kept after a restart, and theget_aml_displayandset_aml_displayMCP tools read and set them.S-412 Marine Weather Warnings (draft). The new
EncDotNet.S100.Datasets.S412package reads S-412 GML datasets (wind, significant wave height, restricted visibility, thunderstorm and ice accretion warnings) and portrays them with the draft WMO portrayal catalogue, now bundled with the feature catalogue inEncDotNet.S100.Specifications.s100 renderand the other hosts detect S-412 and draw it on the S-98 cautions and warnings plane, with S-124.S412MarineWeatherWarningsis the typed model. S-412 isn't approved yet, so expect its catalogues to change. Its validation pack (S412MarineWeatherWarningRules, 14 rules, all warnings while the specification is a draft) checks the feature catalogue's mandatory attributes and listed values, times, references and geometry. Warnings follow the Timeline: each is drawn only from the start to the end of its date range and until its cancellation date, by the rule S-124 and CAP warnings use, ands100 render --time-stepdraws a step.describe_featuredecodes a warning's threshold, Beaufort force and message in each language. See the S-412 README.Picks match the map's time. MCP
identify_featurestakes an optionaltimeand returns only the S-412 and CAP warnings in force then, the surface analysis valid then and a tropical cyclone's position then. In SoundCharts,identify_featureswithout a time andpick_featuresfollow the map: its view time and the S-124 parts it hides. Hosts supply what their map draws throughIMapDrawState(S100McpServerOptions.MapDrawState), andFeatureAccessor.GetFeatureshas an overload that takes the time.PickFeaturesToolnow takes theIdentifyFeaturesToolit uses.Faster multi-cell
s100 renderands100 tiles, and HiDPI captures. The CLI ands100 mcp servenow render through the chart engine (EncDotNet.S100.Rendering.Engine): cells parse, portray and build their scenes in parallel, so a 17-cell composite renders in about 10 s instead of 14 s, and tile blocks render as scheduled jobs in the order they're written.render_to_image'spixelDensitynow applies inmcp serve, as in SoundCharts. Finer cells hide coarser ones by their coverage footprint, not its bounding box, so composites where a coarse cell's coverage isn't rectangular can change slightly. Breaking changes:HeadlessCompositor,HeadlessCompositeScene,HeadlessCompositeInput,HeadlessCompositeOptions,HeadlessTileRenderer,HeadlessTileOptions,HeadlessTileandTileBlockleaveEncDotNet.S100.Datasets.Pipelines; useChartCompositor,ChartComposition,ChartCompositeInput,ChartCompositeOptions,ChartTileRenderer,ChartTileOptions,ChartTileandTileBlockinEncDotNet.S100.Rendering.Engine, whereChartCompositornow takes its S-98 authority explicitly.S100CompositeOptions.PixelDensityis new. See the Rendering.Engine README.Tropical cyclones on a route. With an NHC advisory loaded, Check route,
check_routeands100 route checktest the route against the storm at each ETA: stretches inside its 34, 50 or 64 kt wind radius (in the quadrant the vessel is in) and inside the forecast cone, the closest approach to its centre, and stretches reached after the forecast ends (not checked). By default the 34 kt radius is tested, the 50 and 64 kt radii are Must review, and the 34 kt radius and the cone are Check; SoundCharts sets these in Settings > Chart display > Mariner Settings > Tropical cyclones on a route, MCP withset_route_weather_settingsandcheck_route'scyclone*arguments, and the CLI with--cyclone-radius,--cyclone-must-reviewand--no-cyclone-cpa. The verdict card's Weather row counts the storm's findings and gives the closest approach, and the map draws the storm at that ETA. In the libraries,RouteCheckSources.Cyclones(IRouteCyclone),RouteCheckSettings.TropicalCyclones(TropicalCycloneCheckSettings),WeatherCheckResult.Cyclones,TropicalCycloneDetailsand theweather.tc_*codes are new. Breaking changes:WeatherVerdictgainsInsideCycloneRadiusas its first value,CycloneCheckStormandWeatherSample.Cyclonesare new, and the weather check runs, rather than being skipped, when only an advisory is loaded. See Tropical cyclones.Weather along a route. Check route,
check_routeands100 route checkgain a weather check: with a GRIB2 or NetCDF forecast loaded, they sample the route every nautical mile at the ETA and compare the wind at 10 m and the significant wave height with the vessel's limits. Stretches above a limit are Check findings with their time window ("Wind above 25 kn for 3 h",weather.wind_above_limit,weather.waves_above_limit); where the forecast ends before the vessel gets there, or a grid doesn't cover it, the stretch is reported as not checked (weather.forecast_endsand others), never passed. Each sample reads the nearest grid node and time step, and the finest grid with the newest run wins where grids overlap. In SoundCharts the limits are in Settings > Chart display > Mariner Settings > Weather on a route (get_route_weather_settings,set_route_weather_settings), the verdict card gains a Weather row whose tooltip names the limits in use, and Findings gains a Weather chip. An RTZ route'svesselMaxWind(knots) andvesselMaxWaveare used where no limit is set.check_routetakesmaxWindKnotsandmaxWaveHeightMetersand returns aweathersection with an optional departure sweep; the CLI takes--max-windand--max-wave. In the libraries,WeatherCheckjoins the built-in checks, withIRouteWeatherSource(onRouteCheckSources.Weather),WeatherLimitsonRouteCheckSettingsandPassagePlan.VesselLimits,WeatherDetails,WeatherFindings,RouteFindingCategory.WeatherandRtzPassagePlan.VesselLimits. Breaking changes:RouteCheckerruns five built-in checks, soRouteCheckReport.Checkshas aweatherentry; thePassageRouteSnapshotrecord has a new last positional parameter. See Weather along the route.Precipitation, thunderstorm risk and cloud cover on the chart. GRIB2 and NetCDF files with a precipitation rate, CAPE or total cloud cover, such as GFS, can now draw them: precipitation in rain radar colours from 0.1 mm/h, thunderstorm risk in ochre where CAPE is 1000 J/kg or more (moderate, high and extreme), and cloud cover as a light grey veil from 25 %. All three are off by default, behind new Precipitation, Thunderstorm risk and Cloud cover switches in Display controls (and in
set_weather_display), and each has a legend. Picks give the rate in mm/h, CAPE in J/kg with its risk, and cloud cover in percent, and the Library's GFS sources can fetch PRATE, CAPE and TCDC.s100 rendergains--show-layerto draw layers that are off by default. In the libraries,WeatherParametersgainsPrecipitationRate,CapeandCloudCover,WeatherUnitgainsKilogramsPerSquareMetrePerSecond,JoulesPerKilogramandPercent,WeatherLevelgainsEntireAtmosphere(GRIB2 fixed surface 10), and the new styles arePrecipitationStyle,ThunderstormRiskStyleandCloudCoverStyle.WeatherCoverageStyle.Opacityis now set per style, andStyleVersionis 7. See Show wind and waves on the chart.Tropical cyclones from the Library. A new Library source, Tropical cyclones — NHC (
FEED), lists every storm NHC is issuing advisories for in the Atlantic, East and Central Pacific, one item each, named by the storm with its class symbol. An item downloads the advisory's forecast, wind radii and best track zips, and NHC's next advisory replaces it in place. While a storm is loaded, the Library reads NHC's list every hour and announces a new advisory for it, with Load latest run; nothing is loaded on its own, and a storm newly active doesn't notify. An advisory is stale 7 hours after it's issued ("Advisory 17 is over 7 hours old"); a stale storm isn't faded but says its age on its label and in Object information. A loaded storm NHC stops listing is drawn as its final advisory: past track and a post-tropical storm, "Final advisory issued". Display controls shows its Weather section for cyclones and surface analyses too, and ends it with Wind radii, Past track and Forecast times switches while a cyclone is loaded; the newget_weather_displayandset_weather_displayMCP tools read and set every Weather switch. In the libraries,WeatherServiceKindgainsNhcStorms(NhcActiveStormsreadsCurrentStorms.json),RemotePartgainsFileName(a download's parts saved side by side),TimeSemanticsgainsStaleAfterIssue,TropicalCycloneAdvisorygainsIsFinal,NhcAdvisoryFilesgainsIsFinalandFinalMarkerName, andTropicalCycloneStylegains the switch keys. Breaking changes:MapsuiMapTimedDataset.StaleAgeAttakes an optional clock, andTimeSemanticshas a new last positional parameter. See Get active storms from the Library.Tropical cyclones follow the Timeline. The cone and forecast always draw; the storm and its wind radii are drawn at the view time, so scrubbing moves them smoothly along the track. Between forecast points the storm is an estimate, in a dashed ring labelled "est.", with its position on the great circle and its wind and radii in between; before the advisory it follows the best track; beyond the forecast the cone stays and the Datasets row has a Beyond forecast tag. Object information gives the storm at the view time and says when it's an estimate. The Timeline groups storms under Tropical cyclones, in a lane named for the storm with a tick at each forecast point and diamonds at the issue time and the next advisory due; the step menu lists the storm, so ‹ › step its forecast points. In Live mode the storm follows the clock. In the libraries:
TropicalCycloneAdvisory.StormAtandTropicalCycloneStormAt,TimeStepSelection.Continuous(andMapsuiTimeSelectionKind.Continuous),ITimeAwareDatasetProcessor.NextIssueTime,TimelineLabelandTimelineDetail(onMapsuiMapTimedDatasettoo), andTropicalCycloneStyle.StormDetailLabel;TropicalCycloneDatasetProcessoris time-aware.get_timeline_statereports a lane'ssub,issued,nextIssueandstepTicksand a layer's warningtag. Breaking change: a storm's own parts (the storm and its radii) now come after the advisory's other parts inEnumerateFeatures. See Show tropical cyclones.Surface analyses follow the Timeline, from the Library. A WPC bulletin's analysis or forecast is now drawn from its valid time for 12 hours: after 6 it's stale, at half opacity with its age on each H and L, a Stale tag in the Datasets panel and a warning line in Object information; beyond 12 hours the Datasets row says "No analysis at view time". Of several loaded bulletins, the one valid latest at or before the view time draws, so a newer analysis or a nearer forecast takes over. The Timeline groups them under Surface analysis in a WPC lane. A new Library source, Surface analysis — WPC (
FEED), lists the latest analysis and, when chosen, the forecast fronts; a loaded analysis is replaced by the next every 3 hours, and is stale after 6. In the libraries,TimeSemanticsgainsStaleAfterandSupersession,RenderContextgainsTimeStepAge,VectorSubLayergainsOpacity,PickAttributegainsStaleNotice, andWeatherServiceKindgainsWpcBulletins, withWeatherService.StaleAfterHoursandRefreshHoursandWeatherServiceDataset.File.get_timeline_statereports a stale layer'sstaleHours. Breaking changes:SurfaceAnalysisDatasetProcessor.DrawnAnalysisOftakes a time step, andSurfaceAnalysisStyle.BuildCentretakes the analysis's stale age. See Show a surface analysis.Tropical cyclones on the chart. SoundCharts and
s100 rendernow draw an NHC advisory in one plum-grey storm ink: the cone, tinted and stippled beyond 72 hours, the 34, 50 and 64 kt wind radii, the forecast and past tracks, a WMO weather-map symbol at each forecast point (mirrored south of the equator), and the storm with its name, wind, pressure, advisory and motion. Times on the chart follow the Local or UTC setting. In the Layer stack a storm has two entries, one for its lines and symbols and one for its cone and radii, each with a legend. Picking any part shows one storm in Object information, with the advisory, the next advisory due, the intensity, the part picked and the radii by quadrant. Not for navigation. New in the libraries:TropicalCycloneStyleand theWXTC*tokens inEncDotNet.S100.Datasets.Weather,RenderContext.DisplayTimeZone,MapPresentationState.DisplayTimeZone,InstructionBuilder.Point'ssymbolScaleandTropicalCycloneWindRadii.QuadrantSurface. Breaking changes:EncDotNet.S100.Datasets.Weathernow depends onEncDotNet.S100.Datasets.TropicalCyclones, andTropicalCycloneDatasetProcessor.NotForNavigationNoticereads "Tropical cyclone forecast, not for navigation. Follow official NHC advisories." See Show tropical cyclones.Fronts and pressure centres on the chart. A WPC coded surface bulletin now draws its cold, warm, occluded and stationary fronts and its troughs with the triangles and semicircles of a printed weather map, on the side each front moves towards, and its highs and lows as a bold H or L with the pressure. Everything is in one dark ink (
WXFRONT) over the isobars, with a Layer stack legend and a pick in Object information.s100 renderdraws bulletins too. Feature ids are now the bulletin's code and number, such asCOLD 3, and the pick notice is "Weather analysis, not for navigation." See Show a surface analysis.Tropical cyclone advisories. A new
EncDotNet.S100.Datasets.TropicalCyclonespackage reads the National Hurricane Center's GIS shapefile zips for an advisory: the forecast track and cone (al092022_5day_020.zip), the wind radii (_fcst_) and the best track (_best_track).NhcAdvisoryReadergives aTropicalCycloneAdvisorywith the storm, the advisory number and issue time, every forecast point with its wind, gusts, pressure and class, the 34, 50 and 64 kt radii by quadrant, the cone split at 72 hours, and the past track with observed radii. The default registry recognises a forecast zip, or a folder of one storm's zips, asTC/1.0.0, ands100 infodescribes the storm, the advisory, the forecast and every forecast point. Tropical cyclones aren't drawn on the chart yet. Not for navigation. Breaking changes:SpecName.NonS100Formats,S100Products.CreateDefaultRegistry()(and soProductRegistry.Default) andWeatherProducts.Allnow also holdTC. See the Datasets.TropicalCyclones README.Lines with symbols along them, and legends with pictures. Code-defined portrayals can now draw a line with a symbol repeated along it, such as a weather front's triangles:
ComplexLineStylesets the pen, the symbols, their spacing and the side of the line they go on, optionally alternating, andInstructionBuilder.ComplexLinedraws it. The spacing is in millimetres on the display, so it holds at every zoom. Layer stack legends can now show a symbol, a line sample or an outlined area beside each label, built withLegendBuilder.CoverageLegendEntryis replaced byLegendEntryand itsSwatchLegendEntry,SymbolLegendEntryandLineLegendEntryrows. See EncDotNet.S100.Portrayals.Surface analyses: fronts and pressure centres.
s100and the libraries now read the Weather Prediction Center's coded surface bulletins, the 3-hourly analysis at standard and high resolution and the coded forecast bulletins, into a surface analysis model of fronts, troughs, highs and lows.s100 infogives each bulletin's valid times and what it holds. Drawing them on the chart comes next. See Show wind and waves on the chart.Air temperature and freezing spray on the chart. GRIB2 and NetCDF files with 2 m air temperature now draw it as dashed isotherms every 5 °C, off by default, behind a new Air temperature switch in Display controls. Where a file also has the 10 m wind and a sea temperature, or GFS's surface temperature and land mask, SoundCharts works out the freezing spray (vessel icing) risk with Overland's predictor and draws it in four classes, from light to extreme. Picks give the air temperature and the icing class, and the Library's GFS sources can fetch the inputs. See Show wind and waves on the chart.
Restricted visibility on the chart. GRIB2 and NetCDF files with visibility, such as GFS, now draw fog and poor visibility as a grey fill in the marine forecast bands: very poor (under 1000 m), poor (to 2 nautical miles) and moderate (to 5 nautical miles). Good visibility isn't drawn. The Library's GFS sources can now fetch visibility, and picks give it in nautical miles. See Show wind and waves on the chart.
Charts get ready for panning in the background. When a Library source or a large exchange set loads as you pan, SoundCharts now portrays its not-yet-loaded cells one at a time while the map is idle, so panning to them later takes about a second instead of many seconds. It stops whenever the map is loading or drawing, picks up where it left off after a restart, and shows its progress under the Library's bulk bar. Turn it off with Prepare charts in the background in Settings → Advanced. The portrayal cache is now capped at 1 GB, and background work fills at most three quarters of it.
S-57 updates are checked before they apply. An S-57 update now applies only when it's for the cell's edition and follows on from the updates before it, record by record. Updates a re-issue already holds are skipped, and an update of edition 0 is reported as cancelling the cell. SoundCharts warns when an update is refused or cancels a cell,
s100 s57 convertprints what applied, andS57Dataset.UpdateReportgives the details. Exchange sets that hold only updates are now CRC-checked too. See Apply update cells..NET 10 only. The packages no longer target .NET 8, which reached end of support in November 2026; they target .NET 10 and run on later versions. CI also runs the tests on .NET 11. The packages now build on EncDotNet 0.11.0, which made the same change.
Surface currents on the chart. GRIB2 and NetCDF files with currents now draw them as arrows in S-111's speed bands and colours, from ocean models such as HYCOM and Copernicus Marine, satellite altimetry or HF radar. Where an S-111 grid is loaded, only its arrows are drawn inside its area. A Currents switch in Display controls turns them off. The Library has two new sources: Surface currents, altimetry — NOAA AOML ERDDAP (worldwide, daily) and Surface currents, HF radar — NOAA ERDDAP (US coasts, hourly). Picks and
sample_coveragegive speed in knots and the direction the current sets to. See Show wind and waves on the chart.Sea surface temperature on the chart. GRIB2 and NetCDF files with sea surface temperature now draw it as a colour fill with a band for each degree from 0 °C to 30 °C, so fronts such as the edge of the Gulf Stream stand out; the fill is clipped to water. An Isotherms switch in Display controls adds labelled lines every 2 °C. The Library has a new Sea surface temperature — NOAA ERDDAP source with the NASA MUR, NOAA OISST and NOAA Geo-polar Blended daily analyses, and picks and
sample_coveragegive the temperature in degrees Celsius. See Show wind and waves on the chart.Convert S-101 to S-57.
s100 s101 convert --to s57writes an S-101 dataset as an S-57 Edition 3.1 base cell, following S-65 Annex C, and prints what Annex C dropped or folded intoINFORM.--exchange-setwrites anENC_ROOTwith aCATALOG.031, and options cover the choices Annex C leaves to the converter. It's for testing the S-57 → S-101 translation and for tools that read only S-57, not for producing ENCs. See Converting S-101 to S-57.tiles serveno longer exits on a file rename.tiles serve,feed serveandmcp serve --transport httpno longer watch the working directory for configuration changes. On Windows, a server started from a short (8.3) path could end with anArgumentOutOfRangeExceptionwhen a file under that folder was renamed.
October 2026
One time readout on the map, and step buttons that stay put. SoundCharts shows the view time once on the map: the stamp at the top left while the dock shows the Timeline tab, otherwise the time bar at the bottom. With the dock on Logs or Clearance, both used to show. The time bar and the Timeline's own readout now have fixed-width slots and an always-present Live / Go live button, so ‹ and › no longer move when you step and a second click can't land on the button that undoes it. The words LIVE and PINNED are gone: a green dot and a muted "now" mean live, an accent dot and an offset such as "in 23 min" mean you chose a time. With navigational warnings or dated chart features loaded, the time bar says "Display Not Real Time" on its own line. The step buttons' tooltips name the step ("Next step: 1 h (→)"), screen readers hear the time in full ("…, in 23 min, pinned"), the time bar's dock button says Show timeline when the dock is open on another tab and is hidden in a narrow window, and its message colours follow the dark theme.
A measure card. SoundCharts' Measure tool now shows a card at the map's top left. It measures along rhumb lines or great circles (press
Gto switch; the choice is remembered), takes typed or pasted From and To positions, and shows the distance in your Distance unit with the other unit system under it, the forward and reverse bearings to 0.1°, and the total. Great-circle legs draw as curves, the earth model is named, and Copy (Ctrl+C or ⌘C) puts the measurement on the clipboard. A great-circle measurement promoted to a route keeps geodesic legs. Theset_measureandget_measureMCP tools drive and read it with unrounded values (#1130).Range & bearing tool. SoundCharts has a new map tool next to Measure: an EBL/VRM pair from an origin you choose (⌘R or Ctrl+R). Click the origin, then the end, or type the origin, range and bearing on its card to read the end position and the reverse bearing; a typed range or bearing is locked. It works along a rhumb line or a great circle (
Gswitches), draws the range as a geodesic circle and can add range rings. MCP'sset_range_bearingandget_range_bearingdrive and read it with unrounded values, for the S-164 Accuracy4–6 and Accuracy12 tests (#1130).What the chart's depths are relative to. SoundCharts' status bar now shows DEPTHS next to OVERSCALE whenever an S-101, S-57 or S-102 dataset is loaded: Charted, or Charted · water level not applied when S-104 water level covers the view but isn't added to the chart. Select it for the vertical datum and sources in view, the S-104 datasets, and where water level is applied (the Depth card and the route check). On a narrow window it shortens to whole words, never an ellipsis. The Depth card, the Clearance readout and route findings now share one vocabulary: Charted depth, Water level, Adjusted depth and "water level not applied" replace Base, Tide, "tide-adjusted" and "tide not applied", in the CLI's route-check findings too. The Depth card reads the S-101
SoundingDatumat the point, so it warns when an S-101 depth and the water level can't be confirmed on the same datum. A new MCP tool,get_depth_basis, returns the indicator's state, andget_check_stateadds it asdepthBasis(#1191).S-101 features follow their dates. A buoy, traffic separation scheme or other S-101 feature with a fixed or periodic date range is now drawn only at the dates it applies, as S-100 Part 9 asks. The parser turns the portrayal's
Date,Time,DateTime,TimeValidandClearTimecommands intoDrawingInstruction.TimeValidintervals, and S-101 and S-401 draw atRenderContext.PortrayalTime(an instant, or a viewing range) without running the portrayal rules again. With no time set, every feature is drawn as before. SoundCharts draws them at the view time, with dates read in your Local/UTC setting, and a pinned view time says "Display Not Real Time" for these charts as it does for S-124 warnings. The S-164 FixedDateRange and PeriodicDateRange tests now pass (#1126).Why an HDF5 file wasn't opened. An HDF5 file is detected only from its root
productSpecificationattribute, which S-100 Part 10c requires, and one that doesn't have it is no longer read as S-102. When no product recognises an HDF5 file, SoundCharts' warning,s100 info,validate,render,tilesandidentify, and MCP'sopen_datasetnow say why: the file has noproductSpecification, it names a product that isn't supported, or it can't be read as HDF5 (for example an encrypted S-100 dataset opened outside its exchange set). The newDatasetPipelineFactory.DescribeUnrecognizedDatasetgives the same sentence to library hosts, andCreateProcessorandS100Dataset.Openinclude it in their errors. To open a file that omits the attribute, passopen_dataset'sspec. Every real S-102 file checked, including NOAA's published tiles, declares it (#1092).One not-for-navigation notice per pick. SoundCharts' pick report on a GRIB2 or NetCDF weather grid or a CAP warning no longer repeats the notice it leads with as the first attribute row. The processors still put the notice first in their feature info for other callers (MCP, the Mapsui pick query), now marked by
PickAttribute.IsNavigationNotice; build one withPickAttribute.NavigationNotice(text).Wind and waves in the CLI, MCP and docs. A new guide, Show wind and waves on the chart, covers the GRIB2, NetCDF and CAP formats, where to get the data, NDBC buoys, own-ship wind and what isn't supported.
s100 identifynow samples GRIB2 and NetCDF grids (afieldssample with units) and finds CAP warning areas, and prints a not-for-navigation notice (noticesin JSON) for weather data;--specacceptsgrib2,netcdfandcap.s100 infoadds the model, run, grid, extent and layers of a weather grid, the alert count of a CAP file and a Notice row, ands100 list-specslists the weather formats. Over MCP,list_time_stepslists GRIB2 and NetCDF valid times and CAP warning starts and ends (through a newITimeSteppedDatasetDataon the catalog payload),list_specsflags GRIB2 and NetCDF as sampleable and CAP as queryable, andidentify_features,query_featuresanddescribe_featureread CAP warning areas, whose features now carry the pick report's attributes. SoundCharts' About box and the site footer credit the weather data providers (NOAA, ECMWF under CC BY 4.0, Copernicus Marine, DWD), and Open Dataset... has a Weather Data (GRIB2, NetCDF, CAP) file type.Weather sources in the Library. The known catalogues list six weather services, not S-100 data and not for navigation: GFS-Wave and GFS from the NOMADS GRIB filter (cut to the map view) and from NOAA's GFS bucket on AWS (the whole globe, only the chosen fields read from each file by byte range, driven by its
.idxinventory),api.weather.govmarine alerts for the map view's marine zones, and WAVEWATCH III from NOAA's ERDDAP as a NetCDF subset. A newWeatherFeedSourceandWeatherFeedIndexerinEncDotNet.S100.Collectionslist each service's latest run as one item that downloads as one file (RemoteItemLocation.Parts). A run more than 12 hours old is tagged Stale, with Load latest run (LibraryOperations.LoadLatestRunAsync); a newer run replaces the last unless it's pinned (LibraryDownloads.Pin). Each source's licence and attribution go with its items, the loaded layer in the Datasets panel and its pick reports. Every request sends an identifyingUser-Agent, as the NWS API asks. A folder holding one model run in hourly GRIB2 files is listed and loads as one dataset (GribRunFolder,ProductRegistration.MatchFolder). See the Collections README and the SoundCharts README.Own-ship wind from NMEA 0183. A new
EncDotNet.S100.Nmealibrary is a minimal NMEA 0183 reader, kept apart so an own-ship NMEA driver can share it: checksum validation, talker-agnostic decoding ofMWV,MWD,MTW,XDR(air temperature and pressure),HDT,HDG,VHW,RMCandVTG, true wind from apparent wind, and line sources over a stream, a replay file, TCP and UDP. A newEncDotNet.S100.DynamicSources.Nmealibrary buildsNmeaWeatherSourceon it: one feature at own ship with true wind fromMWD, or derived from relative wind, heading and motion over the ground (falling back toMWVT and to motion through the water), drawn as the weather wind barb (southern-hemisphere barbs south of the equator, byWindBarbSymbols.For) next to the own-ship symbol on S-98OtherChartOverlaysat priority 110. Without a heading or speed it shows the relative wind, grey and labelled so. A pick lists true and relative wind, how true wind was found, heading, water and air temperature and pressure. In the viewer, setSOUNDCHARTS_NMEA_INPUT(udp,tcp://host:portor a recording's path) to get its Layer Stack row. Not for navigation. See the DynamicSources.Nmea README.Weather drawing polish. Wind barbs south of the equator are now the mirrored southern-hemisphere barbs (
WXBARBS005toWXBARBS200), chosen by each cell's latitude;WindBarbSymbols.For(knots, latitude)applies the same rule to a single barb, and NDBC stations south of the equator use it. The wave height fill is clipped to water when an S-101 chart is loaded, by a new S-98 rule,R-101-WX-B, that shares its effect with the S-104R-101-104-Bclip and applies to anyGridCoverageSubLayerwith the newClipToWaterflag; wind isn't clipped. A newPressureIsobarStyledrawspressure.mslas isobars every 4 hPa, labelled in hPa, onOtherChartOverlaysat priority 90, on by default wherever the data has pressure:CoverageContourstraces anICoverageStyle's value-basedContourStyles into anIsolineCoverageSubLayer, which both renderers already draw. In the viewer, each weather fill in the Layer stack shows a colour legend of its bands (GridCoverageSubLayer.Legend); the headless renderer doesn't draw legends. A new Weather section in Display controls, shown while a GRIB2 or NetCDF dataset is loaded, switches Isobars (on), Wind speed fill and Wave arrows (off) for every weather dataset and keeps them between sessions; the switches reach the processors as the newEcdisDisplaySettings.LayerVisibility(WeatherCoverageStyle.IsDrawnWith), ands100 renderdraws the defaults. Not for navigation. Breaking changes: the GRIB2 and NetCDF processors now draw isobars for a file withpressure.msland offer every applicable style inLayerKeys, and their content scope names the drawn layers;WeatherLayerKindgainsIsolines;WeatherCoverageStyle.CreateAll()and, for a pressure grid,CreateForalso returnPressureIsobarStyle;WeatherCoverageStyle.Contoursis virtual;WeatherPalette.Palettehas two more tokens;WeatherCoverageStyle.StyleVersionis 2, so cached weather tiles are redrawn;S98DefaultRules.Defaulthas a seventh rule; anIsolinewith an empty label is drawn unlabelled. See the Datasets.Weather README.Headless renders frame small coverages on their true extent. With no viewport or
--bbox,HeadlessCompositor(and sos100 render) now fits the view to each coverage layer's own extent plus its usual 10 % margin. Before,SeamAwareBoundsAccumulator.AddLonLatBoxwidened a coverage's longitudes out to its 0.5° occupancy bins, so a 0.2° grid composited with a chart cell drew as a small patch. The bins still drive antimeridian detection, and a box whose eastern edge runs past +180° (a 0°–360° grid) is now split across the seam instead of clamped.NDBC buoy observations. A new
EncDotNet.S100.DynamicSources.Ndbclibrary shows NOAA National Data Buoy Center observations as a dynamic feature source.NdbcObservationSourcereads theactivestations.xmlstation table and the head of eachrealtime2standard meteorological file for the stations in view plus a margin, every 10 minutes, with backoff on errors, and nothing while the view is wider than 25° or the layer is hidden. Observations older than 3 hours are drawn grey and dropped after 12. Each station is a station-model glyph (the weather wind barb into the wind and the wave height) built with the portrayal toolkit, on S-98OtherChartOverlaysat priority 100; a pick lists every value with its unit and the observation time. In the viewer, NDBC buoy observations is a Layer Stack row, off by default. Supporting additions:DynamicSourceMetadata.PlaneandWithinPlanePriority(the Layer Stack now groups a dynamic source by its plane),IDynamicFeatureDescriber,DynamicFeatureGeometryProvider,IDynamicFeaturePortrayal,PortrayedDynamicFeatureRendererandMapsuiDisplayListRenderer.RenderFeatures. Not for navigation. See the DynamicSources.Ndbc README.CAP marine weather warnings. A new
EncDotNet.S100.Datasets.Cappackage reads CAP 1.2 alerts: one CAP XML alert, an Atom feed of them, or the NWS GeoJSON fromapi.weather.gov/alerts. Polygons are drawn as given, circles as 64-vertex polygons, and an area with only NWS zone codes (such asANZ535) as the zones from a bundled, simplified copy of the NWS coastal and offshore marine zone layer; codes it doesn't have are listed in the pick report ands100 info, not dropped.CapDatasetProcessordraws each warning only while it's in force at the view time, by the rule S-124 warnings use, hatched and outlined by severity and labelled with its event, on the cautions and warnings plane above S-124, in the viewer,s100 renderands100 info(which lists every alert), and the MCP tools. The default registry recognises CAP files asCAP/1.2.0by their first bytes, whatever their extension. CAP alerts aren't listed in the Navigational warnings panel. Not for navigation. Breaking changes:S100Products.CreateDefaultRegistry()(and soProductRegistry.Default) andWeatherProducts.Allnow also holdCAP; the S-124 in-force rule moved fromNavigationalWarningInfo.StatusAtto the newWarningValidity(same behaviour);InstructionBuildergainsAreaPattern. See the Datasets.Cap README.GRIB2 wind and wave files.
GribDatasetProcessordraws GRIB2 grids from NOAA's GFS and GFS-Wave and ECMWF open data: the wave height fill and wind barbs, time steps, picks,sample_coverageand headless rendering, in the viewer,s100 renderand the MCP tools.GribWeatherDataset(inEncDotNet.S100.Datasets.Grib) reads one file of many messages or several appended, such as a NOMADS GRIB filter download, orders steps by valid time, decodes a field only when its step is needed, and lists fields it can't use (CCSDS, another grid, an older run) and parameters it doesn't draw, with why;s100 infoprints them. The model name comes from NCEP's generating process or the file name. The default registry recognises GRIB2 files asGRIB2/2.0.0by their first bytes, whatever their extension. The parameter table gainswave.wind_sea.dir(NCEP's WVDIR) and ECMWF'smslcode forpressure.msl. Not for navigation. Breaking changes:S100Products.CreateDefaultRegistry()(and soProductRegistry.Default) now also holdsGRIB2, andWeatherParameters.Allhas a twelfth row. See the Datasets.Pipelines README.JPEG 2000 in the GRIB2 decoder.
EncDotNet.S100.Datasets.Gribnow decodes data template 5.40, so GFS-Wave as NOAA serves it on AWS reads directly. It has its own managed JPEG 2000 Part 1 codestream decoder, written from ITU-T T.800 and limited to one greyscale component: all progression orders, tiles and tile-parts, precincts, quality layers, every code-block style, and the 5/3 and 9/7 transforms. Regions of interest, progression order changes, packed packet headers, several components, Part 2 and HTJ2K fail with a message naming them.GribDataRepresentationgainsCompressionTypeandTargetCompressionRatio. A field packed in 0 bits now decodes to its reference value unscaled, as ecCodes reads it, in every template.NetCDF wind and wave files. A new
EncDotNet.S100.Datasets.NetCdfpackage reads NetCDF-CF grids with no native code: NetCDF-3 (classic and 64-bit offset, ERDDAP's.ncoutput) with a managed reader, and NetCDF-4 on PureHDF (deflate and shuffle). It finds the coordinates, decodes CF time units, applies packing and missing values, and matches variables to the weather parameter table bystandard_name; files it can't use fail with a message listing their variables or naming the grid type.NetCdfDatasetProcessor(on a newWeatherGridProcessorBasethat the GRIB2 processor will share) draws the wave height fill and wind barbs, steps through time, picks and samples with units, and renders headlessly, and the default registry recognises the files asNetCDF/4.0.0orNetCDF/3.0.0, so they open in the viewer,s100 renderand the MCPsample_coveragetools. Not for navigation. Breaking changes:S100Products.CreateDefaultRegistry()(and soProductRegistry.Default) now also holdsNetCDF, whichAddAllS100Products()leaves out (useAddWeatherProducts()), andUnsupportedWeatherGridExceptionnow derives fromNotSupportedException. See its README.GRIB2 decoder. A new
EncDotNet.S100.Datasets.Gribpackage decodes GRIB2 in managed code, with no native dependencies: several messages per file and repeated sections, the regular latitude/longitude grid (template 3.0) in any scanning mode, analysis, forecast and time-interval products (4.0 and 4.8), and simple, complex, spatially differenced and PNG packing (5.0, 5.2, 5.3 and 5.41) with bitmaps.GribFileindexes the fields when it opens and decodes values only when asked, and eachGribFieldmaps onto the weather grid model (native grid, level, canonical parameter and a lazyWeatherStepDecoder). GRIB1, JPEG 2000 (5.40), CCSDS (5.42) and other templates fail with a message naming them. See its README.Coverage sampling is a processor capability.
ICoverageSampler(inEncDotNet.S100.Core) finds where a dataset can answer a point, andCoverageSamplingchooses the dataset and applies the time handling (nearest step, one step of tolerance,time_out_of_rangeor the nearest step, range and series windows) for every product. The S-102, S-104 and S-111 processors and catalog payloads implement it, andSampleCoverageServiceno longer names a product: any coverage whose catalog payload samples (aProductDatasetDatathat implementsICoverageSampler, for example) answerssample_coverageandsample_coverage_along, with its values as$kind"fields"entries that carry their quantity and unit. The S-102, S-104 and S-111 results are unchanged. Breaking changes:SampledValueandSampleTimeStatusmoved toEncDotNet.S100.Core(same namespace), andSampledValuedeclares the abstractGetFields(), so a subtype outside the library must implement it. See the Datasets.Pipelines README.Weather grid model. A new
EncDotNet.S100.Datasets.Weatherpackage holds the in-memory model the GRIB2 and NetCDF readers will share: aWeatherGridSet(model and run time, a regular latitude/longitude grid, and parameters with time steps), the canonical parameter table with its GRIB2 codes and CF standard names, normalisation to the coverage grid order (rows running north, longitudes in −180 to 180, missing values asNaN), andWeatherCoverageSource, which decodes time steps only when they're sampled, offers 2× and 4× overview levels, and derives wind speed and direction from U and V. See its README.Weather styles.
EncDotNet.S100.Datasets.Weathernow draws its grids with code-defined coverage styles built on the portrayal toolkit: a wave height fill and WMO wind barbs (on by default), and a Beaufort wind speed fill and wave direction arrows (off by default), in Day, Dusk and Night palettes. Fills go on the on-demand surface plane under S-104 at half opacity; barbs and arrows go on the dynamic arrows plane above S-111.WeatherPortrayalbuilds the coverage sub-layers from aWeatherCoverageSource, so the Skia and Mapsui renderers draw them with no weather-specific code. The package now depends onEncDotNet.S100.Portrayalstoo.One
RenderContextfor every product.RenderContextis now a sealed record with aTimeStepproperty, and its per-product subclasses (S101RenderContext,S102RenderContext,S104RenderContext,S111RenderContext,S122RenderContext,S124RenderContext,S125RenderContext,S127RenderContext,S129RenderContext,S201RenderContextandS411RenderContext) are gone (a breaking change). Writenew RenderContext { TimeStep = t }where you wrotenew S104RenderContext(t).MapPresentationState.CreateRenderContextno longer picks a type by product, so a new time-aware product sees the selected time without a context of its own.Route checks: the engines are the checks. In
EncDotNet.S100.Navigation,RouteCheckEngine,RouteAreaCheck,RouteWarningCheckandPassageCheckEngineare gone (a breaking change):ChartCheck,AreaCheck,WarningCheckandClearanceCheckhold their code. Run one check withRunon aRouteCheckContext, or all of them withRouteChecker. Each check is anIRouteCheck<TDetail>whoseRouteCheckOutcome<TDetail>.Detailis typed:ChartCheckResult(wasRouteCheckResult),AreaCheckResult(wasRouteAreaResult),WarningCheckResult(wasRouteWarningResult) andClearanceCheckResult(wasClearanceOutcome). The findings are on the outcome only. The incremental clearance API (SampleDepths,Evaluate,SweepDepartures,SweepWaterLevelRangeandPassageDepthProfile) is internal toClearanceCheck; departure sweeps come fromRouteCheckSettings.DepartureWindow. The per-checkDefaultHalfWidthMetersandFormatteroptions are gone; setRouteCheckOptions.DefaultLimitandFormatteronce. Codes and finding ids are unchanged. See Run one check.How a route check works. A new page, How a route check works, explains which dataset feeds each check, the time and keel rules, the verdict and each check's status. Route checks and under-keel clearance now lists every finding code, the clearance ones included. The route check sample checks a passage end to end on synthetic data.
One
check_routefor the whole route check. The MCPcheck_routetool now runsRouteCheckerand returns the whole report: theverdict(must_review,water_level_ends_before_arrival,checkorclear, with the finding that names it), each check's status (checks), every finding, the clearance ones included, and the under-keelclearance.includeSamplesadds per-leg results and samples, andincludeWindow(withwindowFromandwindowTo, or the S-104 range) adds the departure sweep.get_passage_resultis gone (a breaking change): its arguments and result are nowcheck_route's, andtimeis nowdeparture.s100 route checkrunsRouteCheckeritself: its JSONcheckis thecheck_routeresult andpassageis gone, and the exit code follows the verdict, so--fail-on checkalso fails on a tight clearance. See Check a route.Route checks: one plan for every check. In
EncDotNet.S100.Navigation, the chart, area, S-124 and clearance checks all take aPassagePlanofPassageLegs and aRouteCheckSettings.RouteCheckLeg,RouteCheckDepthsandRouteWarningTimingare gone. Legs carryLength,DepthandSpeedvalues, and a leg without a draft has none rather than 0. Each leg's dangers are judged against that leg's own draft + squat + required UKC, rather than the deepest keel on the route. Where a leg has no ETA, areas and warnings are judged at the route's departure, and only without one at the view time (SoundCharts) ortime(MCP).Route checks: one set of sources.
CatalogRouteCheckSourcesbuilds aRouteCheckSourcesbundle (charts, depth, water level, areas and warnings) that every check reads, andRouteCheckSourceCachekeeps one per set of loaded datasets. It replacesRouteCheckDataSourcesandPassageDataSources. One depth source serves both the clearance check and the chart check's S-102 test (SampleBathymetry). The warning check reads anIRouteWarningSource;RouteWarningListwraps a list. The source interfaces takeGeoPositionandBoundingBox, and every source, andICrsTransform, is safe to call from several threads at once. SoundCharts, the MCP tools ands100 route checkeach share one cache.Route checks: structured findings. Every finding code is in one catalogue,
RouteFindingCodes, as aRouteFindingCodewith its category, default group and headline rank; it replacesRouteCheckCodes,RouteAreaCodesandRouteWarningCodes. A finding'sCategory(Chart,Depth,Area,Warning,Clearance,ConfidenceorData) replacesSource, and its typedDetails(DangerDetails,ShoalDetails,AreaDetails,WarningDetails,ClearanceDetails) carry the numbers behind it. ARouteFindingFormatterrenders titles and meta lines in one culture, depth unit and time zone, and replacesRouteCheckText,RouteAreaTextandRouteWarningText.ClearanceFindings.Buildturns a clearance result into findings.check_route,get_findingsands100 route check --format jsonadddetailsto each finding and report itscategoryinstead ofsource. Codes and ids are unchanged. The expired S-111 forecast notice (data.s111_forecast_expired) is gone: currents aren't applied to ETAs (#1033).From a warning to its route finding. While SoundCharts checks a route, the Warning card of a warning that crosses or is near it, in Object Information or opened from the Navigational warnings panel, shows where: "Crosses route · leg 3 → 4", "Near route · leg 1 → 2", or "Crosses route on 2 legs". Selecting the row selects that finding in the Routes panel's Findings list.
get_warning_cardsreports the row as each card'sroute, andlist_navigational_warningsadds the legs to each warning'sroute.S-421 datasets become routes only when you open them as routes. Loading an S-421 dataset in SoundCharts no longer adds it to the Routes panel, however it's loaded, so the panel lists only the routes you chose. Select an S-421 dataset in the Library and choose Open as route (it loads the dataset if it isn't loaded), or use Import route… for a file. An explicit Library load now also keeps a dataset that was loaded as you panned, rather than unloading it when you pan away.
import_routegainsdatasetId, which opens a loaded S-421 dataset as a route.Route check tones for Day, Dusk and Night. In SoundCharts' Check route, the findings' markers, sleeves and legend use the route's state tones: Must review in the Below red, Check in the Tight amber and Info in the low-confidence grey. Red is used only for Below and Must review. On Night, every state is dimmed to about 0.10 relative luminance (from 0.15–0.22) so it doesn't spoil night vision, while keeping 3:1 against its black casing. Day's Tight is darker (
#B07D00, 3.6:1 on its white casing), No data is now dotted rather than dashed, so it can't be mistaken for lower confidence, and Night edits routes in a fixed blue (#3F64A6) instead of a toned-down accent. Dusk keeps its colours.Warnings in place while checking a route. In SoundCharts' Check route, selecting an S-124 finding opens the warning's card right in the findings list, with its status judged when you get there ("In force at 06:08", "Not in force at 06:15" or "Cancelled") and a link to Open in Navigational warnings. Moving the departure or changing speed re-judges the open card. While checking, the Navigational warnings panel offers All | On {route}, and each warning on or near the route shows "On route · 06:08" or "Near route · 06:19".
get_findingsreports the open card and each warning's status text, andlist_navigational_warningsgains ascopeand each warning'srouterelation.Classify navigational warnings on chart, off chart or information. S-98 Ed 2.0.0 §12.12.2 asks that the mariner can classify each warning's relevance to the route. In SoundCharts' Navigational warnings panel, each row now ends with a glyph you select to choose On chart (the default), Off chart or Information; the Warning card has the same choice. Off-chart and information warnings aren't drawn, nor are their affected areas and texts, except while their card is open. They stay in the list, marked, and route checks still report them, tagged with the classification. Classification in the order menu lists on-chart warnings first. The classification is kept across restarts and refreshes, keyed by series and number with the year.
list_navigational_warningsandget_warning_cardsreportclassification, and the newset_navigational_warning_classificationtool sets it.Route findings on the map. In SoundCharts' Check route, the route's line keeps its clearance colours and the route checks draw on top: a stretch of the route (drying ground, an area, a warning crossed) is a translucent sleeve along the route, and a point (a wreck, a nearby warning) is a marker above the route, an octagon for Must review, a triangle for Check and a circle for Info, with a dotted leader to a feature off the track. Info markers show only when selected, markers closer than 24 px merge into a counted cluster (click to zoom in), and the cross-track corridor's edges are dotted, filled only on the selected finding's leg. The selected finding gets a ring and one pill with its ETA. A legend at the map's bottom left folds to a chip;
get_map_legendandset_map_legendread and set it, andselect_findingreports what the map highlights.Check routes from the command line. The new
s100 route checkchecks an RTZ (1.0, 1.1, 1.2) or S-421 route against dataset files, an exchange set or a folder, without SoundCharts: land, drying ground, chart coverage, the safety contour, charted dangers, regulated and S-122 protected areas, S-124 warnings and, when the route has a draft, under-keel clearance. Options replace the file's draft, squat, speed, departure, required UKC and corridor, and set the safety contour and depth.--format jsongives thecheck_routeandget_passage_resultresults, and the command exits with code 7 on Must review findings (--fail-on), for CI. The MCPcheck_routetool now also checks S-124 warnings (s124.on_route,s124.near_route,s124.not_in_force,s124.cancelled, with the warning on each finding). A new guide, Route checks and under-keel clearance, explains every finding, threshold and confidence reason, received routes and the route formats. In the libraries,S421Route.GetPlanningSchedulereturns the schedule a passage reads its speeds and departure from.One switch for navigational warnings on the chart. SoundCharts' Display controls panel has a new Overlays › Navigational warnings switch, on by default and kept after a restart (S-98 Ed 2.0.0 §6.1.1, §12.12.2). Off, the map draws no S-124 warning, affected area, text or warning pick highlight, even for an open Warning card; each dataset's own visibility keeps its state. The Navigational warnings panel, the cards and route checks keep working, and the panel says "Not drawn: Navigational warnings are off in Display controls" with a Turn on button.
list_navigational_warningsreportsshowNavigationalWarnings, andset_navigational_warning_displaysets it; both of its arguments are now optional.NEW warnings follow S-98. In SoundCharts' Navigational warnings panel, a newly received warning now shows NEW until you open its card or 24 hours have passed since it was received (S-98 Ed 2.0.0 §12.12.1). A later refresh no longer clears it, and NEW expires on its own. New NEW options limit the indication to warnings received within some hours, or within some nautical miles of own ship or the active route (both off by default), and Mark new since marks everything received in the last few hours NEW again for a watch handover.
list_navigational_warningsreports each warning'sreceivedAt,newUntil,openedAtandnewReason, and the newmark_navigational_warnings_newtool does the handover. The seen-warnings file moves to format 2: an older file is discarded, so each source sets a new baseline.A shorter findings list. In SoundCharts' Check route, Check and Info findings with the same code now share one row with a count ("Charted depth from S-101 only ×9 · Legs 7 → 9 · 9 stretches") that expands into each finding; Must review findings are always listed one by one. INFO is folded until you open it, and the Legs tab marks each leg's route-check findings with a badge, with or without a draft.
get_findingsreports the filter, per-chip counts, merged rows (with every member id), the INFO fold and the expanded row;set_findings_viewchanges them.Open and export RTZ routes. SoundCharts' Import route… now opens RTZ route plans (IEC 61174 Annex S, versions 1.0, 1.1 and 1.2) as read-only received routes in Planning mode, and Export… writes any route as RTZ, with a version select (1.2, 1.1, 1.0). Speeds, the departure, cross-track limits (nautical miles in RTZ), draughts and UKC map onto the route's passage; a copy keeps further schedules, schedule details, vendor extensions and unknown attributes and writes them back. Open RTZ files reopen after a restart. The MCP tools
import_routeandexport_routetake RTZ (format: "RTZ",version). The newEncDotNet.S100.Routes.Rtzpackage reads and writes RTZ in your own code.The map draws S-124 warnings only while they're in force. SoundCharts used to draw every loaded navigational warning; now the map follows the same status as the Navigational warnings panel and the Warning card (S-98 Edition 2.0.0 §12.12). Ended and cancelled warnings, including those left out of the latest in-force bulletin, are never drawn. A new display setting, Show warnings not yet in force (off by default, kept after a restart), also draws a warning from its publication time until it starts. Each part is judged on its own dates, and a hidden part takes its affected area and text with it. The warning on an open Warning card stays drawn. When the view time is pinned with S-124 data loaded, the map's time stamp starts "Display Not Real Time" and stays shown (§12.7.2). The panel's Not in force group says what isn't drawn. MCP:
list_navigational_warningsaddsdrawn,drawnForCard,showNotYetInForceanddrawTime, andset_navigational_warning_displaysets the setting. In the libraries,NavigationalWarningSet.IsDrawnAtholds the rule, andRenderContext.HiddenFeatures/MapDataset.HiddenFeatureslet a host hide features; S-124 leaves them out before portrayal, and they aren't picked.Check route: one verdict for every check. SoundCharts' footer toggle is now Check route, on for any route with two or more waypoints. The verdict card gives one answer for the clearance check, the route checks and S-124 warnings, worst first: its title names the worst finding ("Crosses drying ground", "Below your UKC setting in 2 places", "Inside navigational warning 001/26"), or without a draft counts them ("2 to review", "1 to check"). Under it, Clearance, Route and Warnings rows sum up each check; the minimum UKC is in the Clearance row, and clicking a row filters the Findings list, which has All, Clearance, Route and Warnings chips. Without a draft the Clearance row reads "Not checked · + Add draft", which opens the Passage card at Draft; there is no Clearance tab and the route keeps its normal colour.
get_check_stateaddsverdictKind,verdictSubtitle, thesummaryrows and thefooter;verdictTitleis now the card's overall title.Warnings left out of the latest in-force bulletin are cancelled. S-124 Edition 2.0.0 §9.2.1 says a warning published before the latest in-force bulletin for its series, and not listed in it, is no longer valid; S-98 §12.12 has ECDIS mark it cancelled. SoundCharts now applies this, and cancellation datasets, everywhere a warning's status shows. The Warning card adds a reason line ("Cancelled — not in in-force bulletin NAVAREA X 110/26" or "Cancelled by …"). The Navigational warnings panel's groups, summary count and rail badge, MCP
list_navigational_warningsandget_warning_cards(newstatusReason,endedByandstatusReasonText) and route-check findings agree. A series group also says what its latest bulletin lists but isn't loaded ("Listed in NAVAREA X 110/26 but not received: 103/26, 107/26", §9.2.2);list_navigational_warningsreturns it inbulletins. In the libraries,NavigationalWarningSet(Core) judges all loaded warnings together and reports each series' latest bulletin (LatestBulletins);NavigationalWarningInfogainsInForceBulletin,NavigationalWarningReferenceanInteroperabilityIdentifier, andIDatasetProcessoraGetNavigationalWarningMessagefor datasets with no parts.RouteWarningCheck.Checktakes the set, andStatusOvernow takes it and returns the withdrawal too (a breaking change).Routes are checked against the chart. With Check route on, SoundCharts' findings list shows where a route's track crosses land or drying ground (Must review), where either reaches inside the leg's cross-track limits, and where the route leaves the loaded charts (Check). It runs with or without a draft, and again as you drag a waypoint. Where cells overlap, only the finest one counts. The MCP tool
check_routereturns the same findings for a route or a polyline. In the libraries,RouteCheckEngine(EncDotNet.S100.Navigation) andRouteCheckDataSources(EncDotNet.S100.Datasets.Pipelines) do the check.Check route on a received route shows only its action points. While Check route is on for a received S-421 route, its dataset now draws only its action points (viewing group 52270) under the Planning-mode route line, not its own waypoints and legs as well.
set_dataset_statereports this as the dataset'sviewingGroups. In the libraries,ViewingGroupFilteronMapDataset.ViewingGroupsandRenderContext.ViewingGroupsnarrows the viewing groups of one dataset; the XSLT (GML) vector products honour it. TheMapDatasetconstructor has a new optionalviewingGroupsparameter.Read long attribute text in full. In SoundCharts' Object Information, S-101 referenced text files (
TXTDSC/NTXTDS) and any other text value with a line break or over 120 characters, such as S-122 and S-127 regulation text, show as cards under TEXT instead of being cut off in the attribute table. They share the Warning card's body: the whole text, Show all past 22 lines, Copy and Examiner. Cards for data whose exchange-set catalogue saysnotForNavigationshow NOT FOR NAVIGATION in the footer;get_warning_cardsreports it asnotForNavigation. The card's text, Show all, Copy, Zoom to and Examiner controls now havePickReport.TextCard.*automation ids (PickReport.WarningCard.ZoomTois nowPickReport.TextCard.ZoomTo).See how fresh the navigational warnings are. In SoundCharts' Navigational warnings panel, each group header names the SECOM service or feed the warnings came from and when it last answered ("AMSA · 07:40"). Refresh asks those sources again through the Library. A source whose latest refresh failed says so at the top of its group, with Retry. A warning that first appeared in the latest refresh shows NEW until you open its card, the summary counts them, and the Warnings button shows a badge.
list_navigational_warningsreportsnew,sourcesandstale, andrefresh_navigational_warningsrefreshes. In the libraries,SecomSourceIndexer.HealthOfreports when a SECOM service last answered, as the feed indexers'HealthOfdoes.Warning numbers in a navigational warning link to those warnings. In a Warning card, a number such as "106/26" that names a warning in the Navigational warnings list opens it, so a weekly "warnings in force" bulletin works as an index; the text stays selectable and monospaced. When a pick hits several S-124 warnings, they show as Warning cards, points before lines before areas, with one open at a time and highlighted on the map; pointing at a card previews its warning. Zoom to on the card frames a warning that has a location. The MCP tools
get_warning_cards,follow_warning_linkandpreview_warning_carddo the same.Check passage without a draft. SoundCharts' Check passage now turns on for any route with two or more waypoints. Without a draft the clearance parts are hidden ("Add a draft to check clearance") and the verdict card is titled from the findings. A small marker shows each finding on the map. The findings list now merges findings from several checks, ready for the route checks in #888;
set_check_modeandget_findingsaccept routes without a draft.Find every navigational warning in one list, even the ones with no location. SoundCharts has a Navigational warnings panel beside Library. It lists each S-124 warning part in the loaded datasets, grouped by series with the newest number first, and counts those in force and those that are text-only. Search by number, type or area, and read status at the view time or now; warnings not in force drop into a dimmed group at the bottom. Selecting a row opens its Warning card and frames it on the map, or, for a part with no location, says so over the map. The MCP tools
list_navigational_warningsandselect_navigational_warningdo the same, andIDatasetProcessor.GetNavigationalWarningslists the parts in the libraries.Read a navigational warning's whole message in Object Information. Picking an S-124 warning part in SoundCharts now shows a Warning card: the series and number, the warning type, whether it is in force at the view time, its validity, area and issue time, and the full message text in a monospaced block. A part with text in several languages has a tab per language, the UI language first. Messages over 22 lines stop at 20 behind Show all, and the attribute rows fold beneath the card. In the libraries,
S124NavwarnPart.Informationkeeps every language,S124ComplexAttribute.Groupskeeps each repeated nested attribute, andFeatureInfo.NavigationalWarningcarries the message for any pick report.Passage checks read quirky S-102 and S-104 grids. Passage depth and water level now read grids whose georeferencing is longitude first, grids declaring a geographic CRS other than WGS 84 (such as ETRS89), and grids in the 0…360° longitude frame, instead of skipping them and falling back to S-101 depths. The S-102, S-104 and S-111 readers now check the axis order of a grid in any geographic CRS.
PassageDataSources.FromDatasetsuses its transform factory for projected S-104 grids too.The pick report and
sample_coverageread quirky grids. They now find the cell in S-102, S-104 and S-111 grids that are longitude first, declare another geographic CRS, or use the 0…360° frame, using the same lookup as passage checks.sample_coveragealso reprojects projected S-104 and S-111 grids. For a swapped grid,CoveragePickHelper.SamplePoint.RowandColrun along latitude and longitude, andNativeis the click in the grid's own axes.Producer quirks and protected sets in the scenario generator. The test scenario generator can now reproduce producer quirks per dataset (swapped axes, missing or different datums, unusual CRS declarations, 0…360° longitudes, inverted display scales, no-data holes, gaps and expired runs, conflicting same-band cells, spiked areas), with tests that pin how the library handles each one today. It also writes Part 15 protected exchange sets deterministically, with a permit outcome for every case the reader reports, and five small synthetic sets are checked in under
tests/datasets/ExchangeSets/Protected-*. Two additions support this:S100Cipher.EncryptDatasettakes a fixed prefix block and IV (for test data only), andPart15Signertakes a signing key separate from its certificate. See Test scenario generator.Confidence alongside the clearance. Check passage no longer hides "meets" and "tight" where confidence is lower. A stretch on S-101 depth, or where the depth and water-level datums can't be confirmed to agree, keeps its clearance colour and is drawn dashed; only no data is grey. The verdict follows the clearance, with a line that explains the confidence, and departures that meet your settings with lower confidence still count, with a caveat. In
EncDotNet.S100.Navigation,UkcState.LowConfidenceis replaced byConfidenceReasonson each sample, leg, minimum, result and departure (a breaking change).get_passage_result,get_check_stateandget_clearance_statereport the state and aconfidencelist separately.One axis-order check for every reader. The GML, S-102, S-104 and S-111 readers share one dataset-level check for swapped latitude and longitude, anchored on physical bounds and the declared extent. It replaces the separate S-122, S-128 and S-411 rules, and it swaps back the UKHO S-104 Solent station file, which used to draw in the Indian Ocean, so Check passage now applies its tide. The result is each dataset's
AxisOrder, a{product}-PROJ-AXISvalidation finding, an Axis order row ins100 info, and the dataset warning badge in SoundCharts. See Check the axis order.Route colours on Dusk and Night. The route's check-mode colours, editing line, labels and markers are tuned for the Dusk and Night chart palettes and checked for contrast against the S-101 depth shades. On Night, the editing accent loses most of its colour.
Passage on the Timeline. While Check passage is on, the Timeline shows the passage (departure to arrival, with a tick at the minimum UKC) and its departure window, which you can drag to set the departure. Follow passage pins the view time to the ETA at the Clearance cursor, so S-104 and S-111 show what the ship meets. The MCP tool
set_follow_passageturns it on, andget_timeline_statereports the lanes.Departure window. The Clearance tab has a departure band under the profile. It shows which departures across the loaded S-104 range meet your settings, and which arrive after the data ends. Drag it to set the departure. The verdict card lists the window, such as "Departures 05:35–06:40 meet your settings", and Depart {HH:MM} jumps to the nearest departure in it. The new MCP tool
set_departuresets the departure, andget_check_state,get_clearance_stateandget_passage_result(includeWindow) report the window.Findings for a route. In Check passage mode, the Routes panel's Findings tab lists what to review along the route, grouped MUST REVIEW, CHECK and INFO: stretches below your UKC setting, S-101-only depths, water-level gaps and expired S-111 runs. Clicking one zooms the map to it and moves the Clearance cursor there. The shared
RouteFindingmodel inEncDotNet.S100.Navigationis ready for the route checks in #888. The MCP toolsget_findingsandselect_findingread and select findings.Clearance profile. While Check passage is on, the bottom dock gains a Clearance tab next to the Timeline. It shows the seabed, the required-UKC band, the water level and the keel along the route, against distance or ETA. A readout traces each number to its S-102 cell or S-101 area, and to its S-104 station and time step. The MCP tools
get_clearance_stateandset_clearance_viewread and set the tab.Check passage. In SoundCharts, the Routes panel's Check passage toggle colours the active route by under-keel clearance at ETA. It shows a verdict card with the minimum UKC and where it occurs, and a min-UKC chip on each leg. Edits recompute live. The MCP tools
set_check_mode,get_check_stateandset_passage_cursordrive it. See the viewer README and the route tools.Under-keel clearance along a route. The new
EncDotNet.S100.Navigationpackage computes leg ETAs and checks UKC along a passage. It adds S-104 water level to S-102 charted depth at each sample's ETA, falls back to S-101 depths as low confidence, and reports datum mismatches instead of mixing datums. The new MCP toolget_passage_resultchecks a SoundCharts route or a polyline and draft, and can sweep departures to find a window. See the package README and Under-keel clearance.Raster tiles. The new
s100 tiles exportcommand renders a dataset, a composite or an exchange set as XYZ Web Mercator tiles for MapLibre, Leaflet and OpenLayers, written as a{z}/{x}/{y}folder, a PMTiles archive or an MBTiles database. Each zoom level draws only what's visible at its scale. Seetiles export.Serving tiles.
s100 tiles serveserves tiles on XYZ URLs with a TileJSON document and a preview page, so a web map on your computer can use them as a tile source. It serves a built folder, PMTiles or MBTiles tile set, or renders datasets as their tiles are asked for, in the day, dusk and night palettes and, for S-104 and S-111, at any time step chosen in the URL. It reopens the datasets when their files change, and with--cache-dir, rendered tiles are kept on disk across restarts, reused only while the data and settings are unchanged. Seetiles serve.Overlapping chart cells. In
s100 tiles export,s100 tiles serve, composites100 renderand the library's headless compositor, a finer chart cell now hides the coarser cell it overlaps, as SoundCharts does, so overlapping cells of different scales no longer draw on top of each other.Signing and permits. S-100 Part 15 support now covers the data server's side.
Part15Signerproduces ECDSA P-384 signatures, andPermitFileWriterwrites aPERMIT.XMLand itsPERMIT.SIGN, using cell keys wrapped byDataPermit.Create. The existing readers verify everything these types write. See Reading protected exchange sets.S-57 validation reports the source data. Validating a NOAA cell no longer reports thousands of
S101-as-S57/*errors caused by the S-57 to S-101 translation. Complex sub-attributes now carry their parent index, ring checks follow edge orientation, and bridge spans get their own feature identifier. Findings now carry a location, so the viewer's validation overlay marks them. See Bringing S-57 into the pipeline.Documentation. Getting started now has a quickstart for each of the desktop app, the .NET library and the command-line tool, and the documentation home replaces the Start here page. A documentation style guide sets the structure and tone for these pages.
September 2026
- Local collection manifests. A hand-written
*.s100collection.jsonfile names groups of local folders, such as one per producing country. Add it to the viewer's Library, pick groups as you would an online catalogue's facets, and browse, load or change each group on its own. See Local collection manifests. - Developer guides for the library: Loading datasets, Reading protected exchange sets, Reading product data and Custom catalogues and validation. Their code samples were run against the repository's test data.
- Facade additions. The
EncDotNet.S100package gainedS100Dataset.OpenAsync(IAssetSource, …),S100ExchangeSet(folders,CATALOG.XMLor ZIPs, with S-101 updates applied), and theWithDecryptionandValidateextensions. - XML documentation. Every public API in the NuGet packages has XML documentation, and the packages include it for IntelliSense.
- Docs site. The API reference covers every package, the package READMEs are published under Packages, and the site is built on every pull request.
- S-401 (IEHG inland ENC). The IEHG feature and portrayal catalogues are
bundled, and content-based detection tells S-401, S-101 and S-57 apart
inside the shared
.000extension. S-401 datasets support render, identify, query and describe. No validation rule pack ships yet, sos100 validatereports that no rules are available for S-401. - S-57 inland ENCs. Cells that declare
DSID/PRSP= 10, such as USACE river charts, are portrayed with the S-401 catalogues and keep their S-57 identity. Large inland cells that couldn't be opened before now load, because of a fix in the ISO 8211 reader inEncDotNet.Iso82110.6.1. The inland object classes and attributes of the IENC Feature Catalogue 2.4 are translated to S-401, so inland bridges, distance marks, notice marks and waterway gauges appear. s100 s57 convertand inland cells. The command writes an inland ENC cell as an S-401 dataset, so its inland features are kept.--target s101|s401overrides the choice, and the summary and the--reportJSON name the product written.
July 2026
- Docs site. Added the Start here page, the task guides (Render S-102 to PNG, Inspect S-124 warnings and Compose S-101 and S-102), the Top APIs page, architecture and workflow diagrams, and a site theme.
- S-57 guide. Added Bringing S-57 into the pipeline,
which covers converting, viewing and validating S-57 cells, folding in
sibling updates, and the
s100 s57 convertdiagnostics summary (--report).