EncDotNet.S100.Datasets.S101 0.12.0

EncDotNet.S100.Datasets.S101

Reader and Lua portrayal pipeline for S-101 Electronic Navigational Chart (ENC) datasets.

Overview

This library reads S-101 datasets encoded in ISO 8211 format and executes the S-100 Part 9A Lua portrayal pipeline to produce drawing instructions. Key types include:

• S101Dataset — parsed ENC dataset containing features from ISO 8211 records.
• S101Document, S101DocumentReader — low-level ISO 8211 record parsing.
• S101LuaRuleExecutor — ILuaRuleExecutor implementation that orchestrates the Lua portrayal pipeline (loads main.lua, calls PortrayalMain(), parses and post-processes the emitted instructions).
• S101PortrayalCatalogue — IVectorPortrayalCatalogue implementation that loads XSLT/Lua rules, symbols, line styles, area fills, and color palettes.
• S101VectorSource — IVectorSource implementation for the vector pipeline.
• DrawingInstructionParser — parses the semicolon-separated key:value strings emitted by the Lua portrayal pipeline into the unified DrawingInstruction hierarchy from EncDotNet.S100.Core. Honours text alignment (TextAlignHorizontal / TextAlignVertical), mm offsets (LocalOffset), foreground / background colour with optional transparency, line placement, and the AugmentedPoint:GeographicCRS,… anchor override used by SOUNDG / DepthNoBottomFound rules. Augmented line geometry (AugmentedRay, ArcByRadius, AugmentedPath) is fully supported — sector-light limit lines and arcs, directional-light rays, and all-around-light circles are tessellated into polylines and carried through LineInstruction.CoordinatesOverride to the renderer.

Bundled-adapter Lua patches

content/S101/pc/ stays byte-identical to the upstream IHO S-101 portrayal catalogue. When upstream Lua has a defect that breaks real-world cells, S101LuaRuleExecutor ships a small adapter patch that monkey-patches the offending global rather than editing the bundled catalogue. Current patches:

• contains — restores a missing global the upstream catalogue relies on without defining.
• GetFeatureName / PortrayFeatureName — upstream gates name selection on both name AND nameUsage, but the S-101 FC declares nameUsage with multiplicity 0..1. Cells that omit it are FC-conformant but rendered nameless. The patch treats a missing nameUsage as the default 1 while preserving the original language-matching semantics, so area / point feature names (BuiltUpArea, SeaAreaNamedWaterArea, churches, …) emit correctly.

If upstream fixes a defect, the corresponding patch is dropped.

Validation

A bundled rule pack (EncDotNet.S100.Datasets.S101.Validation.S101DatasetRules.Default) evaluates a typed view over an S101Document against the S-101 Edition 2.0.0 checklist and emits a ValidationReport of findings. The view types under Validation/ (S101DatasetView, S101FeatureView, S101AttributeView) are the spec-aligned façade the pack reads from — they keep rule code decoupled from the raw S101FeatureRecord shape so a future typed DataModel projection can replace them without rewriting the rules.

The pack is invoked automatically by S101DatasetProcessor.Validate() and can also be run directly:

var view = S101DatasetView.From(document, decoder);
var report = S101DatasetRules.Default.Run(view);

The same S101DatasetRules.Default entry point is reused by S-57 post-translation delegation (see EncDotNet.S100.Datasets.S57), with findings rebadged as S101-as-S57/<rule-id> so the user can tell which layer of the pipeline a problem came from.

Record types

S101DocumentReader parses the following ISO 8211 record types:

Installation

dotnet add package EncDotNet.S100.Datasets.S101