Skip to main content

bolides

A package to analyze bolide data in Python.

PyPI link Documentation Status Binder link

https://raw.githubusercontent.com/SETI/bolides/master/docs/preview.gif

bolides is a community package primarily designed to work with bolide detections from the Geostationary Lightning Mapper instruments aboard GOES-16 and GOES-17 that are published at neo-bolide.ndc.nasa.gov. But bolides can also read bolide data from ZODB database files produced by the GLM bolide detection pipeline, from US Government sensors, and from your own .csv files containing bolide data.

Functionality

bolides puts bolide detections from various sources into a common BolideDataFrame format. With this, bolides can do things like:

  • Automatically add metadata like lunar phase, solar time, and solar altitude to bolide detections.

  • Filter the data sets by any variable.

  • Search the data sets for particular bolides by time or location.

  • Make histograms of bolides over time.

  • Plot detections on arbitrary map projections, coloring by any categorical or quantitative variables.

  • Plot GLM fields-of-view in the GOES-West and GOES-East positions, and filter bolide detections by the FOV.

  • Augment one data set with data from another, automatically matching bolide detections from different sources.

  • Pull corresponding bolide light curves from neo-bolide.ndc.nasa.gov and plot them.

  • Pull meteor shower data from the IAU Meteor Data Center and plot their orbits.

  • Run an interactive webapp.

Documentation

All package documentation is hosted at bolides.readthedocs.io.

Installation

We want to make installation as easy as possible. If you have any problems with the installation process, please open an issue.

Dependencies

If using Conda, just use Conda to install cartopy: conda install -c conda-forge cartopy.

If using pip:

  1. First, PROJ needs to be installed on your system using the installation instructions at the link. GEOS also needs to be installed. On Ubuntu both can be installed with sudo apt install proj-bin libproj-dev libgeos-dev

  2. Next, due to known Cartopy and Shapely problems, Cartopy and Shapely need to be installed manually. This is done with: pip install numpy && pip install cartopy==0.18.0 shapely --no-binary cartopy --no-binary shapely. Note that an older Cartopy version is recommended to prevent it from requiring PROJ versions not yet in common repositories. If you already have PROJ 8.0.0, you may omit the ==0.18.0 and install the latest Cartopy version.

The package

While the package is still in development we recommend installing from source:

  1. Download this repository: git clone https://github.com/SETI/bolides.git

  2. Move into it: cd bolides

  3. Install the package in editable mode: pip install -e .

Once this package is on the Python Package Index, you can install via pip using pip install bolides.

Tutorial

For usage tutorials, go here. Interactive versions are hosted on binder: BolideDataFrame and Field-of-View tools.

Historical Note

The original version of bolides was developed by Clemens Rumpf and Geert Barentsen. It has been rewritten since then, but all of the original code and functionality is still present.

Maintaining

Several informational files are located throughout this repository to help in understanding and maintaining the package:

Acknowledgments

This development is supported through NASA’s Asteroid Threat Assessment Project (ATAP), which is funded through NASA’s Planetary Defense Coordination Office (PDCO). Anthony Ozerov is supported through NASA Cooperative Agreement 80NSSC19M0089.

Metadata

Release files for bolides 0.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bolides 0.6.1
File Size Uploaded Provenance Actions
bolides-0.6.1.tar.gz 1.2 MB Without provenance Details for bolides-0.6.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for bolides 0.6.1
File Interpreter ABI Platform Actions
bolides-0.6.1-py3-none-any.whl Python 3 none any Details for bolides-0.6.1-py3-none-any.whl

Total release size: 2.5 MB

Release files / bolides-0.6.1.tar.gz

Download URL bolides-0.6.1.tar.gz
Size 1.2 MB
Tags Source
SHA-256 checksum
How to use checksums
63e19e1f2166df66f4865b72d15665ff2382cb209be9732ae8eddf2dba615ea0
BLAKE2b-256 checksum
How to use checksums
85d6f59312ed3462c41ad8257855d3ee3072522e5fee40efbc8caa51c013b969
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.11.7

Release files / bolides-0.6.1-py3-none-any.whl

Download URL bolides-0.6.1-py3-none-any.whl
Size 1.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
40aa28ba7ae8a13cc9d25b9b150fdd9c806d1ff6a278b96612bcbbb4e294e52b
BLAKE2b-256 checksum
How to use checksums
b3c6bf3affc2798b83b7b1b477d728ebda7ef83e96381a08d47a58f84e828dd4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.11.7

Security for bolides 0.6.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page