docs/RELEASE_NOTES.md

# EventActivityNet v1.0 Release Notes

## Release Status

EventActivityNet v1.0 provides complete 5-bin and 9-bin generated event voxel
representations over the same canonical 3,263-video set.

## Representation Summary

| Representation | Path | Train / validation | Shards | Canonical HDF5 bytes |
|---|---|---:|---:|---:|
| 5-bin | `data_5bin/` | 2,316 / 947 | 219 | 4,355,745,895,245 |
| 9-bin | `data_9bin/` | 2,316 / 947 | 219 | 4,214,122,096,103 |

Both use 157 train and 62 validation tar shards. The repository contains
approximately 8.57 TB of payload overall. The variants are alternative
temporal groupings; neither is claimed to be inherently superior.

## 2026-08 Update

- Added the complete 9-bin representation.
- Normalized public representation directories to `data_5bin/` and `data_9bin/`.
- Retained the same canonical 3,263-video train/validation membership and shared annotations for both variants.
- Separated shard manifests, summaries, and checksums under `metadata/5bin/` and `metadata/9bin/`.
- Generalized source timing metadata to describe both representations without changing canonical source values.

## Integrity

Final audits confirmed:

- 3,263 valid HDF5 files per representation;
- zero unreadable or structurally invalid production files;
- exact `events`, `voxel_event_start`, and `voxel_event_count` datasets;
- `num_bins=5` or `num_bins=9` matching each representation;
- 438 expected remote tar shards with exact recorded sizes and checksums;
- no tar payload under the former `data/` namespace.

## Scale Summary

| Scale | Videos | Hours | Train | Validation | Classes | Event-friendly |
|---|---:|---:|---:|---:|---:|---:|
| Large | 3,263 | 106.94 | 2,316 | 947 | 200 | 65.31% |
| Medium | 1,537 | 50.00 | 1,074 | 463 | 200 | 64.80% |
| Small | 667 | 20.00 | 473 | 194 | 200 | 64.62% |

## Caveats

- These are generated event voxel tensors, not native event-camera recordings.
- The verified release contains 200 action classes.
- The historical 107.3-hour Large figure is approximate; the verified duration is 106.94 hours.
- Medium and Small are deterministic nested v1.0 scales.
- Source FPS varies by video and timing uses released rational FPS metadata.

Changing the original 5-bin directory from `data/` to `data_5bin/` changes
repository URLs used by older download scripts. Tar filenames and content
checksums are unchanged.