sentineltoolbox 0.2.1

No project description provided

sentineltoolbox

This repository contains the sentineltoolbox project.

This project provides tools to manipulate sentinel products.

Sentinel products are described in Copernicus Programme documentation: https://sentiwiki.copernicus.eu/web/

Installation

• install eopf-cpm 2.4 or higher
• pip install sentineltoolbox

To include the given instructions in a README file, you can rephrase them as follows:

Setting Up and Using Sentinel Toolbox with VSCode, as a data processor developer

Installation and Configuration

To enable simultaneous updates between your processor and Sentinel Toolbox (STB) in VSCode, follow these steps:

1. Install Sentinel Toolbox: Use the command pip install -e . --config-settings editable_mode=strict to install sentineltoolbox, from the sentineltoolbox project's root. This ensures that the installation is in editable mode.

2. Ensure VSCode recognition in your processor: After installation, VSCode should recognize Sentinel Toolbox from your processor.

Using Sentinel Toolbox in VSCode

1. Accessing Files: When you CTRL+click on a file in VSCode, you may be redirected to a file with a build path.

2. Editing Files: Edit the file as needed. Since the file is a symbolic link, any changes you make should be reflected in the sentineltoolbox code.

By following these steps, you can seamlessly update and work with Sentinel Toolbox within your processor.

stb_convert_products

This tool converts original sentinel products (*.SAFE, *.SEN3) to DPR zarr products (*.zarr)

Only these products are supported:

Supported products

S3 Products (OLCI, SLSTR, SYNERGY)

• S3 OLCI

  • S3*_OL_1_EFR/ERR_*.SEN3
  • S3*_OL_1_ERR_*.SEN3
  • S3*_OL_2_LFR_*.SEN3

• S3 SLSTR

  • S3*_SL_1_RBT_*.SEN3
  • S3*_SL_2_FRP_*.SEN3
  • S3*_SL_2_LST_*.SEN3

• S3 SYNERGY

  • S3*_SY_2_AOD_*.SEN3
  • S3*_SY_2_SYN_*.SEN3
  • S3*_SY_2_VG1_*.SEN3
  • S3*_SY_2_VGP_*.SEN3
  • S3*_SY_2_VGK_*.SEN3
  • S3*_SY_2_V10_*.SEN3

S2 Products (MSI)

• S2 MSI (L1A, L1B, L1C, L2A)
  • S2*_MSIL1A_*.SAFE
  • S2*_MSIL1C_*.SAFE
  • S2*_MSIL1B_*.SAFE
  • S2*_MSIL2A_*.SAFE

How to use converter

Show help

stb_convert_product --help

dry-run

Product conversion can be very time and space consuming.

Before running conversion it is preferable to launch a dry-run: a simulation that only show expected conversion but do not really do it.

To do dry run, add --dry-run to your command.

stb_convert_product --dry-run PRODUCT_PATH
# example:
# stb_convert_products.exe --dry-run Products/OLCI/S3B_OL_1_ERR____20230506T015316_20230506T015616_20230711T065804_0179_079_117______LR1_D_NR_003.SEN3

INFO      Conversion PLANNED
INFO      [dry-run] convert
INFO      [dry-run]   - S3B_OL_1_ERR____20230506T015316_20230506T015616_20230711T065804_0179_079_117______LR1_D_NR_003.SEN3
INFO      [dry-run]   ---> .../S03OLCERR_20230506T015316_0179_B117_T409.zarr

Convert one product

To convert directly one product, pass "product path" to command

stb_convert_product PRODUCT_PATH
# example:
# stb_convert_products.exe Products/OLCI/S3B_OL_1_ERR____20230506T015316_20230506T015616_20230711T065804_0179_079_117______LR1_D_NR_003.SEN3

To specify output dir, simply use --output-dir

stb_convert_product PRODUCT_PATH --output-dir OUTPUT_DIR
# example:
# stb_convert_products.exe --output-dir ZARR/OLCI/ Products/OLCI/S3B_OL_1_ERR____20230506T015316_20230506T015616_20230711T065804_0179_079_117______LR1_D_NR_003.SEN3

Convert multiple products

To convert all products stored in one directory, use options --input-dir and --recursive.

stb_convert_product --input-dir PRODUCT_DIR --output-dir OUTPUT_DIR --recursive

Example:

stb_convert_products.exe --output-dir ZARR --input-dir Products --recursive --dry-run
INFO      Conversion PLANNED
INFO      [dry-run] convert
INFO      [dry-run]   - OLCI/S3A_OL_0_CR0____20220511T202328_20220511T202413_20220511T213302_0045_085_142______PS1_O_NR_002.SEN3
INFO      [dry-run]   ---> .../ZARR/OLCI/S03OLCCR0_20220511T202328_0045_A142_T8D0.zarr
INFO      [dry-run] convert
INFO      [dry-run]   - OLCI/S3A_OL_0_EFR____20230512T011844_20230512T012042_20230512T031619_0118_098_345______PS1_O_NR_002.SEN3
INFO      [dry-run]   ---> .../ZARR/OLCI/S03OLCL0__20230512T011844_0118_A345_TC85.zarr
INFO      [dry-run] convert
INFO      [dry-run]   - OLCI/S3A_OL_2_LFR____20191227T124111_20191227T124411_20221209T133032_0179_053_109______PS1_D_NR_002.SEN3
INFO      [dry-run]   ---> .../ZARR/OLCI/S03OLCLFR_20191227T124111_0179_A109_T27B.zarr
...