EncDotNet.S100.Datasets.S102 0.16.0

EncDotNet.S100.Datasets.S102

Reader and coverage portrayal pipeline for S-102 Bathymetric Surface datasets.

Overview

This library reads S-102 datasets from HDF5 files and provides coverage data (depth and uncertainty grids) for the portrayal pipeline. Key types include:

• S102Dataset — root model containing horizontal CRS and bathymetric coverages.
• S102DatasetReader — reads an S-102 dataset from an IHdf5File.
• S102CoverageSource — ICoverageSource adapter for the coverage pipeline.
• S102PortrayalCatalogue — coverage portrayal catalogue for depth shading.
• BathymetryCoverage, BathymetryValue — bathymetric data models. BathymetryCoverage.GroupPath carries the HDF5 instance path (e.g. /BathymetryCoverage/BathymetryCoverage.01) and is used by the validation rule pack as the per-coverage RelatedFeatureId.

Portrayal

Portrayal is PC-driven: S102PortrayalCatalogue executes the bundled BathymetryCoverage.lua rule (S-102 Edition 3.0.0, Annex B) through an ILuaEngine and resolves the emitted CoverageColor tokens (DEPDW, DEPMD, DEPMS, DEPVS, DEPIT, NODTA) against the bundled ColorProfiles/colorProfile.xml. The Day, Dusk, and Night palettes are all loaded; SwitchPalette selects the active mood.

The four S-102 context parameters flow in via MarinerSettings:

• FourShades — toggle between two-band (DEPVS / DEPDW split at SafetyContour) and four-band (DEPVS / DEPMS / DEPMD / DEPDW split at ShallowContour / SafetyContour / DeepContour) shading.
• SafetyContour, ShallowContour, DeepContour — depth boundaries in metres.

Invariants (ShallowContour ≤ SafetyContour ≤ DeepContour) are clamped (with a diagnostic) rather than throwing — the viewer settings panel surface area means transient out-of-order slider values must not crash the render pipeline.

Cells whose depth equals S102CoverageSource.FillValue (1,000,000f) are painted with the active palette's NODTA colour via CoverageColorScheme.NoDataColor.

Validation

A bundled rule pack (EncDotNet.S100.Datasets.S102.Validation.S102DatasetRules.Default) evaluates a typed S102Dataset against the S-102 Edition 3.0.0 checklist and emits a ValidationReport of findings. The pack is invoked automatically by S102DatasetProcessor.Validate() and is also runnable directly:

var report = S102DatasetRules.Default.Run(dataset);
foreach (var finding in report.Findings)
    Console.WriteLine($"{finding.RuleId} {finding.Severity}: {finding.Message}");

Installation

dotnet add package EncDotNet.S100.Datasets.S102