Table of Contents

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

Steps

  1. Choose File > Open Dataset... and select the .gml file, or drag it onto the window. The warning areas, lines and points appear on the map.
  2. Turn on pick mode: press I, select the Pick mode button at the top right of the map, or choose View > Appearance > Pick Mode.
  3. 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.
  4. 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.
  5. 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.

S-124 navigational warnings on the SoundCharts map

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.