Skip to main content

A package to analyze bolide data

Project description

A package to analyze bolide data in Python.

PyPI link Documentation Status Binder link

https://raw.githubusercontent.com/jcsmithhere/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/jcsmithhere/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 a usage tutorial, go here. An interactive version is hosted on binder.

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.

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.

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

bolides-0.5.0.tar.gz (1.2 MB view details)

Uploaded Source

Built Distribution

bolides-0.5.0-py3-none-any.whl (1.2 MB view details)

Uploaded Python 3

File details

Details for the file bolides-0.5.0.tar.gz.

File metadata

  • Download URL: bolides-0.5.0.tar.gz
  • Upload date:
  • Size: 1.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for bolides-0.5.0.tar.gz
Algorithm Hash digest
SHA256 32de0359dd5506ffc201c590fa9b102e6edbc615a3906f555ac81bf1f13301fd
MD5 3a301969e8ddbd2ce1600a0cd9bf96e8
BLAKE2b-256 d6802bbb31f0860fc10a12d69ec1c8e93ac1e592cfc28ff7ffbcde2b97c9fe15

See more details on using hashes here.

File details

Details for the file bolides-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: bolides-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 1.2 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for bolides-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6a3b77c4430ad1861f163fef204660d6cd4e95c65e3d7dec211895d702568237
MD5 bb3b7f94aa3ca41c7403cf7c5ec6ef1a
BLAKE2b-256 5ef474ce78e91807af940626ede1c28d2d1a90a66441bf3ac33dcff92d4af2c5

See more details on using hashes here.

Supported by

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