EarthPicture

EarthPicture is a Python package designed to provide public and easy access to time series of satellite imagery, with a particular focus on supporting climate studies. This package enables users to effortlessly retrieve and visualize satellite imagery over selected areas and create time-lapse videos to observe environmental and climate-related changes over time.

Goals

The main goal of EarthPicture is to:

• Simplify access to satellite imagery for climate research and monitoring.
• Enable users to easily generate time-lapse visuals from satellite images to observe changes over time in specific geographic areas.
• Offer a flexible and user-friendly interface for working with data from major satellite data providers, such as Copernicus (Sentinel), with plans to support additional providers in the future.

Planned Features

• Time Series Access: Retrieve sequences of satellite imagery over a specified time period, useful for studying climate-related changes.
• Time-lapse Creation: Generate time-lapse videos from imagery data to visualize changes over time.
• Easy Area Selection: Select areas of interest using either bounding box coordinates or GeoJSON files.
• Data Access: Interface with the Copernicus Open Access Hub and Planet API to query and retrieve satellite data based on mission, date range, cloud cover, and location.
• Sphinx Documentation: Clear and comprehensive documentation for ease of use.

Installation

Clone the repository and install the required packages with pip:

git clone https://github.com/yourusername/EarthPicture.git
cd EarthPicture
pip install -r requirements.txt

Contributors

We welcome contributions from the community to help expand and improve EarthPicture! Whether it’s adding new features, enhancing documentation, or fixing bugs, all types of contributions are appreciated.

How to Contribute

1. Fork the repository: This allows you to make changes on your own copy of the project.
2. Create a branch: Use a descriptive branch name such as feature/add-time-lapse-function or fix/credential-bug.
3. Make your changes: Implement your feature or fix in your branch.
4. Write tests and update documentation: Ensure your changes are tested and documented where appropriate.
5. Submit a pull request: Once you’re happy with your changes, open a pull request to the main branch of the original repository.

Please ensure that your contributions adhere to our coding standards and that all tests pass. Feel free to reach out if you have any questions or need help getting started.

Acknowledgments

A big thank you to everyone who has contributed to EarthPicture! Together, we’re making it easier for researchers and enthusiasts to access and visualize satellite imagery for climate studies.

---

Let’s build a strong community around open-access satellite data and climate study tools!