Inspect S-124 warnings
This guide opens an S-124 navigational warnings dataset in SoundCharts and shows how to read each warning's attributes on the map. Use it to check what a warnings file contains before you process it in code.
Prerequisites
- SoundCharts. See Getting started.
- An S-124 dataset (
.gml). The repository includes small test files intests/datasets/S124/.
Steps
- Choose File > Open Dataset... and select the
.gmlfile, or drag it onto the window. The warning areas, lines and points appear on the map. - Turn on pick mode: press I, select the Pick mode button at the top right of the map, or choose View > Appearance > Pick Mode.
- Click a warning on the map. The OBJECT INFORMATION panel shows a Warning card with the warning's number, type and status, and its full message text. The feature's attributes fold beneath it under Attributes, followed by its references and location. If several warnings are at that point, each has its own Warning card, sorted points, lines, then areas, and by number; select a card's header to open it. Select Zoom to to centre the map on the open warning. In a bulletin that lists other warnings, select a warning number to open that warning. If the panel is closed, choose View > Appearance > Pick Report.
- To find a warning by number, or one with no location (such as a weekly bulletin, which draws nothing on the map), open the Navigational warnings panel from the activity bar. It lists every warning part grouped by series, with the ones not in force at the view time in a group at the bottom. Select a row to open its Warning card; the map centres on the warning when it has a location and is in force.
- To check how the warnings read in other lighting conditions, select the Display Settings button at the top right of the map and choose Day, Dusk or Night under Palette.
Result
You can see each warning's geometry on the map and read its message and attributes in the panel.

If nothing appears
Check which product the file was detected as:
s100 info path/to/warnings.gml
The Specification row should show S-124. Other GML products, such as
S-122 or S-127, can have similar geometry but use their own portrayal.
Inspect from the command line
s100 identify lists the features at a position, like a pick in the viewer:
s100 identify path/to/warnings.gml --lat 50.1 --lon -1.3
s100 validate checks the dataset against the S-124 validation rules:
s100 validate path/to/warnings.gml
For the options of each command, see Command-line rendering.
Read warnings in code
To work with warnings as typed objects (preamble, parts, references) instead of a feature list, use the S-124 typed data model. See Typed data models.