Overview

This package contains classes for reading S57 files. The S57 standard is a numerical map format for nautical maps, which is a standard published by the International Hydrographic Organization (IHO). You can find more information at:
The S57 readers provided in this package are based on the IHO TRANSFER STANDARD FOR DIGITAL HYDROGRAPHIC DATA Edition 3.1.
The S57 Reader module provides access to data in IHO S57 formatted file sets. The S57 Reader module produces S57 features in one or more related S57 data files. An S57 data set can be a directory, in which case all S57 files in the directory are selected, an S57 catalog file, in which case all files referred to from the catalog are selected, or an individual S57 data file. An S57 catalog covers an area with nautical data. It is composed of a single directory containing both a catalog file (.030 or .031) and cell files (.000). Usually cells contain data for only a subzone of the global catalog zone.
S57 feature objects are translated into features. S57 geometry objects are automatically collected and formed into geometries on the features. Geometry objects are not separately accessible with the S57 reader.
When simplified rendering is activated, S52 symbols are rendered using a predefined icon per object type, whatever the object attributes are. Polygon and polyline colors are likewise predefined. When simplified rendering is deactivated, JViews Maps for Defense uses the IHO ECDIS Presentation library (Edition 3.3, March 2004) definitions to create S52 symbols according to attribute content.
The following limitations apply to the use of the ECDIS Presentation library:
  • Conditional procedures defined in this document are not implemented, except for a partial implementation of DEPARE02 DEPCNT03 LIGHTS05 and QUAPOS01.
  • Complex line sets are not used.
  • S52 Symbols are displayed based on the SIMPLIFIED look up table
  • The styling of polygons and areas is limited to the polygon style supported, and is built based on PLAIN_BOUNDARIES, LINES_SET or SIMPLIFIED look up tables.
  • S52 symbols for lights are not rotated.
There are two ways of reading S57 data:
  • Using an IlvS57Reader instance directly. In this case, you must write all the code required to render the map features into graphic objects, and to add them to the manager.
  • Using an IlvS57DataSource instance. This is a convenient way of performing all the above operations at once and is more integrated with the map data model.
The source code for the Map Builder demonstration, which contains all the code described in this section, can be found at <installdir> /jviews-maps89/samples/mapbuilder/index.html.