Cookbooks // Marine Communications & GIS
Maritime Communication Zones & MapLibre GL Modeling
Marine autonomous vessels and sensor platforms operate across diverse radio frequency and satellite modalities. This recipe models physical reach, throughput, and latency across nine maritime communication technologies, exporting GeoJSON FeatureCollections and MapLibre GL vector style specifications.
GitHub Source & Cookbooks Directory
The complete GeoJSON generation script, MapLibre style JSON, and sample geospatial layers are available in the repository:
Nine Maritime Communication Modalities
Terrestrial AIS (VHF 161.975/162.025 MHz) out to 25 to 45 NM, plus LEO Satellite AIS tracking globally with TDMA slot collision handling.
GPS/Galileo/GLONASS with WAAS/EGNOS sub-meter augmentation, Coast Guard DGNSS beacons, and fjord cliff multi-path degradation modeling.
SOLAS Sea Areas A1 (VHF DSC 20 to 30 NM), A2 (MF 2187.5 kHz 100 to 150 NM), A3 (Inmarsat/Iridium global satellite), and A4 (polar HF DSC).
LEO constellations (Starlink Maritime, OneWeb) delivering 25 to 55 ms latency, compared with GEO VSAT (Inmarsat Fleet Xpress, 550 to 750 ms latency).
4G-LTE and 5G low-band (600/700 MHz) with extended timing advance, providing 15 to 100 Mbps out to 15 to 25 nautical miles offshore.
License-free 915 MHz LoRa chirp spread spectrum (-137 dBm sensitivity) providing 10 to 25 km multi-hop coverage between autonomous surface craft.
Line-of-sight voice and DSC radiotelephony (156 to 162 MHz) transmitting at 25 W with 20 to 35 NM range, vulnerable to fjord terrain shadowing.
518 kHz direct-printing groundwave broadcasts that follow seawater curvature, reaching 200 to 300 NM offshore with navigational warnings.
Maritime UHF frequencies (457 MHz) penetrating steel bulkheads for on-board maneuvers, mooring drops, and short-range tender operations (2 to 5 NM).
Propagation Physics Formulation
- Radio Horizon (4/3 Earth Curvature): Accounts for downward atmospheric refraction along the curvature of the sea:D_horizon (km) = 3.57 * (sqrt(h_tx) + sqrt(h_rx))
- Two-Ray Seawater Path Loss: Calculates free-space spreading loss up to the critical Fresnel breakpoint distance, transitioning to fourth-power asymptotic loss over conductive seawater.
- Geostationary Elevation Cutoff: Models VSAT signal loss when satellite look angles drop below 7 degrees elevation in high-latitude fjords.
MapLibre GL JS Styling & GeoJSON Generation
The comm_zones_geojson.py script compiles transmitters and coverage boundaries into standard GeoJSON FeatureCollections:
from comm_zones_geojson import (
generate_transmitter_features,
generate_coverage_polygon_features,
export_geojson,
)
# Generate transmitter points and coverage polygons
transmitters = generate_transmitter_features()
coverage_polygons = generate_coverage_polygon_features()
export_geojson(transmitters, "./marine_communication_transmitters.geojson")
export_geojson(coverage_polygons, "./marine_communication_zones.geojson")
print(f"Exported {len(transmitters)} transmitters and {len(coverage_polygons)} coverage zones.")Adding Layers to MapLibre Map
Incorporate the layers into any MapLibre GL map instance using the provided style specification:
map.on('load', () => {
map.addSource('comm-zones', {
type: 'geojson',
data: '/data/marine_communication_zones.geojson'
});
map.addLayer({
id: 'comm-zones-fill',
type: 'fill',
source: 'comm-zones',
paint: {
'fill-color': ['get', 'fill_color'],
'fill-opacity': ['get', 'fill_opacity']
}
});
});