BlackMarblePy

BlackMarblePy is a Python package for working with Black Marble data. Black Marble is a NASA Earth Observatory project that provides global nighttime lights data. The package automates the process of downloading all relevant tiles from the NASA LAADS archive to cover a region of interest, converting the raw files (in H5 format) to georeferenced rasters, and mosaicing rasters together when needed.

Features

• Download Black Marble data for specific time periods and regions.
• Visualize nighttime lights using customizable color palettes.
• Calculate basic statistics from Black Marble images.
• Perform time-series analysis on nighttime lights data.

Installation

BlackMarblePy is available on PyPI; you can install it using pip:

pip install blackmarblepy

Usage

Before downloading and extracting Black Marble data, define the NASA bearer token, and define a region of interest. For more detailed documentation and examples, please refer to the documentation.

Contributing

Contributions are welcome! If you'd like to contribute, please follow our contribution guidelines.

License

This project is open-source - see the LICENSE file for details