manimaul/njord

Open Source Electronic Navigation Chart Server

Njord

Status: This project is still very much a WORK IN PROGRESS.

Live Demo: https://openenc.com

Marine Electronic Navigational Chart (ENC) Server

Njord consumes S-57 IHO transfer standard for digital hydrographic data. S-57 format chart data is published by hydrographic offices such as NOAA. https://www.charts.noaa.gov/ENCs/ENCs.shtml

Njord displays ENC charts but does NOT strictly follow the IHO S-52 specifications for chart content and display.

S-52 display and S-57 data standards can be found here: https://iho.int/en/standards-and-specifications

---

Development System Requirements

• OpenJDK 17
• Gdal 3.6.2 with Java bindings
  • Note: Homebrew Gdal does not come with Java bindings and the osgeo tap is broken. See docs/gdal/README.md for building gdal from source with java via brew.
• PostGIS 13
  • See chart_server_db/README.md for running PostGIS in a container for development.

---

Local Development Quick Start

Bring up database

cd chart_server_db
docker-compose up

Bring up api

./gradlew :chart_server:run

Brin up front end with hot-reload

cd chart_server_fe
npm start

---

Docs

System Design Notes

njord's Issues

Priority Rules

Basic nmea input/output rule engine

Is this Zoom calculation incorrect?

For example, at level 10, the upper part is not displayed, but it is displayed at level 11. They should be displayed simultaneously. Is this a problem with incorrect level calculation？

s57 update files

Hello, does this project support updating s57 update files, such as. 001 . 002, etc. If not, will this function be added in the future

RTL-SDR Ais

Integrate with RTL-SDR to serve AIS https://github.com/manimaul/rtl-ais

option1: call directly into via JNI
option2: connect via TCP via loopback (see #5 )
option3: fifo / pipe
http://man7.org/linux/man-pages/man7/fifo.7.html
http://man7.org/linux/man-pages/man7/pipe.7.html

pagination on chart catalog

https://openenc.com/control/charts and https://openenc.com/chart/2
response(s) and ui should support pagination

Master branch CI deployment

Github Action

Chart Symbol - Base Set

Create rendering rules for the following base set of features.

• bridge
• cable overhead
• canal
• coastline
• conveyor
• dam
• deep water route centerline
• depth area
• dock area
• floating dock
• gate
• hulk
• ice area
• land area
• lock basin
• log pond
• mooring/warping facility
• obstruction
• offshore platform
• oil barrier
• pontoon
• pylon/bridge support
• shoreline construction
• cartographic area
• notice mark
• harbour basin
• lock basin part
• exceptional navigation structure

Chart Symbols - Standard Set

Create rendering rules for the following standard set of features (the "base set" should be complete before this).

• airport / airfield
• anchor berth
• anchor
• anchorage area
• beacon cardinal
• beacon isolated danger
• beacon lateral
• beacon safe water
• beacon special purpose/general
• building single
• building religious
• built-up area
• buoy cardinal
• buoy installation
• buoy isolated danger
• buoy lateral
• buoy safe water
• buoy special purpose/general
• cable area
• cable submarine
• cargo transshipment area
• causeway
• caution area
• chain/wire
• crane
• daymark
• deep water route part
• dredge area
• dumping ground
• dyke
• fairway
• fence/wall
• ferry route
• fishing ground
• fog signal
• fortified structure
• gate
• hulk
• incineration area
• inshore traffic zone
• lake shore
• land region
• landmark
• light
• light extinguished
• light float
• light vessel
• marine farm/culture
• military practice area
• monument
• navigation line
• offshore production area
• pile
• pilot boarding place
• pipeline area
• precaustion area
• production / storage area
• radar line
• radar range
• radar reflector
• radar transpoder beacon
• radio calling-in point
• recommended route centerline
• recommended track
• recommended traffic lane part
• restricted area
• retro-reflector
• river
• runway
• sand waves
• sea area / named water area
• sea-plane landing area
• signal station traffic
• signal station arning
• silo / tank
• slopeing ground
• submarine transit lane
• swept area
• text
• topmark
• tower
• traffic separation line
• traffic separation scheme boundary
• traffic separation scheme crossing
• traffic separation lane part
• traffic separation roundabout
• traffic separation separation zone
• tunnel
• two-way route part
• unsurveyed area
• zero meter contour
• new object
• navigational system of marks
• cartographic symbol
• text
• bunker station
• beacon water-way
• buoy water-way
• refuse dump
• terminal
• turning basin
• waterway guage
• vehicle transfer
• annotation
• general boundary
• traffic line
• general navaid

Chart Object Query

Add ability to query chart objects under the cursor and list them in a dialog.

Fix upload errors

Kotlin SPA / FE Tooling

Setup a front end module using KotlinJS & React that builds SPA (single page application) artifacts.

TCP Client

Configurable TCP nmea client

Tiles respond slowly

This may not be a good method because it will traverse and query the entire features table, which may cause tile generation to be abnormally slow.

njord/chart_server/src/main/kotlin/io/madrona/njord/db/FeatureDao.kt

Line 48 in 73e3946

conn.prepareStatement("SELECT DISTINCT layer FROM features WHERE (props->'LNAM_REFS')::jsonb ?? ?;").apply {

pagination on chart layer locations

example https://openenc.com/layer/PILPNT
response(s) should be paginated

Latitude Distortion

Verify that we don't need to account for latitudinal distortion in ZFinder when we calculate the zoom for scamin / scamax.

https://github.com/manimaul/njord/blob/master/chart_server/src/main/kotlin/io/madrona/njord/util/ZFinder.kt#L16

Debian Package

Layer Symbol Configuration Rules | Question

Hello, I would like to ask how do you know the layer configuration rules, such as how to determine what properties and symbols to configure for this light.

njord/chart_server/src/main/kotlin/io/madrona/njord/layers/Lights.kt

Line 20 in 05712dc

Color.White -> feature.pointSymbol(Sprite.LIGHTDEF1)

Basic routing

Basic nmea data routing rule engine

Colorize Icons

See SDF
https://maplibre.org/maplibre-style-spec/sprite/

Convert hpgl to svg

Control Plane

gRPC Control Plane - enable dashboard capability

Replace S57 object attribute CSV files with json

s57objectclasses.csv
s57expectedinput.csv
s57agencies.csv

S52 symbol

From this fileS-52_PresLib Ed 4.0.3 Part I Addendum_Clean.pdf it can be seen that there are many s52 symbols, and drawing them one by one will take a major expenditure of time and effort.

The chartsymbols.xml file contains hpgl vector icon information and related attributes. I tried to convert hpgl to png, and it failed. But why can opencpn read it?

Do you have any other ways to obtain symbols?

https://github.com/manimaul/njord/tree/master/docs/reference_material/hpgl

Add chart information to object query.

Chart id can be appended to property metatdata.

Raspberry Pi - Image

FERYRT - linestring bug

Find out if LineString is present in Chart 18448 and investigate why it is being excluded.

Chart 18453, Chart 18448

Upload components

replace upload functionality with react component(s)

S57 Symbol Library WebUI

Create a web application page similar to
http://www.s-57.com/ that catalogs S57 objects and their attributes.

Catalog should visualize the symbol based on input.

Add license

apache 2

Authentication

Remove Gdal Dependence

Move gdal out of web application and into new CLI tool.

pi setup automation

Script Inputs

• pi ip address
• password to configure pi wifi AP with
• pi user password to set

Requirements:

• pi with (Raspbian Buster Lite) https://www.raspberrypi.org/downloads/raspbian/
• ssh turned on
• pi connected to internet via eth0 cable

Script Actions

• Configures Pi & Njord
  • connects to vanilla raspberry pi with ssh setup
  • configures pi to be wifi AP
  • installs Njord
• Makes image from Pi https://www.raspberrypi.org/forums/viewtopic.php?t=207403
• Finds PI on network via nmap

Simplify symbols

We want a greatly simplified chart symbol set useful for recreational use. Create a minimal set of SVG based chart symbols and script to compile sprite sheet and sprite json.

Our current sprites
https://s57dev.mxmariner.com/v1/app/control/sprites

Use NOAA chart 1 (symbols) to distill symbols down to a much smaller set.
https://nauticalcharts.noaa.gov/publications/docs/us-chart-1/ChartNo1.pdf

Fall back to S52 when necessary:
https://github.com/manimaul/njord/blob/master/docs/s52-standard-ed6.1.1.pdf

Web Content Root

Serve /v1/content from filesystem rather than class path resources. This will make iterative web development faster by removing a compilation requirement.

Client Library

Why does the map offset when zooming out?

Hello, thank you very much for this project. However, I've got the problem in the picture. As shown in the picture, why does the map offset when I zoom in and out. Do you have any solution ? Thanks in advance.

natural earth data base map