d-v-b · d-v-b · Jun 21, 2026 · Jun 21, 2026 · Jun 21, 2026 · Jun 22, 2026
diff --git a/.gitignore b/.gitignore
@@ -218,3 +218,4 @@ uv.lock
 # VCS versioning
 src/eopf_geozarr/_version.py
 analysis/.edh_token
+docs/superpowers/
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.10.1"
+  ".": "0.10.2"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.10.2 (2026-07-17)
+
+## What's Changed
+* ci(deps): bump the actions group with 3 updates by @dependabot[bot] in https://github.com/EOPF-Explorer/data-model/pull/185
+* bump zarr conventions; migrate type checking to pyright by @d-v-b in https://github.com/EOPF-Explorer/data-model/pull/199
+* fix(conversion): concurrent-safe source opening (native-chunk-aligned reads + atomic CacheStore) for data-pipeline#339 by @lhoupert in https://github.com/EOPF-Explorer/data-model/pull/220
+
+
+**Full Changelog**: https://github.com/EOPF-Explorer/data-model/compare/v0.10.1...v0.10.2
+
 ## 0.10.1 (2026-06-09)
 
 ## What's Changed

diff --git a/README.md b/README.md
@@ -183,7 +183,6 @@ dt_geozarr = create_geozarr_dataset(
     output_path="s3://my-bucket/geozarr-data/output.zarr",
     spatial_chunk=4096,
     min_dimension=256,
-    tile_width=256,
     max_retries=3
 )
 ```
@@ -207,7 +206,6 @@ dt_geozarr = create_geozarr_dataset(
     output_path="path/to/output/geozarr.zarr",
     spatial_chunk=4096,
     min_dimension=256,
-    tile_width=256,
     max_retries=3
 )
 ```
@@ -227,7 +225,6 @@ Create a GeoZarr-spec 0.4 compliant dataset from EOPF data.
 - `output_path` (str): Output path for the Zarr store
 - `spatial_chunk` (int, default=4096): Spatial chunk size for encoding
 - `min_dimension` (int, default=256): Minimum dimension for overview levels
-- `tile_width` (int, default=256): Tile width for TMS compatibility
 - `max_retries` (int, default=3): Maximum number of retries for network operations
 
 **Returns:**
@@ -283,6 +280,71 @@ Check if a variable is a grid_mapping variable by looking for references to it.
 
 Validate that a specific band exists and is complete in the dataset.
 
+## Supported Products
+
+### Sentinel-2 MSI
+
+Sentinel-2 MSI (MultiSpectral Instrument) L1C and L2A products are detected
+automatically by `eopf-geozarr convert` and routed to the optimized multiscale
+layout (`convert-s2-optimized`).  The three native resolution groups (10 m, 20 m,
+60 m) are reused as-is and coarser overviews (120 m, 360 m, 720 m) are computed
+via /2 downsampling.
+
+### Sentinel-3 OLCI L1 EFR
+
+Sentinel-3 OLCI (Ocean and Land Colour Instrument) Level-1 EFR (Full Resolution)
+products are detected automatically by `eopf-geozarr convert` and routed to the
+dedicated OLCI converter.  Unlike Sentinel-2, OLCI data starts out on **native
+swath geometry**: measurements are stored on a per-pixel 2-D lat/lon grid.  The
+exporter warps this curvilinear swath once onto a regular grid (default
+`EPSG:4326`) so that the output is a standard GeoZarr raster.
+
+#### Auto-detection
+
+```bash
+eopf-geozarr convert S3A_OL_1_EFR.zarr output.zarr
+```
+
+#### Dedicated command
+
+```bash
+eopf-geozarr convert-s3-olci-optimized S3A_OL_1_EFR.zarr output.zarr \
+    --spatial-chunk 1024 \
+    --min-dimension 256 \
+    --compression-level 3
+```
+
+Key flags:
+
+- `--spatial-chunk` — target spatial chunk size in pixels (default: 1024)
+- `--compression-level` — Blosc/zstd compression level 1–9 (default: 3)
+- `--min-dimension` — stop generating /2 overview levels once either spatial
+  dimension would drop below this value (default: 256)
+- `--enable-sharding` — accepted but not yet wired into encoding (follow-up task)
+- `--keep-scale-offset` — accepted but not yet wired into encoding (follow-up task)
+- `--target-crs` — target CRS for the reprojected output grid (default: `EPSG:4326`)
+
+#### What is converted
+
+- **`/measurements/r0`**: all 21 OLCI radiance bands warped once from the
+  native swath onto a regular grid (default `EPSG:4326`, ~300 m preserved),
+  with 1-D `y`/`x` coordinates, a `spatial_ref` variable, and `grid_mapping`
+  on every band; the parent `measurements/` group carries the GeoZarr
+  `multiscales`, `spatial:`, and `proj:` convention metadata.
+- **Overview subgroups** (`r2`, `r4`, …): /2 fill-aware block-averaged copies
+  stored as sibling Zarr groups next to `r0`, each with its own CRS metadata.
+- **`/conditions` and `/quality`**: copied through unmodified.
+
+> **Note:** per-scan-line `time_stamp` is not representable on a regular grid
+> and is dropped from the converted measurements (it remains in the source
+> product).
+
+> **Note:** OLCI support is initial/measurements-focused (v1).  Tie-point grid
+> groups (`conditions/geometry`, `meteorology`, `instrument`) are copied through but
+> not converted to GeoZarr convention.  Encoding wiring for `--enable-sharding`,
+> `--spatial-chunk`, `--compression-level`, and `--keep-scale-offset` is accepted
+> but scheduled as a follow-up task.
+
 ## Architecture
 
 The library is organized into the following modules:

diff --git a/docs/converter.md b/docs/converter.md
@@ -177,6 +177,68 @@ dt_optimized = convert_s2_optimized(
 
 The result is a space-efficient multiscale pyramid: `/measurements/reflectance/{r10m, r20m, r60m, r120m, r360m, r720m}` where the native resolutions are preserved as-is and only the coarser levels are computed.
 
+## Sentinel-3 OLCI L1 EFR Conversion
+
+Sentinel-3 OLCI (Ocean and Land Colour Instrument) Level-1 EFR (Full Resolution)
+products are supported.  OLCI measurements start out on **native swath geometry**:
+a per-pixel 2-D lat/lon grid.  The converter reprojects (warps) the swath measurements
+once onto a regular grid (default `EPSG:4326`) using the swath geolocation arrays,
+then generates /2 fill-aware block-averaged overview subgroups for multi-resolution
+access.
+
+### Auto-detection
+
+The generic `convert` command detects OLCI products automatically:
+
+```bash
+eopf-geozarr convert S3A_OL_1_EFR.zarr output.zarr
+```
+
+### Dedicated command
+
+A dedicated command offers fine-grained control:
+
+```bash
+eopf-geozarr convert-s3-olci-optimized S3A_OL_1_EFR.zarr output.zarr \
+    --spatial-chunk 1024 \
+    --min-dimension 256 \
+    --compression-level 3
+```
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--spatial-chunk` | 1024 | Target spatial chunk size in pixels |
+| `--compression-level` | 3 | Blosc/zstd compression level (1–9) |
+| `--min-dimension` | 256 | Minimum spatial dimension for overview levels |
+| `--enable-sharding` | off | Accepted but not yet wired into encoding (follow-up task) |
+| `--keep-scale-offset` | off | Accepted but not yet wired into encoding (follow-up task) |
+| `--target-crs` | EPSG:4326 | Target CRS for the reprojected output grid |
+
+### Output layout
+
+```
+output.zarr/
+├── measurements/        # Carries multiscales + spatial: + proj: convention metadata
+│   ├── r0/             # Warped native-resolution OLCI bands (oa01_radiance … oa21_radiance)
+│   │                   # with 1-D y/x coordinates and spatial_ref
+│   ├── r2/             # 1/2-resolution overview
+│   ├── r4/             # 1/4-resolution overview
+│   └── ...
+├── conditions/          # Copied through unmodified (tie-point geometry, meteorology)
+└── quality/             # Copied through unmodified (quality flags)
+```
+
+Each measurement group carries GeoZarr `spatial:` and `proj:` convention metadata,
+with 1-D `y`/`x` dimension coordinates and a `spatial_ref` variable referenced by
+`grid_mapping` on every band.  Per-scan-line `time_stamp` is dropped, since it has
+no representation on a regular grid.
+
+> **Note:** OLCI support is initial/measurements-focused (v1).  Tie-point grid
+> groups in `conditions/geometry`, `meteorology`, and `instrument` are copied
+> through but not converted to GeoZarr convention.  Encoding wiring for
+> `--enable-sharding`, `--spatial-chunk`, `--compression-level`, and
+> `--keep-scale-offset` is accepted but scheduled as a follow-up task.
+
 ## Error Handling
 
 The converter includes robust error handling and retry logic for network operations, ensuring reliable processing even in challenging environments.