stactools-sentinel2

# 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
```

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)

Uploaded Jun 17, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

stactools_sentinel2-0.8.0-py3-none-any.whl (25.2 kB view details)

Uploaded Jun 17, 2025 Python 3

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: Jun 17, 2025
Size: 26.9 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.4

File hashes

Hashes for stactools_sentinel2-0.8.0.tar.gz
Algorithm	Hash digest
SHA256	`cedcfc65b33aa29a43aebad255583e64c92a93c759e8cbe688b562bc7ff17bc2`
MD5	`b91044f49b5520b434ea5917c120aee7`
BLAKE2b-256	`1f45c14281376a1f0cbb74e86349d292a9888517c17b30e4f39efbe48c3b2731`

See more details on using hashes here.

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: Jun 17, 2025
Size: 25.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.4

File hashes

Hashes for stactools_sentinel2-0.8.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`3bd6e5d605e95d556f096fc3fad42bfe8f945d7800fea56e62938dcb69f8e996`
MD5	`3a8e4e8149b53c3d515fcf9749da2107`
BLAKE2b-256	`26ff803b48e1eaa38bad6904620de8356254c242dc35273c46cbc53fe6c16dfa`