sentinel2_downloader
====================
Overview
--------
`sentinel2_downloader` is a Python library that allows you to search, download, and retrieve metadata of Sentinel satellite images from the Copernicus Data Space.
Features
--------
- Search for Sentinel satellite images based on various parameters such as footprint, date range, product type, cloud cover percentage, and platform name.
- Download Sentinel satellite images using their product IDs.
- Save downloaded images to the specified directory.
- Display a progress bar during the download process, showing the download speed, elapsed time, and percentage of completion.
Installation
------------
You can install `sentinel2_downloader` using pip:
.. code:: bash
pip install sentinel2_downloader
Usage
-----
Here's an example of how to use `sentinel2_downloader`:
.. code:: python
from sentinel2_downloader import SentinelAPI
# Create an instance of the SentinelAPI
api = SentinelAPI(username='your_username', password='your_password')
# Perform a search for Sentinel satellite images
products = api.query(footprint='POLYGON((longitude1 latitude1, longitude2 latitude2, longitude3 latitude3, ...))',
start_date='2020-01-01', end_date='2020-01-31', cloud_cover_percentage='20', product_type='MSIL1C',
platform_name='SENTINEL-2')
if len(products) > 1:
for product in products:
# Download the images
a = api.download(product_id=product['Id'], directory_path='output')
Args:
* footprint (str): The footprint to define the geographic area of interest. It should be in the Well-Known Text (WKT) format.
* start_date (str): The start date of the data acquisition period in the format 'yyyy-mm-dd'.
* end_date (str): The end date of the data acquisition period in the format 'yyyy-mm-dd'.
* product_type (str): The type of Sentinel product to query.
* cloud_cover_percentage (str): The maximum cloud cover percentage allowed.
* platform_name (str): The name of the Sentinel platform.
Raw data
{
"_id": null,
"home_page": "https://github.com/Azim-Kenzh/sentinel2_downloader",
"name": "sentinel2-downloader",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "copernicus,sentinel,satellite,download,GIS",
"author": "Azimkozho Kenzhebek uulu",
"author_email": "azimkozho.inventor@gmail.com",
"download_url": "",
"platform": null,
"description": "sentinel2_downloader\n====================\n\nOverview\n--------\n\n`sentinel2_downloader` is a Python library that allows you to search, download, and retrieve metadata of Sentinel satellite images from the Copernicus Data Space.\n\nFeatures\n--------\n\n- Search for Sentinel satellite images based on various parameters such as footprint, date range, product type, cloud cover percentage, and platform name.\n- Download Sentinel satellite images using their product IDs.\n- Save downloaded images to the specified directory.\n- Display a progress bar during the download process, showing the download speed, elapsed time, and percentage of completion.\n\nInstallation\n------------\n\nYou can install `sentinel2_downloader` using pip:\n\n.. code:: bash\n\n pip install sentinel2_downloader\n\nUsage\n-----\n\nHere's an example of how to use `sentinel2_downloader`:\n\n.. code:: python\n\n from sentinel2_downloader import SentinelAPI\n\n # Create an instance of the SentinelAPI\n api = SentinelAPI(username='your_username', password='your_password')\n\n # Perform a search for Sentinel satellite images\n products = api.query(footprint='POLYGON((longitude1 latitude1, longitude2 latitude2, longitude3 latitude3, ...))',\n start_date='2020-01-01', end_date='2020-01-31', cloud_cover_percentage='20', product_type='MSIL1C',\n platform_name='SENTINEL-2')\n if len(products) > 1:\n for product in products:\n # Download the images\n a = api.download(product_id=product['Id'], directory_path='output')\n\n\nArgs:\n * footprint (str): The footprint to define the geographic area of interest. It should be in the Well-Known Text (WKT) format.\n * start_date (str): The start date of the data acquisition period in the format 'yyyy-mm-dd'.\n * end_date (str): The end date of the data acquisition period in the format 'yyyy-mm-dd'.\n * product_type (str): The type of Sentinel product to query.\n * cloud_cover_percentage (str): The maximum cloud cover percentage allowed.\n * platform_name (str): The name of the Sentinel platform.\n",
"bugtrack_url": null,
"license": "",
"summary": "Utility for searching and downloading satellite images Dataspace Copernicus",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/Azim-Kenzh/sentinel2_downloader"
},
"split_keywords": [
"copernicus",
"sentinel",
"satellite",
"download",
"gis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c17dc6b2f322e6129be4cb8122b7b2991d9565626b4164022d5fde96d2d9840e",
"md5": "b65d65d2bf924729af86d34718e9662c",
"sha256": "1408fedc98cf8aeec563b821ee705999f7394c3aeacdad2eddb6f1838fb061bd"
},
"downloads": -1,
"filename": "sentinel2_downloader-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b65d65d2bf924729af86d34718e9662c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 4716,
"upload_time": "2023-06-08T15:13:15",
"upload_time_iso_8601": "2023-06-08T15:13:15.091341Z",
"url": "https://files.pythonhosted.org/packages/c1/7d/c6b2f322e6129be4cb8122b7b2991d9565626b4164022d5fde96d2d9840e/sentinel2_downloader-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-08 15:13:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Azim-Kenzh",
"github_project": "sentinel2_downloader",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "requests",
"specs": []
},
{
"name": "tqdm",
"specs": []
}
],
"lcname": "sentinel2-downloader"
}
JSON
