# V35 active-registry notice

V35 loads `assets/v35-data.js`: six species, 27 calls and 17 campaign stages. TUOC is intentionally excluded from active gameplay. Original recordings, annotations, point-cloud bytes and legacy data are retained. Any older seven-species/pending-control discussion below documents the inherited source, not V35's active menu or roster. The raw recording is now the default.

---

# AVE DOJO V34 data notes

## Scope

V34 combines the supplied AveRosetta V20 Trial 91 point-cloud/audio package, the supplied vocalization posterior/cluster table, and the uploaded AVE DOJO visual assets. The implementation does not silently invent a sound or recorded location when the source package lacks one.

## Data inventory

- Registered focal species: **7**
- Species with authenticated Trial 91 audio/events: **6**
- Source-data-pending species: **1** (`TUOC`)
- Structured call definitions: **29**
- Authenticated Trial 91 call events used by V34: **474**
- Events with direct event-level horizontal spatial estimates: **460**
- Progressive campaign stages: **20**
- Full point-cloud returns: **1,546,233**
- Mobile research-visualizer returns: **61,251**
- Trial 91 audio duration: **709.049604 s**
- Derived ambient-bed duration: **60.0065 s**

## Focal species and persistent representative locations

Coordinates retain the V20 observer-relative convention: `xLeft` is lateral position, `yForward` is forward distance, and `heightAGL` is height above ground. Means are calculated from the authenticated V20 Trial 91 events for each species.

| Code | Common name | Scientific name | Events | Call definitions | Mean xLeft | Mean yForward | Mean height AGL | Horizontal n | Status |
|---|---|---|---:|---:|---:|---:|---:|---:|---|
| HARU | Red-crowned Ant-Tanager | *Habia rubica* | 160 | 5 | -0.215822 | 1.214318 | 3.9871 m | 156 | authenticated |
| THAR | Dusky-throated Antshrike | *Thamnomanes ardesiacus* | 39 | 6 | -0.006786 | 1.016230 | 3.8347 m | 35 | authenticated |
| MYAX | White-flanked Antwren | *Myrmotherula axillaris* | 20 | 4 | 0.123441 | 1.113461 | 5.2117 m | 18 | authenticated |
| MYME | Gray Antwren | *Myrmotherula menetriesii* | 57 | 6 | 0.192767 | 1.044253 | 9.1366 m | 57 | authenticated |
| LAVE | White-winged Shrike-Tanager | *Lanio versicolor* | 179 | 5 | -0.126918 | 1.121766 | 11.8218 m | 178 | authenticated |
| MYSC | Sclater's Antwren | *Myrmotherula sclateri* | 19 | 1 | -0.314580 | 0.955903 | 13.7500 m | 16 | authenticated |
| TUOC | Tawny-crowned Greenlet | *Tunchiornis ochraceiceps* | 0 | 2 | — | — | — | 0 | posterior table only; authentic Trial 91 source pending |

The source registry retains a historical provisional TUOC display slot, but V34 does not use it as a measured scene anchor. TUOC stays pending until authentic audio and a representative location are supplied.

## Risk-state system

The risk-state system uses:

| State | Interpretation | Base color |
|---:|---|---|
| 1 | Imminent threat | red |
| 2 | High risk | orange |
| 3 | Transition / recovery | green |
| 4 | Normal / safe foraging | blue |

Each call definition stores:

- cluster;
- mean time;
- risk period;
- posterior state;
- posterior probability;
- kurtosis, skewness, and IQR when supplied;
- a four-state probability-vector object;
- source label indicating whether the value came from the supplied posterior table or a visibly labeled Trial 91 fallback.

The interface computes risk-control color by blending the base state color toward neutral grey as posterior probability declines. Species icon/location colors are separate and never overwritten by risk colors.

## Call definitions

| Call | Samples | Posterior state | Posterior p | Training tier | Audio status |
|---|---:|---:|---:|---|---|
| HARU-S1 | 10 | 2 | 0.59 | intermediate | Trial 91 exemplar |
| HARU-A1 | 2 | 1 | 0.75 | advanced | Trial 91 exemplar |
| HARU-A2 | 9 | 1 | 0.75 | advanced | Trial 91 exemplar |
| HARU-C1 | 104 | 1 | 0.42 | advanced | Trial 91 exemplar |
| HARU-C2 | 35 | 1 | 0.42 | advanced | Trial 91 exemplar |
| THAR-B1 | 7 | 4 | 0.86 | introductory | Trial 91 exemplar |
| THAR-SC1 | 3 | 4 | 0.98 | introductory | Trial 91 exemplar |
| THAR-SQ2 | 21 | 4 | 0.68 | introductory | Trial 91 exemplar |
| THAR-SQ1 | 3 | 2 | 0.50 | intermediate | Trial 91 exemplar |
| THAR-UB1 | 4 | 2 | 0.60 | intermediate | Trial 91 exemplar |
| THAR-A1 | 1 | 1 | 1.00 | advanced | Trial 91 exemplar |
| MYAX-C1 | 7 | 3 | 0.71 | introductory | Trial 91 exemplar |
| MYAX-A1 | 5 | 1 | 1.00 | advanced | Trial 91 exemplar |
| MYAX-DC1 | 7 | 1 | 0.63 | advanced | Trial 91 exemplar |
| MYAX-DC2 | 1 | 1 | 0.63 | advanced | Trial 91 exemplar |
| MYME-CH1 | 3 | 4 | 1.00 | introductory | Trial 91 exemplar |
| MYME-S1 | 1 | 4 | 0.90 | introductory | Trial 91 exemplar |
| MYME-C1 | 35 | 3 | 0.57 | introductory | Trial 91 exemplar |
| MYME-SC1 | 1 | 3 | 0.46 | introductory | Trial 91 exemplar |
| MYME-SQ1 | 11 | 3 | 0.55 | introductory | Trial 91 exemplar |
| MYME-A1 | 6 | 2 | 0.55 | intermediate | Trial 91 exemplar |
| LAVE-C1 | 102 | 4 | 0.31 | introductory | Trial 91 exemplar |
| LAVE-C3 | 4 | 4 | 1.00 | introductory | Trial 91 exemplar |
| LAVE-C2 | 71 | 3 | 0.50 | introductory | Trial 91 exemplar |
| LAVE-S2 | 1 | 3 | 1.00 | introductory | Trial 91 exemplar |
| LAVE-A2 | 1 | 1 | 1.00 | advanced | Trial 91 exemplar |
| MYSC-S1 | 19 | 4 | 0.60 | introductory | Trial 91 exemplar |
| TUOC-S1 | 0 | 4 | 0.60 | introductory | source pending |
| TUOC-A1 | 0 | 2 | 0.78 | intermediate | source pending |

## Four-source audio registry

Every call definition includes four replaceable source descriptors:

1. `clean` — temporary focused field-derived exemplar;
2. `cleaned` — less-restrictively filtered field segment;
3. `field` — original Trial 91 field segment;
4. `composite` — focused field-derived exemplar over the derived ambient bed.

Each descriptor stores the asset, event segment, spatial location, status, and role. A later true isolated exemplar can retain the existing call ID, risk metadata, and spatial identity. Its asset loader and schedule source offsets must also be updated together; the current focus scheduler reads the bundled Trial 91 buffer.

No true isolated or source-separated recordings were supplied. Current `clean` and `cleaned` modes must therefore be interpreted as training-oriented processing of the authenticated Trial 91 field source, not as independently recorded clean exemplars.

## Point cloud and ground surface

`visualizer.html` preserves the V20 full point-cloud renderer and the three compressed full-cloud chunks. The embedded terrain remains the V20 preliminary low-envelope ground estimate. It should not be treated as a formally classified ground product.

V34 adds a game overlay/API that:

- places persistent grey or active Digiviz species markers;
- reports the full point count to the game host;
- accepts camera/orbit/risk/hawk/location messages;
- reveals the resolved source;
- produces localized light particles and highlights nearby measured returns without a circular screen-wide shell;
- leaves `visualizer-v20-original.html` available as the unmodified source interface.

## Field-state objects

At Field Mode start, the game creates one male and one female individual for each authenticated active species. Each instance tracks:

- species and sex;
- alive/lost status;
- individual health;
- whether its calls are currently eligible;
- loss and floater-replacement state.

The live field state also tracks risk state, predator risk, legitimate acoustic threat, visual threat, attack start time, health timing, and threat frequency. These are runtime objects rather than hard-coded DOM components.

## V34 timing and projection

The versioned shared module `engine-v34.js` owns schedule construction, response deadlines, full-frequency plot transforms, the fixed representative-location mapping, and camera projection. Training node positions use measured clip durations and fixed practice gaps. Expert nodes preserve original recording onsets. The clock is `AudioContext.currentTime`, held by Pause or Repeat; early answers do not move future onsets.

The complete dataset contains 1,546,233 returns. The shipped default game level of detail draws 192,176 original points while retaining the full data. Camera-space perspective scaling, faint floor, and local light effects do not modify those source coordinates. Rendered overlay positions use the same frame's MVP matrix and viewport, not a separately calculated screen-space offset.