Skip to main content

SYNAPSE-SR, Sentinel-2 super-resolution

SYNAPSE-SR: Sentinel-2 super-resolution to 2 m

Sentinel-2 at 2 m, with every pixel accounted for

PyPI PyPI Downloads tests docs Hugging Face weights Open in Colab Open in Kaggle 5-minute video explainer GitHub stars

RV University, Bengaluru: Sentinel-2 10 m and synapse-sr 2 m

Free Sentinel-2 imagery of anywhere on Earth, enhanced from 10 m to 2 m resolution, on a laptop.
If it is useful to you, a ⭐ helps other people find it.

synapse-sr turns a Sentinel-2 L2A scene into a 2.0 m red / green / blue / near-infrared GeoTIFF. A physical model of the instrument pins everything the satellite measured. The network only adds what 10 m pixels cannot show, and every output says which pixels came from the measurement and which came from the learned prior.

pip install synapse-sr
import synapse_sr

r = synapse_sr.super_resolve("sentinel2_l2a.tif")   # progress bar, then a 5x larger result
r.save("sentinel2_2m.tif")                           # georeferenced, same CRS and bounds
r.summary()                                          # size, consistency, support, time
synapse-sr sentinel2_l2a.tif sentinel2_2m.tif        # the same from the shell
synapse-sr --fetch 12.92,77.50 --dates 2025-01-01:2025-03-15 out.tif --preview preview.png   # download + run
synapse-sr scenes/ scenes_2m/ --cog                  # a whole folder, as Cloud-Optimised GeoTIFFs

Every common task on one page: cheat sheet. AI assistants and agents can read the whole documentation from llms.txt.

On real places

Bengaluru city centre: Sentinel-2 10 m and synapse-sr 2 m
Bengaluru city centre
Farm fields in Punjab: Sentinel-2 10 m and synapse-sr 2 m
Farm fields, Punjab
Wayanad landslide area: Sentinel-2 10 m and synapse-sr 2 m
Wayanad landslide, Kerala

Each pair is the same Sentinel-2 L2A scene at its native 10 m and after synapse-sr. Run your own place with synapse-sr --fetch LAT,LON out.tif, or watch the 5-minute explainer.

Benchmarks

Official opensr-test protocol (Aybar et al.): Sentinel-2 L2A input, harmonised high-resolution references, opensr_test.Metrics() defaults, mean over its five datasets (NAIP, SPOT, Spain urban, Spain crops, VENµS; 178 scenes). Every model at its native scale, compared on the reference grid.

Official Sentinel-2 super-resolution benchmark: SYNAPSE leads on 5 of 7 measures

Model Improvement ↑ Omission ↓ Hallucination ↓ Detail corr. ↑ RMSE ↓ Spectral error ↓ Reflectance error ↓
SYNAPSE Flash 0.155 0.748 0.097 0.300 0.0234 0.401 0.0018
SYNAPSE Pro 0.199 0.631 0.171 0.289 0.0254 0.223 0.0011
SEN2SR 0.150 0.759 0.091 0.284 0.0235 0.665 0.0025
SEN2SR-Lite 0.152 0.749 0.099 0.290 0.0234 0.463 0.0019
LDSR-S2 0.197 0.599 0.204 0.206 0.0240 1.015 0.0036
Satlas ESRGAN 0.129 0.181 0.690 0.089 0.0443 7.787 0.0242
Bicubic 0.102 0.830 0.068 0.279 0.0234 0.601 0.0028

Best in bold. SYNAPSE runs with the package defaults (synapse_sr.super_resolve). SYNAPSE is best on five of the seven columns: Pro on improvement, spectral and reflectance error, Flash on detail correlation and (tied) RMSE. Flash processes a 1.28 km scene in about 1 s on a laptop CPU; Pro in about 5 s on a GPU.

What it is for

One line
Crop monitoring r.indices()["ndvi"], synapse_sr.boundaries(r, "field") NDVI, SAVI, EVI, red-edge NDRE, field edges at 2 m
Urban analysis synapse_sr.boundaries(r, "urban"), r.indices()["ndbi"] buildings, roads, built-up index
Water and floods synapse_sr.change(before, after, "ndwi") flooded area in km², shoreline strength
Disaster assessment synapse_sr.change(before, after, "nbr") burn scars, landslides, debris; changes flagged only where both dates are trustworthy

Worked examples for each: Applications.

Flash or Pro

Flash (default) Pro
Network ~0.6 M-parameter re-parameterised CNN, distilled from Pro 14.4 M-parameter state-space (Mamba) model
Speed (1.28 km scene) ~1 s on a laptop CPU; 10 km x 10 km in ~14 s ~5 s on a GPU (Colab / Kaggle T4, workstations)
Runs on any CPU, laptops, integrated graphics, Apple silicon, ARM, any GPU GPU recommended; CPU works, slower
Choose it synapse_sr.super_resolve(src) synapse_sr.super_resolve(src, model="pro")
Load Flash.from_pretrained() Pro.from_pretrained()
Tuned for balanced fidelity: best detail correlation, lowest RMSE (tied), measured 10 m mean reflectance restored exactly maximum detail: best improvement, spectral and reflectance error
Physics, support map, calibrated uncertainty yes yes

Both run the same observation-consistent pipeline. Use Flash for speed, anywhere-deployment and the most faithful output, Pro for the most recovered detail on a GPU. synapse-sr --models lists every published checkpoint.

Why trust the output

import synapse_sr
r = synapse_sr.super_resolve("scene.tif")

r.x_base        # what the 10 m observation determines
r.prior         # what the network added (x_base + prior == image), invisible to the sensor
r.support       # per pixel: 2 observation-determined, 1 medium, 0 prior-dominated or invalid
r.uncertainty() # calibrated expected error per pixel and band
r.consistency   # how closely re-observing the output reproduces the input, in sensor-noise units

x_hat = x_base + P_N(delta): P_N removes every component the sensor could have seen from the network's output, so the network cannot contradict the measurement. See How it works.

Runs everywhere

Platform What you get
Colab / Kaggle GPU Pro with a Triton scan kernel, compiled on first use (no extra installs)
Linux GPU + mamba-ssm fused CUDA kernel (pip install "synapse-sr[cuda]")
Windows / macOS / CPU-only / ARM exact PyTorch path; Flash recommended
Offline / air-gapped Pro.from_pretrained(weights="model.safetensors")

synapse-sr --env shows what is active on your machine.

See Hardware compatibility for the full device and runtime matrix (CUDA, ROCm, MPS, OpenVINO, ONNX Runtime, TensorRT), including preview backends.

Documentation

Quick start · Colab and Kaggle · Applications · Examples · API

Contributing

See CONTRIBUTING.md. Report security issues privately per SECURITY.md; accessibility barriers are tracked as bugs, see ACCESSIBILITY.md. Bug reports and feature requests use the issue templates; pull requests follow the PR template checklist.

Citation and acknowledgements
@software{synapse_sr,
  title  = {synapse-sr: observation-consistent super-resolution of Sentinel-2 imagery},
  author = {Naidu, Sharadh},
  year   = {2026},
  url    = {https://github.com/SharadhNaidu/synapse-sr}
}
  • Third-party components and their licences are listed in THIRD_PARTY_NOTICES.
  • The optional fused kernel comes from mamba-ssm (Apache-2.0).
  • Sentinel-2 data: Copernicus programme, European Space Agency.

Star history

Star history of synapse-sr

Metadata

Release files for synapse-sr 0.4.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for synapse-sr 0.4.3
File Size Uploaded Provenance Actions
synapse_sr-0.4.3.tar.gz 92.8 kB With provenance Details for synapse_sr-0.4.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for synapse-sr 0.4.3
File Interpreter ABI Platform Actions
synapse_sr-0.4.3-py3-none-any.whl Python 3 none any Details for synapse_sr-0.4.3-py3-none-any.whl

Total release size: 178.8 kB

Release files / synapse_sr-0.4.3.tar.gz

Download URL synapse_sr-0.4.3.tar.gz
Size 92.8 kB
Tags Source
SHA-256 checksum
How to use checksums
1a6ca32b02040f4652e5d6581fb5ca47e63d48d424a6507afadc961a83360820
BLAKE2b-256 checksum
How to use checksums
352831bd9f3f36942f4e2a2b0c14400af7789da74796a5830290a6b09d650899
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / synapse_sr-0.4.3-py3-none-any.whl

Download URL synapse_sr-0.4.3-py3-none-any.whl
Size 86.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
760c72b960ca35419bc9387f2d8d7ae507f394a5b8e8ee2758345142d1720d01
BLAKE2b-256 checksum
How to use checksums
e2b46fe5437adb4cd0dcdbd837380de5f89ab3763fb89266e731a334ef8c4afd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for synapse-sr 0.4.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for synapse_sr-0.4.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page