# `cogpy.events`

Event data structures and catalog management. `EventCatalog` is the unified
container for point and interval events returned by all detectors. It wraps
a pandas DataFrame with standardized columns and provides converters,
factories, and query helpers.

**Guide:** {doc}`/howto/event-detection` |
**Tutorial:** {doc}`/tutorials/detection-and-events` |
**Spec:** {doc}`/reference/event-catalog-spec`

## Submodules

```{eval-rst}
.. autosummary::
   :recursive:

   cogpy.events.catalog
   cogpy.events.match
   cogpy.events.overlap
```

```{eval-rst}
.. automodule:: cogpy.events
   :members:
   :undoc-members:
   :show-inheritance:
   :noindex:
```