Skip to main content

LIGO/Virgo/KAGRA Follow-up Advocate Tools

Project description

LIGO Follow-up Advocate Tools

This package provides tools for LIGO/Virgo/KAGRA follow-up advocates to assist in tasks such as drafting astronomical bulletins for gravitational-wave detections.

To install

The easiest way to install ligo-followup-advocate, is with pip:

pip install --user ligo-followup-advocate

To upgrade

Once you have installed the package, to check for and install updates, run the following command:

pip install --user --upgrade ligo-followup-advocate

Current templates

If you wish to just see examples of the current templates or submit these to be reviewed in P&P, you can find them here.

Example

ligo-followup-advocate provides a single command to draft a GCN Circular skeleton. Pass it the authors and the GraceDB ID as follows:

ligo-followup-advocate compose \
    'A. Einstein (IAS)' 'S. Hawking (Cambridge)' \
    'I. Newton (Cambridge)' 'Data (Starfleet)' \
    'S190407w'

Optionally, you can have the program open the draft in your default mail client by passing it the --mailto option.

For a list of other supported commands, run:

ligo-followup-advocate --help

For further options for composing circulars, run:

ligo-followup-advocate compose --help

You can also invoke most functions directly from a Python interpreter, like this:

>>> from ligo import followup_advocate
>>> text = followup_advocate.compose('S190407w')

To develop

To participate in development, clone the git repository:

git clone git@git.ligo.org:emfollow/ligo-followup-advocate.git

To release

The project is set up so that releases are automatically uploaded to PyPI whenever a tag is created. Use the following steps to issue a release. In the example below, we are assuming that the current version is 0.0.5, and that we are releasing version 0.0.6.

  1. Check the latest pipeline status to make sure that the master branch builds without any errors.

  2. Make sure that all significant changes since the last release are documented in CHANGES.md.

  3. Update the heading for the current release in CHANGES.md from 0.0.6 (unreleased) to 0.0.6 (YYYY-MM-DD) where YYYY-MM-DD is today's date. Also update the version in pyproject.toml similarly.

  4. Update the PDF templates with this new version.

  5. Commit those changes:

    git commit -a -m "Update changelog for version 0.0.6"
    
  6. Tag the release:

    git tag v0.0.6 -m "Version 0.0.6"
    
  7. Add a new section to CHANGES.md like this:

    ## 0.0.7 (unreleased)
    
    - No changes yet.
    
  8. Commit the changes:

    git commit -a -m "Back to development"
    
  9. Push everything to GitLab:

     git push upstream && git push upstream --tags
    

    Within a few minutes, the new package will be built and uploaded to PyPI.

  10. Upload PDF of templates created from the publish CI job to DCC. Initiate P&P review and address comments in a new release. Note that it may take multiple releases to get P&P approval.

  11. Create an SCCB ticket. Note that there is an option to do this via the a button in the CI/CD pipeline, but this template could be outdated. The recommendation is to create the ticket by hand via the above link.

Project details


Download files

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

Source Distribution

ligo_followup_advocate-1.3.5.tar.gz (12.3 MB view details)

Uploaded Source

Built Distribution

ligo_followup_advocate-1.3.5-py3-none-any.whl (12.4 MB view details)

Uploaded Python 3

File details

Details for the file ligo_followup_advocate-1.3.5.tar.gz.

File metadata

  • Download URL: ligo_followup_advocate-1.3.5.tar.gz
  • Upload date:
  • Size: 12.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for ligo_followup_advocate-1.3.5.tar.gz
Algorithm Hash digest
SHA256 b4a5c169193a1c4cac499781ac0819f1b6429b1f0ced4f9efd65aa256f873a9c
MD5 6709e5e9b055391e1d8a6c0eae6efe8d
BLAKE2b-256 3f3763e59f7f3ae3057b7ce7e19bb90b0e222e8a671bf8176885d99ca0976e1c

See more details on using hashes here.

File details

Details for the file ligo_followup_advocate-1.3.5-py3-none-any.whl.

File metadata

File hashes

Hashes for ligo_followup_advocate-1.3.5-py3-none-any.whl
Algorithm Hash digest
SHA256 04ef5ae2592b8ec1a59c79ffb3fee1f4454509c71a7ea3b3f3c4b91cf29a5818
MD5 d285b4387ed790361e43dfa2ca756288
BLAKE2b-256 287c86205cafe891009ba993a8a9441b5405a8dee577e5b8bb069ad479bb1c6a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page