EncDotNet.S57 0.10.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package EncDotNet.S57 --version 0.10.0
                    


                    

                
NuGet\Install-Package EncDotNet.S57 -Version 0.10.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="EncDotNet.S57" Version="0.10.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="EncDotNet.S57" Version="0.10.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="EncDotNet.S57" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add EncDotNet.S57 --version 0.10.0
                    


                    

                
#r "nuget: EncDotNet.S57, 0.10.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package EncDotNet.S57@0.10.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=EncDotNet.S57&version=0.10.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=EncDotNet.S57&version=0.10.0
                    


                            Install as a Cake Tool

EncDotNet.S57

EncDotNet.S57 reads and writes IHO S-57 Edition 3.1 Electronic Navigational Chart (ENC) cells. It gives you the dataset metadata, feature and vector records, and attributes as encoded, and a typed chart model of point, line and area features with indexed nodes, edges and faces. It also applies update cells (.001, .002, ...), reads and verifies exchange sets, and writes base cells and CATALOG.031 files. It identifies NATO Additional Military Layers (AML) cells and looks up their object classes and attributes in the AML object catalogues. Reference it to work with S-57 data in .NET 8 or .NET 10. It depends on EncDotNet.Iso8211, which it installs for you.

Install

dotnet add package EncDotNet.S57

Example: read a cell and list its depth areas

using EncDotNet.S57;

S57Document document = S57DocumentReader.ReadFromFile("path/to/cell.000");

Console.WriteLine($"{document.DataSetIdentification?.DataSetName} at 1:{document.DataSetParameters?.CompilationScale}");

foreach (S57FeatureRecord feature in document.GetFeaturesByObjectCode(S57ObjectCode.DEPARE))
{
    Console.WriteLine($"{feature.RecordName}: {feature.Attributes.Count} attributes, {feature.SpatialPointers.Count} spatial pointers");
}

Main entry points

Records as encoded

Type Use it to
S57DocumentReader Read a cell from a file, stream or bytes into an S57Document
S57DocumentWriter Write an S57Document as a base cell (.000) to a file, stream or bytes
S57Document Get metadata (DSID, DSPM), feature records and vector records; apply an update cell with ApplyChanges
S57FeatureRecord Get a feature's object class, primitive, attributes and pointers
S57VectorRecord Get a node's or edge's coordinates, soundings and topology pointers
S57ObjectCode Identify object classes (DEPARE, SOUNDG, LIGHTS, ...) by their S-57 code

Typed chart model (EncDotNet.S57.Charts)

Type Use it to
S57Chart Get features grouped by primitive and object class, and nodes, edges and faces indexed by record name
S57PointFeature, S57LineFeature, S57AreaFeature, S57MetaFeature Work with a feature and its geometry references
S57IsolatedNode, S57ConnectedNode, S57Edge, S57Face Work with spatial records

Exchange sets (EncDotNet.S57.ExchangeSets)

Type Use it to
S57ExchangeSetReader Find the catalog, base cell and update cells of a single-cell exchange set
S57ExchangeSet Read the cell with its updates applied; verify the exchange set
S57CatalogReader Read CATALOG.031 entries and their coverage
S57CatalogWriter Write CATALOG.031, and compute the CRCs its entries list
S57ExchangeSetVerifier Check each file's CRC-32 against the catalog

NATO Additional Military Layers (EncDotNet.S57.Aml)

Type Use it to
AmlDataSet Get an AML cell's product, metadata and catalogue, and look up its features' object classes and attributes
AmlDataSetMetadata Parse the title, protective marking and other metadata in an AML cell's DSID comment
S57ObjectCatalogue Look up IHO, Inland ENC and AML object classes and attributes by code or acronym

Reading S-57 charts covers each of these with examples, Reading AML data sets covers AML cells, and Writing S-57 charts covers the writers.

Exchange set verification outcomes

S57ExchangeSet.VerifyAsync reports a checksum outcome and a signature outcome for each file, as S57VerificationOutcome values. It doesn't throw for files that fail. S-63 signature verification isn't implemented yet; IS63SignatureVerifier and S63TrustAnchorOptions are the extension point, and files report NotSigned until it is.

S57VerificationOutcome Meaning
Ok The check passed
NoChecksum The catalog entry has no CRC to check against
ChecksumMismatch The file's CRC doesn't match the catalog
FileMissing The file isn't on disk
NotSigned The file has no digital signature
SignatureInvalid, CertificateUntrusted, CertificateExpired, CertificateNotFound S-63 signature outcomes
Error An unexpected error occurred during verification

License

MIT. See LICENSE.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on EncDotNet.S57:

Package Downloads
EncDotNet.S100.Datasets.S57

Libraries for manipulating S-100 based nautical charts.
EncDotNet.S100.Datasets.Aml

SoundCharts' own code-built portrayal of NATO Additional Military Layers (AML) cells, read with EncDotNet.S57: the overlay signature (dash-dot lines on a halo, unfilled areas with inward ticks, framed point symbols), four colour families in Day, Dusk and Night, italic labels, airspace limits, the RAL air and operational classes, CLB contours and soundings, MFF, the AML 3.0 chart and land background, and the SBO and LBO seabed classes with screen-space clustering. Not the official AML portrayal, which is restricted to S-52 Presentation Library holders. AML is never a source of depths or route checks. Not for navigation. Depends on EncDotNet.S100.Core, EncDotNet.S100.Portrayals and EncDotNet.S57.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.11.0 4,681 11/3/2026
0.10.0 96 11/3/2026
0.9.0 777 11/2/2026
0.8.1 1,724 10/30/2026
0.8.0 4,661 10/12/2026
0.7.2 906 10/11/2026
0.7.1 113 10/11/2026
0.7.0 5,170 9/16/2026
0.6.1 113 9/16/2026
0.6.0 169 7/12/2026
0.5.1 6,437 6/18/2026
0.5.0 1,533 6/11/2026
0.4.3 137 5/19/2026
0.4.2 137 5/19/2026
0.4.1 134 5/7/2026
0.4.0 3,859 4/29/2026
0.3.6 140 4/11/2026
0.3.5 139 4/9/2026
0.3.4 134 4/9/2026
0.3.3 131 4/9/2026
Loading failed