SevenCs WMS ChartServer

Version 5.0

Installation and Operating Manual

SevenCs GmbH, Hamburg Germany

 SevenCs GmbH
Atlantic Haus
Zirkusweg1
D-20359 Hamburg
Tel. +49 (0)40/851 72 40
FAX +49 (0)40/851 72 4-79
http://www.sevencs.com

Copyright:
All rights reserved. No part of this document may be reproduced, in any form or by any
means, disclosed or used by any person who has not received prior written authorization
from SevenCs GmbH.
Brand names:
Brand names, logos and trademarks used in this document remain the property of their
respective owners.
Referrals and links:
SevenCs does not assume any liability for any external content linked to our site / to this
document, including links provided in our website. SevenCs has no influence on the content
of such sites. The owners of such linked websites take sole responsibility for their content.
Disclaimer:
SevenCs does not guarantee any actuality, correctness, completeness or quality of the information
provided. Claims of liability referring to material or ideal damages, due to the use or non-use of the
information or due to the use of wrong and incomplete information, are strictly ruled out, as long
as there is no verifiable wilful or reckless fault on the part of SevenCs GmbH.
 ChartServer - Operating Manual

Preface
This document is aimed at users who are going to integrate WMS ChartServer into a chart display
system or planning to provide a WMS service. It gives a step by step introduction to the installation
and the use of WMS ChartServer.

Document Conventions
This manual uses several conventions to highlight certain words and phrases and draw attention to
specific pieces of information.

Calibri font is used for plain text in this document

Calibri bold font is used for program or tool names

Calibri bold italic font is used for file names or environment variables

Calibri blue font is used for cross references

Calibri blue underline font is used for hyperlinks

Indented Calibri red bold font is used for command line calls

Important notes are displayed in shaded text boxes

Note:
Such a note box displays important information which should not be ignored.

Simple file content is displayed in black.

#Configuration file
Version 1.0
screenW 1024
screenH 768

© SevenCs GmbH 2019 iii

ChartServer - Operating Manual

Trademarks
Windows 7/10, Windows Server 2012/2016 are trademarks of Microsoft Corporation.
Linux is a trademark of Linus Torvalds.
SUSE and openSUSE are trademarks of Novell Inc.
Red Hat is a trademark of Red Hat Inc.
Intel is a trademark of Intel Corporation.
Sentinel is a trademark of SafeNet Inc.
Ubuntu is a trademark of Canonical Ltd.

iv © SevenCs GmbH 2019

 ChartServer - Operating Manual

Preface ........................................................................................................................ iii

Document Conventions ..................................................................................................iii
Trademarks.................................................................................................................... iv

Introduction ................................................................................................................. 1

1 Quick Installation Guide....................................................................................... 2

2 Hardware and Software Requirements ................................................................ 3

2.1 Supported Operating Systems .......................................................................... 3
2.2 Hardware Requirements .................................................................................. 3
2.3 Software Requirements ................................................................................... 4
2.3.1 Linux ..........................................................................................................................4

3 Installation .......................................................................................................... 5
3.1 Installation on Linux......................................................................................... 5
3.1.1 Public Key for Digital Signature .................................................................................5
3.1.2 Installation of WMS ChartServer ...............................................................................5
3.1.3 WMS ChartServer Package Dependencies ................................................................6
3.1.4 Environment Variables ..............................................................................................7
3.1.5 User Id........................................................................................................................7
3.1.6 Daemon installation - Systemd..................................................................................7
3.1.7 Linux Directory Structure ..........................................................................................8
3.2 Installation on Windows .................................................................................. 9
3.2.1 Windows Directory Structure ....................................................................................9
3.2.2 User Access Control ................................................................................................ 10
3.3 Use of Dongles ................................................................................................11
3.4 WMS ChartServer Update ...............................................................................11
3.5 Software Registration .....................................................................................11
3.5.1 Registration Permit................................................................................................. 12
3.5.2 Registry Robot ........................................................................................................ 12
3.5.3 License File.............................................................................................................. 14
3.6 Chart Installation Settings ...............................................................................14

4 Starting WMS ChartServer ................................................................................. 16

4.1 WMS ChartServer GUI .....................................................................................16
4.2 Terminal / Command Line Window .................................................................16
4.2.1 Linux ....................................................................................................................... 16
4.2.2 Windows ................................................................................................................. 17

5 WMS ChartServer Configuration File .................................................................. 18

5.1 System Settings ..............................................................................................18
5.2 Chart Settings .................................................................................................20
5.3 Chart Loading .................................................................................................20

© SevenCs GmbH 2019 v

ChartServer - Operating Manual

5.4 GeoJSON Settings ........................................................................................... 20

5.5 Layer Settings ................................................................................................. 20
5.6 Default Settings .............................................................................................. 20

6 Using WMS ChartServer ..................................................................................... 23

6.1 WMS Request Types ....................................................................................... 23
6.1.1 GetCapabilities........................................................................................................ 23
6.1.2 GetMap ................................................................................................................... 23
6.1.3 GetFeatureInfo ....................................................................................................... 25
6.1.4 CreateFeatureList ................................................................................................... 26
6.1.5 Extended Capabilities ............................................................................................. 27
6.1.5.1 On/Off Chart Settings ................................................................................... 28
6.1.5.2 Value Chart Settings ..................................................................................... 28
6.1.5.3 Object Filtering ............................................................................................. 29
6.1.5.4 Screen Properties ......................................................................................... 30
6.1.5.5 Chart rotation ............................................................................................... 30
6.2 Chart Display Configuration ............................................................................ 31
6.2.1 Screen Properties ................................................................................................... 31
6.2.2 Chart Settings ......................................................................................................... 31
6.2.2.1 On/Off Settings ............................................................................................. 32
6.2.2.2 Value Settings ............................................................................................... 33
6.2.2.3 Scale dependent object and text display ..................................................... 33
6.2.2.4 Display of National Text ............................................................................... 34
6.2.2.5 Fixed Chart Settings ...................................................................................... 34
6.2.2.6 Scale-Usage Settings / Load Scale Factor ..................................................... 35
6.2.3 User defined Chart Display ..................................................................................... 36
6.2.4 Tiling ....................................................................................................................... 36
6.2.5 Joint Chart Display .................................................................................................. 37
6.2.5.1 Layer by Layer............................................................................................... 37
6.2.5.2 Combined ..................................................................................................... 37
6.2.5.3 Alpha blending for CIO+ ............................................................................... 37
6.2.6 Chart Products ........................................................................................................ 38
6.2.6.1 ENC World Data Set ...................................................................................... 38
6.2.6.2 Inland ENC - IENC.......................................................................................... 38
6.2.6.3 AML .............................................................................................................. 38
6.2.6.4 Navionics ENC - NENC................................................................................... 38
6.2.6.5 ARINC ............................................................................................................ 39
6.2.6.6 DTED ............................................................................................................. 39

vi © SevenCs GmbH 2019

 ChartServer - Operating Manual

6.2.6.7 CIO+ .............................................................................................................. 40

7 Chart Installation ............................................................................................... 41

7.1 ChartHandler ..................................................................................................41
7.1.1 ChartHandler – Quick chart installation steps........................................................ 41
7.2 Automation of Chart Installation .....................................................................42
7.2.1 Chart Installation Tool ............................................................................................ 42
7.2.2 Batch Process / Shell script..................................................................................... 42

8 ChartViewer ...................................................................................................... 44

9 WMS ChartServer Client .................................................................................... 45

10 Administration .................................................................................................. 46

11 Trouble Shooting ............................................................................................... 47

Annex A – Viewport Calculations ................................................................................ 49

Annex B - Example Calls .............................................................................................. 51

Annex C – Chart Products ........................................................................................... 53

Annex D – S-57 Object Token ...................................................................................... 56

Annex D – ENC Legend ................................................................................................ 59

© SevenCs GmbH 2019 vii

 ChartServer - Operating Manual

Introduction
WMS ChartServer is a server application which generates images of vector or raster navigation
charts on request of client applications. Clients may use the chart images as background for other
geo-referenced data such as weather, sea state, etc. or as an overlay for satellite images.
WMS ChartServer allows software manufacturers or OEMs to develop their own applications, i.e.
solutions in which clients access WMS ChartServer in order to utilize the advantages of a central
chart data base. Clients can either be a web-based or a stand-alone desktop application.
In addition, WMS ChartServer can be used whenever chart producing organizations want to allow
people to look at and refer to charts without the possibility to modify them locally.
WMS ChartServer supports the Open Geospatial Consortium (OGC) compliant Web Map Service
(WMS) protocol versions 1.1.1 and 1.3.0.
WMS ChartServer supports the query of spatial information, using extended proprietary WMS
parameters. The result is a GeoJSON formatted XML file.
WMS ChartServer is delivered with ChartHandler, a chart installation and maintenance tool and
with ChartViewer, a desktop chart viewer.

© SevenCs GmbH 2019 1

ChartServer - Operating Manual

1 Quick Installation Guide

For installation details please refer to chapter 3 Installation.

Windows
1. Login as administrator and start the installer wms_chartserver-<version>-64bit.msi or
run a command prompt as administrator and start the installer with
>msiexec -i wmsWMS ChartServer-<version>-<bit>.msi
2. Install ChartHandler, i.e. start charthandler-<version>-64bit.msi.
3. Reboot to enable the environment variables
4. Start WMS ChartServer to open the configuration dialog window and query for the hardware
Id in the Registration tab

Linux
1. Login as root and install the four rpm or deb packages
2. Create a user “wmschartserver” if not created yet by the installer
3. To enable the environment variables, re-login as root
4. Start WMSChartServerConfig to open the configuration dialog window and query for the
hardware Id in the Registration tab

General
5. Provide the hardware Id to SevenCs in order to receive the license file
6. Upload the license file in the Registration tab
7. In case of the use of ARCS charts define the necessary keys and permits in the Charts tab
8. Windows: Start the server in the Operation tab
Linux: Start the server with systemctl start wmschartserver

2 © SevenCs GmbH 2019

 ChartServer - Operating Manual

2 Hardware and Software Requirements

2.1 Supported Operating Systems

WMS ChartServer is offered for 64bit Intel PCs. The following operation systems are supported;
others can be made available on request:
• Red Hat 7.6
• SUSE Enterprise Server 15
• Ubuntu 18.04
• Windows 7, 8, 10, Windows Server 2008, 2012, 2016

2.2 Hardware Requirements

The performance of WMS ChartServer is mainly influenced by:
• The loading process of charts which are stored on a hard disk and not in the memory.
• The chart rendering process, i.e. the process of image generation
The chart loading process very much depends on the speed and access time of the hard disk.
Therefore, it is recommended to store the chart database on the same computer.
The rendering process is mainly affected by the processor speed, besides the size of the requested
image. The display process chiefly depends on the graphic interface.
WMS ChartServer does not require high end graphic cards. Standard graphic cards are sufficient,
unless other applications may require high end cards. SevenCs highly recommends to not use on-
board graphic processors, i.e. graphic processors with shared memory.
WMS ChartServer spreads the rendering of chart images of different client requests on different
threads. Therefore, a multi-core processor is recommended.

Hardware Minimum Recommended

RAM 8 GB 16 GB
Processor Dual core, 2 GHz Quad core, 3 GHz
Storage (min 100GB) HDD with fast access time SSD
Bus Interface SATA 3 (6 Gbit/s) PCIe

© SevenCs GmbH 2019 3

ChartServer - Operating Manual

2.3 Software Requirements

2.3.1 Linux

WMS ChartServer requires an X-Server. For performance reasons it is recommended to run WMS
ChartServer and X-Server on the same installation. The colour depth should be at least 32bit.
The maximum number of file handles which is required by WMS ChartServer depends on:
• number of simultaneous requests (threads)
• charts which have to be loaded for one view
WMS ChartServer is permanently checking its number of file handles. In case the maximum number
of file handles is reached a timeout of 20 seconds will be set. During this time an HTML error code
503 is sent.
To display the current limit of open files run

 ulimit -n

Ensure that the number of file handles is about 1000 per thread. To increase the number of open
files please refer to the instructions of the individual Linux distribution.

4 © SevenCs GmbH 2019

 ChartServer - Operating Manual

3 Installation
The WMS ChartServer package consists of several installation packages, i.e.
- WMS ChartServer
- ChartHandler
- CodeMeter (Runtime and Wupi engine)

3.1 Installation on Linux

3.1.1 Public Key for Digital Signature

The rpm or deb packages are signed with a GnuPG key. The public key can be downloaded from the
following URL:
 wget https://www.sevencs.com/data/uploads/sevencs-gmbh-rpm-pubkey.asc

If you would like to verify the signature upon installation of the rpm packages, please save it to your
system and import it by running as root:
 rpm --import sevencs-gmbh-rpm-pubkey.asc

or
 apt-key add sevencs-gmbh-rpm-pubkey.asc

3.1.2 Installation of WMS ChartServer

The WMS ChartServer will be delivered as a zip archive which contains a set of rpm or deb packages.
For the installation please login as root and run

Red Hat or SUSE Enterprise

 rpm -i CodeMeter-lite-6.50.2624-500.x86_64.rpm

 rpm -i sevencswupiengineredistributable--<version>-<build>-
<distribution>.<platform>.rpm

 rpm -i wms-chartserver-<version>-<build>_<platform>.rpm

 rpm -i charthandler-<version>-<build>_<platform>.rpm

 zypper in charthandler-<version>-<build>_<platform>.rpm

Ubuntu

 dpkg -i CodeMeter-lite-6.50.2624-500.x86_64.deb

 dpkg -i sevencswupiengineredistributable--<version>-<build>-
<distribution>.<platform>.deb

 dpkg -i wms-chartserver-<version>-<build>_<platform>.deb

© SevenCs GmbH 2019 5

ChartServer - Operating Manual

 dpkg -i charthandler-<version>-<build>_<platform>.deb

WMS ChartServer and ChartHandler are both linked with the SevenCs EC2007 ECDIS Kernel libraries
libeckernel and libs63lib. This leads to conflict report of the package manager which can be ignored
by
 rpm -i --force charthandler-<version>-<build>_<platform>.rpm

or
 dpkg -i --force-overwrite charthandler-<version>-<build>_<platform>.deb

The rpm or deb package for the Sentinel dongle drivers are not installed by means of the WMS
ChartServer package but contained as independent rpm package within the delivery.

Note:
To automatically set the environment variable WMSCHARTSERVER_LIB, a re-login is necessary.

3.1.3 WMS ChartServer Package Dependencies

The WMS ChartServer package depends on following components, which have to be installed in
case they are not installed yet.

WMS ChartServer

Dependency Package name Package name Package Name

Red Hat 7.6 SUSE Enterprise 15 Ubuntu 18.04
Qt 4.x qt, qt-devel libqt4-devel libqt4-dev
Qt 5.x qt5-qtxmlpatterns libQt5Xml5 libqt5core5a
qt5-qtx11extras libQt5XmlPatterns5 libqt5gui5, …
boost boost-regex libboost_regex1_66_0 libboost-regex1.65
libboost_date_time1_66_0 libboost-date_time1.65
libminizp minizip libminizip1 libminizip1
libjpeg openjpeg-libs openjpeg1 libopenjp2-7, libjpeg8
xerces xerces-c libxerces-c-3_1 libxerces-c3.2
libzip libzip libzip5 libzip-dev
X11/Motif libXp libXp6 x11-xserver-utils, libxt-dev,
libxmu-dev, libxft2

6 © SevenCs GmbH 2019

 ChartServer - Operating Manual

ChartHandler

Dependency Package name Package name Package Name

Red Hat 7.6 SUSE Enterprise 15 Ubuntu 18.04
Qt 4.x qt, qt-devel libqt4 libqt4-dev
libqt4-x11

On Ubuntu it may be necessary to add the universe repository by

 add-apt-repository universe

Note:
A possible reported failed dependency libNautilus-1.2-dynd.so.1.2 can be ignored

3.1.4 Environment Variables

The environment variable WMSCHARTSERVER_LIB will be set to /usr/share/SevenCs/WMS

ChartServer by a shell script WMS ChartServer-<version>.sh which is installed in /etc/profile.d. In
case of a failure a copy of this script can be found in $WMSCHARTSERVER_LIB/userconf. Please
ensure that this script will be called during the boot process.

3.1.5 User Id

During start of WMS ChartServer the user id is set to the default user wmschartserver. In case
another user shall be used it has to be defined in the WMS ChartServer configuration file
chartserver.ini (see chapter 5 WMS ChartServer Configuration File). The defined user must exist
on the system.

3.1.6 Daemon configuration - Systemd

The systemd script wmschartserver.service is located in $WMSCHARTSERVER_LIB/config/system.

To make it known to systemd run
 ln -s /usr/share/SevenCs/WMS_ChartServer/config/systemd/wmschartserver.service
/etc/systemd/system/wmschartserver.service

 systemctl daemon-reload

To check if WMS ChartServer has been installed (not started) use the command

 systemctl status wmschartserver

Note:
Depending on the Linux system configuration the provided scripts may have to be adjusted.

© SevenCs GmbH 2019 7

ChartServer - Operating Manual

3.1.7 Linux Directory Structure

The WMS ChartServer executables are installed in /usr/bin.

/usr/bin/wmschartserver WMS ChartServer
/usr/bin/registerchartserver WMS ChartServer Registration tool (command line tool)
/usr/bin/installcharts Command line tool for chart installation
/usr/bin/WMSChartServerConfig Chart Server GUI
/usr/bin/ChartViewer Chart Viewer application
/usr/bin/ChartHandler ChartHandler application for chart installation

WMS ChartServer is linked with the following SevenCs Kernel libraries which will be installed in
/usr/lib64
• /usr/lib/libeckernel-<version>-dynr.so.<subminor version>
• /usr/lib/libs63lib-<version>-dynr.so.<subminor version>
• /usr/lib/libwmslib-<version>-dynr.so. <subminor version>
• /usr/lib/libdtedlib-<version>-dynr.so. <subminor version>
• /usr/lib/libNautilus-<version>-dynr.so. <subminor version>
All other files are installed in the /usr/share/SevenCs/WMS ChartServer directory in the following
sub-directories:
charts/ Chart Database
DENC DENC structure with S-57 based chart products
(pre-installed 7Cs world data set)
DTED DTED directory structure (created by WMS ChartServer, filled by
ChartHandler)
config chartServer.ini
objectgroups.ini
ChartHandler.ini (created by WMS ChartServer during start)
capabilities_1.1.1.xml (Template for GetCatabilities 1.1.1)
capabilities_1.3.0.xml (Template for GetCatabilities 1.3.0)
upstart upstart scripts
systemd systemd scripts
env / lib / config EcRegMsg (registration file)
license.upd (software license file, provided by SevenCs)
PERMITS.7CP (SENC Chart Permits, created by Chart Handler)
fonts Fonts for text display in charts
objcat S-57 object and attribute catalogues
preslib4 Presentation library (colour definitions, lookup tables, symbols)

8 © SevenCs GmbH 2019

 ChartServer - Operating Manual

log log files created by WMS ChartServer

logStart start process log files created by WMS ChartServer User Interface
scripts Start script used by WMS ChartServer User Interface
userconf shell scripst to set environment variable
WMS ChartServer creates a process Id file WMS ChartServer.pid in /var/run. Since it is possible to
run several WMS ChartServer instances it may contain several process ids.

3.2 Installation on Windows

For Windows WMS ChartServer is provided as an MSI setup. ChartHandler is provided as an
independent MSI setup
WMS ChartServer has to be installed with administrator rights. This can be done either by logging
in as administrator or by running a command prompt as administrator and manually starting the
MSI setup with:
 msiexec -i wms_chartServer-<version>-<bit>.msi

 msiexec -i charthandler-<version>-<bit>.msi

WMS ChartServer is installed as a Windows service.

Note:
To automatically set the environment variable WMSCHARTSERVER_LIB, a reboot is necessary.
In case the installer runs a rollback, ensure that the 32 and 64bit redistributables for MS Visual
Studio 2013 are installed.

3.2.1 Windows Directory Structure

Program Files are stored in %ProgramFiles%\SevenCs\WMS_ChartServer

bin WMS ChartServer executables and dlls
lib WMS ChartServer registration executables
All WMS ChartServer relevant environment data and charts are stored in
%ProgramData%\SevenCs\WMS_ChartServer\
charts\ Chart Database
DENC DENC structure with S-57/S-63 based chart products
(pre-installed 7Cs world data set)
DTED DTED directory structure
ARCS ARCS directory structure
config chartServer.ini
objectgroups.ini
ChartHandler.ini (created by WMS ChartServer during start)

© SevenCs GmbH 2019 9

ChartServer - Operating Manual

capabilities_1.1.1.xml (Template for GetCatabilities 1.1.1)

capabilities_1.3.0.xml (Template for GetCatabilities 1.3.0)
env \ lib \ config license.upd (software license file, provided by SevenCs)
PERMITS.7CP (SENC Chart Permits, created by Chart Handler)
config.crt (Screen settings from clients, if known)
fonts Fonts for text display in charts
objcat S-57 object and attribute catalogues
preslib4 Presentation library (colour definitions, lookup tables, symbols)
log log files created by WMS ChartServer
logStart start process log files created by WMS ChartServer GUI
contrib Sentinel dongle driver setup
scripts Start and stop scripts used by ChartHandler (not on Windows)

3.2.2 User Access Control

The WMS ChartServer GUI and ChartHandler have to be started within the Microsoft User Access
Control (UAC). This is necessary because both tools must be able to start and stop the WMS
ChartServer service. Therefore, each time one of these tools is started the following message will
be displayed:

10 © SevenCs GmbH 2019

 ChartServer - Operating Manual

3.3 Use of Dongles

In case dongles shall be used for the WMS ChartServer registration, the dongle driver has to be
installed. For Linux there is a Sentinel rpm package for the dongle drivers besides the rpm package
of WMS ChartServer. For Windows a setup for the Sentinel dongle drivers is installed in
%WMSCHARTSERVER_LIB%\contrib.

3.4 WMS ChartServer Update

There is no need to uninstall older versions of WMS ChartServer 5 before a new version is installed.
However, the WMS ChartServer service or daemon have to be stopped.
A backup of the WMS ChartServer ini file should be created in case some specific settings had been
defined or changed, e.g. the S-63 or ARCS settings.
In case of an update from ChartServer 4 to WMS ChartServer 5 and a preferred and continued use
of the installed charts following steps have to be performed:
• Register WMS ChartServer 5 with the same license of ChartServer 4
• Copy the directory $CHARTSERVER_LIB/charts/DENC to $WMSCHARTSERVER_LIB/charts
• Delete $WMSCHARTSERVER_LIB/charts/DENC/CATALOG.7CC

3.5 Software Registration

Note:
Before registering WMS ChartServer make sure that the registration will run on the final hardware.
Each new registration key is linked to a new registry license which will be charged for.

The registration of WMS ChartServer is performed by means of the WMS ChartServer GUI tool. On
Windows it can be started directly from the desktop or from the menu. On Linux run
 WMSChartServerConfig

During the first start the following message can be confirmed by clicking OK.

1. Switch to the registration tab. All available hardware sources are selectable.
In case WMS ChartServer shall be registered with a dongle, the dongle has to be plugged in
before the WMS ChartServerConfig is started. Please ensure that the dongle driver is installed
as well.

© SevenCs GmbH 2019 11

ChartServer - Operating Manual

2. Define the hardware source for the calculation of the hardware Id

3. Define if WMS ChartServer light shall be registered.
4. Query for the hardware Id
5. Provide the hardware Id together with the registration permit (please refer to the following
chapter). This can happen either automatically using the SevenCs Registry Robot (please refer
to chapter 3.5.2 Registry Robot) or manually via contacting the SevenCs support by email.
6. Upload the received license file

In case the WMS ChartServer GUI tool fails to recognize the hardware Id or to upload the license
file, the command line tool registerchartserver may be used. To register WMS ChartServer run
 registerchartserver -n -o

 cp license.upd /usr/share/SevenCs/WMS_ChartServer/env/lib/config/

 registerchartserver -n

3.5.1 Registration Permit

The registration permit is enclosed in the WMS ChartServer shipment. The permit comprises a
specific number of registrations depending on the number of ordered licenses. In addition, the
permit defines the different modules which have been purchased. There are different permits for
development and runtime licenses. Examples:
EH0914.Company.01 Permit for Evaluation licenses
PH0914.Company.01 Permit for permanent licenses

Note:
Before registering the Kernel make sure that the registration will run on the final hardware. Each
new registration key is linked to a new registry license which will be charged for.

3.5.2 Registry Robot

The Registry Robot at the SevenCs office automatically issues Registration Keys via e-mail in return
of hardware IDs. The Registry Robot scans incoming e-mails for a company acronym, a formatted
permit, and hardware IDs. It then calculates the respective Registration Keys and returns them via
e-mail as plain text and as attached license file license.upd (please refer to 3.5.3 License File).

12 © SevenCs GmbH 2019

 ChartServer - Operating Manual

For each e-mail multiple registrations are possible, but only for one permit.
To receive registration strings from the Registry Robot your e-mail should contain the following
information:
• your return e-mail address (retrieved in the e-mail header)
• company acronym and permit (make sure that the format is correct, i.e. comma separated)
• name of the vessel where the software shall be installed (optional parameter, may be blank)
• at least one hardware ID

Note:
The e-mail has to be formatted in plain text. HTML or other formats cannot be recognized.

The address of the Registry Robot is: [email protected]

Here is an example for a registration request by e-mail. In the example, the

• company acronym is SevenCs
• the registration permit is PH0114.SevenCs.01
• the name of the vessel is MV Hamburg (may be left empty)
• the hardware ID 1234-5678-90AB-CDEF-1D3E-C

SevenCs,PH0114.SevenCs.01
SHIP: MV Hamburg
1234-5678-90AB-CDEF-1D3E-C

Here is an example of the answer of the registry robot

Answer of 7Cs Registry Robot V3.6

-----------------------------------------------------------

Registration Permit: PH0114.SevenCs.01

Modules: EC_S57/S63Imp, ARCS, INLAND,
Registrations left: 3

Ship: MV Hamburg

|---------------------------+--------------------------+---------------|
| HardwareID | Registration Key | Num. Lic. |
|---------------------------+--------------------------+---------------|
| 1234-5678-90AB-CDEF-1D3E-C| FEDC-BA09-8765-4321-1D3E | 3 |
|---------------------------+--------------------------+---------------|
| Second RegKey| 8DF6-018B-D9DA-9576-1D3E |
| Optionmodul key| 7049-A8CF-149F-D0B3-C504 |
| Arcs Pin| 1234 |
| Arcs Permit| 1234567890ABCDEF |
|---------------------------+--------------------------+---------------|

© SevenCs GmbH 2019 13

ChartServer - Operating Manual

3.5.3 License File

License files are simply text files containing some keywords, related keys and text information. The
following example displays all keywords and keys in bold font.

Note:
The entries in the license file MUST NOT be changed.

# Licence update file for EC2007 ECDIS Kernel

# This file contains one or more sections for
# a HwId providing appropiate registration keys.

# The file is searched in the location

# LIB_7CS/lib/config

# If a licence is required the Kernel automatically

# installs the keys for a matching HwId.

[7674-9CD8-53C9-2A61-1D3E-C]

RegKey: A6C7-6D57-B1BB-FA69-257C
RegKey2: 035A-D4E2-CE99-34E1-257C
ModKey: 3FB7-220D-C1DB-F2E7-29E8
EvalKey:

# optional entries

Date: 20140520
Permit:
ShipName:
ArcsPin: 1234
ArcsPerm: D20F60FA913E3743

This procedure allows to distribute licenses for a number of WMS ChartServer installations with
only one file.

3.6 Chart Installation Settings

For the installation of official ENCs and ARCS a S-63 User Permit, ARCS Pin and ARCS User Permit
are required.
The S-63 User Permit is calculated by WMS ChartServer and is indicated in the Charts tab of WMS
ChartServerConfig.
In case WMS ChartServer is integrated into a system by an IHO approved S-63 Manufacturer the S-
63 Manufacturer Key (S63MKEY) and the S-63 User Permit (S63USERPERMIT) have to be entered
by the system integrator in the WMS ChartServer configuration file chartServer.ini, located in
$WMSCHARTSERVER_LIB/config.
The ARCS Pin and User Permit are provided by SevenCs on request and have to be entered in the
Charts tab.

14 © SevenCs GmbH 2019

 ChartServer - Operating Manual

The User Permits have to be supplied to the chart distributor for calculation of the chart permits,
either for ENCs (S-63) or for ARCS.

© SevenCs GmbH 2019 15

ChartServer - Operating Manual

4 Starting WMS ChartServer

WMS ChartServer itself is a service or daemon which is running in the background. WMS
ChartServer can be started in two different ways.
1. Using the WMS ChartServer User Interface, i.e. WMS ChartServerConfig (Windows only)
2. Starting from the terminal or command line window

Note:
During the initialization WMS ChartServer parses the chart database to create a chart catalogue,
i.e. the file $WMSCHARTSERVER_LIB/charts/DENC/CATALOG.7CC. In case of very huge chart
databases with worldwide coverage this may take up to ten minutes. During this time WMS
ChartServer does not reply to any kind of requests.

4.1 WMS ChartServer GUI

If WMS ChartServer has been registered successfully it can be started and stopped from the
Operation tab. In the current version this is only supported for Windows.

4.2 Terminal / Command Line Window

4.2.1 Linux

WMS ChartServer has to be started as root because WMS ChartServer’s UID and GID are set to the
user and group wmschartserver which must be created prior to the first start of WMS ChartServer.
If started directly from the terminal the access to the X-Server has to be allowed for root, e.g. with
 xhost +

In case of access problems to the X server and its display a start of a second X server with another
display may help by running following command:
 X :1 -ac > x.log 2>&1 &

16 © SevenCs GmbH 2019

 ChartServer - Operating Manual

In addition the display number in the systemd environment file

$WMSCHARTSERVER_LIB/config/system/environment has to be set to 1.

To start WMS ChartServer from a terminal run

 systemctl start WMS ChartServer.service

WMS ChartServer can be stopped with

 systemctl stop WMS ChartServer.service

4.2.2 Windows

The command line window has to be opened with administration privileges, i.e. “run as
administrator”.
Open a command line window with administrator privileges, i.e. “run as administrator”. From there
WMS ChartServer can be started/stopped with
 net start/stop WMSChartServer

or
 sc start/stop WMSChartServer

© SevenCs GmbH 2019 17

ChartServer - Operating Manual

5 WMS ChartServer Configuration File

All settings of WMS ChartServer are stored in the configuration file chartServer.ini, located in
$WMSCHARTSERVER_LIB/config.
The settings are read during the start of WMS ChartServer and saved in case the chart settings have
been changed.

Note (Linux only):

When the configuration file is saved by ChartServer the order of the entries is resorted and does
not reflect the order described in the following chapters.

5.1 System Settings

NETINTERFACE
In case the calculated IP address is not the correct one, the IP address itself or the name of the used
network interface has to be entered in the WMS ChartServer configuration file chartServer.ini,
located in $WMSCHARTSERVER_LIB/config.

NETINTERFACE=192.168.145.1

Linux:

NETINTERFACE=eth0

Windows:

NETINTERFACE=Local Area Connection

or

NETINTERFACE=Ethernet

Note:
As soon as the network interface has been defined, the “localhost” in the URL will not be recognized
anymore but only the IP address.

If an IP address is defined, a list of all detected network interface names is checked and given in the
log file ChartServer_action_yymmdd_hhmmss.txt.

PORTWEB/PORTADMIN
Definition of the port number of the WMS ChartServer itself and the web-based administration
interface.

18 © SevenCs GmbH 2019

 ChartServer - Operating Manual

CONCURRENTCLIENTSMIN/ CONCURRENTCLIENTSMAX
Definition of the number of threads which will be opened for the request handling.
In WMS ChartServer Light the maximum number of threads is set to 5 automatically and cannot be
changed.

KERNELTHREADS
Definition of the number of threads which are used for the symbolization of a set of charts. It is
advised to set this number to twice of the number of CPU cores.

PROCESSINGTIMEOUTWMS
This timeout defines the time in seconds after a thread is available again in case the process could
not be finished.

DENCDIR/DTEDDIR
Definition of the directories of the chart libraries, relative to the root directory of WMS ChartServer,
i.e.
• C:\ProgramData\SevenCs\WMS_ChartServer (Windows)
• /usr/share/SevenCs/WMS_ChartServer (Linux)

PERFORMANCEMODE
For a description of the performance mode please refer to chapter 6.2.2.5 Fixed Chart Settings

FIXEDCENTER
For a description of the performance mode please refer to chapter 6.2.2.5 Fixed Chart Settings

TEXTSIZEFACTOR / NTEXTSIZEFACTOR
For a description of the performance mode please refer to chapter 6.2.2.5 Fixed Chart Settings

LOADSCALEFACTOR
For a description of the load scale factor please refer to chapter 6.2.2.6 Scale-Usage Settings / Load
Scale Factor

S63MKEY / S63USERPERMIT / ARCSPIN / ARCSUSERPERMIT

For a description of the performance mode please refer to chapter 3.6 Chart Installation Settings.

© SevenCs GmbH 2019 19

ChartServer - Operating Manual

5.2 Chart Settings

For a description of the chart settings please refer to chapter 6.2.2 Chart Settings.

5.3 Chart Loading

For a description of the chart loading approach, either scale or S-57 usage based, please refer to
chapter 6.2.2.6 Scale-Usage Settings / Load Scale Factor.

5.4 GeoJSON Settings

The GeoJSON settings define the mode in which WMS ChartServer responses to the GeoJSON
request. The default is a immediate response. However, a handshake is supported as well. I.e. WMS
ChartServer responses with an XML file which contains the pick-up request URL.

<PickUpInfo>
<URL>
10.125.100.73:8080/RESULTS2PickUp/12294826982721454081
</URL>
<timeout unit="seconds">60 </timeout>
</PickUpInfo>

5.5 Layer Settings

The layer settings are generated by WMS ChartServer automatically and must not be modified.

5.6 Default Settings

[SYSTEM]
USER=wmschartserver
NETINTERFACE=
PORTWEB=8080
PORTADMIN=8081
CONCURRENTCLIENTSMIN=5
CONCURRENTCLIENTSMAX=20
PROCESSINGTIMEOUTWMS=40
KERNELTHREADS=8
DENCDIR=charts/DENC
DTEDDIR=charts/DTED
LOGFILES=log
PERFORMANCEMODE=true
FIXEDCENTER=false
SCREENHSIZE=470
SCREENVSIZE=300
SCREENHRES=1680
SCREENVRES=1050
TEXTSIZEFACTOR=1.0
NTEXTSIZEFACTOR=1.0
S63MKEY=10121
S63USERPERMIT=66B5CBFDF7E4139D5B6086C23130

20 © SevenCs GmbH 2019

 ChartServer - Operating Manual

ARCSPIN=1234
ARCSUSERPERMIT=1234567890ABCDEF
LOADSCALEFACTOR=0.0

[CHART]
ShowLights=false
ShowText=false
ShowSymbolFail=false
ShowShallowPattern=false
ShowOverscale=false
ShowInformationPoints=false
ShowShallowSoundings=false
ShowDeepSoundings=false
ShowTwoShades=false
ShowGrayShades=false
ShowUseAutoSCAMIN=false
ShowUseChartSCAMIN=true
ShowChartBoundaries=false
ShowContourLabels=false
ShowGridMask=false
ShowNationalText=false
SafetyContour=10
ShallowContour=5
DeepContour=20
SafetyDepth=10
SymbolSet=1
DisplayCategory=2
ColorScheme=1
TextScale=10000000
ShallowSoundingsScale=10000000
DeepSoundingsScale=10000000
LayerStrategy=0
OverlayAlphaBlend=64

[SCALEUSAGE]
Mode=0
Overview=20000000
General=1000000
Coastal=300000
Approach=100000
Harbour=25000
Berthing=10000
River=8000
RiverHarbour=4000
RiverBerthing=2000

[GeoJson]
GS_PickUp_Tout=60
GS_ReplyMode=0

[LAYERS]
LAYERLIST\1\LAYERNAME=ENC
LAYERLIST\1\QUERYABLE=true
LAYERLIST\1\OPAQUE=false
LAYERLIST\1\OVERLAY=false
LAYERLIST\1\ENABLED=true
LAYERLIST\size=1

© SevenCs GmbH 2019 21

ChartServer - Operating Manual

[DTED]
Pixel4Elevat=1
ColorMode=3
ElevatColorMap\1\Elevation=0
ElevatColorMap\1\ColorARGB=0
ElevatColorMap\2\Elevation=1
ElevatColorMap\2\ColorARGB=3694305370
ElevatColorMap\3\Elevation=50
ElevatColorMap\3\ColorARGB=4288071780
ElevatColorMap\4\Elevation=100
ElevatColorMap\4\ColorARGB=4294638210
ElevatColorMap\5\Elevation=1000
ElevatColorMap\5\ColorARGB=4293964880
ElevatColorMap\6\Elevation=2000
ElevatColorMap\6\ColorARGB=4288028190
ElevatColorMap\7\Elevation=4000
ElevatColorMap\7\ColorARGB=4291358960
ElevatColorMap\size=7

22 © SevenCs GmbH 2019

 ChartServer - Operating Manual

6 Using WMS ChartServer

WMS ChartServer is a service (Windows) or daemon (Linux) which runs in the background. It listens
on a definable port for requests and responses either with an image or textual information,
depending on the request type. Requests must be in conformance with the OGC WMS standard.
WMS ChartServer supports version 1.1.1 and 1.3.0 of the WMS standards.
The WMS standard can be downloaded from the OGC homepage
www.opengeospatial.org/standards/wms.

6.1 WMS Request Types

Depending on the request type WMS ChartServer requires specific WMS parameters. The following
WMS request types are supported:
• GetCapabilities (WMS)
• GetMap (WMS)
• GetFeatureInfo (WMS)
• CreateFeatureList (7Cs proprietary for spatial query)

6.1.1 GetCapabilities

WMS Parameter Value Remark

SERVICE WMS Service which is supported by WMS ChartServer
VERSION 1.1.1 or 1.3.0 WMS version which is supported by WMS
ChartServer
REQUEST GetCapabilities
Example:
http://localhost:8080/?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities

6.1.2 GetMap

WMS Parameter Value Remark

VERSION 1.1.1 or 1.3.0 Supported WMS version
REQUEST GetMap
LAYERS ENC Electronic Navigational Charts 2.0
IENC Inland ENC 2.3
AML_CLB, AML_ESB, Advanced Military Layers 1,0 and 2.1
AML_LBO, AML_MFF
AML_RAL, AML_SBO

© SevenCs GmbH 2019 23

ChartServer - Operating Manual

AML_3 Advanced Military Layers 3.0

DNC Digital Nautical Chart
VMAP0 Vector Map Level 0
VMAP1 Vector Map Level 1
ARINC ARINC Aviation Charts
DTED Digital Terrain Elevation Data
NENC Navionics ENC

SRS (1.1.1) AUTO:42001 (1.1.1) Universal Transverse Mercator

CRS (1.3.0) AUTO2:42001 (1.3.0)
AUTO:42002 (1.1.1) Transverse Mercator
AUTO2:42002 (1.3.0)
AUTO:42003 (1.1.1) Orthographic
AUTO2:42003 (1.3.0)
AUTO:42004 (1.1.1) Equirectangular
AUTO2:42004 (1.3.0)
AUTO2:7CS01 Gnomonic (SevenCs proprietary)
AUTO2:7CS02 Stereographic (SevenCs proprietary)
AUTO2:7CS03 Azimutal equidistant (SevenCs proprietary)
EPSG:3395 WGS 84 / World-Mercator
EPSG:3857 WGS 84 / Pseudo-Mercator
EPSG:4087 WGS 84 / World Equidistant Cylindrical
EPSG:4326 WGS 84
EPSG:23028 ED50 / UTM zone 28N
| |
EPSG:23038 ED50 / UTM zone 38N
EPSG:25828 ETRS89 / UTM zone 28N
| |
EPSG:25838 ETRS89 / UTM zone 38N
EPSG:32601 WGS 84 / UTM zone 1N
| |
EPSG:32660 WGS 84 / UTM zone 60N
EPSG:32661 WGS84 / UPS North
EPSG:32701 WGS 84 / UTM zone 1S
| |

24 © SevenCs GmbH 2019

 ChartServer - Operating Manual

EPSG:32760 WGS 84 / UTM zone 60S

EPSG:32761 WGS84 / UPS South
BBOX x ll, y-ll, x-ur, y-ur Bounding box corners (lower left, upper right) in
CRS units, comma separated (see below).
WIDTH,HEIGHT width, height Width and height of chart image in pixels.
FORMAT png, jpg, tiff Depends on installed Qt version and plug-ins

The order of coordinates in the BBOX parameter is “min east, min north, max east, max north” in
meters with one exception. In case of WMS 1.3.0 and CRS=EPSG:4326 (WGS-84) the parameter
order is “min lat, min lon, max lat, max lon”.

Optional parameters:

WMS Parameter Value Remark

BGCOLOR Color value Hexadecimal red-green-blue color value for the
background color (default=0xFFFFFF).
TRANSPARENT True or false Default is true, i.e. the background is transparent.
If set to false, BGCOLOR will be used instead.
STYLES userdef Merges the user defined look-up tables

6.1.3 GetFeatureInfo

WMS Parameter Value Remark

VERSION 1.1.1 or 1.3.0 WMS version which is supported by WMS
ChartServer
REQUEST GetFeatureInfo
LAYERS see GetMap
CRS see GetMap
BBOX See GetMap
WIDTH,HEIGHT See GetMap
QUERY_LAYERS See GetMap LAYERS
I Pixel column horizontal coordinate in pixels
J Pixel row vertical coordinate in pixels
INFO_FORMAT text/xml Return format
text/html
text/plain

© SevenCs GmbH 2019 25

ChartServer - Operating Manual

Example output:
<picreport i="100" j="100" lon="8.47844" lat="54.06079">
<Feature Cell="7C4BD005.000" GeoType="Area" Token="M_COVR" Type="Meta" Name="Coverage">
<Attribute Token="CATCOV" ValueName="coverage" Name="Category of coverage" Value="1"/>
</Feature>
<Feature Cell="7C4BD005.000" GeoType="Sounding" Token="SOUNDG" Type="Geo"
Name="Sounding">
<Attribute Token="QUASOU" ValueName="depth known" Name="Quality of sounding
measurement" Value="1"/>
<Attribute Token="SCAMIN" Name="Scale minimum" Value="170000"/>
<Attribute Token="TECSOU" ValueName="found by echo-sounder" Name="Technique of sounding
measurement" Value="1"/>
</Feature>
<Feature Cell="7C4BD005.000" GeoType="Area" Token="DEPARE" Type="Geo" Name="Depth Area">
<Attribute Token="DRVAL1" Name="Depth range value 1" Value="5"/>
<Attribute Token="DRVAL2" Name="Depth range value 2" Value="10"/>
</Feature>
</picreport>

6.1.4 CreateFeatureList

CreateFeatureList is a SevenCs proprietary request type to support the query of spatial information.
WMS Parameter Value Remark
VERSION 1.1.1 or 1.3.0 WMS version which is supported by WMS
ChartServer
REQUEST GetFeatureList
LAYERS see GetMap
CRS see GetMap
BBOX See GetMap
WIDTH,HEIGHT See GetMap
QUERY_LAYERS See GetMap LAYERS
OBJECT See GetMap
OBJECTGROUP See GetMap
OBJECTFILTERNEGATION See GetMap
CLIP true/false True: Clips polygon with BBOX
False: Returns entire polygons
INFO_FORMAT geo+json mandatory

Example Output (GeoJSON formatted):

26 © SevenCs GmbH 2019

 ChartServer - Operating Manual

{"type":"FeatureCollection",
"features": [{
"type":"Feature",
"id":"31868.1455880645.159_2709",
"properties":{"CLSNAM": "DEPARE",
"DRVAL1": 0,
"DRVAL2": 100},
"geometry":{"type":"MultiPolygon",
"coordinates": [
[[[130.56,31.56],
[130.563,31.5572],
[130.56,31.5455],
[130.553,31.5467],
[130.553,31.4735],
[130.596,31.4735],
[130.64,31.4735],
[130.639,31.5444],
[130.63,31.5552],
[130.623,31.5519],
[130.618,31.56],
[130.596,31.56],
[130.56,31.56]
]
]
]
}
}]
}

6.1.5 Extended Capabilities

To configure the content of the chart display, proprietary parameters were introduced. The default
chart settings are defined in the WMS ChartServer configuration file chartServer.ini, located in
$WMSCHARTSERVER_LIB /config (5 WMS ChartServer Configuration File)

WMS Parameter Value Remark

CSBOOL bit mask (hex) Chart settings switches (see below)
CSVALUE comma separated list of Chart values settings (see below)
values
OBJECT comma separated list of A list of tokens is given in the Annex
S-57 object tokens

OBJECTGROUP name of user defined object groups can be defined by the user
object group in the objectgroups.ini file
OBJECTFILTERNEGATION true/false Defines if the object filters OBJECT and
OBJECTGROUP shall be negated
SCREENHSIZE screen size screen size in millimeters

© SevenCs GmbH 2019 27

ChartServer - Operating Manual

SCREENVSIZE
SCREENHRES screen resolution screen resolution in pixels
SCREENVRES

6.1.5.1 On/Off Chart Settings

The display of certain chart objects can be switched on and off by means of the parameter CSBOOL.
For a description of the settings please refer to chapter 6.2.2 Chart Settings.

No. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

Chart SCAMIN

Auto SCAMIN

National Text
Gray Shades
Two Shades
Symbol Fail

Boundaries
Soundings

Soundings
InfoPoints
Overscale

Contour
Shallow

Shallow
Pattern

Lables
Lights

Chart
Deep
Text

Grid

Example CSBOOL=4183:
Show Lights (1) + ShowText (2) + Show Shallow Soundings (8) + Show Deep Soundings (9) + Show
Contour Labels (15)
No 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1
Pow 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
Bin 0 1 0 0 0 0 0 1 1 0 0 0 0 0 1 1
Dec 214 28 27 26 21 20
Dec 32768 16384 8192 4096 2048 1024 512 256 128 64 32 16 8 4 2 1
Hex 8000 4000 2000 1000 800 400 200 100 80 40 20 10 8 4 2 1
Hex 4183

Note:
The switch of text, shallow soundings and deep soundings might have no effect, depending on the
defined scale, i.e. the 8th, 9th or 10th value of the CSVALUE parameter.
The switch of text has a higher priority than the switch of national text.
The S-52 display category (6th CSVALUE) has a higher order than the CSBOOL values. Soundings for
instance will not be shown if the display category is not “ALL”.

6.1.5.2 Value Chart Settings

All chart settings depending on values can be defined by means of the CSVALUE parameter. For a
description of the settings please refer to chapter 6.2.2 Chart Settings.

28 © SevenCs GmbH 2019

 ChartServer - Operating Manual

No. 1 2 3 4 5 6 7 8 9 10 11
Safety Shallow Deep Safety Symbol Display Color Text Shallow Deep Layer
Contour Contour Contour Depth Set Category Scheme Scale Sounding Sounding Strategy
Scale Scale

Type value value value value enum enum enum value value value enum

S-52 SymbolSet: S-52 DisplayCategory: S-52 ColorScheme: Layer Strategy:

• Traditional = 1 • Base = 1 • Day = 1 • Layer by Layer=0
• Simplified = 2 • Standard = 2 • Dusk = 2 • Combined=1
• Other (all) = 3 • Night = 3

The three scale values define at which scale the respective chart objects will be displayed. For
instance the value 1.000.000 for Text means that Text is only displayed at scales bigger than
1:1.000.000, i.e. you have to zoom in more than this scale.
The layer strategy defines how layers are handled in case more than one layer is defined (s. 6.2.5
Joint Chart Display)
Examples: CSVALUE=10,5,20,10,1,2,1,500000,100000,200000,1 will set all values
CSVALUE=,,,,,3 will set only the display category, all other values are default

6.1.5.3 Object Filtering

To display only certain objects of a chart the parameters OBJECT and OBJECTGROUP can be used.
With the parameter OBJECT the objects are defined as a comma separated list in the request string.
Objects can be defined as a group in the objectgroup.ini file, located in $WMSCHARTSERVER_LIB
/config.
The object tokens which have to be defined in the OBJECT parameter or the objectgroup.ini file are
the S-57 object tokens. A list of the ENC object tokens can be found in Annex D – S-57 Object Token.
Examples: OBJECT=SOUNDG will only draw soundings
OBJECTGROUP=ATON will only draw objects of the group ATON, defined in the
objectgroup.ini file
In the objectgroup.ini file several object groups can be defined.
After editing the objectgroup.ini file a restart of WMS ChartServer is required.

[ObjectGroups]
ObjectGroupsMap\size=3
ObjectGroupsMap\1\GROUPNAME=ATON
ObjectGroupsMap\1\GROUPOBJECTS="BCNCAR,BCNISD,BCNLAT,BCNSAW,BCNSPP,BOYCAR,BOYISD,
……"
ObjectGroupsMap\2\GROUPNAME=AREAS

© SevenCs GmbH 2019 29

ChartServer - Operating Manual

ObjectGroupsMap\2\GROUPOBJECTS="ACHARE,ACHBRT,CBLARE,CTNARE,DMPGRD,ISTZNE,MIPARE,
……"

Note:
The filter is applied to all loaded charts. In case a big scale, more detailed and accurate chart is
drawn on top of small scale chart the objects of both charts will be drawn. This may lead to multiple
symbols or lines, if the filled areas of the covering big scale chart are not drawn.
The use of the filter does not disable the display settings, e.g. display category or SCAMIN. Therefore
it is advised to switch to display category “Other” when using the filter.

In case all objects except some defined objects shall be displayed the parameter
OBJECTFILTERNEGATION can be used. In that case all objects except the ones defined with the
parameter OBJECT and OBJECTGROUP are displayed.
Example: OBJECT=LNDARE,M_COVR&OBJECTFILTERNEGATION=TRUE will display all objects
except land areas and chart boundaries, e.g. to overlay an satellite image.

6.1.5.4 Screen Properties

Screen properties, i.e. the size and resolution can be defined by means of following parameters
• SCREENHRES (horizontal resolution in pixel)
• SCREENVRES (vertical resolution in pixel)
• SCREENHSIZE (horizontal size in mm)
• SCREENVSIZE (vertical size in mm)
In case all clients which are served by WMS ChartServer have the same screen properties, it is
advised to define the screen properties in the chartServer.ini configuration file.

6.1.5.5 Chart rotation

For a rotation of the chart the extended parameter VIEWPORT has to be used instead of the BBOX
parameter. The rotation of the chart is only supported for the vector chart products, i.e. it is not
supported for ARCS and DTED.
VIEWPORT=center latitude, center longitude, rotation angle (heading), range, scale value
Example: VIEWPORT=53.8767,8.7152,331,2
Units: center latitude [decimal degrees]
Center longitude [decimal degrees]
Rotation angle (heading) [degrees]
Range [nautical miles (from center to upper viewport boundary)
Scale value (unit-less)

30 © SevenCs GmbH 2019

 ChartServer - Operating Manual

The values for center latitude, center longitude and the rotation angle (heading) are mandatory, as
well as either the range or the scale value. If the scale value shall be considered the range value
must not be defined, e.g. VIEWPORT=53.8767,8.7152,331,,10000

6.2 Chart Display Configuration

The content of chart images is mainly defined by the chart settings, the chart product type, the way
how the different chart products are displayed together, i.e. a joint chart display and the screen
properties.
Most of the chart configuration can be defined on-the-fly, i.e. in the WMS request. Some can only
be defined once before the start of WMS ChartServer. Both, the default values of the on-the-fly
settings and the fixed settings are defined in the WMS ChartServer configuration file
chartServer.ini, located in $WMSCHARTSERVER_LIB/config.

6.2.1 Screen Properties

Screen properties, i.e. the screen resolution and screen size are required for the projection
calculations and the calculation of the pixel size which is the basis for the calculation of:
• Text and symbol size
• Scale/Range
• View port (only in case of the use of the extended parameter VIEWPORT instead of BBOX)
The screen resolution and screen size can be defined either in the chartServer.ini file or for
individual definition in the URL by means of the extended WMS parameters:
• SCREENHRES (horizontal resolution in pixel)
• SCREENVRES (vertical resolution in pixel)
• SCREENHSIZE (horizontal size in mm)
• SCREENVSIZE (vertical size in mm)

6.2.2 Chart Settings

The following chart settings are applicable to the S-57 based products, i.e. ENC, IENC, AML, the VPF
based products, i.e. DNC and VMap and in parts to the ARINC aviation charts. Chart settings can be
defined by means of the extended WMS parameters CSBOOL and CSVALUE, i.e. on-the-fly, whereas
all default values are defined in the chartServer.ini file.

Note:
All Boolean chart settings, i.e. the settings in the CSBOOL parameter, can only be switched on. To
allow a toggling, all Boolean values should be set to false in the chartServer.ini file.

© SevenCs GmbH 2019 31

ChartServer - Operating Manual

6.2.2.1 On/Off Settings

Setting Description
Lights Light flare and light sectors
Text Chart object names, e.g. of cities, land regions, sea areas, navigational aids
Symbol fail Indication of symbol fails, i.e. missing information for symbolization
Overscale Indication (straight line pattern) if display scale is bigger than chart
compilation scale
Info Points Indication (magenta “i”) of chart objects which contain additional
information
Grid Chart Grid (only supported for rectangular chart projections)
Shallow Soundings Spot soundings shallower than the defined safety depth
Deep Soundings Spot soundings deeper than the defined safety depth
Two Shades Depth areas will only be displayed by two color, i.e. dark blue (unsafe) and
white (safe)
Grey Shades The entire chart image will be converted to grey shades
Chart SCAMIN SCAMIN of the chart objects will be considered
Auto SCAMIN SCAMIN will be applied automatically
Chart boundaries: Chart boundaries of loaded charts (grey lines) and available charts of better
usage or bigger scale (magenta lines)
Contour Labels Labels of depth contours (Display category has to be set to All, to display
depth contours)
National Text Chart object names encoded with non-latin characters will be displayed

32 © SevenCs GmbH 2019

 ChartServer - Operating Manual

6.2.2.2 Value Settings

Safety Contour
Shallow Contour
Deep Contour

Safety Depth Defines the limit of shallow soundings (black) and deep soundings (grey)
Symbol Set Simplified or traditional (paper chart) symbolization of buoys, beacons and
navigational area boundaries
Display Category S-52 Display Category Base, Standard or Other (Base = minimum, other = all
chart objects)
Color Scheme S-52 Color Scheme (Day, Dusk or Night)
Text Scale Scale minimum values for text, shallow and deep soundings (s. 6.2.2.3 Scale
Sounding Scale dependent object and text display)

6.2.2.3 Scale dependent object and text display

To avoid clutter in chart images, the chart producers assign so-called “Scale minimum (SCAMIN)”
values to chart objects. This guarantees that not all chart objects are always drawn but only if the
display scale is bigger than the SCAMIN value of the object.
However, there might be S-57 charts with no SCAMIN values. This is usually not the case with official
ENCs but might be with the VPF products DNC and VMap. To apply an automatic SCAMIN, the
CSBOOL value 13 (Auto SCAMIN) can be set.
For spot soundings and text a third method of defining SCAMIN values is supplied, i.e. by means of
the parameter CSVALUE. Only if the display scale value is smaller (scale is bigger) than the one
defined in the CSVALUE parameter, text or soundings will be displayed.
Example: CSVALUE=10,5,20,10,1,3,1,100000,200000,300000
Display Scale = 1:250000
In this case only the deep soundings are displayed. Shallow Soundings and text is not displayed.

© SevenCs GmbH 2019 33

ChartServer - Operating Manual

If a spot sounding is considered as shallow or deep depends on the value of the safety depth, i.e.
the 4th CSVALUE value.

6.2.2.4 Display of National Text

S-57 charts may contain text encoded with non-latin characters, i.e. in Unicode. Usually the text of
the attribute OBJNAM (object name) is displayed. In case of non-latin characters the attribute
NOBJNM (national object name) has to be use and the attribute OBJNAM contain the translated or
transliterated test. To display the content of NOBJNM instead of OBJNAM the respective CSBOOL
parameter has to be set.
The display of the natural surface text and navigation related areas, e.g. “nature reserve”, is done
by means of symbols and is not translated into other languages.

6.2.2.5 Fixed Chart Settings

Following chart settings cannot be defined or changed on-the-fly or during run-time and therefore
have to be defined in the chartServer.ini file before WMS ChartServer is started.

Performance Mode
By means of the performance mode the time-consuming rendering of thick lines and text outlines
are disabled. The default for the Key PERFORMANCEMODE is true.
In case text outlines shall be shown the performance mode has to be set to false.

Centered Symbols/Text
According to the IHO S-52 standard centered symbols and text have to be drawn in the center of
the visible part of an area. The default for the key FIXEDCENTER is false.
In case WMS ChartServer is used to generate tiles it is advised to set FIXEDCENTER to true.
In the latter case it may happen that centered symbols are clipped, i.e. the symbol is only visible in
the tile where the center of gravity of the area object is located. The same clipping may be visible
for symbols of point objects as well.

Default: FIXEDCENTER = true:

34 © SevenCs GmbH 2019

 ChartServer - Operating Manual

Text Sizes
Text sizes are calculated by means of the screen properties. In case the size appears too small it can
be increased by means of the keys TEXTSIZEFACTOR for normal text and NTEXTSIZEFACTOR for
chart text in national characters.

6.2.2.6 Scale-Usage Settings / Load Scale Factor

Chart Server supports two different chart loading algorithms:

• Load by Scale
• Load by S-57 Usage

Load by Scale
When this mode is used (in chartServer.ini file set LOADSCALEFACTOR parameter ≠ 0) the current
display scale and the compilation scale of the individual charts are compared to decide if they are
loaded or not. For this purpose, ChartServer determines the current display scale value and
multiplies it with the LOADSCALEFACTOR parameter. The result is used and compared with the
reciprocals of the chart compilation scales. If for example the current Display Scale is 1:10000
(reciprocal 10000) and the LOADSCALEFACTOR is 2 the result is 20000. Consequently, only charts
that have a compilation scale of 1:20000 or smaller (e.g. 1:30000, 1: 50000, etc.) will be loaded.
Usually float values between 0 and 20 should be used. A big LOADSCALEFACTOR has the effect that
large-scale charts will already be loaded at relatively small display scales. This can have a negative
performance impact on chart rendering but on the other hand it would provide many chart details
at small display scales.
Unfortunately, Chart Producers worldwide use different compilation scale policies. This makes it
difficult to define an optimal LOADSCALEFACTOR parameter. Hence the effect can differ from one
geographic region to another. The recommended default value is 1.5.
To deactivate this loading mode and use the Load by Usage instead, the LOADSCALEFACTOR
parameter must be set to 0.

Load by Usage
To use this mode in the chartserver.ini file LOADSCALEFACTOR parameter must be set to 0 (“do not
use Load by Scale method”). Then with the scale-usage settings it can be defined at which display
scale charts of a certain usage are used. For instance, with the given values charts with the usage
“General” will be loaded if the display scale is greater than 1:1.000.000, e.g. 1:5.000.000.
In case chart with more details shall be displayed earlier during zoom in, the values have to be
increased.

© SevenCs GmbH 2019 35

ChartServer - Operating Manual

Usage Mode 0 (User defined) Mode 1 (7Cs – hard coded)

Default Navionics Inland
Overview 20.000.000 3.000.000 3.000.000 3.000.000
General 1.000.000 500.000 1.500.000 1.500.000
Coastal 300.000 200.000 350.000 350.000
Approach 100.000 80.000 150.000 120.000
Harbor 25.000 40.000 80.000 30.000
Berthing 10.000 10.000 60.000 12.000
River 8.000 8.000 50.000 4.000
River Harbor 4.000 4.000 30.000 1.200
River Berthing 2.000 2.000 10.000 500

6.2.3 User defined Chart Display

WMS ChartServer supports the overwriting of the S-52 lookup tables. This is controlled by the
parameter STYLES and the value “userdef”. In that case the user defined look-up tables are merged,
regardless of the selected layers or chart products. The entries of the user defined look-up tables
will overwrite any existing entry of the look-up table of the other chart products.
The names of the user defined look-up tables are asymudef.dic, lsymudef.dic and psymudef.dic,
located in %WMSCHARTSERVER_LIB%\env\lib\preslib4\lookup.

Note:
For the compilation of user defined look-up tables a profound knowledge of the syntax of S-52 look-
up tables is required. Please contact SevenCs for possible introduction to the S-52 look-up tables.

6.2.4 Tiling

In case WMS ChartServer is used within systems which clients make use of tiling/caching it is
advised to split the request into one for the tile generation and one for the un-tiled overlay. This
can be achieved by using the object filters.
Tiled: OBJECTGROUP=TILE
Un-tiled: OBJECTGROUP=TILE and OBJECTFILTERNEGATION=true
In addition, the drawing of fixed center symbols should be switched on by means of the key
FIXEDCENTER in the chartServer.ini file.

36 © SevenCs GmbH 2019

 ChartServer - Operating Manual

6.2.5 Joint Chart Display

The different chart products are handled by means of different layers. A joint display of different
chart products in one view can be achieved by two strategies:
1. “Layer by Layer” i.e. define the chart order by means of the order of layer name in the LAYERS
parameter. This is in conformance with the WMS standard.
2. “Combined” i.e. WMS ChartServer decides how to arrange the charts by means of the chart
type.

6.2.5.1 Layer by Layer

This approach is the standard WMS approach and the default procedure in WMS ChartServer. Each
layer is rendered separately and overlaid in the order which is defined by the parameter LAYERS.
Example for a joint display of ENC with VMap0 (with VMap0 Eurasia test data):
http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC,VMAP0&CRS=EPSG:4326&BBOX=7.8,53.6,9.6,
54.2&WIDTH=1280&HEIGHT=800&FORMAT=image/png

6.2.5.2 Combined

This approach should be used if ENCs are mixed with AML or special overlay charts like CIO+
Environmental. Those charts influence each other and should not be handled individually. With the
combined mode WMS ChartServer controls the rendering of all layers.
Example for a joint display of ENC with AML (with UKHO AML 2.1 test data):
http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC,AML_ALL&CRS=EPSG:4326&BBOX=-1.8,50.4,-
0.6,50.8&WIDTH=1280&HEIGHT=800&CSVALUE=,,,,,,,,,,1&FORMAT=image/png

This method is used in the ChartViewer tool as well.

6.2.5.3 Alpha blending for CIO+

On Windows alpha blending technique can be used to control the degree of transparency of CIO+
overlays. For this purpose, the parameter OverlayAlphaBlend can be used. It takes integer values
between 0 – 255 (0 = full transparency, 255 = no transparency). The parameter OverlayAlphaBlend
can be edited in the chartserver.ini file. The default value is 64 (appr. 75% transparency).
Alpha blending can be switched off by setting OverlayAlphaBlend=0. In this case ChartServer will
use the “4-pixel square” method of transparency handling (also referred to as stippled fill or pseudo
transparency).

Note:
Alpha blending is not supported by Linux versions of WMS ChartServer. Hence in the chartserver.ini
file the parameter OverlayAlphaBlend must be set to 0.

© SevenCs GmbH 2019 37

ChartServer - Operating Manual

6.2.6 Chart Products

All S-57 based products, i.e. ENC, IENC, AML, the VPF based products, i.e. DNC and VMap and the
ARINC aviation charts are displayed by means of the IHO S-52 Presentation mechanisms, i.e. the
display follows the S-52 presentation rules.
For a general description of the supported chart products please refer to Annex C – Chart Products.

6.2.6.1 ENC World Data Set

With the installation of WMS ChartServer the SevenCs world data set will be installed as well. This
world data set is defined as ENC and covers the ENC usages 1 (overview) and 2 (general). The
individual charts can be identified by the first three characters of the file name which are either 7C1
or 7C2.
The same data set is also installed as Layer NENC, identifiable by the first two characters 1I. In case
of worldwide coverage of official ENCs it is advised to use this layer for very small scales or zoom
levels, e.g. from zoom level 0 to 6.

6.2.6.2 Inland ENC - IENC

IENC are usually provided as usage 7 (river). For Inland application it is proposed to increase the
scale-usage values (please refer to chapter 6.2.2.6 Scale-Usage Settings), otherwise it will be
required to zoom in very deeply until Inland ENCs are loaded and displayed.

6.2.6.3 AML

AML data are always displayed in the simplified mode. I.e. a switch to the traditional mode will not
make any difference in the chart display.
The layer AML_ALL includes all available AML layers including AML_3. Therefore, the display of AML
1.o or AML 2.1 data slightly changes if the layer AML_ALL is used compared to individual layers of
AML 1.0 and 2.1 only.

6.2.6.4 Navionics ENC - NENC

NENC are treated as an independent ENC layer. NENC are provided as usage 3 (coastal) and 5
(harbor) only. In case NENC and official ENC are installed for the same area it is advised to only
request ENC or NENC.
The density and resolution of chart information in NENC is much higher than in ENC. To avoid
performance loss it is advised to switch to the custom scale-usage table in the chartServer.ini file
(6.2.2.6 Scale-Usage Settings). In addition it might be helpful to enable the indication of the chart
boundaries, so that the user is aware of the availability of big scale charts. The indication of chart
boundaries can be defined either in the chartServer.ini file with the key

38 © SevenCs GmbH 2019

 ChartServer - Operating Manual

[CHART]ShowChartBoundaries or for individual definition in the URL by means of the extended

WMS parameter CSBOOL (6.1.5.1 On/Off Chart Settings).

6.2.6.5 ARINC

The level of detail of ARINC aviation charts can be influenced by the so-called display category, i.e.
the value number 6 of the CSVALUE parameter.
Display Base Only low altitude airspaces, airways and navigational aids
Display Standard Low and high altitude airspaces, airways and navigational aids
Display All All including airports

6.2.6.6 DTED

DTED (Digital Terrain Elevation Data) contain gridded elevation points, i.e. latitude, longitude and
elevation.
DTED are provided as single files covering an area of 1 by 1 degree.
There are three different levels, depending on the grid latitude spacing.
Level 0 30 arc seconds approx. 900m
Level 1 3 arc seconds approx. 90m
Level 2 1 arc second approx. 30m

DTED Level 0 and 1 should be full one degree cells, i.e. each position has a known and defined
elevation. DTED Level 2 may exist as a partial one degree cell, i.e. not all elevations are known and
defined (null-elevation).
Depending on the display scale WMS ChartServer selects the appropriate DTED level automatically,
in case more than one level exists for one location.
The color handling for the display of DTED is defined in the chartServer.ini file. The color values are
the hexadecimal ARGB values given as decimal values.
The color mode defines whether only the given values or their nearest values shall be taken
(ColorMode=0), or missing colors shall be interpolated (ColorMode=3) which is the default.

Example:
Colour Alpha Red Green Blue
Full opaque dark brown Dec 255 109 72 37
Hex FF 6D 48 25
Ini File 4285351973

© SevenCs GmbH 2019 39

ChartServer - Operating Manual

6.2.6.7 CIO+

CIO+ contains additional information overlays used to complement the chart image. For more
information about CIO+ please refer to chapter Annex C – Chart Products.
Also refer to chapter 6.2.5.3 Alpha blending for CIO+ to learn more about specifics regarding CIO+
transparency handling.

40 © SevenCs GmbH 2019

 ChartServer - Operating Manual

7 Chart Installation
Chart Installation is performed by separate tools, the GUI based ChartHandler or a command line
tool for automated chart installation (ENCs only)

7.1 ChartHandler
For the operation of ChartHandler please refer to the ChartHandler User’s Guide.
ChartHandler is provided as part of the WMS ChartServer package but has to be installed
independently. It can either be started by the desktop icon (Windows) or manually (Linux) with:
 ChartHandler -cfgfile=/usr/share/SevenCs/WMS_ChartServer/config/ChartHandler.ini

To avoid the output of errors and warnings use

 ChartHandler -cfgfile=/usr/share/SevenCs/WMS_ChartServer/config/ChartHandler.ini
&>/dev/null

Note:
To run ChartHandler, WMS ChartServer must have been registered successfully and started once.
For chart ordering a so-called ENC or S-63 User Permit is required. This User Permit is hardware
locked. With each new installation on a different system a new User Permit is calculated, i.e. new
chart permits are necessary.

WMS ChartServer creates a configuration file ChartHandler.ini in $WMSCHARTSERVER_LIB/config.

This file must not be edited.
WMS ChartServer can continue to run and does not have to be disabled, paused or stopped.
ChartHandler installs charts in its own chart database which is synchronized with the chart database
of WMS ChartServer after chart installation has been finished.
Before synchronization ChartHandler stops WMS ChartServer and starts WMS ChartServer again
after a successful synchronization. Therefore on Windows ChartHandler is started within the User
Access Control (UAC).

Note (Linux only):

In case ChartHandler cannot stop or start WMS ChartServer by itself, stop/start scripts are called.
The scripts are binaries which are started with root privileges. They are located in
/usr/share/SevenCs/WMS ChartServer/scripts.

7.1.1 ChartHandler – Quick chart installation steps

1. Start ChartHandler
2. Switch to the Settings tab
3. Enable Scan local path and chose the folder, e.g. the root folder of ENC_ROOT in case of ENCs
4. Switch to the Chart Loading tab

© SevenCs GmbH 2019 41

ChartServer - Operating Manual

5. Click on Scan Drives button to initiate scanning

6. When the scan process is finished and the light in the Synchronisation section turned yellow,
click on Apply Changes (This will stop ChartServer for a moment)

7.2 Automation of Chart Installation

WMS ChartServer Package is provided with a command line tool and Windows batch file / Linux
shell script to support chart installation with as little as possible user interactions. For the entire
chart installation process a Windows batch file or Linux shell script is provided.

7.2.1 Chart Installation Tool

The chart installation tool reads all necessary parameters except the chart sources from the
ChartHandler configuration file ChartHandler.ini. It is located in
C:\ProgramData\SevenCs\WMS_ChartServer\config\ChartHandler.ini on Windows and
/usr/share/SevenCs/WMS_ChartServer/config/ChartHandler.ini on Linux. This configuration file
is created by WMS ChartServer during the start process.
The main parameters read from the configuration file are:
DENCDIR: Working chart directory of WMS ChartServer
…\SevenCs\WMS_ChartServer\charts\DENC
S63USERPERMIT: S-63 User Permit, calculated by WMS ChartServer based on hardware Id
To allow chart installation during the runtime of WMS ChartServer charts are not installed in the
working chart directory of WMS ChartServer directly. The name of the given directory is extended
by “_INSTALL”, i.e. charts are installed in …\SevenCs\WMS_ChartServer\charts\DENC_INSTALL.
All parameters and chart installation logs are written to a log file, i.e.
…\SevenCs\WMS_ChartServer\log\installCharts.log.
After each installation process an inventory list is created in
…\SevenCs\WMS_ChartServer\charts\Inventory-yyyy-mm-dd.txt.

Usage:
>installcharts -s <sourcefolder> -p <permitfile>
-s <sourcefolder>: S-63 or S-57 Exchange Set, root folder of ENC_ROOT folder (Mandatory)
-p <permitfile>: S-63 permit file (Mandatory in case of S-63 Exchange set)

7.2.2 Batch Process / Shell script

Because charts are not installed into the working chart directory of WMS ChartServer the working
and installation directories have to be swapped after chart installation. For this short time WMS
ChartServer has to be stopped. To run these processes together with the chart installation a
Windows batch file is provided in

42 © SevenCs GmbH 2019

 ChartServer - Operating Manual

C:\ProgramData\SevenCs\WMS_ChartServer\scripts
and for Linux in
usr/share/SevenCs/WMS_ChartServer/scripts.

Usage:
>wms_installCharts <source folder> <permitfile>
-<sourcefolder>: S-63 or S-57 Exchange Set, root folder of ENC_ROOT folder (Mandatory)
-<permitfile>: S-63 permit file (Mandatory in case of S-63 Exchange set)

Note:
On Windows the batch script has to be started as administrator. Otherwise the WMS ChartServer
service cannot be stopped and restarted.

Steps performed by the script:

1. Copy the chart working directory DENC to DENC_INSTALL
2. Start the chart installation tool
DENC Working chart directory
DENC_INSTALL Installation chart directory with new charts
3. Stop WMS ChartServer service
4. Delete former chart backup directory
5. Rename chart working directory DENC to DENC_BACKUP
DENC_INSTALL Installation chart directory with new charts
DENC_BACKUP Backup of former working chart directory
6. Rename chart installation directory to DENC (new chart working directory)
DENC Working chart directory with new charts
DENC_BACKUP Backup of former working chart directory
7. Start WMS ChartServer service

© SevenCs GmbH 2019 43

ChartServer - Operating Manual

8 ChartViewer
WMS ChartServer is provided with a separate stand-alone chart viewing tool which works on the
same chart database than WMS ChartServer itself.

Note:
ChartViewer does not make use of the same chart product or layer approach as WMS ChartServer.
I.e. all available charts, independent of the product, are loaded and at least indicated as magenta
lines or question marks. The display of the non-ENC products AML, DNC, VMap, ARINC and DTED
data have to be switched on explicitly in the view menu.

ChartViewer can either be started by the desktop icon (Windows), by the menu entry (Windows
and Linux) or manually (Linux) with:
 ChartViewer -cfgfile=/usr/share/SevenCs/WMS_ChartServer/config/ChartHandler.ini

To avoid the output of errors and warnings use

 ChartViewer -cfgfile=/usr/share/SevenCs/WMS_ChartServer/config/ChartHandler.ini
&>/dev/null

44 © SevenCs GmbH 2019

 ChartServer - Operating Manual

9 WMS ChartServer Client

WMS ChartServer is provided with a web client, based on OpenLayers. The sources are installed in
$WMSCHARTSERVER_LIB/client.
To access WMS ChartServer remotely, just copy the client directory to any outside location and
change the web address in line 258 of $WMSCHARTSERVER_LIB/client/js/menu.js.

© SevenCs GmbH 2019 45

ChartServer - Operating Manual

10 Administration
WMS ChartServer can be administered to a certain extent by a web-based interface, the webAdmin.
It is listening on the port number defined in the chartServer.ini file.

Note:
There is no user authentication required yet. I.e. the webAdmin can be called and run without
restrictions.

Stop: WMS ChartServer will be completely stopped and cannot be started again
remotely.
Pause: Settings are written to the ini file and the connection to the chart database is
closed. WMS requests will not be answered anymore.
Disable: Settings are written to the ini file and WMS requests will not be answered anymore.
Resume: WMS ChartServer will be resumed and settings and chart database are read again.
Please note that resuming WMS ChartServer can take a few minutes in case of huge
chart databases.
Once WMS ChartServer has been stopped it can only be started again manually from either the GUI
(Windows) or the terminal (Linux).

46 © SevenCs GmbH 2019

 ChartServer - Operating Manual

11 Trouble Shooting

General
In case of problems WMS ChartServer should be started in the debug mode. To switch on the debug
mode change the key DEBUG in the chartServer.ini file to “true”. In that case WMS ChartServer will
intensively log information in
$WMSCHARTSERVER_LIB/log/WMS ChartServer_error_[date].txt.

Linux: WMS ChartServer does not not start

In case the WMS ChartServer deamon does not start or the error message
WMS ChartServer: symbol lookup error: undefined symbol: _ZN9QListData11detach_growEPii
please ensure that LD_LIBRARY_PATH is pointing to the right Qt version which is defined in the
upstart or system configuration file.
In case WMS ChartServer is started directly from the terminal please ensure that the environment
variable LD_LIBRARY_PATH is pointing to the right Qt version.

Linux: WMS ChartServer GUI, ChartHandler or ChartViewer do not start

In case the WMS ChartServerConfig, ChartHandler or ChartViewer do not start please ensure that
the environment variable LD_LIBRARY_PATH is pointing to the right Qt version. If the system finds
the right Qt version can be checked with:
 ldd /usr/bin/ChartHandler

Chart Installation (ChartHandler)

Log Files
The general start-up log file ChartHandler.log can be found in %TEMP% (Windows) or in /tmp
(Linux).
The chart installation logs can be found in %PROGRAMFILES%\SevenCs\WMS ChartServer\LOGS
(Windows) or in $HOME/LOGS (Linux).

Renaming installation directory failed, Renaming working directory failed

To let the main application further load and work on charts, ChartHandler installs charts in an
additional installation directory. By pressing “Apply Changes” the directories will be swapped. This
might fail, especially on Windows if other processes like virus scanner or Windows explorer accesses
the directories at the same time.
First Scan Drives a second time and apply changes. If that does still not work, please ensure that no
other processes access the directory %WMSCHARTSERVER_LIB%\charts.

© SevenCs GmbH 2019 47

ChartServer - Operating Manual

EcDENCCreate() failed: Error 514

7. Quit ChartHandler and main application
8. Delete DENC_INSTALL sub-directory of the chart inventory
9. Delete the catalogue file CATALOG.7CC in the sub-directory DENC of the chart inventory
10. Start main application and ChartHandler

Starting from scratch

In the worst case, i.e. if for any reasons there are no charts visible anymore please first check if
ChartViewer does not display charts either. If that is the case and in ChartHandler there are no
charts listed in the Chart Inventory, please take the following steps to bring the chart database back
to the initial status:
• Stop WMS ChartServer
• Rename %WMSCHARTSERVER_LIB%\charts\DENC directory
• Delete %WMSCHARTSERVER_LIB%\charts\DENC_INSTALL directory
• Delete %WMSCHARTSERVER_LIB%\charts\DENC_RENAME directory
• Start ChartHandler and install world overview charts from
%WMSCHARTSERVER_LIB%/charts/WorldENC
• Start WMS ChartServer

48 © SevenCs GmbH 2019

 ChartServer - Operating Manual

Annex A – Viewport Calculations

For WMS ChartServer one method to define the transformation matrix is to use the center position,
the range, and the azimuth together with a predefined Coordinate reference system (CRS). The
latter will be a Projected CRS defining a geodetic datum (ellipsoid and central meridian) and a
projection (method and parameter).
It turns out that due to the internal calculation the scale factor of the coordinate transformation
changes with the latitude of the center position when the projection method is Mercator.
This paper described a method to calculate a range so that the scale factor will be constant.

Prerequisites
To achieve the calculation, we need the following functions.
1. The projection function converting geographic coordinates into Cartesian coordinates as
defined by the CRS. We denote it: 𝑝𝑟𝑜 = 𝑓(𝜑, 𝜆). ϕ and λ are the geographic latitude and
longitude of the point to convert. The function returns a point with the coordinates
denotes as X and Y.
2. A function calculating a position in a geographic CRS that is defined by the distance and
azimuth from a given position using the geodetic line. Calculation will be done with the
ellipsoid of the CRS as a base. We denote it: 𝑜𝑟𝑡ℎ𝑜 = 𝑓(𝜑, 𝜆, 𝜌, 𝛼) where the parameters
are defined as:
a. ϕ : geographic latitude
b. λ : geographic longitude
c. ρ : range
d. α: azimuth
e. It returns a position with the coordinates ϕ and λ.
3. A function calculating the distance between the upper and lower point on the viewport in
Cartesian World coordinates. We denote it: 𝑑𝑖𝑠𝑡 = 𝑓(𝜑𝑐 , 𝜆𝑐 , 𝜌, 𝛼).
The parameters are.
ϕc : geographic latitude of the viewport center
λc : geographic longitude of the viewport center
ρ : the range of the viewport
α : the azimuth
It returns a distance in coordinates as defined by the CRS and is defined as.
𝜑1 , 𝜆1 = 𝑜𝑟𝑡ℎ𝑜(𝜑𝑐 , 𝜆𝑐 , 𝜌, 𝛼)
𝜑2 , 𝜆2 = 𝑜𝑟𝑡ℎ𝑜(𝜑𝑐 , 𝜆𝑐 , 𝜌, 𝛼 + 𝜋)
𝑋1 , 𝑌1 = 𝑝𝑟𝑜(𝜑1 , 𝜆1 )
𝑋2 , 𝑌2 = 𝑝𝑟𝑜(𝜑2 , 𝜆2 )
𝑑 = √(𝑋2 − 𝑋1 )2 + (𝑌2 − 𝑌1 )2

Algorithm
The following algorithm ensures that the scale factor will not change when the center latitude
changes. It calculates the range that has to be passed in the request.
Given parameters are:

© SevenCs GmbH 2019 49

ChartServer - Operating Manual

• Center latitude and longitude: ϕc and λc

• The azimuth: α
• The range valid for the projection center: ρ (Note this will not be the range of the
viewport)
• A projected CRS

The algorithm is:

1. Get the reference latitude and longitude from the CRS: ϕ0, λ0
2. Calculate: 𝑑0 = 𝑑𝑖𝑠𝑡(𝜑0 , 𝜆0 , 𝜌, 𝛼)
3. Set start value: 𝜌0 = 𝜌
4. Iterate:
𝑑0
𝑓 = 𝑑𝑖𝑠𝑡(𝜑
𝑐 ,𝜆𝑐 ,𝜌𝑖 ,𝛼)
𝜌𝑖+1 = 𝑓𝜌𝑖
until |𝑓 − 1| < 10−8

The last value of ρ is the result of the algorithm and can be passed to the Chart server. Usually this
algorithm iterates with only a few iteration cycles.

50 © SevenCs GmbH 2019

 ChartServer - Operating Manual

Annex B - Example Calls

To evaluate WMS ChartServer, especially the chart settings, we recommend to install the sample
charts which cover the Elbe estuary in Germany. They are located in
WMSCHARTSERVER_LIB/charts/Sample.
In case they shall be deleted again all 7C3*, 7C4*, 7C5* and 7C6* charts have to be selected in
ChartHandler.

GetCapabilities
http://localhost:8080//?VERSION=1.3.0&REQUEST=GetCapabilities

World - Pseudo Mercator

http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&CRS=EPSG:3857&FORMAT=image/png&BBO
X=-20000000,-12890914,20000000,12890914&WIDTH=1200&HEIGHT=800

GetFeatureInfo
http://localhost:8080/?VERSION=1.3.0&REQUEST=GetFeatureInfo&LAYERS=ENC&QUERY_LAYERS=ENC&I=100&J=100&
CRS=EPSG:4326&BBOX=53.8,8.4,54.1,9.2&WIDTH=1024&HEIGHT=768&Info_FORMAT=text/xml

Elbe mouth -WGS 84

http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&CRS=EPSG:4326&BBOX=53.8,8.4,54.1,9.2&W
IDTH=1280&HEIGHT=800&FORMAT=image/png

Elbe mouth, show all (IHO display category ALL) objects (proprietary parameter CSVALUE)
http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&CRS=EPSG:4326&BBOX=53.8,8.4,54.1,9.2&C
SVALUE=,,,,,3&WIDTH=1280&HEIGHT=800&FORMAT=image/png

Elbe mouth, switch on the display of lights: ((proprietary parameter CSBOOL)

http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&CRS=EPSG:4326&BBOX=53.8,8.4,54.1,9.2&C
SBOOL=1&CSVALUE=,,,,,3&WIDTH=1280&HEIGHT=800&FORMAT=image/png

Display of national text characters (Sample charts are necessary)

http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&CRS=EPSG:4326&BBOX=31.14,0.06,31.5,0.72
&WIDTH=1280&HEIGHT=800&CSBOOL=8002&CSVALUE=,,,,,3&FORMAT=image/png

Only show depth contours (proprietary parameter OBJECT)

http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&CRS=EPSG:4326&BBOX=53.8,8.4,54.1,9.2&W
IDTH=1280&OBJECT=DEPCNT&HEIGHT=800&FORMAT=image/png

Only show aids to navigation (ATON), defined in objectgroup.ini. (proprietary parameter

OBJECTGROUP)
http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&CRS=EPSG:4326&BBOX=53.8,8.4,54.1,9.2&W
IDTH=1280&OBJECTGROUP=ATON&HEIGHT=800&FORMAT=image/png

© SevenCs GmbH 2019 51

ChartServer - Operating Manual

Show all except land areas and chart boundaries (proprietary parameter OBJECT and
OBJECTFILTERNEGATION)
http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&CRS=EPSG:4326&BBOX=53.8,8.4,54.1,9.2&W
IDTH=1280&OBJECT=LNDARE,M_COVR&OBJECTFILTERNEGATION=true&HEIGHT=800&FORMAT=image/png

SevenCs proprietary Gnomonic projection

http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&CRS=AUTO2:7CS01,1,-45,45&BBOX=-
2717752,-3004157,4673538,2572079&WIDTH=1280&HEIGHT=800&FORMAT=image/png

SevenCs proprietary Stereographic projection

http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&CRS=AUTO2:7CS02,1,0,89.99999&BBOX=-
10000000,-10000000,10000000,10000000&WIDTH=800&HEIGHT=800&FORMAT=image/png

SevenCs proprietary Azimutal Equidistant projection

http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&CRS=AUTO2:7CS03,1,0,89.99999&BBOX=-
10000000,-10000000,10000000,10000000&WIDTH=800&HEIGHT=800&FORMAT=image/png

Chart Rotation
http://localhost:8080/?VERSION=1.3.0&REQUEST=GetMap&LAYERS=ENC&CRS=EPSG:3395&VIEWPORT=53.8767,8.715
2,331,2&WIDTH=1280&HEIGHT=800&FORMAT=image/png

GeoJSON request
http://localhost:8080/?VERSION=1.3.0&REQUEST=CreateFeatureList&LAYERS=ENC&OBJECT=DEPARE&CRS=EPSG:4326
&BBOX=53.82,8.46,54.05,9.1&WIDTH=1280&HEIGHT=800&FORMAT=geo+json&CLIP=true

52 © SevenCs GmbH 2019

 ChartServer - Operating Manual

Annex C – Chart Products

ENC
ENCs (Electronic Navigational Chart) are the official digital chart products for maritime navigation,
i.e. for use with an ECDIS. An ENC must conform to the S-57 Standard of the International
Hydrographic Office (IHO) before it can be certified as an ENC. Only ENCs can be used within ECDIS
to meet the performance standards of the International Maritime Organization (IMO).
ENCs are produced by the national Hydrographic Offices (HO) and are available through Regional
Electronic Navigational Chart Coordinating Centres (RENC), e.g. IC-ENC or Primar, or through UKHO.
They all distribute the ENCs further to chart agents, e.g. ChartWorld, where the ENCs finally can be
ordered.
For distribution ENCs are encrypted and digitally signed according to the S-63 Standard of the IHO.

NENC
The Navionics digital nautical charts are S-57 vector charts which are privately produced by
Navionics SpA. Navionics provides a seamless cartographic database with global coverage and is
the largest privately-owned database of its kind in the world.

IENC
IENCs (Inland Electronic Navigational Chart) are the official digital chart products for inland
navigation, i.e. for use with an InlandECDIS. An IENC is based on the S-57 format and must conform
to the IENC product specification of the International IENC Harmonization Group (IEHG) before it
can be certified as an IENC.
IENCs are produced by the national inland water authorities. IENCs are usually available free of cost
through the local authorities.

AML
AMLs (Additional Military Layers) data are special vector chart products for military purposes. The
purpose of AML is to provide a unified series of geospatial data products which can e.g. act as an
overlay to a chart display.
The AML product specifications are maintained and administered by a NATO wide initiative,
coordinated by the United Kingdom Hydrographic Office. AML data are produced and distributed
by the NATO countries themselves.
There are vector products based on the S-57 format and gridded products based on the NetCDF or
GRIB format. Unlike the gridded products the vector products are already produced by many
countries.
There are three approved versions of AML, 1.0, 2.1 and 3.0. AML 1.0 and 2.1 consist of several
independent AML vector products, which are:

© SevenCs GmbH 2019 53

ChartServer - Operating Manual

• Contour Line Bathymetry (CLB)

• Environment, Seabed and Beach (ESB)
• Large Bottom Objects (LBO)
• Maritime Foundation and Facilities (MFF)
• Routes, Areas and Limits (RAL)
• Small Bottom Objects (SBO)
In AML 3.0 the former six products are integrated into one AML 3.0 product.

DNC
DNCs (Digital Nautical Charts) are unclassified, digital vector charts containing significant maritime
features essential for safe marine navigation, similar to ENCs.
DNCs are based on the VPF format and are produced by the US National Geospatial-Intelligence
Agency (NGA) mainly for use in electronic chart display systems of the US Navy or Coastguard.

Vmap
VMap (Vector Map) are digital vector charts containing geographic and topographic land
information.
VMap are based on the VPF format and are produced by NGA. They are provided at various levels
of detail from 0 to 2, i.e. VMap0 to VMap1. VMap0 has global coverage and is available in the public
domain. VMap 1 is mainly used for military purposes.

ARINC
ARINC (Aeronautical Radio, Incorporated) 424 is a standard for the preparation and transmission of
data for assembly of airborne navigation system data bases.
ARINC data contain all necessary information for aeronautical navigation, i.e. navigational aids,
airports, airways and controlled airspaces.

ARCS
ARCS (Admiralty Raster Chart Service) are digital raster charts and published in Hydrographic Chart
Raster Format (HCRF) by UKHO. These raster charts are scanned from traditional paper charts and
are realized as a set of one or more panels. The chart itself is always the panel 0, and each inset
plan represents an additional panel. Some panels may even be split into sub-panels because of
mathematical problems in connection with the dateline or the coverage of a wide latitude range.
Following the notices to the mariners for paper charts the UKHO publishes weekly updates which
can be applied to ARCS charts.

ChartWorld Information Overlay (CIO+)

On request SevenCs can help to integrate additional user-defined information and create
respective overlays (called ChartWorld Information Overlay – CIO+) for use in ChartServer.

54 © SevenCs GmbH 2019

 ChartServer - Operating Manual

Currently CIO supports Emission Control Areas, Marine Sanctuaries, National Limits, Port
areas, and Vessel general permit area and can be extended.

© SevenCs GmbH 2019 55

ChartServer - Operating Manual

Annex D – S-57 Object Token

Object Token Object Token
Administration area ADMARE Magnetic variation MAGVAR
Airport / airfield AIRARE Marine farm/culture MARCUL
Anchor berth ACHBRT Military practice area MIPARE
Anchorage area ACHARE Mooring/warping facility MORFAC
Archipelagic Sea Lane ARCSLN Navigation line NAVLNE
Archipelagic Sea Lane Axis ASLXIS Obstruction OBSTRN
Beacon, cardinal BCNCAR Offshore platform OFSPLF
Beacon, isolated danger BCNISD Offshore production area OSPARE
Beacon, lateral BCNLAT Oil barrier OILBAR
Beacon, safe water BCNSAW Pile PILPNT
Beacon, special purpose BCNSPP Pilot boarding place PILBOP
Berth BERTHS Pipeline area PIPARE
Bridge BRIDGE Pipeline, overhead PIPOHD
Building, single BUISGL Pipeline, submarine/on land PIPSOL
Built-up area BUAARE Pontoon PONTON
Buoy, cardinal BOYCAR Precautionary area PRCARE
Buoy, installation BOYINB Production / storage area PRDARE
Buoy, isolated danger BOYISD Pylon/bridge support PYLONS
Buoy, lateral BOYLAT Radar line RADLNE
Buoy, safe water BOYSAW Radar range RADRNG
Buoy, special purpose BOYSPP Radar reflector RADRFL
Cable area CBLARE Radar station RADSTA
Cable, overhead CBLOHD Radar transponder beacon RTPBCN
Cable, submarine CBLSUB Radio calling-in point RDOCAL
Canal CANALS Radio station RDOSTA
Cargo transhipment area CTSARE Railway RAILWY
Causeway CAUSWY Rapids RAPIDS
Caution area CTNARE Recommended route centerline RCRTCL
Checkpoint CHKPNT Recommended track RECTRC
Coastguard station CGUSTA Recommended Traffic Lane Part RCTLPT
Coastline COALNE Rescue station RSCSTA

56 © SevenCs GmbH 2019

 ChartServer - Operating Manual

Contiguous zone CONZNE Restricted area RESARE

Continental shelf area COSARE Retro-reflector RETRFL
Control point CTRPNT River RIVERS
Conveyor CONVYR Road ROADWY
Crane CRANES Runway RUNWAY
Current - non - gravitational CURENT Sand waves SNDWAV
Custom zone CUSZNE Sea area / named water area SEAARE
Dam DAMCON Seabed area SBDARE
Daymark DAYMAR Sea-plane landing area SPLARE
Deep water route centerline DWRTCL Shoreline Construction SLCONS
Deep water route part DWRTPT Signal station, traffic SISTAT
Depth area DEPARE Signal station, warning SISTAW
Depth contour DEPCNT Silo / tank SILTNK
Distance mark DISMAR Slope topline SLOTOP
Dock area DOCARE Sloping ground SLOGRD
Dredged area DRGARE Small craft facility SMCFAC
Dry dock DRYDOC Sounding SOUNDG
Dumping ground DMPGRD Spring SPRING
Dyke DYKCON Straight territorial sea baseline STSLNE
Exclusive Economic Zone EXEZNE Submarine transit lane SUBTLN
Fairway FAIRWY Swept Area SWPARE
Fence/wall FNCLNE Territorial sea area TESARE
Ferry route FERYRT Tidal stream - harmonic prediction TS_PRH
Fishery zone FSHZNE Tidal stream - non-harmonic prediction TS_PNH
Fishing facility FSHFAC Tidal stream - time series TS_TIS
Fishing ground FSHGRD Tidal stream panel data TS_PAD
Floating dock FLODOC Tide - harmonic prediction T_HMON
Fog signal FOGSIG Tide - non-harmonic prediction T_NHMN
Fortified structure FORSTC Tide - time series T_TIMS
Free port area FRPARE Tideway TIDEWY
Gate GATCON Top mark TOPMAR
Gridiron GRIDRN Traffic Separation Line TSELNE
Harbour area HRBARE Traffic Separation Scheme Boundary TSSBND
Harbour facility HRBFAC Traffic Separation Scheme Crossing TSSCRS

© SevenCs GmbH 2019 57

ChartServer - Operating Manual

Hulk HULKES Traffic Separation Scheme Lane part TSSLPT

Ice area ICEARE Traffic Separation Scheme Roundabout TSSRON
Incineration area ICNARE Traffic Separation Zone TSEZNE
Inshore traffic zone ISTZNE Tunnel TUNNEL
Lake LAKARE Two-way route part TWRTPT
Land area LNDARE Underwater rock / awash rock UWTROC
Land elevation LNDELV Unsurveyed area UNSARE
Land region LNDRGN Vegetation VEGATN
Landmark LNDMRK Water turbulence WATTUR
Light LIGHTS Waterfall WATFAL
Light float LITFLT Weed/Kelp WEDKLP
Light vessel LITVES Wreck WRECKS
Local magnetic anomaly LOCMAG
Lock basin LOKBSN
Log pond LOGPON

58 © SevenCs GmbH 2019

 ChartServer - Operating Manual

Annex D – ENC Legend

Depths, Tides, Currents

Dredged area Soundings

Unsurveyed area Depths areas

Safety contour Tidal stream (ebb stream)

Tidal stream (flood stream)

Buildings

Bridge Overhead cable

Railway Road

Tunnel Built-up area (Town City etc.)

Production/storage area Airport, airfield

Natural Shapes, Coastlines

Coastline (marshy shore) Coastline

Lake area Sloping ground (dunes, hills)

Slope topline Land elevation

Vegetation (general) Vegetation (grassland)

Vegetation (mangrove) Vegetation (mixed)

Shipping Routes, Radar, Seabed

Navigational line/recommended
Ferry route
track
Navigational line
Recommended track
(as transit, clearing line

© SevenCs GmbH 2019 59

ChartServer - Operating Manual

Traffic separation scheme

Traffic separation scheme
(lane part)

Traffic separation scheme Traffic separation scheme

(boundary) (separation zone)

Deep water route Deep water route centreline

Inshore traffic zone

Radar line Seabed area (nature of seabed)

Offshore

Submarine cable Cable area

Pipeline

Areas, Boundaries

Restricted area
Restricted area (fishing prohibited)
(anchoring prohibited)

Restricted area (nature reserve) Military practice area

Restricted area (entry prohibited) Cargo transshipment area

Caution area Dumping ground

Maritime jurisdiction boundaries and

limits (national territory, territorial sea, Anchorage area
exclusive economic zone)
Restricted area (dredging
Precautionary area
prohibited)
Administration area (national
Submarine transit lane
boundary)

Constructions, Ports

Pontoon River/canal

60 © SevenCs GmbH 2019

 ChartServer - Operating Manual

Dam Floating dock

Dyke Lock basin

Shoreline construction Shoreline construction (pier)

Landmarks

Temple Mosque Church, chapel

Single building (custom

Cairn Cemetery
office, harbour master, etc.)
Daymark (coloured or
Chimney Crane
white mark)

Column Radio, television mast Mast

Pylon (power transmission, Flare stack

telephone, telegraph) (on land)

Quarry Tank farm Notice mark

Production area
Refinery area
(timber yard)
Silo, tank
Radar scanner Silo, tank
(silo in general)
Fortified structure
Dish aerial Dome
(castle, fort)

Water tower Tower Radio, television tower

Production area
Windmotor Windmill
(wind farm)

Flagstaff
Sloping ground
(flagpole)

© SevenCs GmbH 2019 61

ChartServer - Operating Manual

Obstructions
Underwater rock (always Underwater rock Underwater rock
under water) (awash) (covers and uncovers)
Underwater rock as
Underwater rock of isolated danger (if
Obstruction
known depths shallower than safety
contour)
Obstruction Obstruction Obstruction of known
(foul ground) (always dry) depths
Obstruction as isolated
Non dangerous wreck
danger (if shallower than Dangerous wreck
(always under water)
safety contour)
Wreck showing any
Wreck of known depth
Wreck of known depth portion of hull or
(swept by wire drag)
super- structure
Wreck as isolated danger
(if shallower than safety contour)

Point Symbols A

Small craft facility or

Signal station Coast guard station
yacht harbour, marina
Caisson, flood barrage
Lock gate gate, dyke gate Bridge

Coast radar station

Fishing harbour Rescue station

Built-up area (city, town,

RoRo-terminal Airport, airfield
etc.)
Spring

Point Symbols B

Fog signal Radar reflector Pile

Anchorage area Anchor berth Caution area

Radar transponder
Berth (with name) Pilot boarding place
beacon

Deviation dolphin Land area Mooring facility

point symbol with Fishing facility (fish

Offshore platform
additional information trap)

62 © SevenCs GmbH 2019

 ChartServer - Operating Manual

Fishing facility (fishing

Fishing facility Marine farm/culture
stake)

Distance mark Hulk Retro reflector

Weed / kelp Sand waves Water turbulence

Navigational Aids

Direction of Buoyage

Beacon (unknown shape)

Buoy (unknown shape)

Mooring Buoys

Shape: barrel (ton); colour: yellow, black, unknown

Shape: super-buoy; colour: yellow, black, unknown

Shape: can (cylindrical); colour: yellow, black, unknown

Beacons and Buoys

1 2 3 4 5 6 7 8 9 10
Beacons (1 - 3) and Buoys (4 - 10): colour: unknown
1: Shape: stake pole
2: Shape: lattice beacon
3: Shape: beacon tower
4: Shape: spar (spindle)
5: Shape: can (cylindrical)
6: Shape: conical
7: Shape: pillar
8: Shape: spherical

© SevenCs GmbH 2019 63

ChartServer - Operating Manual

9: Shape: barrel (ton)

10: Shape: super-buoy

East Cardinal Marks

1 2 3 4 5 6
East cardinal marks (4, 5, 6 lighted marks):
Colour: black, yellow, black
Topmark: two cones base to base
Lights: white

North Cardinal Marks

1 2 3 4 5 6
North cardinal marks (4, 5, 6 lighted marks):
Colour: black, yellow
Topmark: two cones points upward
Lights: white

South Cardinal Marks

1 2 3 4 5 6
South cardinal marks (4, 5, 6 lighted marks):
Colour: yellow, black
Topmark: two cones points downward
Lights: white

West Cardinal Marks

64 © SevenCs GmbH 2019

 ChartServer - Operating Manual

1 2 3 4 5 6
West cardinal marks (4, 5, 6 lighted marks):
Colour: yellow, black, yellow
Topmark: two cones point to point
Lights: white

Isolated Danger Marks

1 2 3 4 5 6
Isolated danger marks (4, 5, 6 lighted marks):
Colour: black, red, black
Topmark: two black spheres
Lights: white

Starboard Hand Lateral Marks

1 2 3 4 5 6 7 8 9 10
Starboard-hand lateral marks (5, 6, 10 with topmark, 6, 7, 8 lighted, 9 starboard-hand withy):
Colour: green
Topmark: 5, 6 cone point up, 10 besom point up
Lights: green

Port-Hand Lateral Marks

1 2 3 4 5 6 7 8 9 10
Port-hand lateral marks (5, 6, 10 with topmark, 6, 7, 8 lighted, 9 porthand withy):

© SevenCs GmbH 2019 65

ChartServer - Operating Manual

Colour: red
Topmark: 5, 6 cylinder (can)
10 besom point down

Preferred Channel to Starboard

1 2 3 4 5 6 7 8
Preferred channel to starboard (5, 6 with topmark, 6, 7, 8 lighted):
Colour: red, green, red
Topmark: cylinder (can)
Lights: red

Preferred Channel to Port

1 2 3 4 5 6 7 8
Preferred channel to port (5, 6 with topmark, 6, 7, 8 lighted):
Colour: green, red, green
Topmark: cone point up
Lights: green

Safe Water Marks

1 2 3 4 5 6
Safe water marks (5, 6, 7 lighted marks):
Colour: red, white
Topmark: red sphere
Lights: white

Special Purpose Marks

66 © SevenCs GmbH 2019

 ChartServer - Operating Manual

1 2 3 4 5 6 7 8 9
Special purpose marks (7, 8, 9 lighted and with topmark):
Colour: yellow
Topmark: yellow x – shape cross
Lights: yellow

Lights Symbols

1 2 3 4
Carried by a landmark or non floating object:
1 Colour unknown
2 Colour red
3 Colour green
4 Colour yellow or white
_________________________________________________________________

1 2 3 4
Carried by a floating object or if used as leading light:
1 Colour unknown
2 Colour red
3 Colour green
4 Colour yellow or white
_________________________________________________________________

1 2 3 4 5
1 Strip light
2 Spotlight

© SevenCs GmbH 2019 67

ChartServer - Operating Manual

3 Floodlight
4 Light-float
5 Light-vessel
__________________________________________________________________

Lights with light characteristics (examples)

__________________________________________________________________

Sector lights
__________________________________________________________________

Leading lights

68 © SevenCs GmbH 2019