GDAL S-101 驱动完全指南:读取 IHO S-101 电子航海图(ENC)数据的架构、图层与实战

原创2026-10-11 18:19:382,156 阅读
文章标签:GIS数据处理

GDAL S-101 驱动完全指南:读取 IHO S-101 电子航海图(ENC)数据的架构、图层与实战

本篇指南围绕 GDAL 中新增的 S101 矢量驱动(自 GDAL 3.14 起内置)展开,系统讲解如何以只读方式读取国际海道测量组织(IHO)S-101 Electronic Navigational Chart(ENC) 数据集。你将掌握 S-101 文件与更新文件的组织方式、STRICT 与 UPDATES 两个打开选项的用法、informationType 与各类几何/要素图层的字段结构,以及 Feature Catalog 的加载机制,并学会用 ogrinfo、ogr2ogr 和 Python/ogr 快速验证与转换数据。

S-101 与 S100 驱动背景

S-101 是 IHO 面向电子航海图(Electronic Navigational Charts, ENC)制定的新一代产品规范,其数据编码遵循 S-100 Edition 5.2 Part 10a(ISO/IEC 8211 编码),并在此基础之上增加了额外的约束。GDAL 的 S101 驱动负责将这种编码底层的海图数据解析为 OGR 要素模型,让上层应用能够像读取普通矢量数据一样读取 S-101 海图。

在 GDAL 中,S-101 数据由以下部分组成:

  • S-101 基础数据文件:文件名通常以 101 开头,扩展名为 .000;
  • S-101 更新文件:扩展名为 .001、.002 等,包含对已分发基础数据文件的增量更新(新增、删除、修改记录)。

官方文档见 IHO S-101 产品规范官方页面。

从源码结构看,驱动被声明为 GDAL 内置(built_in_by_default),同时支持插件化构建(PLUGIN_CAPABLE)。其实现位于 ogr/ogrsf_frmts/s101/,包含 ogrs101reader*(数据读取与解析)、ogrs101layer*(图层实现)与 ogrs101featurecatalog*(要素编目解析)三组核心源文件,构建脚本见 CMakeLists.txt。

驱动能力与识别机制

S101 驱动的能力(capabilities)如下:

  • 仅支持只读访问:OGRS101Dataset::Open() 在检测到 GA_Update 访问模式时直接拒绝打开(见 ogrs101dataset.cpp),test_ogrsf 测试也以 -ro 只读方式运行(见 ogr_s101.py)。
  • 支持地理配准(georeferencing):所有地理要素统一参照 WGS 84(EPSG:4326);点/多点几何还可能带有垂向基准(深度,单位为米),形成复合 CRS。
  • 支持 VSI 虚拟文件系统(Virtual I/O):驱动元数据中声明了 GDAL_DCAP_VIRTUALIO = YES。
  • 支持多矢量图层(GDAL_DCAP_MULTIPLE_VECTOR_LAYERS)与 Z 几何(GDAL_DCAP_Z_GEOMETRIES)。
  • 支持 OGRSQL 与 SQLITE 两种 SQL 方言(GDAL_DMD_SUPPORTED_SQL_DIALECTS)。

驱动通过解析 ISO/IEC 8211 的 DDR Leader(目录头) 来识别 S-101 文件:检查交换级别、Leader 标识、字段控制长度、扩展字符集指示符等字节,并进一步在头中查找 DSID 字段及其子字段结构 RCNM!RCID!ENSP!ENED!PRSP!PRED!PROF!DSNM!DSTL!DSRD!DSLG!DSAB!DSED\*DSTC,相关实现见 ogrs101drivercore.cpp。ReadDatasetGeneralInformationRecord 还会校验产品标识必须包含 S-101(见 ogrs101readerdatasetgeneralinformationrecord.cpp)。

打开选项(Open Options)

S101 驱动支持两个打开选项,可通过 GDAL Open Options 传入:

STRICT

  • 类型:布尔(YES / NO)
  • 默认值:YES
  • 作用:是否启用严格解析模式。YES 时,一旦解析遇到与规范不一致的错误即立即报错中止;NO 时则以警告(CPLError 的 Warning 级别)替代报错,并尽可能继续解析文件(见 ogrs101reader.cpp 的 EmitErrorOrWarning 实现)。

典型用法(Python):

from osgeo import gdal

# 严格模式(默认):遇到不规范数据立即失败
ds = gdal.Open("data/101A1234.000")

# 宽松模式:输出警告并尽量继续解析
ds = gdal.Open("data/101A1234.000", open_options=["STRICT=NO"])

命令行(ogrinfo):

ogrinfo -ro -oo STRICT=NO /path/to/101A1234.000

从源码看,驱动内部通过 m_bStrict 成员控制错误/警告的分流,并对 DSID/DSSI/CSID 等关键记录做了大量规范性校验。测试用例 ogr_s101.py 构造了大量“改动字段定义”与“改动记录内容”的用例来验证严格模式的行为:例如将产品标识改为 INT.IHO.S-101.3.0 会报 Product identifier is 'INT.IHO.S-101.3.0', but only 'INT.IHO.S-101.2.0' is nominally handled;将 DCOX 置为 NaN 会报 NaN value in DCOX subfield of DSSI 等。这些用例通过 8211createfromxml 工具将 XML 描述重新编码为 .000 二进制文件进行验证,说明严格模式的校验粒度覆盖字段定义、记录参数与 CRS 结构等层面。

UPDATES

  • 类型:枚举(APPLY / IGNORE)
  • 默认值:APPLY
  • 作用:是否将更新文件实时合并进基础数据。

读取器在加载完基础 .000 文件后,会按扩展名 .001 到 .999 的顺序逐一尝试打开更新文件并应用(见 ogrs101reader.cpp)。当 UPDATES=IGNORE 时跳过该过程,只返回基础文件内容。

# 不应用更新文件,仅读取 .000 基础数据
ds = gdal.Open("data/101A1234.000", open_options=["UPDATES=IGNORE"])

测试 ogr_s101_update.py 展示了二者的差异:取消(cancelled)数据集在默认 APPLY 下打开后图层数为 0、STATUS=CANCELLED;而用 UPDATES=IGNORE 打开同一文件时图层数为 1,STATUS=VALID,APPLICATION_PROFILE=1。

驱动元数据中的完整选项定义(默认值、可选项说明)见 ogrs101drivercore.cpp。

数据模型:记录(Records)与图层(Layers)

S-101 数据集在逻辑上由若干类“记录”组成。驱动内部为每一类记录维护一个 DDFRecordIndex(记录索引),并通过 IngestInitialRecords()/IngestUpdateRecords() 在内存中构建完整视图(见 ogr_s101.h)。记录类型常量定义在 ogrs101readerconstants.h:

记录类型 记录名(RCNM 数值) 标识字段
Dataset Identification 10 DSID
Coordinate Reference System 15 CSID
Information Type 150 IRID
Point 110 PRID
MultiPoint 115 MRID
Curve 120 CRID
Composite Curve 125 CCID
Surface 130 SRID
Feature Type 100 FRID

数据集打开后,OGRS101Dataset 根据读取器生成的要素定义逐一实例化图层(见 ogrs101dataset.cpp)。在测试文件 feature.000 上可以看到典型图层集合(见 ogr_s101_featuretype.py):

informationType
Point2D
MultiPoint2D
Curve
CompositeCurve
Surface
FeatureType1_NoGeom
FeatureType1_Point2D
FeatureType2_MultiPoint2D
...
FeatureType7_MultiPolygon

记录编号与版本

每类记录的标识字段(PRID、IRID、FRID 等)都包含若干通用子字段,驱动将其映射为统一命名的 OGR 字段:

  • recordId(Integer):标识字段中 RCID 子字段的内容;
  • recordVersion(Integer):标识字段中 RVER 子字段的内容。

例如 Curve 图层的 recordId/recordVersion 来自 CRID 字段(见 ogr_s101_curve.py)。

几何类型与 CRS

  • Point2D:WGS 84 下的二维点(wkbPoint,EPSG:4326);
  • Point3D_{vertical_crs_name}:复合 CRS 下的三维点(wkbPoint25D),水平部分为 WGS 84,垂直部分为深度(米);图层名中的 {vertical_crs_name} 来自垂向基准名(源码通过 LaunderCRSName() 清洗 CRS 名称以适配图层命名,见 ogrs101readercrs.cpp);
  • MultiPoint2D / MultiPoint3D_{vertical_crs_name}:对应多点几何;
  • Curve:二维折线(wkbLineString);
  • CompositeCurve:由若干 Curve 拼接而成的二维折线;
  • Surface:二维多边形(wkbPolygon),可含内环。

三维点记录通过 C3IT(三维整数坐标元组)字段的 VCID 子字段引用对应的垂向 CRS(见 ogrs101readerpoint.cpp),C3IL(三维坐标列表)同理用于 MultiPoint。坐标读取时按 DSSI 字段中的坐标原点偏移(DCOX/DCOY/DCOZ)与比例因子(CMFX/CMFY/CMFZ,默认分别为 10000000、10000000、10)换算为以度为单位的经纬度与以米为单位的深度(见 ogr_s101.h)。

informationType 图层

informationType 图层对应数据集中的 Information Type 记录(RCNM=150),没有几何字段,每条记录生成一个 OGR 要素。可用字段包括:

  • recordId(Integer):IRID.RCID;
  • recordVersion(Integer):IRID.RVER;
  • informationType(String):记录类型,例如 ContactDetails、SpatialQuality 等;
  • ATTR 字段的属性以扁平化点号命名展开,例如 spatialAccuracy.horizontalPositionUncertainty.uncertaintyFixed;复合属性重复出现时带下标,如 lightSector.sectorInformation[1].language、lightSector.colour(多值时为 IntegerList)。

测试文件 information_type.000 的典型输出(见 ogr_s101_informationtype.py):

{
  "type": "Feature",
  "geometry": null,
  "properties": {
    "recordId": 1,
    "recordVersion": 1,
    "informationType": "SpatialQuality",
    "spatialAccuracy.horizontalPositionUncertainty.uncertaintyFixed": 4.5,
    "spatialAccuracy.verticalUncertainty.uncertaintyFixed": 5.5,
    "lightSector.sectorInformation[1].language": "EN",
    "lightSector.sectorInformation[2].language": "FR",
    "lightSector.sectorInformation[1].text": "my text",
    "lightSector.sectorInformation[2].text": "mon texte",
    "lightSector.colour": [1, 2]
  },
  "id": 1
}

信息关联(Information Association)

当记录存在一个信息关联(INAS 字段)时,额外暴露以下可选字段:

  • infoAssociationRecordId(Integer):指向另一条 informationType 要素 recordId 的外键;
  • infoAssociationCode(String):信息关联类型,如 AdditionalInformation、SpatialAssociation;
  • infoAssociationRoleCode(String):关联角色,如 providesInformation、supports、defines;
  • 关联自身的属性以扁平化方式暴露,并以 association_ 前缀开头,如 association_text。

当存在多个信息关联时,上述字段带下标索引:infoAssociationRecordId<a href="https://link.gitcode.com/i/60bcc3c52b6d4baab300e05dfdcc58ee" target="_blank">{idx}]、infoAssociationCode[{idx}]、infoAssociationRoleCode[{idx}],关联属性则前缀为 association[{idx}]_。更新测试 [ogr_s101_update.py 展示了经更新文件合并后的多关联字段形态(如 association[1]_text: "assoc with 1 modified")。

几何基元图层

以下图层对应“裸”的几何基元记录(不含要素语义),字段集合统一为 recordId、recordVersion,并可选携带与 informationType 图层相同的信息关联字段:

  • Point2D:PRID.RCID / PRID.RVER,二维点(WGS 84);
  • Point3D_{vertical_crs_name}:同 Point2D,但为复合 CRS 下的三维点(深度,米);
  • MultiPoint2D:MRID.RCID / MRID.RVER,二维多点;
  • MultiPoint3D_{vertical_crs_name}:同 MultiPoint2D,三维多点;
  • Curve:CRID.RCID / CRID.RVER,二维折线;
  • CompositeCurve:CCID.RCID / CCID.RVER,二维折线(由 Curve 组件按 ORNT 子字段规定的正向/反向拼接,见 ogrs101readerconstants.h);
  • Surface:SRID.RCID / SRID.RVER,二维多边形(可含内环)。

测试 ogr_s101_curve.py 与 ogr_s101_surface.py 分别展示了 Curve 与带内环 Surface 的 JSON 输出形态。

Feature Type 图层

S-101 的 Feature Type 记录(RCNM=100)承载真正的“要素”语义,如锚地(AnchorageArea)、航标系统(RangeSystem)等。驱动为每个要素类型 × 几何类型组合生成一个图层:要素类型由 FRID 字段的 NTFC 子字段确定(对照 Feature Catalog 中的编码表),图层命名为 {featureTypeShortName}_{geometryType},例如:

  • AnchorageArea_Point2D、AnchorageArea_Polygon;
  • RangeSystem_NoGeom(无几何要素)。

当同一要素关联了多个同性质几何时,驱动自动使用多几何类型:MultiPoint、MultiLineString、MultiPolygon;当单个几何本身是 MultiPoint 时使用 GeometryCollection(测试文件 feature.000 中即有 FeatureType4_CollectionOfMultiPoint 图层,见 ogr_s101_featuretype.py)。

通用字段

  • recordId(Integer):FRID.RCID;
  • recordVersion(Integer):FRID.RVER;
  • featureIdentificationNumber(Integer):FOID.FIDN;
  • featureIdentificationSubdivision(Integer):FOID.FIDS;
  • producingAgency(Integer):FOID.AGEN,对应文本名称见 IHO S-62 Producer Code Register。

FOID 字段的结构定义见 ogrs101readerconstants.h。

空间要素的附加字段

  • geometryLayerName(String / StringList):关联几何所在图层的名称;
  • geometryRecordId(Integer / IntegerList):指向 geometryLayerName 图层中 recordId 的外键;
  • geometryOrientation(String / StringList):仅当几何为 Curve 或 CompositeCurve 时出现,取值为 forward(按定义方向)或 reverse(按定义的反方向);
  • scaleMinimum(Integer / IntegerList):要素被设计显示的最小(倒数)比例尺;
  • scaleMaximum(Integer / IntegerList):要素被设计显示的最大(倒数)比例尺。

SPAS(Spatial Association)字段承载上述空间关联,其子字段 SMIN/SMAX/SAUI 的定义见 ogrs101readerconstants.h。

实测样例(ogr_s101_featuretype.py):

{
  "geometry": {"type": "MultiPoint", "coordinates": [[2.0, 49.0], [2.01, 49.1]]},
  "properties": {
    "recordId": 3,
    "recordVersion": 1,
    "producingAgency": 12345,
    "featureIdentificationNumber": 33,
    "featureIdentificationSubdivision": 1,
    "geometryLayerName": ["Point2D", "Point2D"],
    "geometryRecordId": [10, 20],
    "scaleMinimum": null,
    "scaleMaximum": null
  }
}

要素关联(Feature Association)

要素关联(FASC 字段)的暴露方式与信息关联类似,但字段前缀为 featureAssociation 而非 infoAssociation:

  • featureAssociationRefLayerName、featureAssociationRefRecordId:指向被关联要素图层与记录的外键;
  • featureAssociationCode:要素关联类型(如 StructureEquipment);
  • featureAssociationRoleCode:关联角色(如 defines);
  • 关联属性以 featureAssociation 前缀暴露。

对应常量见 ogrs101readerconstants.h。

掩膜(Mask)字段

在某些情况下,曲线在面要素中的符号化需要被抑制(例如只绘出某段海岸线),即“掩膜”。当数据中定义了掩膜时,面要素图层会额外暴露:

  • maskLayerName(String / StringList):掩膜几何所在图层名(Curve 或 CompositeCurve);
  • maskRecordId(Integer / IntegerList):指向 maskLayerName 图层中 recordId 的外键;
  • maskIndicator(String / StringList):掩膜应用方式,取值为 truncatedByDataCoverageLimit 或 suppressPortrayal。

掩膜几何还会作为一个额外的 OGR 几何字段 maskGeometry 附加在要素上。注意:格式转换时该附加几何字段可能因目标格式限制而丢失,此时可通过 maskLayerName + maskRecordId 属性恢复掩膜几何。

掩膜的底层字段为 MASK(Masked Spatial Type),其 MIND 子字段的数值 1/2 分别映射为 truncatedByDataCoverageLimit/suppressPortrayal(见 ogrs101readerfeaturetype.cpp),多掩膜时字段类型自动升级为 StringList / IntegerList(见同文件第 401-442 行附近)。

数据集元数据(Dataset Metadata)

数据集打开后,以下元数据项从 DSID/DSSI 字段提取并挂载在数据集层面(映射关系见 ogrs101readerdatasetgeneralinformationrecord.cpp):

元数据键 说明
APPLICATION_PROFILE 1 表示仅处理初始文件 .000,2 表示涉及更新文件
DATASET_EDITION 数据集版本号;数据集被取消时为 0
DATASET_IDENTIFIER 文件名(含扩展名,不含路径)
DATASET_LANGUAGE 数据集主语言,必须为 EN(英语)
DATASET_REFERENCE_DATE 数据集参考日期,格式 YYYYMMDD(ISO 8601)
DATASET_TITLE 数据集标题
ENCODING_SPECIFICATION 必须为 S-100 Part 10a
ENCODING_SPECIFICATION_EDITION 必须为 5.2
PRODUCT_EDITION 必须为 2.0
PRODUCT_IDENTIFIER 必须为 INT.IHO.S-101.2.0
STATUS VALID 或 CANCELLED

最小测试文件的完整元数据断言见 ogr_s101.py,取消数据集的元数据见 ogr_s101_update.py。此外 DSSI 还承载 DATASET_ABSTRACT(DSAB)等可选字段。取消状态的判定逻辑是:当更新文件或初始文件中的 DATASET_EDITION 为 0 时,STATUS 置为 CANCELLED 并停止加载后续记录(见 ogrs101readerdatasetgeneralinformationrecord.cpp 与 ogrs101reader.cpp)。

Feature Catalog(要素编目)

S-101 驱动可以在系统上没有 XML Feature Catalog 文件的情况下工作,但拥有该文件可以带来三方面提升:

  1. 更好的属性类型判定,尤其是布尔型字段;
  2. 更严格的属性与要素类型一致性检查;
  3. 将枚举型属性暴露为 OGR 字段域(field domains)。

查找顺序

GDAL 首先在 GDAL 数据目录(或启用 EMBED_RESOURCE_FILES=ON 时的内嵌资源)中查找编目。若内嵌资源不存在,则按优先级递减依次查找(实现见 ogrs101featurecatalog.cpp):

  1. 配置选项 GDAL_S101_FEATURE_CATALOG 指定的路径(设为 NO/FALSE/OFF/0 可显式禁用);
  2. $INSTALL_PREFIX/share/gdal/101_Feature_Catalogue_2.0.0.xml;
  3. $HOME/.gdal/101_Feature_Catalogue_2.0.0.xml。

若最终仍未找到,驱动会尝试从 IHO OHI GitHub 仓库下载 FeatureCatalogue.xml,校验大小后缓存到 $HOME/.gdal/101_Feature_Catalogue_2.0.0.xml(每个进程仅尝试一次,超时 1 秒;文件期望大小为 2017402 字节,相关常量见 ogrs101featurecatalog.cpp)。在 GDAL 数据目录中随驱动一同分发的编目文件为 101_Feature_Catalogue_2.0.0.xml(含许可证文件 101_Feature_Catalogue_2.0.0.xml.LICENSE),CMake 构建系统会将其安装到 GDAL_DATA_FILES 或内嵌到二进制资源中(见 CMakeLists.txt)。

字段域(Field Domain)示例

当 Feature Catalog 可用时,枚举属性会映射为 OGR 编码字段域。测试 ogr_s101_informationtype.py 验证了 lightSector.colour 字段绑定名为 colour 的字段域,其枚举为白、黑、红、绿、蓝……直至品红、粉红共 13 种颜色编码。

显式指定编目路径

from osgeo import gdal

# 通过配置选项显式指定 Feature Catalog 路径
gdal.SetConfigOption(
    "GDAL_S101_FEATURE_CATALOG",
    "/path/to/101_Feature_Catalogue_2.0.0.xml",
)
ds = gdal.Open("data/101A1234.000")

# 显式禁用 Feature Catalog
gdal.SetConfigOption("GDAL_S101_FEATURE_CATALOG", "NO")
ds = gdal.Open("data/101A1234.000")

更新文件(Update Files)的读取机制

更新文件是 S-101 数据分发的核心机制:生产机构先分发基础 .000 文件,后续修订以 .001、.002……文件发布。读取器在默认 UPDATES=APPLY 下按编号升序自动加载全部存在的更新文件,并实时合并到内存中的基础数据视图,因此应用拿到的要素数据已经包含全部更新。

更新指令由各记录中的更新指令子字段控制(取值 1/2/3 分别对应 INSERT/DELETE/UPDATE,见 ogrs101readerconstants.h),驱动实现了对 ATTR、INAS/FASC 及各类几何记录(Point/MultiPoint/Curve/CompositeCurve/Surface/FeatureType)的差异化合并逻辑(方法列表见 ogr_s101.h)。更新文件还可以将整个数据集“取消”(cancel)。

注意两点使用限制:

  • 更新文件(APPLICATION_PROFILE=2)不能直接打开,必须打开主 .000 文件(见 ogrs101readerdatasetgeneralinformationrecord.cpp);
  • 更新文件与其基础文件的 DATASET_EDITION 不应相同,否则会给出警告。

更新场景的完整测试覆盖见 ogr_s101_update.py,配套数据文件在 autotest/ogr/data/s101/ 下(如 point_2d_update.000/point_2d_update.001、information_type_update.000/information_type_update.001 等成对出现的文件)。

实战:用 ogrinfo 与 ogr2ogr 读取 S-101 数据

快速浏览

# 列出所有图层与字段结构
ogrinfo -ro -al /path/to/101A1234.000

# 只查看某个要素类型图层
ogrinfo -ro /path/to/101A1234.000 AnchorageArea_Polygon

# 查看数据集元数据
ogrinfo -ro -so /path/to/101A1234.000

格式转换

# 全部图层转换为 GeoPackage
ogr2ogr -f GPKG output.gpkg /path/to/101A1234.000

# 仅转换指定图层,并应用宽松解析
ogr2ogr -f GPKG -oo STRICT=NO -oo UPDATES=APPLY \
  output.gpkg /path/to/101A1234.000 AnchorageArea_Point2D

注意 ogr2ogr 默认转换全部图层;如需逐图层控制或批量转换大量海图,可结合 GDAL 的 VSI 虚拟文件系统支持读取压缩/远程封装的数据。

Python 读取示例

from osgeo import ogr

ds = ogr.Open("data/101A1234.000")  # 自动应用更新文件
print("Driver:", ds.GetDriver().GetDescription())  # S101
print("Metadata:", ds.GetMetadata())

lyr = ds.GetLayerByName("AnchorageArea_Polygon")
if lyr:
    print("Geometry type:", lyr.GetGeomType())
    print("CRS:", lyr.GetSpatialRef().GetAuthorityCode())
    for feat in lyr:
        geom = feat.GetGeometryRef()
        print(feat.GetFID(), geom.ExportToWkt() if geom else "No geometry")
        for i in range(feat.GetFieldCount()):
            print(" ", feat.GetFieldDefnRef(i).GetName(), "=", feat.GetField(i))

测试与验证

S101 驱动在 GDAL 自动化测试套件中拥有完整覆盖,所有用例均要求驱动已构建(pytest.mark.require_driver("S101")):

测试数据(*.000、.001 及对应 .xml 中间描述文件)位于 autotest/ogr/data/s101/。此外,驱动实现了延迟插件机制(DeclareDeferredOGRS101Plugin,见 ogrs101drivercore.cpp),支持按需加载与 PLUGIN_INSTALLATION_MESSAGE 提示。

总结

GDAL 的 S101 驱动以只读方式完整支持 IHO S-101 ENC 产品,覆盖从 ISO/IEC 8211 二进制解析、更新文件实时合并,到几何基元图层、要素类型图层、信息/要素关联、掩膜与 Feature Catalog 字段域的完整数据模型。借助 STRICT 与 UPDATES 打开选项,你可以精确控制解析容错与更新应用行为;结合 ogr_s101.h 中的记录类型与字段常量、ogrs101readerconstants.h 中的字段结构定义,以及 autotest/ogr/data/s101/ 下的真实测试数据,可以快速验证解析行为、排查不规范数据,并在此基础上构建自己的 S-101 海图应用。

该驱动的初始开发由 Rijkswaterstaat 资助,更新文件读取支持由 Zydromarine 资助,体现了 S-101 在海事导航与内河航运数字化中的实际应用价值。

登录后查看全文
gdal