Astro-COLIBRI v2.34.0: Redesigned sub-filters, the Gravitational-Wave Treasure Map, and more observing services

Hi all,

We’re happy to announce the release of Astro-COLIBRI v2.34.0! The sub-filters got a complete redesign, and Astro-COLIBRI now works hand in hand with the Gravitational-Wave Treasure Map, so you can share your follow-up of gravitational-wave events with the community and further optimize your follow-ups. You can also send events to SkyPortal, request observations from the Las Cumbres Observatory network.
As a first direct results of our recent workshop and hackathon, we are now distributing our alerts on the AT Protocol (in addition to the Kafka stream) and you can now filter the broker stream with your own filters in the Python SDK.

Here are the highlights of this release:

:control_knobs: Redesigned sub-filters: clearer panels with sliders, presets and units, and a live count of the events each filter lets through.
:world_map: Gravitational-Wave Treasure Map: report your tilepy schedules and pointings, and see everybody’s pointings on the sky map of GW events.
:telescope: SkyPortal and Las Cumbres Observatory: save events within SkyPortal (ICARE and Fritz already built in) and request LCO observations with your proposal.
:snake: Broker filtering in the Python SDK: astro-colibri 1.3.0 applies your app filters to the alert stream, available via PyPI and GitHub.
:butterfly: Alerts on the AT Protocol: all important alerts are posted on the open network behind Bluesky.
:link: SAMP: send events from the web interface straight to VO tools like TOPCAT, Aladin Desktop or DS9.

We describe the main new features in detail in the replies below. The full changelog is on our release history page.

As always, this update also includes a series of minor improvements and bug fixes.
And of course we look forward to your feedback!

Clear skies,
The Astro-COLIBRI Team

1 Like

:control_knobs: Redesigned sub-filters

Every filter’s sub-filter panel has a new, clearer layout, with more room on the web and no more sideways scrolling on phones.

  • Options are grouped as Any of and All of, on/off choices are chips and conditions are aligned rows.
  • Set values with sliders, day presets (1, 3, 7, 14 and 30 days) and +/- steppers instead of typing every number.
  • Every condition names its unit: GW class probabilities [0-1], significances [σ], Sun distance [deg], days since the last detection, latest magnitudes [mag].
  • A new All bands row sets one magnitude limit for all photometric bands at once.
  • See how many of the loaded events each filter lets through, in the sub-filter panel and, if you switch it on in the display settings, on every filter button.
  • On mobile, tap the tune icon on a filter button to open its sub-filters (the long-press still works).

Another major improvement: your filter settings are now kept when a new version updates the filters: your on/off choices and sub-filter values stay as you set them.

:world_map: Gravitational-Wave Treasure Map

Astro-COLIBRI now reports to and reads from the Gravitational-Wave Treasure Map, the community platform where observers share where they plan to search for the counterpart of a gravitational-wave event and where they already observed.

  • Obtain your optimized observation plan with tilepy as usual.
  • Then report a whole tilepy schedule, or a single pointing of a GW event, of one tilepy pointing or of a custom event.
  • Report planned pointings as completed once you have observed them, or cancel those you will not observe, so others know these fields are free.
  • See everybody’s pointings on the sky map of GW events, with the instrument footprints. Switch instruments and planned or completed pointings on and off.

To report, connect your Treasure Map API token (shown on your Treasure Map profile page) in the menu under Account settings > Observatory & TOM access. Viewing the pointings needs no account. The details are on our new integrations page.

:telescope: SkyPortal and Las Cumbres Observatory

Two more observing services join the TOMs you can already reach from Astro-COLIBRI.

  • SkyPortal: connect with your SkyPortal API token under Account settings > Observatory & TOM access and save an event as a source for the groups you choose. The source links back to Astro-COLIBRI. The ICARE and Fritz instances are already configured, and you can add further SkyPortal instances yourself.
  • Las Cumbres Observatory: request observations from the LCO network with your LCO proposal, then follow the state of your requests and their data.

All TOMs and observing services, and how to connect them, are described on the new integrations page.

:butterfly: Alerts on the AT Protocol

Follow the important alerts on the AT Protocol, the open network behind Bluesky, without any account.

  • Every alert of the important stream is posted publicly from @astro-colibri.science, seconds after the broker, in the native JSON format and as VOEvent.
  • Listen live with the nebra Python package, or browse the archive.
  • The broker status panel shows whether the AT Protocol mirror is running.

Everything else is in the documentation.

Also, you can now follow us on Bluesky!

:snake: Filter the broker stream with your own filters (Python SDK 1.3.0)

The alerts you receive from the Astro-COLIBRI Kafka broker can now pass through the same filters you use in the app:

from astrocolibri import Consumer, EventFilter

event_filter = EventFilter.from_saved_filters()   # your app filters, user ID from ASTROCOLIBRI_UID

with Consumer(username="...", password="...") as consumer:
    consumer.subscribe(["astrocolibri.all.JSON"])
    for alert in consumer.consume(event_filter=event_filter):
        event = alert.event()
        print(event["trigger_id"], event["type"], event["ra"], event["dec"])
  • Use the filters saved in the app for your account, the file from the Download Filters button (EventFilter.from_file()), or a filter written by hand.
  • The same filter gives the same answer on the JSON and the VOEvent topics, and the same answer as the API searches.
  • The new API endpoint /saved_filters returns the filters saved in the app for your account, ready to use in your searches.
  • alert.important tells you whether an alert on the astrocolibri.all stream is also on the astrocolibri.important stream, so you can filter the full stream without subscribing to both.
  • The VOEvents from the broker and the API now include the photometry of optical transients (first, peak and last detection per band) and more event details: constellation, associated event, discoverer name, image links.

Upgrade with pip install --upgrade astro-colibri. The broker documentation and the SDK tutorial have the details, and examples/filter_stream.py is a script to start from.

:link: Send events to your VO desktop tools via SAMP

In science mode on the web interface, a new button in the event details sends the event’s position and a VOTable of the event to the SAMP applications running on your computer: TOPCAT, Aladin Desktop, DS9 and others.

  • Start TOPCAT or Aladin Desktop to open a SAMP hub, then accept the connection from Astro-COLIBRI.
  • Works in Chrome and Firefox. Safari cannot connect to a local SAMP hub.
  • The new public API endpoint /get_event_as_votable returns one or more events (by trigger_id, archive_id or source_name) as a VOTable.

:wrench: Minor improvements and bug fixes

  • The tilepy request dialog now shows the visibility of the event on the chosen date from the chosen observatory, right under the date and time
  • CBAT “TCP” transient announcements are now sent to everyone subscribed to “Optical transients: other”, next to the CBAT nova alerts
  • Heads-up for API users: /getContour now returns each localisation region with its credible level (contours); the contours50 / contours95 fields were removed