Skip to main content

Download wildfire hotspots detected by NASA satellites and the Fire Information for Resource Management System (FIRMS)

Project description

Download wildfire hotspots detected by NASA satellites and the Fire Information for Resource Management System (FIRMS)

Hourly scrapes powered by a GitHub Action are stored in the data directory.

Installation

pipenv install nasa-wildfires

Command-line usage

Usage: nasawildfires [OPTIONS] COMMAND [ARGS]...

  A command-line interface for downloading wildfire data from NASA
  satellites.

  Returns world GeoJSON in a recent 24-hour period. For available regions and time ranges, see options.

Options:
  --help  Show this message and exit.

Commands:
  modis  Hotspots detected by the MODIS satellitel
  viirs_suomi  Hotspots detected by the VIRRS S-NPP satellite.
  viirs_noaa  Hotspots detected by the VIRRS NOAA-20 satellite.

Download a GeoJSON of hotspots detected by the MODIS satellite in a recent 24-hour period.

nasawildfires modis

Download a GeoJSON of hotspots detected by the MODIS satellite for USA and Hawaii in a recent 48-hour period.

nasawildfires modis -r usa-hawaii -t 48h

Download a GeoJSON of hotspots detected by the VIIRS S-NPP satellite in a recent 24-hour period.

nasawildfires viirs-suomi

Download a GeoJSON of hotspots detected by the VIIRS NOAA-20 satellite in a recent 24-hour period.

nasawildfires viirs-noaa

Python usage

Import the library.

>>> import nasa_wildfires

View list of available regions

>>> nasa_wildfires.REGION_LIST
['global', 'canada', 'alaska', 'usa-hawaii', 'central-america', 'south-america', 'europe', 'north-central-africa', 'southern-africa', 'russia-asia', 'south-asia', 'southeast-asia', 'australia-newzealand']

View list of availabe time ranges

>>> nasa_wildfires.TIME_RANGE_LIST
['24h', '48h', '7d']

Download a GeoJSON of hotspots detected by the MODIS satellite in a recent 24-hour period. Returns GeoJSON.

>>> data = nasa_wildfires.get_modis()

Download a regional GeoJSON of hotspots detected by the MODIS satellite in a recent 24-hour period.

>>> data = nasa_wildfires.get_modis(region='usa-hawaii')

Download a regional GeoJSON of hotspots detected by the MODIS satellite in a recent 7-day period.

>>> data = nasa_wildfires.get_modis(region='usa-hawaii', time_range='7d')

Download a GeoJSON of hotspots detected by the VIIRS S-NPP satellite in a recent 24-hour period. Returns GeoJSON.

>>> data = nasa_wildfires.get_viirs_suomi()

Download a GeoJSON of hotspots detected by the VIIRS NOAA-20 satellite in a recent 24-hour period. Returns GeoJSON.

>>> data = nasa_wildfires.get_viirs_noaa()

Contributing

Install dependencies for development.

pipenv install --dev

Run tests.

make test

Shipping new version to PyPI.

make ship

Developing the CLI

The command-line interface is implemented using Click and setuptools. To install it locally for development inside your virtual environment, run the following installation command, as prescribed by the Click documentation.

pip install --editable .

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

nasa-wildfires-1.0.5.tar.gz (6.7 kB view details)

Uploaded Source

Built Distribution

nasa_wildfires-1.0.5-py2.py3-none-any.whl (5.5 kB view details)

Uploaded Python 2Python 3

File details

Details for the file nasa-wildfires-1.0.5.tar.gz.

File metadata

  • Download URL: nasa-wildfires-1.0.5.tar.gz
  • Upload date:
  • Size: 6.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.8

File hashes

Hashes for nasa-wildfires-1.0.5.tar.gz
Algorithm Hash digest
SHA256 c8ad99444d3c3b610dbe60385325d2765168970fa62c1f3944fc143faa5f9386
MD5 24b712c867061a5deba126882e07b6f3
BLAKE2b-256 8b11331256b98825f8a8815906ad6c3593e14986798fc8c66e8774f7c99d67e0

See more details on using hashes here.

File details

Details for the file nasa_wildfires-1.0.5-py2.py3-none-any.whl.

File metadata

  • Download URL: nasa_wildfires-1.0.5-py2.py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.8

File hashes

Hashes for nasa_wildfires-1.0.5-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 3a2942bece5d5d15e5c7a481d6162c3db9fb4addd8ca0a9c1c48e4398202967b
MD5 30c0854088f408cdf94aeb987a8bd1c5
BLAKE2b-256 ef81a5dbb8447953acdd13ba7c761f164117db13fe98839d6c1eecafc42888c5

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