juliensimon/otter-tde-catalog

---
license: cc-by-4.0
pretty_name: "OTTER TDE Catalog"
language:
- en
description: "Tidal disruption events (TDEs) from the Open TDE Catalog — stars torn apart by black holes."
task_categories:
- tabular-classification
- tabular-regression
tags:
- space
- tidal-disruption
- black-holes
- transients
- astronomy
- open-data
- tabular-data
size_categories:
- n<1K
configs:
- config_name: default
data_files:
- split: train
path: data/otter_tde_catalog.parquet
default: true
---

# OTTER TDE Catalog

*Part of the [Astronomy Datasets](https://huggingface.co/collections/juliensimon/astronomy-datasets-67c2e994a8b1a76b88ecfe22) collection on Hugging Face.*

All **90** known tidal disruption events (TDEs) from the
[Open TDE Catalog](https://github.com/astrocatalogs/tidaldisruptions),
spanning discoveries from **1990** to **2018**.

## Dataset description

A tidal disruption event (TDE) occurs when a star passes close enough to a
supermassive black hole to be ripped apart by tidal forces, producing a
luminous flare visible across the electromagnetic spectrum. The Open TDE
Catalog aggregates all known TDE candidates with coordinates, redshifts,
host galaxy identifications, and peak magnitudes.

Each record includes sky coordinates, spectroscopic classification,
redshift, host galaxy, peak apparent and absolute magnitude, and
Milky Way extinction (E(B-V)).

## Schema

| Column | Type | Description |
|--------|------|-------------|
| `name` | string | Primary name (e.g., "ASASSN-14li", "Swift J1644+57") |
| `aliases` | string | Alternative designations (comma-separated) |
| `ra_hms` | string | Right ascension in HH:MM:SS.ss format |
| `dec_dms` | string | Declination in +DD:MM:SS.ss format |
| `ra` | float64 | Right ascension in decimal degrees |
| `dec` | float64 | Declination in decimal degrees |
| `redshift` | float64 | Spectroscopic redshift |
| `claimed_type` | string | Classification (TDE, TDE?, TDE-H, TDE-He, etc.) |
| `host_galaxy` | string | Host galaxy name |
| `host_ra` | float64 | Host galaxy RA in decimal degrees |
| `host_dec` | float64 | Host galaxy Dec in decimal degrees |
| `host_offset_arcsec` | float64 | Angular offset from host nucleus (arcsec) |
| `peak_mag` | float64 | Peak apparent magnitude |
| `peak_abs_mag` | float64 | Peak absolute magnitude |
| `peak_date` | datetime | Date of peak brightness |
| `discovery_date` | datetime | Date of discovery |
| `discovery_year` | int64 | Year of discovery |
| `luminosity_distance_mpc` | float64 | Luminosity distance in Mpc |
| `velocity_km_s` | float64 | Recession velocity in km/s |
| `ebv` | float64 | Milky Way E(B-V) extinction |
| `instruments` | string | Instruments used for observations |

## Quick stats

- **90** tidal disruption events (1990--2018)
- **77** with sky coordinates
- **84** with redshift measurements
- **37** with spectroscopic classification
- **83** with identified host galaxy
- **43** with peak magnitude

### Classifications

| Type | Count |
|------|-------|
| TDE? | 14 |
| MS + SMBH | 8 |
| TDE | 6 |
| AGN? | 3 |
| Candidate | 2 |
| WD + IMBH | 1 |
| Planet + WD | 1 |
| Low-mass TDE | 1 |
| SLSN-I? | 1 |

## Usage

```python
from datasets import load_dataset

ds = load_dataset("juliensimon/otter-tde-catalog", split="train")
df = ds.to_pandas()

# All confirmed TDEs
confirmed = df[df["claimed_type"] == "TDE"]

# TDEs with redshift
with_z = df[df["redshift"].notna()].sort_values("redshift")

# Nearby TDEs (z < 0.05)
nearby = df[df["redshift"] < 0.05].sort_values("redshift")

# TDEs with peak magnitude
bright = df[df["peak_mag"].notna()].sort_values("peak_mag")

# Discoveries per year
per_year = df["discovery_year"].dropna().value_counts().sort_index()
```

## Data source

[Open TDE Catalog](https://github.com/astrocatalogs/tidaldisruptions) via
the [astrocatalogs](https://github.com/astrocatalogs) GitHub organization.
The catalog aggregates data from ASAS-SN, ZTF, Swift, XMM-Newton, SDSS,
and the astronomical literature.

## Related datasets

- [open-supernova-catalog](https://huggingface.co/datasets/juliensimon/open-supernova-catalog) — Open Supernova Catalog
- [grb-catalog](https://huggingface.co/datasets/juliensimon/grb-catalog) — Gamma-ray burst catalog
- [exoplanet-archive](https://huggingface.co/datasets/juliensimon/exoplanet-archive) — Confirmed exoplanets

## Pipeline

Source code: [juliensimon/space-datasets](https://github.com/juliensimon/space-datasets)

Static dataset — uploaded manually (only ~30 new TDEs per year).

## Citation

```bibtex
@article{open_tde_catalog,
author = {Guillochon, James and Parrent, Jerod and Kelley, Luke Zoltan and Margutti, Raffaella},
title = {An Open Catalog for Supernova Data},
journal = {The Astrophysical Journal},
year = {2017},
volume = {835},
number = {1},
pages = {64},
doi = {10.3847/1538-4357/835/1/64},
note = {The TDE catalog uses the same astrocatalogs infrastructure}
}
```

## License

[CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/)