HyperSIGMA bets one backbone on seven hyperspectral tasks
The official repo for [TPAMI'25] "HyperSIGMA: Hyperspectral Intelligence Comprehension Foundation Model"
At a glance
- What is it?
- The TPAMI 2025 foundation model for hyperspectral imagery, built on sparse sampling attention, whose pretraining corpus is 20 million samples cut from 1,701 satellite scenes, and whose Apache-2.0 code licence does not extend to the research-use-only denoising data.
- Who is it for?
- Adopt HyperSIGMA if you are doing hyperspectral work and want one pretrained backbone across classification, detection, unmixing, denoising, super-resolution and change detection rather than a task-specific model, since the weights are published at three ViT sizes on Hugging Face as well as a regional drive. It does not suit a team that needs a pip-installable library, because the visible documentation offers per-task scripts and no package or install steps.
- Can I use it commercially?
- Yes. Apache-2.0 is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
- Is it still maintained?
- Yes. The repository last received commits 145 days ago.
- What is it written in?
- Mainly Python, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on October 12, 2026, and from our analysis. They are not legal advice.
Editorial analysis
Sparse sampling attention is the block everything else is built from
HyperSIGMA is described as the first billion-level foundation model built specifically for hyperspectral image interpretation, published in IEEE Transactions on Pattern Analysis and Machine Intelligence in 2025 after appearing on arXiv in June 2024.
The problem it addresses is redundancy on two axes. A hyperspectral image carries many more bands than a photograph, so the spectral axis is over-determined, and each band is itself an image, so the spatial axis repeats too. Sparse sampling attention is the mechanism introduced to deal with both, and it is the basic building block rather than one component among several. A separate spectral enhancement module then fuses the spatial and spectral features the backbone produces.
The comparison named in the repository is SpectralGPT, and the framing is that HyperSIGMA outperforms it and models designed specifically for these tasks. That framing is the whole argument for a foundation model here: if one backbone trained generically beats specialists, the specialists were solving the same problem seven times.
The breadth claim is stated as superior performance across 16 datasets and 7 tasks, covering high-level and low-level hyperspectral work plus multispectral scenes.
Seven task directories, and they are the evidence for the breadth claim
The claim about seven tasks can be checked against the repository layout, and it holds up. The top level has a directory per task family:
- `HyperspectralDetection/` for object detection in hyperspectral scenes - `ImageClassification/` for scene classification - `HyperspectralUnmixing/` for separating mixed pixels into components - `ImageDenoising/` for noise removal - `ImageSuperResolution/` for spatial upsampling - `ChangeDetection/` for hyperspectral change detection - `MultispectralCD/` for change detection in multispectral imagery - `Pretrain/` for the pretraining code itself
Two of those deserve a note. Unmixing is the one task with no mainstream consumer equivalent, since it estimates what materials are present in a pixel rather than labelling the image. And the presence of both `ChangeDetection/` and `MultispectralCD/` means the claim about multispectral scenes is backed by a separate code path rather than being an assertion.
Alongside the task directories there are `Fig/` for the paper's figures, plus `index.html` and `static/`, so the project page is served from the repository itself rather than from a separate site.
HyperGlobal-450K is 1,701 scenes cut into 20 million samples
The pretraining corpus is where the numbers need reconciling, because two figures in the README describe different things.
The text says HyperGlobal-450K contains over 20 million three-band images, collected from around the globe and far exceeding the scale of existing hyperspectral datasets. The distribution figure describes what those samples come from: 1,701 images, of which 1,486 are from EO-1 and 215 from GF-5B, each with hundreds of spectral bands.
So the corpus is 1,701 satellite scenes, and the twenty million figure counts samples derived from them rather than distinct scenes. That is the normal construction for hyperspectral pretraining, where a single scene yields many patches, but it means the effective number of independent locations is in the thousands rather than the millions, and a reader who takes twenty million at face value will overestimate scene diversity.
The word three-band also deserves a question. The source scenes have hundreds of bands while the samples are described as three-band, which implies a band selection or compression step. The visible documentation does not describe how bands are chosen or how samples are cut, so anyone intending to reproduce pretraining is relying on the paper for that step rather than on the repository.
Three MAE checkpoint sizes, and two download routes
The published pretrained models are Spatial_MAE checkpoints at three vision transformer sizes: ViT-B, ViT-L and ViT-H. Each row in the table offers a Baidu Drive link and a Hugging Face link, and the Hugging Face filenames encode the configuration, for example a base and a large checkpoint both ending in the same numeric suffix.
Having the weights on Hugging Face matters for reproducibility, since one route is a plain model repository and the other is a regional file-sharing service whose links carry an access password in the query string. The latter was also the only route listed for the large pretraining dataset until a later update added a Baidu Drive entry for it.
Alongside the base models there are task-specific artefacts released on their own schedule: super-resolution scripts, denoising checkpoints, and denoising datasets. That staggered release pattern is worth noting when planning a task, since the code for one task directory and the weights for another may have arrived months apart, and only the latest entry in the update log mentions both.
What is not published in the visible documentation is any install step, environment specification or usage snippet. The table of models is cut off mid-link, so the full list of released checkpoints is not readable here.
Apache-2.0 on the code, research use only on some of the data
The repository declares Apache-2.0, and for a research artefact that is a permissive choice with one significant exception.
The denoising datasets are described as released for research use only. That is a narrower grant than Apache-2.0 and it applies to data rather than code, so the two coexist in one repository without either overriding the other. A commercial team that trains on the denoising data inherits a term the code licence says nothing about.
The pretraining corpus is a separate question again. HyperGlobal-450K is distributed through its own dataset pages, and the visible text does not restate a licence for it, so its terms have to be read where it is hosted rather than assumed from the repository's own file.
For anyone planning derived work, the practical checklist is therefore: read the Apache-2.0 file for the code, read the denoising dataset terms before touching those images, and read the dataset page for the pretraining corpus, since none of the three is stated by the other two.
Recent updates are citations, and the code has not moved since May
The update log is worth reading as a status report, because its recent entries are about reception rather than software.
The last three entries are a Highly Cited Paper selection in November 2025, the addition of a drive link for the pretraining dataset later that month, and an ESI Hot Paper selection in May 2026. Before that come the substantive ones: acceptance by TPAMI in March 2025, an expanded arXiv version and the release of HyperGlobal-450K in April 2025, the online publication in April 2025, and the task scripts and checkpoints through 2024.
So no code or model change has been recorded in the log since the summer of 2024, and the last push to the repository was on 2026-05-20, the same date as the Hot Paper announcement. The repository is not archived.
There are no tagged releases either, so versions come from checkpoint filenames rather than from a tag, and the arXiv version in circulation is the older of the two published forms, with the README noting that it was updated in April 2025 with more detail than the original June 2024 posting.
None of that makes the artefact wrong. It makes it a paper with released weights and per-task scripts, which is a different kind of thing from a library that tracks its upstream data and dependencies.
Editorial conclusion
Adopt HyperSIGMA if you are doing hyperspectral work and want one pretrained backbone across classification, detection, unmixing, denoising, super-resolution and change detection rather than a task-specific model, since the weights are published at three ViT sizes on Hugging Face as well as a regional drive. It does not suit a team that needs a pip-installable library, because the visible documentation offers per-task scripts and no package or install steps. Verify first what your sensor's band count implies for the pretrained checkpoints, whether the research-use-only datasets cover the task you are attempting, and whether the per-task scripts under each task directory run against the checkpoint naming you have, since the visible README is truncated inside the model table.
Frequently asked questions
What is HyperSIGMA and what problem does it solve?
A billion-parameter foundation model for hyperspectral image interpretation, published in IEEE TPAMI in 2025. It introduces sparse sampling attention to handle the redundancy hyperspectral imagery has along both the spectral and spatial axes, and adds a spectral enhancement module to fuse the two.
Which tasks does HyperSIGMA support?
Seven task families, each with its own directory: hyperspectral detection, image classification, hyperspectral unmixing, image denoising, image super-resolution, hyperspectral change detection and multispectral change detection, plus a pretraining directory. The README claims superior performance across 16 datasets on those tasks.
How large is the HyperGlobal-450K pretraining dataset?
The README describes over 20 million three-band samples, drawn from 1,701 satellite images comprising 1,486 EO-1 and 215 GF-5B scenes with hundreds of spectral bands each. The twenty million figure counts samples rather than distinct scenes.
Where can I download the HyperSIGMA pretrained models?
Spatial_MAE checkpoints at ViT-B, ViT-L and ViT-H size are offered from both Baidu Drive and Hugging Face. Super-resolution scripts and denoising checkpoints were released separately, and the pretraining dataset is on its own dataset page with a drive link added later.
Can I use HyperSIGMA commercially?
The repository code is under Apache-2.0, but the denoising datasets are explicitly released for research use only, and the pretraining corpus states its terms on its own hosting page. Read each separately rather than assuming the repository licence covers the data.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/whu-sigma-hypersigma)