SoundMapper4D Demo Data
======================

3-minute extract from the OSBS (Ordway-Swisher Biological Station) dataset.
10 mono WAV files (16 kHz, 16-bit) from 5 recorders (lower + upper mics).
Contains 4 bird playback events: Chimney Swift, Chuck-will's-widow,
Common Nighthawk, and Downy Woodpecker.
Location: Ordway-Swisher Biological Station, Putnam County, Florida, USA
          (~29.692 N, 81.992 W)
		  
Date: 01/25/2019		  

Files in this ZIP
-----------------
  demo_mic*_lower.wav    -- lower mic on each recorder (mono WAV)
  demo_mic*_upper.wav    -- upper mic on each recorder (mono WAV)
  demo_mic_positions.csv -- mic GPS positions, ready to upload (see below)


How to run a full analysis with this data
------------------------------------------
1. Extract this ZIP.
2. Open SoundMapper4D and click "Upload Recordings".
3. Choose the "Upload GPS CSV" tab.
4. Select all 10 WAV files.
5. Select demo_mic_positions.csv as the Mic Position CSV.
6. Click Analyze.

That's it. The CSV already has every microphone's filename, GPS coordinates,
and channel — nothing else to fill in.


demo_mic_positions.csv columns
-------------------------------
  filename      Name of the .wav file this row applies to  (links audio → GPS)
  channel       Mono / Left / Right
  lat           Latitude,  decimal degrees WGS84
  lon           Longitude, decimal degrees WGS84
  elevation_m   Microphone height above sea level, metres

  start_time is optional (ISO 8601 UTC). Leave blank if recorders were
  GPS-synced or if you only need species ID without precise TDOA sync.


Understanding the RESULTS CSV (output — not input)
----------------------------------------------------
The downloaded results CSV contains COMPUTED columns — the system calculates
these; you do not provide them:

  lat / lon       Estimated position of the detected bird (decimal degrees)
  northing /
  easting         Same position in UTM metres
  height          Estimated bird elevation above ground (metres)
  species_1       Top BirdNET species identification
  confidence_1    BirdNET confidence score (0-1)
  uncertainty_h   Horizontal position uncertainty radius (metres, 1-sigma)
  uncertainty_v   Vertical   position uncertainty       (metres, 1-sigma)
