Create STAC Items from Sentinel-2 metadata
Project description
# stactools-sentinel2
stactools package for Sentinel-2 data.
## Examples
- [L1C item](./examples/sentinel2-l1c-example/S2A_T01LAC_20200717T221944_L1C/S2A_T01LAC_20200717T221944_L1C.json)
- [L2A item](./examples/sentinel2-l2a-example/S2A_T07HFE_20190212T192646_L2A/S2A_T07HFE_20190212T192646_L2A.json)
## Running
```shell
pip install stactools-sentinel2
```
SAFE archive:
```shell
stac sentinel2 create-item tests/data-files/S2A_MSIL2A_20190212T192651_N0212_R013_T07HFE_20201007T160857.SAFE output/
```
AWS Open Data bucket `sentinel-s2-l2a`:
```shell
stac sentinel2 create-item tests/data-files/S2A_OPER_MSI_L2A_TL_SGS__20181231T210250_A018414_T10SDG output/
```
Sentinel Hub metadata:
```shell
stac sentinel2 create-item --asset-href-prefix s3://sentinel-s2-l2a/tiles/34/L/BP/2022/4/1/0/ \
https://roda.sentinel-hub.com/sentinel-s2-l2a/tiles/34/L/BP/2022/4/1/0/ output
```
**Note:** this does not currently work with S3 buckets using requester-pays.
The flag `--tolerance` can be set to a decimal value to define the simplification tolerance of the Item geometry.
This is a pass-through to the [Shapely simplify method](https://shapely.readthedocs.io/en/stable/manual.html#object.simplify).
## Development
Install pre-commit hooks with:
```commandline
pre-commit install
```
Run these pre-commit hooks with:
```commandline
pre-commit run --all-files
```
Install the code in the local python env so your IDE can see it:
```commandline
pip install -e ".[dev]"
```
### Testing
Run the tests with:
```commandline
pytest -vvv
```
Most tests fixture expectations can be updated by running:
```shell
pytest --update-expectations
```
If the expectation file is missing for any test in `test_commands` it will be
generated, and the test will fail. This failure is to ensure fixture updates
don't happen silently.
Alternatively, tests can be updated by using the following command:
```shell
python scripts/create_expected.py
```
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
stactools_sentinel2-0.8.0.tar.gz
(26.9 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file stactools_sentinel2-0.8.0.tar.gz.
File metadata
- Download URL: stactools_sentinel2-0.8.0.tar.gz
- Upload date:
- Size: 26.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cedcfc65b33aa29a43aebad255583e64c92a93c759e8cbe688b562bc7ff17bc2
|
|
| MD5 |
b91044f49b5520b434ea5917c120aee7
|
|
| BLAKE2b-256 |
1f45c14281376a1f0cbb74e86349d292a9888517c17b30e4f39efbe48c3b2731
|
File details
Details for the file stactools_sentinel2-0.8.0-py3-none-any.whl.
File metadata
- Download URL: stactools_sentinel2-0.8.0-py3-none-any.whl
- Upload date:
- Size: 25.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3bd6e5d605e95d556f096fc3fad42bfe8f945d7800fea56e62938dcb69f8e996
|
|
| MD5 |
3a8e4e8149b53c3d515fcf9749da2107
|
|
| BLAKE2b-256 |
26ff803b48e1eaa38bad6904620de8356254c242dc35273c46cbc53fe6c16dfa
|