Skip to content
finwave Docs

Encounters

What you’ll learn

Section titled “What you’ll learn”
  • What an encounter represents in finwave
  • What metadata is associated with an encounter
  • How encounters relate to individuals and annotations
  • How encounter status is tracked

What is an encounter?

Section titled “What is an encounter?”

An encounter is a collection of photographs from a single observation event at a specific time and location. It is the fundamental unit of data in finwave — everything else (annotations, identifications, individual sighting histories) flows from encounters.

Each encounter represents one field observation. A whale-watching trip that produces 200 photos at one location on one date is one encounter. If the same trip stops at two locations, those become two encounters.

Encounter metadata

Section titled “Encounter metadata”

Every encounter carries the following metadata:

  • Date — when the encounter took place
  • Location — where the encounter took place (name and coordinates)
  • Photographer — who captured the images
  • Images — the photographs associated with the encounter
  • Organization — optionally, the organization under which the encounter was submitted

Additional optional metadata includes behavioral observations, predation event flags, prey information, and notes.

Status indicators

Section titled “Status indicators”

Encounters display status indicators that provide a quick visual summary.

Analysis status

Section titled “Analysis status”
  • Complete (green) — ML analysis has finished and results are available
  • In progress (yellow) — analysis is currently running
  • New (red) — the encounter has been uploaded but analysis has not started

Encounter completeness

Section titled “Encounter completeness”
  • Complete — all individuals present during the encounter were photographed
  • Incomplete — not all individuals present were photographed
  • Unknown — it is not known whether all individuals were photographed

This distinction matters for population analysis. Complete encounters are more valuable for mark-recapture models because absence from a complete encounter is informative (the individual was genuinely not present), while absence from an incomplete encounter is ambiguous.

Predation events

Section titled “Predation events”

An encounter can be flagged as a predation event, which adds a predation icon to the encounter card. This is used to track predation observations as part of behavioral and ecological monitoring.

License and visibility

Section titled “License and visibility”

Each encounter has visibility and license settings:

  • Public / Creative Commons — shared publicly with a Creative Commons license
  • Non-commercial — available for non-commercial use only
  • Attribution required — the photographer must be credited
  • Private — visible only to members of the submitting organization

How encounters connect to individuals

Section titled “How encounters connect to individuals”

When images in an encounter are processed — either by finwave’s ML models or by human annotators — annotations are placed on identified features (typically dorsal fins). Each annotation can be linked to an individual in the population catalog. This creates a sighting record: individual X was seen in encounter Y.

A single encounter can contain sightings of multiple individuals. An individual can appear in many encounters over time. This many-to-many relationship between encounters and individuals is what makes population-level analyses possible.

Section titled “Related”