Skip to content
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)

### Changed

- `docs/source/listings.rst`
- updated resource names and descriptions for LSST data listings
- `pittgoogle/alert.py`
- Address a bug in the `get` and `get_key` functions that raises an `AttributeError` when a field's value is `None`

Expand Down
28 changes: 16 additions & 12 deletions docs/source/listings.rst
Original file line number Diff line number Diff line change
Expand Up @@ -205,7 +205,7 @@ Pub/Sub Alert Streams
attribute is set to "likely" if the alert has a Stetson J index of at least 20 and at least 30 detections in
the g, r, or u band. The default value is "unlikely".

* - lsst-SuperNNova
* - lsst-supernnova
- lsst-lite plus SuperNNova classification results (Ia vs non-Ia).

BigQuery Tables
Expand All @@ -221,28 +221,31 @@ BigQuery Tables
- Description

* - lsst
- alerts_v7_4
- Alert data for LSST schema version 7.4. This table is an archive of the lsst-alerts Pub/Sub stream,
excluding image cutouts and metadata.
It has the same schema as the original alert bytes (except cutouts), including nested and repeated fields.
Equivalent tables exist for previous schema versions: alerts_v7_3, alerts_v7_1.
- alerts_v9_0
- Alert data for LSST schema version 9.0. This table is an archive of the lsst-alerts Pub/Sub stream,
excluding image cutouts and metadata. It has the same schema as the original alert bytes (except cutouts),
including nested and repeated fields. The fields `kafkaPublishTimestamp` and `healpix9`, `healpix19`, and
`healpix29` are included to support time-based partitioning and spatial clustering, respectively.

* - lsst
- upsilon
- Results from UPSILoN's (Kim \& Bailer-Jones, 2015) multi-class classification results (e.g., RR Lyrae,
Cepheid, Type II Cepheid, Delta Scuti star, eclipsing binary, long-period variable, etc.). Contains
the predicted label (i.e., class), the probability of the predicted label, and a flag value: 0
(successful classification), 1 (suspicious classification because the period is in period alias or the period
SNR is lower than 20) for each band used to observe the diaObject associated with an alert.
SNR is lower than 20) for each band used to observe the diaObject associated with an alert. The field
`kafkaPublishTimestamp` is included to support time-based partitioning.

* - lsst
- variability
- Results from the lsst-variability module. This table contains Stetson J indices and the number of detections (i.e.,
data points) for each band used to observe the diaObject associated with an alert.
data points) for each band used to observe the diaObject associated with an alert. The field
`kafkaPublishTimestamp` is included to support time-based partitioning.

* - lsst
- SuperNNova
- Results from a SuperNNova (Möller \& de Boissière, 2019) Type Ia supernova classification (binary).
- supernnova
- Results from a SuperNNova (Möller \& de Boissière, 2019) Type Ia supernova classification (binary). The field
`kafkaPublishTimestamp` is included to support time-based partitioning.

Cloud Storage Buckets
^^^^^^^^^^^^^^^^^^^^^
Expand All @@ -258,5 +261,6 @@ Cloud Storage Buckets
* - ardent-cycling-243415-lsst_alerts
- Alert data for LSST. This bucket is an Avro file archive of the lsst-alerts Pub/Sub stream,
including image cutouts and metadata. Each alert is stored as a separate Avro file.
The filename syntax is: `<schema_version>/<alert_date>/<diaObjectId>/<diaSourceId>.avro`.
For example, `v7_3/2026-10-01/3516505565058564097/3527242976319242284.avro`.
The filename syntax is: `<schema_version>/kafkaPublishTimestamp=<kafka_timestamp>/<objectid_key>=<objectid>/<sourceid_key>=<sourceid>.avro`.
DIA Object example: `v9_0/kafkaPublishTimestamp=2026-10-01/diaObjectId=3516505565058564097/diaSourceId=3527242976319242284.avro`.
Solar System Object example: `v9_0/kafkaPublishTimestamp=2026-10-01/ssObjectId=3516505565058564097/diaSourceId=3527242976319242284.avro`.