About Cognoscere

Cognoscere is a sailing analytics web app for uploading, storing, and visualizing VKX race files. It is built for crews and coaches who need quick replay, race comparison, and cloud-backed file access.

Quick Start

  1. Open /cognoscere.
  2. Sign in if you want cloud storage and sharing.
  3. Upload a .vkx file by click or drag-and-drop.
  4. Choose local-only or cloud+local processing when prompted.
  5. Use play/pause, speed, and timeline controls to replay.
  6. Switch between Track, Trail, and Heat map modes.
  7. Load historical files from Select from Cloud or View Recent File.

Core Surfaces

  • Home / Upload (`/cognoscere`): upload files, sign in, open shared links, load recent cloud files.
  • Map View: replay and inspect races with timeline controls and layered map visuals.

Cloud Workflow

  • Upload locally or choose to save to cloud when signed in.
  • Select files from Cloud Drive with previews and metadata.
  • Use sharing, export, rename, and map-loading tools from the file explorer.

Map Capabilities

Track, Trail, and Heat visual modes

How to switch: use the map mode controls and choose Track, Trail, or Heat.

Track: draws the full race path for the selected race so you can inspect the complete route.

Trail: shows only recent motion (default ~50s) with fading opacity, making short-term maneuvers easier to see.

Heat: plots all points as density to reveal where boats spent the most time.

Playback controls and time navigation

Use Play/Pause to animate race progress and the speed control to accelerate or slow review.

Use the time slider to scrub to exact moments. Playback automatically stops at the end of the dataset.

Boat icons, stats, and tooltips

Boat icons rotate with heading and update as time changes.

Click a boat for detailed live stats, including timestamp, SOG, COG, and VMG/leg context when available.

Use per-boat toggles to hide/show individual files while comparing races.

Start-line, lay-lines, and ladder rungs

When line-mark data exists, Cognoscere renders the start-line plus calculated lay-lines.

Optional ladder-rungs can be toggled on to help assess angle and spacing references.

Weather and map style controls

Weather overlays are sourced from Open-Meteo (historical or forecast context by dataset time).

Use the style toggle to switch between base map and satellite view while preserving race overlays.

Get in Touch

Have a question, concern, or feature request? Reach out at liam@telltalesolutions.com.au