Skip to content

Zone Analysis Reference

This page describes the current zone-analysis contract used by Annolid's GUI and post-processing tools.

Saved Zone Contract

New zone shapes should include explicit metadata:

  • semantic_type=zone
  • zone_kind
  • phase
  • occupant_role
  • access_state

Legacy zone JSON files are still accepted when they use bounded compatibility hints, but explicit metadata is the preferred contract for new projects.

Supported Outputs

Legacy Place-Preference CSV

This is the historical output. It keeps one column per zone and is useful when you need compatibility with older scripts.

Generic Zone Metrics CSV

This output adds:

  • occupancy frames and seconds
  • dwell frames and seconds
  • entry counts
  • transition counts
  • barrier-adjacent frames and seconds
  • outside-zone counts

Assay Summary Markdown + CSV

This output explains:

  • which zones were included
  • which zones were excluded
  • which zones were accessible or blocked
  • which phase profile was used
  • which metrics were computed

Social Summary Markdown + CSV

This output is intended for social-approach assays and adds:

  • latency to first enter each social zone
  • zone dwell and occupancy using the rover-side social zones
  • door proximity based on the selected anchor point
  • pairwise centroid proximity across tracked voles
  • the anchor source used for each instance

Latency is measured from the first analyzed frame unless you supply an explicit reference frame in the Zone Analysis dialog.

Available Assay Profiles

  • Generic
  • Analyze every explicit zone without profile-specific access filtering.
  • Phase 1
  • Intended for partially blocked chamber layouts.
  • Phase 2
  • Intended for fully open chamber layouts.

The same saved zone file can produce different summaries by changing the selected profile.

Arena Presets

The Zone Dock currently includes two one-click presets:

  • 3x3 Chamber Layout
  • 3x3 Social Door Layout

The chamber preset creates nine editable chamber zones on the live canvas. The social-door preset creates rover-side approach zones around the mesh doors.

You can still:

  • rename chambers,
  • recolor them,
  • move or resize them,
  • or delete shapes you do not need.
  • Video: session.mp4
  • Zone JSON: session_zones.json
  • Generic metrics CSV: session_zone_metrics.csv
  • Assay summary Markdown: session_phase_1_assay_summary.md
  • Assay summary CSV: session_phase_1_assay_summary.csv
  • Social summary Markdown: session_generic_social_summary.md
  • Social summary CSV: session_generic_social_summary.csv
  • Pairwise centroid CSV: session_generic_social_summary_pairwise.csv

GUI Entry Points

  • Video Tools → Zones
  • open the zone dock and draw/edit zones on the current frame
  • Video Tools → Zone Analysis
  • export legacy CSV, generic metrics, assay summary, or social summary reports