AMPEL-HU-astro

Contributed Ampel units from HU/DESY group

Installing

Install poetry.
Configure poetry to create virtualenvs in the project: poetry config virtualenvs.in-project true. This makes it easier to work with IDEs like VSCode.
git clone https://github.com/AmpelProject/Ampel-HU-astro.git; cd Ampel-HU-astro
Check your virtualenv setup with poetry env info. The output should include:
```
Virtualenv
Python:         3.12.x
```
If not, point poetry at an installation of Python >=3.12 with e.g. poetry env use python3.12 (assuming that python3.12 is in your PATH)
poetry install -E "ztf sncosmo extcats" --with notebook
cd notebooks
poetry run jupyter notebook

This will allow a number of Demo / access / development notebooks to be run. Note that most of them requires an access token if data is to be retrieved.

Pitfalls

lightgbm expects to find OpenMP on your system. If you see an error message like OSError: libgomp.so.1: cannot open shared object file: No such file or directory, you will need to install OpenMP with e.g. brew install libomp (macOS) or apt-get install libgomp1 (Ubuntu).
to install with parsnip support, `poetry install -E "elasticc" --with notebook

Provided units

T0 units (alert filters):

LensedTransientFilter
PredetectionFilter: Filter derived from the DecentFilter.
RandFilter
RcfFilter: Filter for the ZTF Redshift Completeness Factor program..
RedshiftCatalogFilter: Filter derived from DecentFilter designed to only accept transients located close to a galaxy in a catalog, and within redshift bounds.
SimpleDecentFilter: General-purpose filter devloped alongside DecentFilter but without use of external catalogs.
StellarFilter: a.k.a. as the IndecentFilter, i.e. an inversion of the DecentFilter mainly used for finding extragalactic objects.
TimeDistributionFilter: Filter derived from the DecentFilter, in addition.
TransientInClusterFilter: Filter derived from the DecentFilter, in addition selecting candidates with position compatible with that of nearby galaxy clusters..
XShooterFilter: Filter derived from the DecentFilter, in addition selecting very new transients which are visible from the South.

T2 units (augment):

T2BayesianBlocks: T2 unit for running a bayesian block search algorithm to highlight excess regions.
T2BrightSNProb: Derive a number of simple metrics describing the rise, peak and decline of a lc.
T2CatalogMatchLocal: Cross matches the position of a transient to those of sources in a set of catalogs.
T2ClassificationReport: Require and propagate classification information from ParsnipRiseDecline..
T2DemoLightcurveFitter: Demonstration class showing how methods of T2BaseLightcurveFitter can be used develop a specific classifier.
T2DigestRedshifts: Compare potential matches from different T2 units providing redshifts.
T2DustEchoEval
T2ElasticcRedshiftSampler: Parse the elasticc diaSource host information and returns a list of redshifts and weights.
T2ElasticcReport: Parse a series of T2 results from T2RunParsnip and T2XgbClassifier, and create combined classifications according to the taxonomy of https://github.com/LSSTDESC/elasticc/blob/main/taxonomy/taxonomy.ipynb.
T2FastDecliner: Determine decline rate in two last obs.
T2GetLensSNParameters
T2InfantCatalogEval: Evaluate whether a transient fulfills criteria for being a potentially infant (extragalactic) transient.
T2InfantReport: Report potential infant transients.
T2KilonovaEval: Evaluate whether a transient fulfills criteria for being a potential kilonova-like event.
T2KilonovaStats: Evaluate kilonovaness stats for transient given map distance and number of detections..
T2LCQuality: determine the 'quality' of the light curve by computing ratios between the number of detection and that of upper limits.
T2LSPhotoZTap: Query the NOIR DataLab service for photometric redshifts from the Legacy Survey.
T2LasairReport: Propagate classification results to Lasair..
T2LoadRedshift: Add redshifts from external .csv.
T2MatchBTS: Add information from the BTS explorer page.
T2MinorPlanetCenter: Check if the latest detection of a transient corresponds matches something known by the MinorPlanetCenter..
T2MultiXgbClassifier: For a range of xgboost classifier models, find a classification.
T2NedSNCosmo: Fits lightcurves using SNCOSMO (using SALT2 defaultwise) with redshift constrained by catalog matching results.
T2NedTap: See also: https://ned.ipac.caltech.edu/tap/sync?QUERY=SELECT+*+FROM+TAP_SCHEMA.tables&REQUEST=doQuery&LANG=ADQL&FORMAT=text Export all NED: https://ned.ipac.caltech.edu/tap/sync?QUERY=SELECT+*+FROM+NEDTAP.objdir&REQUEST=doQuery&LANG=ADQL&FORMAT=text.
T2Observability: cross match the position of a transient to those of sources in a set of catalogs and attach the required information to the transient..
T2RiseDeclineStat
T2RunParsnip: Gathers information and runs the parsnip model and classifier.
T2RunParsnipRiseDecline
T2RunPossis: Load a POSSIS kilnova model and fit to a LightCurve object as process is called.
T2RunSncosmo: Gathers information and runs Sncosmo.
T2RunSnoopy: Gathers information and runs snoopy.
T2RunTDE: Create a TDE model and fit to a LightCurve object as process is called.
T2SNCosmo
T2TNSEval: Evalute whether a transient fulfills criteria for submission to TNS.
T2XgbClassifier: Load a series of xgboost classifier models (distinguished by number of detections) and return a classification.

T3 units (react):

AstroColibriPublisher: Publish results to AstroColibri.
ChannelSummaryPublisher: Create a json file with summary statistics for the channel.
CostCounter: Derive metrics for the total cost, as parsed by the provided documents.
DCachePublisher: Publish TransientViews to DCache in gzipped JSON format.
ElasticcClassPublisher: This unit is intended to submit classifications to the DESC TOM db during the ELAsTICC LSST alert simulation.
ElasticcClassTablePrinter: Unit which will print Elasticc unit classifications to STDOUT and/or an output csv file.
HealpixCorrPlotter: Compare healpix coordinate P-value with output from T2RunSncosmo..
PlotLightcurveSample: Unit plots results from lightcurve fitters (RunSncosmo, RunParsnip).
PlotTransientLightcurves: Create a (pdf) plot summarizing lightcurves of candidates provided to the unit.
RapidBase: Trigger rapid reactions.
RapidLco: Submit LCO triggers for candidates passing criteria..
RapidSedm: Select transients for rapid reactions.
ScoreSingleObject: Calculate score based on how early a specific SN is detected.
ScoreTNSObjects: Calculate score based on detection time reported to TNS, if any..
SlackSummaryPublisher
SubmitTNS: Submit candidates to TNS (unless already submitted).
TransientInfoPrinter
TransientTablePublisher: Construct a table based on selected T2 output values.
TransientViewDumper

T4 units (control):

HealpixTokenGenerator: Based on a URL to a Healpix map.
RandomMapGenerator: Generate smoothed circular healpix probability values around a random coordinate..
StreamTokenGenerator: Stream based token generator for.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ampel_hu_astro-0.10.0a30.tar.gz (806.9 kB view details)

Uploaded Jul 23, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ampel_hu_astro-0.10.0a30-py3-none-any.whl (978.9 kB view details)

Uploaded Jul 23, 2026 Python 3

File details

Details for the file ampel_hu_astro-0.10.0a30.tar.gz.

File metadata

Download URL: ampel_hu_astro-0.10.0a30.tar.gz
Upload date: Jul 23, 2026
Size: 806.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for ampel_hu_astro-0.10.0a30.tar.gz
Algorithm	Hash digest
SHA256	`fe967a1ab22b8623a66879d33bf696dccac8f42534ed30855c2270d292519336`
MD5	`0318ffe9ec985a7efaa6966947d56e79`
BLAKE2b-256	`e8abb74bae8bfede2a6557ec9da571b34f3606f67ac9b6ad5153826afac25e6b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ampel_hu_astro-0.10.0a30.tar.gz:

Publisher: main.yml on AmpelAstro/Ampel-HU-astro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ampel_hu_astro-0.10.0a30.tar.gz
- Subject digest: fe967a1ab22b8623a66879d33bf696dccac8f42534ed30855c2270d292519336
- Sigstore transparency entry: 2224278114
- Sigstore integration time: Jul 23, 2026
Source repository:
- Permalink: AmpelAstro/Ampel-HU-astro@1b41bce583970a51079b42c4357f3d1bfae575ac
- Branch / Tag: refs/heads/main
- Owner: https://github.com/AmpelAstro
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: main.yml@1b41bce583970a51079b42c4357f3d1bfae575ac
- Trigger Event: push