---
description: "Read events from a cell's event log"
---

# Event Log Read

Query events from a cell's event log.

## Usage

```python
from petri.storage.event_log import query_events, get_verdicts, load_events
from pathlib import Path

events_path = Path("$petri_dir/petri-dishes/{colony}/{level}-{seq}/events.jsonl")

# Load all events
events = load_events(events_path)

# Query by filters
results = query_events(events_path, cell_id="{cell_id}", event_type="{type}", iteration={n})

# Get verdicts for a cell + iteration
verdicts = get_verdicts(events_path, cell_id="{cell_id}", iteration={n})
```

## Important

- Events are read from append-only JSONL files — the source of truth.
- Use query parameters to filter efficiently.
- NEVER parse `.jsonl` files manually — always use these functions.
