Technical documentation

How to use OCEASTRA services, API formats and deployment notes.

Getting access

All interactive services (Noise Estimation, Airgun Estimation) require a registered account. Create an account with email/password or sign in with Google, GitHub or Microsoft when configured by your administrator.

Noise Estimation (web UI)

After signing in, open Noise Estimation. The full MNAT interface provides:

• Sea area — select a predefined sea region and use live AIS vessels
• Custom box — draw or enter lat/lon bounds
• API — browse and load a JSON snapshot (one timestamp, multiple vessels)

Click Start Process to run Bellhop transmission-loss estimation (if no model exists), train the ML model, and predict per-vessel noise. Use depth controls and the heatmap layer; download the combined JSON when complete.

JSON request format (API mode)

{
  "request_id": "snapshot-001",
  "timestamp": "2026-06-28T08:00:00Z",
  "area_box": {
    "min_lat": 45.0, "max_lat": 45.2,
    "min_lon": 12.7, "max_lon": 12.95
  },
  "processing": {
    "frequency_hz": 100,
    "depth_min_m": 0, "depth_max_m": 50,
    "depth_step_m": 5,
    "grid_spacing_deg": 0.02,
    "propagation_model": "bellhop"
  },
  "vessels": [
    {
      "user_id": 247341800,
      "ship_type": 70,
      "dimension_a": 100, "dimension_b": 20,
      "dimension_c": 10, "dimension_d": 8,
      "max_static_draught": 6.1,
      "name": "VESSEL_ONE",
      "latitude": 45.10, "longitude": 12.80,
      "sog": 12.0, "cog": 45.0
    }
  ]
}

Batch REST API

Programmatic jobs (same payload) are available at:

• POST /api/jobs — submit JSON body
• GET /api/jobs/{id} — poll status
• GET /api/jobs/{id}/result — download heatmap JSON

OpenAPI reference: /docs (Swagger UI — auto-generated).

Result format

Exported files contain { "data": [ { "Latitude", "Longitude", "Depth", "Value" }, ... ] } where Value is received noise level in dB re 1 µPa.

Propagation stack

• Bellhop (Acoustics Toolbox) for ray-based transmission loss
• GEBCO bathymetry and WOA sound-speed profiles
• Stacking regressor (RF + GB + meta) per area/frequency/grid
• Vessel source levels from AIS dimensions, type and speed

Support

Contact [email protected] for enterprise deployment, OAuth setup and SLA options.