# Overview

#### Welcome to Hydrosat's documentation site!

Whether you're getting started with Hydrosat imagery, building advanced workflows, or just curious about thermal data and its applications, here you'll find tutorials, API references, and guides to help you get the most out of our products.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><h4>Thermal Basics</h4></td><td>Learn the fundamentals of thermal imagery.</td><td><a href="/thermal-data/explore-thermal">Explore Thermal</a></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2Fj9VOLgTbUSuQrgImh9xc%2FScreenshot%202026-07-31%20at%2012.41.48%E2%80%AFPM.png?alt=media&amp;token=255138c5-3f26-40a6-b8a3-d1f0c5edab4a">Screenshot 2026-07-31 at 12.41.48 PM.png</a></td></tr><tr><td><h4>Satellite Technology</h4></td><td>Get to know Hydrosat's on-orbit sensors.</td><td><a href="/thermal-data/satellite-technology">Satellite Technology</a></td><td data-object-fit="contain"><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2Fh958VKH3aUHBwReSbuzy%2FYAM-7-pose-1.png?alt=media&amp;token=2759cbec-2816-4b78-adf4-2c18be3d2bb2">YAM-7-pose-1.png</a></td></tr><tr><td><h4>Data Discovery Portal</h4></td><td>See how you can explore our imagery archive.</td><td><a href="/data-discovery-platform/discovery-portal">Data Discovery Portal</a></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FdinIg2xWKvOLQdTOdyiq%2FPicture1.png?alt=media&amp;token=21ad99b0-3fbe-4253-8b1c-8c22e18f0ea6">Picture1.png</a></td></tr><tr><td><h4>Use Cases</h4></td><td>Explore real case studies with Hydrosat data.</td><td><a href="/thermal-data/use-cases">Use Cases</a></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2F6uhIdvNQG0XxWoWqfzFO%2FScreenshot%202026-08-12%20at%201.57.24%E2%80%AFPM.png?alt=media&amp;token=39bc3652-47cf-4eb9-a64a-f1b299b3e51a">Screenshot 2026-08-12 at 1.57.24 PM.png</a></td></tr><tr><td><h4>Product Details</h4></td><td>Find information on our available imagery products.</td><td><a href="/thermal-data/product-details">Product Details</a></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FiQmiIZU5e5w1tdD4mZGR%2FPicture1.png?alt=media&amp;token=efa21751-51b2-4d24-be79-13c5e281c71e">Picture1.png</a></td></tr><tr><td><h4>API Reference</h4></td><td>Read through our STAC API documentation.</td><td><a href="/data-discovery-platform/stac-api-documentation">STAC API</a></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FzlcuVDtoMQLT65VEFMF3%2FScreenshot%202026-08-12%20at%202.39.34%E2%80%AFPM.png?alt=media&amp;token=8880e5f7-4422-442e-932a-f867b43af19a">Screenshot 2026-08-12 at 2.39.34 PM.png</a></td></tr></tbody></table>

{% hint style="warning" icon="user-question" %}
Please reach out to us at <support@hydrosat.com> if you have any questions. We’ll get back to you as soon as we can.
{% endhint %}


# Explore Thermal

Understand thermal imagery and how to apply it.

Thermal imagery is unique. By capturing heat emitted directly by the Earth's surface, it reveals physical processes that drive changes across landscapes. Here, we'll build some intuition about how thermal imaging works and why it's fundamentally distinct from other remote sensing techniques.

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2Fp9qWwCvRgiHsT7ppWnGN%2FScreenshot%202026-07-31%20at%2012.41.48%E2%80%AFPM.png?alt=media&amp;token=edfb78e2-dfd1-456d-aef4-5e3e3c3385e5" alt=""><figcaption><p>Thermal imagery reveals patterns that are invisible to the human eye. <br><em>Imagery © 2025 Hydrosat.</em></p></figcaption></figure></div>

## Thermal Imaging 101

Every object with a temperature above absolute zero emits electromagnetic radiation. Hotter objects emit more energy, a relationship described by blackbody radiation curves:

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FVX8u6d0JbHtU6vYcymQh%2FScreenshot%202026-07-30%20at%202.02.34%E2%80%AFPM.png?alt=media&amp;token=432c2b91-fda4-4b56-a723-d2953de252d8" alt=""><figcaption><p>Blackbody radiation provides the physical basis for measuring temperature from space.</p></figcaption></figure></div>

Real-world materials aren't perfect blackbodies, but they follow the same fundamental behavior. As temperature increases, the total emitted energy increases. Thermal sensors exploit this relationship by measuring emitted radiation in specific infrared wavelengths.

This means that thermal imagery and traditional optical imagery observe fundamentally different things. Optical sensors measure sunlight reflected from the Earth's surface, just like how our eyes see the world. But thermal sensors directly measure that emitted radiation, providing a unique lens into how landscapes store and release heat, rather than just how they look. By extension, this also means that thermal sensors can operate both day and night, enabling continuous observation even after sunset.

## From Radiance to Temperature

Thermal sensors don't measure temperature directly. Instead, they measure the amount of infrared radiation that reaches the detector. That measured signal depends not only on the temperature of the Earth's surface, but also on the physical properties of the surface, as well as the atmosphere between the surface and the satellite. Let's break down how we account for those factors to translate measurements into meaningful temperature values.

### The Role of Emissivity

Different materials emit thermal radiation with different efficiencies. This is a concept known as emissivity. A perfect blackbody has an emissivity of 1; it emits the maximum possible radiation for its temperature. Real-world materials have lower emissivities, and those emissivities can vary significantly depending on the material type. This means that two surfaces at the same physical temperature can emit very different amounts of thermal radiation. For example, metals are highly reflective, so they absorb less and emit less radiation than vegetation or bare soil does. Without accounting for emissivity, a thermal sensor can't distinguish whether a difference in measured radiation is actually due to temperature or to variability in surface properties.

### The Role of the Atmosphere

As emitted radiation from the surface makes its way to the satellite, it must pass through the atmosphere. Along the way, gases like water vapor and carbon dioxide absorb and re-emit part of the thermal signal. So by the time the radiation reaches the detector, it has already been modified by the atmosphere. Atmospheric correction algorithms estimate and remove these effects to better recover the true surface signal.

### Deriving Surface Temperature

We've seen that thermal sensors measure emitted infrared radiation, not temperature directly. Since many users require knowledge of Earth's surface temperature (LST), LST retrieval algorithms, like the one implemented by Hydrosat, work backward from radiance. These physics-based models correct for atmospheric effects, account for surface emissivity, and apply the principles of thermal radiation to produce a physically meaningful estimate of LST that can be compared across different locations and over time.

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FlRVWhxO1pEA6RoN1TMir%2FScreenshot%202026-07-30%20at%203.21.09%E2%80%AFPM.png?alt=media&amp;token=3a610880-c772-4a1c-a866-bf06386baf6c" alt=""><figcaption><p>Surface temperature changes dynamically from day to day. Users can leverage this signal to understand how landscapes respond to different environmental conditions.</p></figcaption></figure></div>

Unlike many landscape characteristics that change gradually over the course of weeks or months (e.g., vegetation greenness), LST is one of the most dynamic properties of the Earth's surface. Adjacent agricultural fields might differ by several degrees because of differences in vegetation or moisture levels. A single location may experience large temperature swings throughout the day as it absorbs and releases heat. Frequent, high-resolution LST observations capture these dynamics help users identify anomalies, monitor environmental conditions, and better understand the processes driving change across ecosystems.


# Understanding Our Products

Now that you've got the basics down, let's look at how Hydrosat's data products fit in.

Hydrosat's data processing pipeline translates measurements from our satellites into progressively higher-level data products, ranging from raw sensor observations to analysis-ready surface temperature.&#x20;

The bottom line is that every pixel in a thermal image tells a story, but the context for that story depends on exactly which data product you're looking at.&#x20;

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FtoWHsxZWC0WBd1kbqhtO%2FPicture1.png?alt=media&amp;token=551030b8-bbd9-4f6b-8868-64649475b242" alt=""><figcaption><p>Each data product represents a different physical quantity and therefore can be used for different analyses.</p></figcaption></figure></div>

{% stepper %}
{% step %}

## Level-1A Radiance

If you're using the Level-1A data product, you're looking at the closest representation of what the satellite saw.&#x20;

Level-1A pixels are at-sensor radiance values in units of watts per square meter per steradian per micrometer (W/m²/sr/µm). You can think of this as the uncorrected thermal radiation that reached the detector after traveling through the atmosphere.

Radiance data is a good choice if you're interested in applying your own higher-level processing or developing advanced workflows. It's not the best choice if you want to dive right into analyzing conditions at the land surface.
{% endstep %}

{% step %}

## Level-1B Brightness Temperature

The Level-1B brightness temperature product is still a direct representation of what the satellite observed, but it's a little more intuitive to work with than Level-1A radiance.

Pixel values represent the apparent temperature in units Kelvin based solely on the radiation measured by the satellite. In other words, this is the temperature a blackbody would need to have in order to emit that amount of radiation.

You might use brightness temperature if you want an intuitive thermal measurement that avoids additional assumptions and uncertainties introduced during Level-2 processing.
{% endstep %}

{% step %}

## Level-2 Surface Temperature

The Level-2 data product is our best estimate of what's happening at the Earth's surface, after accounting for emissivity and the atmosphere.

Each pixel value is a temperature in units Kelvin that describes how hot the Earth's surface was—including vegetation, soil, water, pavement, and other surfaces—at the moment the satellite passed overhead.

If you're interested in monitoring something like urban heat, vegetation dynamics, or drought, surface temperature will give you the most direct window into that process.

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2F1ZBfSG72K1ag71CLubRa%2FPicture1.png?alt=media&amp;token=84e9a41b-d330-4f79-8505-433a97e067a4" alt=""><figcaption><p>Unlike Level-1 products, which describe what the satellite directly measured, Level-2 products estimate the physical state of the Earth's surface by correcting for atmospheric effects and emissivity. <em>Imagery © 2025 Hydrosat.</em></p></figcaption></figure></div>
{% endstep %}
{% endstepper %}


# Use Cases

Learn how thermal imagery can be applied to real-world challenges.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Agriculture</strong></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FL10sRM4siqlFPZP95duW%2Fbernd-dittrich-MbL4KOV5stM-unsplash.jpg?alt=media&amp;token=49b7959f-8479-422a-9e22-e406d621d653">bernd-dittrich-MbL4KOV5stM-unsplash.jpg</a></td><td></td></tr><tr><td><strong>Wildfire</strong></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FMvuCyO0Rxmi8RyNqlW1o%2Fivan-bandura-Rb0AyRGE7LE-unsplash-lowres.jpg?alt=media&amp;token=8eb73e0d-f900-4ea2-a8f5-ad6a42b4f894">ivan-bandura-Rb0AyRGE7LE-unsplash-lowres.jpg</a></td><td><a href="/thermal-data/use-cases/wildfire">Wildfire</a></td></tr><tr><td><strong>Urban Heat</strong></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FxEEILvPuXgjL4DB7mJem%2Furban-heat%402x.jpg.webp?alt=media&amp;token=d74601e7-eb58-4c6c-9306-cdff6cfc72ef">urban-heat@2x.jpg.webp</a></td><td></td></tr><tr><td><strong>Energy &#x26; Industrial</strong></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FR0sZc71GGWOAiEu3XqWd%2Fenergy%402x.jpg.webp?alt=media&amp;token=682ae29b-f151-4dcd-985f-cacabeaacc0a">energy@2x.jpg.webp</a></td><td><a href="/thermal-data/use-cases/energy-and-industrial">Energy &amp; Industrial</a></td></tr><tr><td><strong>Defense &#x26; Intelligence</strong></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FdTmMxlbSeXfQL3H2xLlS%2Fdefence%402x.jpg.webp?alt=media&amp;token=c84ef799-179c-43f9-8009-cef384af8cc7">defence@2x.jpg.webp</a></td><td></td></tr><tr><td><strong>Forestry</strong></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FXJB0Ww7gZK9VPt8CK5gy%2Fmitchell-luo-Cip_dNOVI0A-unsplash.jpg?alt=media&amp;token=0e4cdc38-a23a-4a4e-ad53-fc2ecadb7424">mitchell-luo-Cip_dNOVI0A-unsplash.jpg</a></td><td></td></tr></tbody></table>

{% hint style="warning" icon="spinner" %}

#### This page is under construction. Check back soon for more detailed examples and case studies!

{% endhint %}


# Energy & Industrial

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Activity patterns at a Kuwait refinery</strong></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2Fzrh0MieHCnu7jcweIooz%2FKNPC-Ahmadi-Refinery-Kuwait.jpg?alt=media&amp;token=2c41f925-92ba-4280-9e18-90fb54ca23cb">KNPC-Ahmadi-Refinery-Kuwait.jpg</a></td><td><a href="/thermal-data/use-cases/energy-and-industrial/industrial-monitoring-with-thermal-imagery">Activity patterns at a Kuwait refinery</a></td></tr><tr><td><strong>Environmental compliance at Tata Steel</strong></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FIoLP9iZjljgWBS76ANLX%2Fimages.jpeg?alt=media&amp;token=239d1e4a-191e-4c0c-ac23-7d3a93746df1">images.jpeg</a></td><td><a href="/thermal-data/use-cases/energy-and-industrial/industrial-tata-steel">Environmental compliance at Tata Steel (IJmuiden, Netherlands)</a></td></tr></tbody></table>


# Activity patterns at a Kuwait refinery

Industrial facilities contain many processes that generate, transfer, or release heat. While these processes may be difficult to distinguish in visible imagery alone, thermal imagery provides an effective way to observe activity across a site and over time.&#x20;

By comparing thermal observations temporally, we can identify changes in heat signatures associated with operational units, flaring, water discharge, and other industrial processes.&#x20;

## Seeing industrial activity in thermal data

The images below show Hydrosat longwave infrared observations of the Mina Al-Ahmadi and Mina Abdullah refinery sites in Kuwait.&#x20;

At first glance, visible imagery provides useful context about the layout of the facilities. Thermal imagery adds another layer of information by showing differences in emitted heat across the site.&#x20;

<div align="center" data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2F4NJ4wMwoKLhnlWKzU9cW%2FIM_Blog1.jpg?alt=media&amp;token=fe82fb7b-b601-4e76-b7ae-6bcc93378225" alt="" width="563"><figcaption><p>A 70 x 70km Hydrosat scene shown in the visible and thermal bands, with an industrial center highlighted. </p></figcaption></figure></div>

Areas with stronger thermal signals stand out from their surroundings, making it possible to see where heat-producing processes are occurring within a large and complex industrial facility.&#x20;

### Looking at change over time

A single thermal image provides a snapshot. Because industrial processes are so dynamic, repeated observations make it possible to compare activity from one date to another.&#x20;

Hydrosat collected multiple observations of the refinery sites between September 2025 and January 2026, including both daytime and nighttime imagery.&#x20;

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2F9adaKEuNOu0oNKKnPgDR%2FIM_Blog2.jpg?alt=media&amp;token=080d9b5f-c9dd-4ad5-a4bc-97ff0fb7b0b5" alt="" width="563"><figcaption><p>Temperature signals above a set threshold are shown over an ESRI basemap.</p></figcaption></figure></div>

Across the series, some thermal features remain relatively consistent while others appear, disappear, or change in intensity. These differences provide a simple way to identify areas where facility activity levels are changing.&#x20;

### Identifying changes within a facility&#x20;

Looking more closely at individual parts of the site reveals several examples of changing thermal activity. &#x20;

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FFPLQHO23WxzgYl0ohXQj%2FIM_Blog3.jpg?alt=media&amp;token=5512e435-1921-4fc6-84f5-73ace50c2ca5" alt=""><figcaption><p>Temperature increases from darker to brighter tones, while cooler values below the threshold are rendered transparent.</p></figcaption></figure></div>

Flaring is clearly visible in some observations and absent in others. Other parts of the facility shift between higher and lower levels of thermal activity, as indicated by temperature. Comparing the same locations across dates makes these changes easier to distinguish from the surrounding background.&#x20;

Thermal imagery can also reveal features beyond the main processing areas.&#x20;

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FHyC8PhlN7EE88qzn7lGq%2FIM_Blog4.jpg?alt=media&amp;token=67877327-2737-4c12-afac-0d7b84c2ad72" alt=""><figcaption><p>Industrial outflow is clearly visible in this nighttime image due to the temperature contrast of the water body.</p></figcaption></figure></div>

&#x20;In this example, a warm industrial discharge is visible in the January 14 nighttime observation. A nearby tailings basin also shows a thermal signal on some dates but not others.&#x20;

These examples illustrate an important advantage of thermal monitoring: rather than relying only on how a facility looks with visible imagery, we can observe how its heat signature physically changes over time to understand aspects that are on, off, or operating at different thresholds.&#x20;

## Why thermal imagery?

Industrial sites can be large, complex, and geographically dispersed. Satellite thermal imagery provides a consistent way to observe heat-producing activity across these sites without requiring sensors to be installed at each facility.&#x20;

Repeated thermal observations can help analysts:&#x20;

* Monitor variations in facility activity&#x20;
* Identify persistent or intermittent heat sources&#x20;
* Observe flaring and other high-temperature events&#x20;
* Monitor discharge and thermal patterns around infrastructure&#x20;
* Compare activity across multiple facilities or dates&#x20;

Large-area coverage, spectral diversity, frequent revisit, and nighttime imaging make it possible to monitor industrial activity across broad areas and compare changing thermal conditions consistently over time.&#x20;

Thermal data provides a key physical signal that identifies when, where and to what degree industrial changes happen.  &#x20;


# Environmental compliance at Tata Steel (IJmuiden, Netherlands)

In this case study, we’ll show how you can identify changes in industrial activity with a few simple analyses applied to Hydrosat data.

![Tata Steel IJmuiden](https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2Fgit-blob-c7fcd947d53ba63ebaea3d4f75f1282702bce859%2Ftata_steel_hero.png?alt=media)

### Introduction

Tata Steel IJmuiden is one of Europe's largest integrated steelworks and a major employer and exporter for the Netherlands, producing several million tonnes of steel a year at its site on the North Sea coast. In April 2026, the plant's DSP unit was shut down after air quality measurements showed chromium-6 emissions from one of its chimneys exceeding permissible limits, a serious environmental and public health concern. [Source: GMK Center](https://gmk.center/en/news/tata-steel-nederland-has-temporarily-shut-down-its-direct-sheet-plant-in-eemeden/).

Thermal satellite imagery offers a way to independently verify whether the DSP has genuinely gone offline, without relying solely on self-reported compliance data.

### Loading the L1B LIRI Collection

We'll start with a single Level-1B LIRI scene, `VZ02_L1b_20260302_132735`, taken before the DSP shutdown. Before diving into any analysis, we'll take a quick look at the images and their metadata.

```python
from pathlib import Path
import matplotlib.pyplot as plt
import rioxarray
import xarray as xr

# Define the scene ID and data directory for the imagery
DATA_DIR = Path("data")
SCENE_ID = "VZ02_L1b_20260302_132735"
```

```python
# Read LWIR bands
lwir1 = rioxarray.open_rasterio(DATA_DIR / SCENE_ID / "LWIR1.tiff", masked=True).squeeze("band", drop=True)
lwir2 = rioxarray.open_rasterio(DATA_DIR / SCENE_ID / "LWIR2.tiff", masked=True).squeeze("band", drop=True)

# Build an RGB preview from the individual RED/GREEN/BLUE bands
red = rioxarray.open_rasterio(DATA_DIR / SCENE_ID / "RED.tiff", masked=True).squeeze("band", drop=True)
green = rioxarray.open_rasterio(DATA_DIR / SCENE_ID / "GREEN.tiff", masked=True).squeeze("band", drop=True)
blue = rioxarray.open_rasterio(DATA_DIR / SCENE_ID / "BLUE.tiff", masked=True).squeeze("band", drop=True)
preview = xr.concat([red, green, blue], dim="band").assign_coords(band=["red", "green", "blue"])
```

#### Visualizing the LWIR Bands and Preview

`rioxarray` already masked out nodata pixels for us on load. L1B LIRI pixel values are scaled brightness temperature, so multiplying by the `0.01` scaling factor converts them to Kelvin, which we then convert to Fahrenheit for readability. We'll also show the full-resolution RGB preview alongside the two thermal bands for context.

```python
# Scaling factor for brightness temperature (from DN to Kelvin)
BT_SCALE = 0.01


# Convert brightness temperature from Kelvin to Fahrenheit
def kelvin_to_fahrenheit(da):
    return (da - 273.15) * 9 / 5 + 32


# Stretch each band independently to enhance contrast in RGB composite
def percentile_stretch(da, low=1, high=99):
    vmin, vmax = da.quantile(low / 100), da.quantile(high / 100)
    return ((da - vmin) / (vmax - vmin)).clip(0, 1)


# Convert LWIR bands to brightness temperature and stretch RGB preview
lwir1_bt = kelvin_to_fahrenheit(lwir1 * BT_SCALE)
lwir2_bt = kelvin_to_fahrenheit(lwir2 * BT_SCALE)
preview_stretched = preview.groupby("band").map(percentile_stretch)

# Plot LWIR brightness temperature and RGB preview
fig, axes = plt.subplots(1, 3, figsize=(19, 6))

for ax, da, label in zip(
    axes[:2], [lwir1_bt, lwir2_bt], ["LWIR1 (10.9 µm)", "LWIR2 (12.0 µm)"]
):
    da.plot.imshow(ax=ax, cmap="magma", add_colorbar=True, cbar_kwargs={"label": "°F"})
    ax.set_title(f"{label} Brightness Temperature")
    ax.set_aspect("equal")
    ax.axis("off")

preview_stretched.plot.imshow(ax=axes[2], rgb="band")
axes[2].set_title("RGB Preview")
axes[2].set_aspect("equal")
axes[2].axis("off")

fig.suptitle(SCENE_ID)
plt.tight_layout()
plt.show()
```

![](https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2Fgit-blob-92484f81ffbdad669bd6893e6c38f774aa9c9f9c%2Foutput_8_0.png?alt=media)

Here we can see the broader context of the area, including the North Sea coastline and the harbor canal running through IJmuiden. Let's focus in on the steelworks for our next steps.

### Cropping to a Region of Interest

The full scene extends well beyond the steelworks. We'll crop LWIR1 to a region of interest (ROI) around the plant, loaded from a local file, so the same box can be reused across scenes with different projections or pixel grids.

```python
import json


# Function to extract ROI bounds from a GeoJSON file
def roi_bounds_from_geojson(path):
    coords = json.loads(Path(path).read_text())["features"][0]["geometry"]["coordinates"][0]
    lons, lats = zip(*coords)
    return (min(lons), min(lats), max(lons), max(lats))


# Extract ROI bounds from the GeoJSON file and clip the LWIR band to the ROI
ROI_BOUNDS = roi_bounds_from_geojson("assets/tata_steel.geojson")
lwir1_roi = lwir1_bt.rio.clip_box(*ROI_BOUNDS, crs="EPSG:4326")
```

```python
from matplotlib.patches import Rectangle
from rasterio.warp import transform_bounds

# Reproject the ROI bounds into the raster's CRS so the box lines up on the full scene
roi_minx, roi_miny, roi_maxx, roi_maxy = transform_bounds(
    "EPSG:4326", lwir1_bt.rio.crs, *ROI_BOUNDS
)

# Create a figure with two subplots: one for the full scene and one for the ROI
fig, axes = plt.subplots(1, 2, figsize=(14, 6))

lwir1_bt.plot.imshow(ax=axes[0], cmap="magma", add_colorbar=True, cbar_kwargs={"label": "°F"})
axes[0].add_patch(
    Rectangle(
        (roi_minx, roi_miny),
        roi_maxx - roi_minx,
        roi_maxy - roi_miny,
        edgecolor="cyan",
        facecolor="none",
        linewidth=2,
    )
)
axes[0].set_title("LWIR1 (10.9 µm) - Full Scene")
axes[0].set_aspect("equal")
axes[0].axis("off")

lwir1_roi.plot.imshow(ax=axes[1], cmap="magma", add_colorbar=True, cbar_kwargs={"label": "°F"})
axes[1].set_title("LWIR1 (10.9 µm) - ROI")
axes[1].set_aspect("equal")
axes[1].axis("off")

fig.suptitle(f"{SCENE_ID}")
plt.tight_layout()
plt.show()
```

![](https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2Fgit-blob-747a4b1e42111fb4ffb7e2fa8cc45e700d1693cf%2Foutput_12_0.png?alt=media)

Here, several distinct hotspots stand out clearly against the surrounding land: individual stacks and process units across the steelworks, each running well above ambient. [The facility plan](https://www.tatasteelnederland.com/sites/default/files/tata-steel-plattegrond.pdf) reveals that the DSP is located in the middle-left part of the cropped region. Since this image was taken before the DSP shutdown, its thermal signature is visible (the two hotspots near the shoreline). Let's take a look at how the overall thermal picture changes after the DSP was taken offline.

```python
# Close all opened raster files to free up resources
lwir1.close(); lwir2.close(); red.close(); green.close(); blue.close(); preview.close()
```

### Time Series: LWIR1 Before and After the DSP Shutdown

We have two LWIR1 acquisitions bracketing the shutdown: `20260302` (before, March 2026) and `20260619` (after, June 2026), both from the VZ02 sensor. We'll plot them side by side with a shared color scale for direct comparison.

```python
# Imagery scene IDs
TIMESERIES_SCENES = [
    "VZ02_L1b_20260302_132735",
    "VZ02_L1b_20260619_132916",
]


# Helper function to extract the date from a scene ID
def scene_date(scene_id):
    return scene_id.split("_")[2]


# Load and crop LWIR1 imagery for a given scene ID
def load_cropped_lwir1(scene_id):
    da = rioxarray.open_rasterio(
        Path("data") / scene_id / f"LWIR1.tiff", masked=True
    ).squeeze("band", drop=True)
    da = da.rio.clip_box(*ROI_BOUNDS, crs="EPSG:4326") * BT_SCALE
    return kelvin_to_fahrenheit(da)


# Load the LWIR1 time series for all scenes
timeseries = {scene_id: load_cropped_lwir1(scene_id) for scene_id in TIMESERIES_SCENES}
dates = sorted(timeseries, key=scene_date)
```

```python
from datetime import datetime

# Determine the min and max brightness temperature values for consistent color scaling
vmin = min(float(da.min()) for da in timeseries.values())
vmax = max(float(da.max()) for da in timeseries.values())

# Plot the LWIR1 time series
fig, axes = plt.subplots(1, len(dates), figsize=(7 * len(dates), 6))

for ax, scene_id in zip(axes, dates):
    da = timeseries[scene_id]
    da.plot.imshow(ax=ax, cmap="magma", vmin=vmin, vmax=vmax, cbar_kwargs={"label": "°F"})
    ax.set_title(datetime.strptime(scene_date(scene_id), "%Y%m%d").strftime("%B %d, %Y"))
    ax.axis("off")

fig.suptitle("LWIR1 Brightness Temperature")
plt.tight_layout()
plt.show()
```

![](https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2Fgit-blob-253c9d8831a9747a898857d5710d081fda684ff9%2Foutput_17_0.png?alt=media)

When sharing a color scale, the March scene shows a handful of sharp, distinct hotspots against a cool background, while the June scene is warm across almost the entire site. This is a product of summer solar heating, making it hard to tell whether the DSP (or anything else) is active. Normalizing each frame relative to its own background can help separate genuine activity from ambient seasonal heating.

### Normalizing the Time Series

Different acquisitions can have different baseline brightness temperatures due to atmospheric and seasonal conditions unrelated to plant activity. Simply subtracting each frame's median still leaves frames with a lot of background texture (e.g. a hot summer day) looking uniformly "hot," since the deviations are on a different scale from frame to frame.

Instead, we use a **robust z-score**, which normalizes both the center and the spread of each frame using statistics that resist being skewed by a small number of extreme hot pixels:

$$z = \frac{x - \text{median}(x)}{1.4826 \times \text{MAD}(x)}$$

where `MAD(x) = median(|x - median(x)|)` is the median absolute deviation. Subtracting the median (instead of the mean) keeps the center from being pulled up by a handful of very hot pixels, and dividing by the (rescaled) MAD instead of the standard deviation keeps the scale from being inflated by those same outliers. The `1.4826` constant rescales MAD so it's comparable to a standard deviation for normally-distributed data, making the resulting z-score readable the same way as an ordinary one (e.g. `+3` ≈ "3 robust standard deviations above typical").

```python
# Compute robust z-score normalized timeseries for each scene
def robust_zscore(da):
    median = float(da.median())
    mad = float(abs(da - median).median()) * 1.4826  # scaled to be comparable to std
    return (da - median) / mad


# Apply robust z-score normalization to all scenes in the timeseries
normalized_timeseries = {
    scene_id: robust_zscore(da) for scene_id, da in timeseries.items()
}
```

```python
# Determine the global min and max for the normalized timeseries for consistent color scaling
norm_vmin = min(float(da.min()) for da in normalized_timeseries.values())
norm_vmax = max(float(da.max()) for da in normalized_timeseries.values())


# Plot the normalized timeseries
fig, axes = plt.subplots(1, len(dates), figsize=(7 * len(dates), 6))

for ax, scene_id in zip(axes, dates):
    da = normalized_timeseries[scene_id]
    da.plot.imshow(
        ax=ax,
        cmap="magma",
        vmin=norm_vmin,
        vmax=norm_vmax,
        cbar_kwargs={"label": "Robust z-score"},
    )
    ax.set_title(datetime.strptime(scene_date(scene_id), "%Y%m%d").strftime("%B %d, %Y"))
    ax.axis("off")

fig.suptitle("LWIR1 Brightness Temperature (robust z-score)")
plt.tight_layout()
plt.show()
```

![](https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2Fgit-blob-457e552398f6ee0282db4cc923219ad7d322efc7%2Foutput_21_0.png?alt=media)

After normalization, the difference between the images becomes clear: by June, Tata Steel has shut off the DSP (as per the article), and the Warmband facility (the hot-rolled strip steel mill) also appears to be offline. With a few simple image processing steps, we have gone from raw imagery to actionable compliance insights.

### Thermal Profile Through the Hottest Point

Beyond a visual inspection, extracting pixel values can provide further insight into the thermal activity of a scene. A profile (a cross-sectional view that shows the change in pixel values along a linear path) through the hottest point tells us two distinct things at once:

1. Whether a given unit is active or idle (does the profile spike well above the surrounding background, or does it stay flat and close to ambient?)
2. How active it is (values along the profile indicate the intensity of the thermal signal, not just its presence)

We'll use the `20260302` acquisition, taken before the DSP shutdown, since it's where the plant's activity registers most clearly.

```python
from rasterio.warp import transform

# Get the data for the profile scene
profile_scene_id = "VZ02_L1b_20260302_132735"
profile_da = timeseries[profile_scene_id]

# Find the hotspot location in the profile scene
hotspot_idx = profile_da.argmax(dim=["y", "x"])
hotspot_row = int(hotspot_idx["y"])
hotspot_col = int(hotspot_idx["x"])
hotspot_northing = float(profile_da["y"].isel(y=hotspot_row))
hotspot_easting = float(profile_da["x"].isel(x=hotspot_col))

# Extract the transect along the hotspot row
transect = profile_da.isel(y=hotspot_row)

# Convert the hotspot's own coordinates to latitude for the title
_, hotspot_lat = transform(
    profile_da.rio.crs, "EPSG:4326", [hotspot_easting], [hotspot_northing]
)
hotspot_lat = hotspot_lat[0]

# Convert the transect's easting coordinates to longitude for the x-axis
transect_lons, _ = transform(
    profile_da.rio.crs,
    "EPSG:4326",
    transect["x"].values,
    [hotspot_northing] * transect.sizes["x"],
)

# Compute overall statistics for the profile scene
overall_min = float(profile_da.min())
overall_max = float(profile_da.max())
overall_mean = float(profile_da.mean())
overall_std = float(profile_da.std())

# Plot the profile scene and the transect through the hotspot
fig, (ax_img, ax_profile) = plt.subplots(1, 2, figsize=(16, 6))

profile_da.plot.imshow(ax=ax_img, cmap="magma", cbar_kwargs={"label": "°F"})
ax_img.axhline(hotspot_northing, color="cyan", linestyle="--", linewidth=1.5)
ax_img.set_title(f"{profile_scene_id} - Latitude: {hotspot_lat:.4f}°N")
ax_img.axis("off")

ax_profile.plot(transect_lons, transect.values, color="crimson", label="Transect")
ax_profile.axhline(overall_mean, color="black", linewidth=1, label="Mean")
ax_profile.axhspan(
    overall_mean - overall_std,
    overall_mean + overall_std,
    color="gray",
    alpha=0.3,
    label="Mean ± 1 std",
)
ax_profile.axhline(overall_min, color="steelblue", linestyle=":", label="Min")
ax_profile.axhline(overall_max, color="firebrick", linestyle=":", label="Max")
ax_profile.set_xlabel("Longitude")
ax_profile.set_ylabel("°F")
ax_profile.set_title("Thermal Profile")
ax_profile.legend()

plt.tight_layout()
plt.show()
```

![](https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2Fgit-blob-da8e4d68724e73f197c9b76da5a03c08ea2fe081%2Foutput_24_0.png?alt=media)

This profile is (taken through the Warmband) shows a clear signal of activity. By extracting similar profiles through our images, or by taking pixel statistics for an AOI polygon, we can further learn about the thermal characteristics of locations and derive insights from thermal imagery.


# Wildfire

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Gifford Fire, California</strong></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FQGDVhldotNFZI193siBB%2FScreenshot%202026-10-28%20at%2010.16.10%E2%80%AFAM.png?alt=media&amp;token=9fd5a1ce-2d0f-487a-9d72-ee7edf278623">Screenshot 2026-10-28 at 10.16.10 AM.png</a></td><td><a href="/thermal-data/use-cases/wildfire/progression-of-the-gifford-fire">Progression of the Gifford Fire</a></td></tr></tbody></table>


# Progression of the Gifford Fire

Thermal imagery offers an important lens into understanding wildfire behavior when data from other sensors might be obscured by smoke.

During the summer of 2025, [the Gifford megafire burned over 130,000 acres across California's Los Padres National Forest](https://www.fire.ca.gov/incidents/2025/8/1/gifford-fire). The largest fire of the season, it spurred wide-ranging evacuation orders, destroyed several structures, injured over a dozen people, and took two months to fully contain.&#x20;

Wildfires like the Gifford Fire are highly dynamic events, and understanding how they develop, spread, and impact communities requires observations that can capture that volatility and scale. Thermal satellite imagery provides an important complement to optical and radar data by revealing the spatial distribution of heat associated with active fires, even under some smoky conditions.

With longwave infrared imagery from VanZyl-1 (VZ-1) acquired before, during, and after the Gifford Fire, here we show how researchers and decision-makers can leverage repeated thermal observations to track changing fire activity and better understand the legacy of wildfire across large regions.

## Before the fire

VZ-1 first imaged the area on July 31, 2025, the day before the Gifford Fire started.&#x20;

This observation helps us establish baseline thermal characteristics for comparison with subsequent collects. Here, we can see how differences in topography and land cover create a patchwork of relatively warmer (sunlit slopes, bare ground, developed areas) and cooler (shaded slopes, healthy forest) features across the undisturbed landscape. Pre-fire data can also support quantitative estimation of wildfire risk via fuel moisture content, which can reveal how easily a fire might start.

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FkEi96Q0pOA6v8urbXZGW%2FVZ-1%20Publishable%20Imagery%20v1-70.png?alt=media&amp;token=29afd357-f054-44eb-81d4-747eb21a725f" alt=""><figcaption><p>This image was acquired in the late morning.</p></figcaption></figure></div>

## During the fire

As the Gifford Fire broke out and moved westward in early August, VZ-1 captured intense hotspots associated with active fire activity. Repeated VZ-1 observations on August 4, 8, and 12 show exactly where and how the fire moved across the landscape.&#x20;

Early on, [multiple fire fronts emerged](https://www.fire.ca.gov/incidents/2025/8/1/gifford-fire/updates/98a14e79-9607-4160-825a-f55d702ae6e5) on the north and south sides of Highway 166 in Santa Barbara County:

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FyJNjKN30RALYsU2Iul8u%2FVZ-1%20Publishable%20Imagery%20v1-71.png?alt=media&amp;token=cf8f56a9-e9b4-42ed-91b6-9caca388df42" alt=""><figcaption></figcaption></figure></div>

These hotspots are evident in the thermal image, despite the active fire area being shrouded in smoke.

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FsysgnqUYZ4Zpqys9R9Fu%2FGifford%20-%20Aug%204%202025%20-%20RGB.png?alt=media&amp;token=f904b787-dd53-4fd2-9108-95f6a365dd9e" alt=""><figcaption><p>Here, we show RGB imagery from VZ-1's visible and near-infrared sensor, collected at the same time as the thermal image above.</p></figcaption></figure></div>

On August 8, thermal imagery from VZ-1 shows how the fire's multiple fronts had consolidated into a single one, moving northwest toward the community of Pozo.&#x20;

At that point, a week after the Gifford Fire started, it was [only 15% contained](https://www.fire.ca.gov/incidents/2025/8/1/gifford-fire/updates/a902880e-fc78-4943-a0df-936080015eea) but had already [officially become California's largest fire of 2025](https://www.independent.com/2025/08/08/more-than-3000-firefighters-on-gifford-fire-now-nearly-10000-acres/).

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2F9gpVpc6bpqYvRGVWQDED%2FVZ-1%20Publishable%20Imagery%20v1-72.png?alt=media&amp;token=45e9cb1d-413b-488f-baa2-d735c51e8a9e" alt=""><figcaption><p>Pozo is located just north of the text box.</p></figcaption></figure></div>

Four days later, the fire was [33% contained](https://www.fire.ca.gov/incidents/2025/8/1/gifford-fire/updates/aaa207c5-045c-43d0-b33c-4a7926cffe5d) and [continued encroaching on Pozo](https://calcoastnews.com/2025/08/gifford-fire-closing-in-on-pozo-a-fourth-structure-destroyed/).&#x20;

The relative size of the active fire front had slightly diminished since VZ-1's last look at the region, but the total burned area had grown to 125,000 acres, most of which was largely captured in VZ-1's broad footprint.

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FiCioMIVfsoTziyiDUNa4%2FVZ-1%20Publishable%20Imagery%20v1-73.png?alt=media&amp;token=0430e409-2a81-4843-85af-b5d71092b418" alt=""><figcaption></figcaption></figure></div>

## After the fire

The last VZ-1 image in the sequence was captured on August 16. At that point, the fire was [mostly contained](https://www.fire.ca.gov/incidents/2025/8/1/gifford-fire/updates/fa91d207-cb08-43b7-a464-8ab96e3fb8a6), with no visible hotspots evident in the imagery. However, its effects remained thermally apparent across the landscape, with warmer temperatures associated with the disturbed forest left in the wake of the fire.

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FJuGYlg8Qj96VGqN0ffk3%2FVZ-1%20Publishable%20Imagery%20v1-74.png?alt=media&amp;token=b8f23468-3a7b-4cce-accd-05e25a3cb2e6" alt=""><figcaption></figcaption></figure></div>

Thermal imagery can also be used alongside traditional vegetation indices to evaluate recovery after disturbance. In the weeks and months after a wildfire, pioneering plants and shrubs will begin to recolonize the burn scar. With thermal data, analysts can track how the land surface temperature of the burned area approaches its pre-burn baseline as evapotranspiration recovers.

More than a year after the fire, the Gifford Fire burn scar was still recovering, as seen in both the LWIR and VNIR data.

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FaJqjhbvNEXli9wpK0Wzu%2FGifford%20-%20Oct%202026.png?alt=media&amp;token=f1e71b2a-5acd-4749-a071-177d8593d72d" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FKMKKSps3716i0rFWknhj%2FVanZyl%20-%20Oct%204%202026%20-%20RGB.png?alt=media&amp;token=9ac754f2-381b-43c6-a0d1-eda4702c77c8" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" icon="envelope-open" %}
For access to the Gifford Fire data, [sign up for a Hydrosat Discovery account](https://hydrosat.com/discovery-platform/) and indicate your interest in wildfire, or simply contact <support@hydrosat.com>.
{% endhint %}


# Product Details

Find detailed information about Hydrosat's available data products.

<table data-view="cards"><thead><tr><th></th><th></th><th><select multiple><option value="IZmnWZFdUKc4" label="Daytime" color="blue"></option><option value="Fi2K9tw2u7XB" label="Nighttime" color="blue"></option></select></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>Level-1A Products</h4></td><td>At-sensor radiance</td><td><span data-option="IZmnWZFdUKc4">Daytime, </span><span data-option="Fi2K9tw2u7XB">Nighttime</span></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2F3qhMxbhmGPncfz57lgFI%2Fl1a.png?alt=media&amp;token=7fa5734c-b8bc-4020-95ff-f22dbca2375e">l1a.png</a></td><td><a href="/thermal-data/product-details/level-1a-products">Level-1A Products</a></td></tr><tr><td><h4>Level-1B Products</h4></td><td>At-sensor reflectance and brightness temperature</td><td><span data-option="IZmnWZFdUKc4">Daytime, </span><span data-option="Fi2K9tw2u7XB">Nighttime</span></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FzOtziL8n2tzl7eVIDCE3%2Fl1b.png?alt=media&amp;token=04842a74-9813-4fec-aaab-c8494f5dab07">l1b.png</a></td><td><a href="/thermal-data/product-details/level-1b-products">Level-1B Products</a></td></tr><tr><td><h4>Level-2 Products</h4></td><td>Surface variables, including land surface temperature</td><td><span data-option="IZmnWZFdUKc4">Daytime</span></td><td><a href="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FLk4TXTkng3vW4c1zHnvh%2Fl2.png?alt=media&amp;token=4f35652b-83b9-44ea-b22f-f2d1ad5f3ff8">l2.png</a></td><td><a href="/thermal-data/product-details/level-2-products">Level-2 Products</a></td></tr></tbody></table>


# Level-1A Products

At Level-1A, we provide the closest representation of what the satellite measured.

## Key Details

* [x] The least processed of Hydrosat's available imagery products
* [x] Pixel values represent at-sensor radiance in scaled units of W/m²/sr/µm
* [x] Preserves the native spatial resolution and swath of each sensor
* [x] Includes essential instrument-level corrections and georegistration
* [x] Nighttime LWIR data available

## Access

Level-1A products are available in three STAC collections: daytime VNIR, daytime LWIR, and nighttime LWIR. You can access and explore these collections via either the [Discovery portal](https://discover.hydrosat.com) (using the Collection dropdown) or the [STAC API](/data-discovery-platform/stac-api-documentation).

<table><thead><tr><th width="313.34765625">Collection Name</th><th>Collection ID</th><th>Imaging TIme<select><option value="FYAq5teYqZma" label="vz-viri-l1a" color="blue"></option><option value="EWecW3jOmwZt" label="vz-liri-l1a-night" color="blue"></option><option value="FtHXeinPQD91" label="vz-liri-l1a" color="blue"></option><option value="X5SCApiuC9oh" label="Daytime" color="blue"></option><option value="Dw5T3x8V9AWU" label="Nighttime" color="blue"></option></select></th></tr></thead><tbody><tr><td>Level-1A VNIR Data</td><td><code>vz-viri-l1a</code></td><td><span data-option="X5SCApiuC9oh">Daytime</span></td></tr><tr><td>Level-1A Thermal Data</td><td><code>vz-liri-l1a</code></td><td><span data-option="X5SCApiuC9oh">Daytime</span></td></tr><tr><td>Level-1A Thermal Data (Nighttime)</td><td><code>vz-liri-l1a-night</code></td><td><span data-option="Dw5T3x8V9AWU">Nighttime</span></td></tr></tbody></table>

## Data & Metadata

Each Level-1A item includes multiple STAC assets, including one cloud-optimized GeoTIFF (COG) for each spectral band.

{% hint style="warning" %}
Because VNIR and LWIR products are provided in separate Level-1A collections, each collection exposes only the subset of assets applicable to that sensor. For details, see the `Availability` column.
{% endhint %}

<table data-search="false"><thead><tr><th width="220.4921875">Asset Name</th><th width="266.22265625">Description</th><th width="113.8125">File Type<select><option value="4uUQ8vQbL2MX" label="COG" color="blue"></option><option value="0UZddAqx82hy" label="PNG" color="blue"></option><option value="Dh6mpinfrDQj" label="JSON" color="blue"></option></select></th><th>Availability<select multiple><option value="dnCj7YU44ok5" label="vz-viri-l1a" color="blue"></option><option value="QI2q3lCxbFrR" label="vz-liri-l1a" color="blue"></option><option value="aqc791Aiofam" label="vz-liri-l1a-night" color="blue"></option></select></th></tr></thead><tbody><tr><td><code>BLUE</code></td><td>Blue radiance</td><td><span data-option="4uUQ8vQbL2MX">COG</span></td><td><span data-option="dnCj7YU44ok5">vz-viri-l1a</span></td></tr><tr><td><code>GREEN</code></td><td>Green radiance</td><td><span data-option="4uUQ8vQbL2MX">COG</span></td><td><span data-option="dnCj7YU44ok5">vz-viri-l1a</span></td></tr><tr><td><code>RED</code></td><td>Red radiance</td><td><span data-option="4uUQ8vQbL2MX">COG</span></td><td><span data-option="dnCj7YU44ok5">vz-viri-l1a</span></td></tr><tr><td><code>REDEDGE1</code></td><td>Red edge 1 radiance</td><td><span data-option="4uUQ8vQbL2MX">COG</span></td><td><span data-option="dnCj7YU44ok5">vz-viri-l1a</span></td></tr><tr><td><code>REDEDGE2</code></td><td>Red edge 2 radiance</td><td><span data-option="4uUQ8vQbL2MX">COG</span></td><td><span data-option="dnCj7YU44ok5">vz-viri-l1a</span></td></tr><tr><td><code>REDEDGE3</code></td><td>Red edge 3 radiance</td><td><span data-option="4uUQ8vQbL2MX">COG</span></td><td><span data-option="dnCj7YU44ok5">vz-viri-l1a</span></td></tr><tr><td><code>NIR</code></td><td>NIR radiance</td><td><span data-option="4uUQ8vQbL2MX">COG</span></td><td><span data-option="dnCj7YU44ok5">vz-viri-l1a</span></td></tr><tr><td><code>LWIR1</code></td><td>LWIR1 radiance</td><td><span data-option="4uUQ8vQbL2MX">COG</span></td><td><span data-option="QI2q3lCxbFrR">vz-liri-l1a, </span><span data-option="aqc791Aiofam">vz-liri-l1a-night</span></td></tr><tr><td><code>LWIR2</code></td><td>LWIR2 radiance</td><td><span data-option="4uUQ8vQbL2MX">COG</span></td><td><span data-option="QI2q3lCxbFrR">vz-liri-l1a, </span><span data-option="aqc791Aiofam">vz-liri-l1a-night</span></td></tr><tr><td><code>QUALITY_ASSURANCE</code></td><td>Radiometric saturation mask</td><td><span data-option="4uUQ8vQbL2MX">COG</span></td><td><span data-option="dnCj7YU44ok5">vz-viri-l1a, </span><span data-option="QI2q3lCxbFrR">vz-liri-l1a, </span><span data-option="aqc791Aiofam">vz-liri-l1a-night</span></td></tr><tr><td><code>PREVIEW</code></td><td>Full-resolution preview image</td><td><span data-option="4uUQ8vQbL2MX">COG</span></td><td><span data-option="dnCj7YU44ok5">vz-viri-l1a, </span><span data-option="QI2q3lCxbFrR">vz-liri-l1a, </span><span data-option="aqc791Aiofam">vz-liri-l1a-night</span></td></tr><tr><td><code>THUMBNAIL</code></td><td>Low-resolution thumbnail</td><td><span data-option="0UZddAqx82hy">PNG</span></td><td><span data-option="dnCj7YU44ok5">vz-viri-l1a, </span><span data-option="QI2q3lCxbFrR">vz-liri-l1a, </span><span data-option="aqc791Aiofam">vz-liri-l1a-night</span></td></tr><tr><td><code>MTA</code></td><td>Ancillary metadata file</td><td><span data-option="Dh6mpinfrDQj">JSON</span></td><td><span data-option="dnCj7YU44ok5">vz-viri-l1a, </span><span data-option="QI2q3lCxbFrR">vz-liri-l1a, </span><span data-option="aqc791Aiofam">vz-liri-l1a-night</span></td></tr></tbody></table>

The ancillary metadata file includes, among other information, the coefficients that a user would need to convert radiance values to reflectance or brightness temperature.

* VNIR radiance values can be converted to top-of-atmosphere reflectance by applying the per-band `LEVEL1_REFLECTANCE_SCALING` coefficient.
* LWIR radiance values can be converted to brightness temperature as BT = K<sub>2</sub>/ln(K<sub>1</sub>/L+1), where K<sub>1</sub> and K<sub>2</sub> are per-band `LEVEL1_THERMAL_CONSTANTS`  and L represents scaled radiance.

## Specifications

<table><thead><tr><th width="221">Item</th><th valign="top">Level-1A VNIR</th><th>Level-1A LWIR</th></tr></thead><tbody><tr><td><strong>Scene Size</strong></td><td valign="top">122 km x 70 km</td><td>70 km x 70 km</td></tr><tr><td><strong>Pixel Size</strong></td><td valign="top">29.9 m</td><td>68.8 m</td></tr><tr><td><strong>Map Projection</strong></td><td valign="top">EPSG 4326</td><td>EPSG 4326</td></tr><tr><td><strong>No Data Value</strong></td><td valign="top">0</td><td>0</td></tr><tr><td><strong>Scale Factor</strong></td><td valign="top">0.01</td><td>0.001</td></tr></tbody></table>

## Processing

Only the most essential onboard and ground processing steps are applied at Level-1A. These include:

* Time delay integration (TDI) to combine multiple measurements and produce a cleaner image
* Non-uniformity correction to reduce variations in detector response
* Band coregistration to align the spectral bands within each sensor
* Georegistration to assign each pixel a geographic location
* Radiometric calibration to convert sensor measurements into radiance


# Level-1B Products

At Level-1B, we introduce additional processing to make the measurements easier to analyze and compare.

## Key Details

* [x] Builds on Level-1A with additional radiometric and geometric processing
* [x] Pixel values represent top-of-atmosphere (TOA) reflectance and brightness temperature
* [x] VNIR and LWIR data are co-registered and aligned on a common 30 m grid
* [x] Nighttime LWIR data available

## Access

Level-1B products are distributed in two separate STAC collections to reflect differences in acquisition mode. The first collection includes both VNIR and thermal data from daytime acquisitions, while the second includes only thermal data from nighttime acquisitions.

You can access and explore these collections via either the [Discovery portal](https://discover.hydrosat.com) or the [STAC API](/data-discovery-platform/stac-api-documentation).

<table><thead><tr><th width="350.55078125">Collection Name</th><th>Collection ID</th><th>Imaging Time<select><option value="FYAq5teYqZma" label="vz-viri-l1a" color="blue"></option><option value="EWecW3jOmwZt" label="vz-liri-l1a-night" color="blue"></option><option value="FtHXeinPQD91" label="vz-liri-l1a" color="blue"></option><option value="X5SCApiuC9oh" label="Daytime" color="blue"></option><option value="Dw5T3x8V9AWU" label="Nighttime" color="blue"></option></select></th></tr></thead><tbody><tr><td>Level-1B Combined Thermal &#x26; VNIR Data</td><td><code>vz-l1b</code></td><td><span data-option="X5SCApiuC9oh">Daytime</span></td></tr><tr><td>Level-1B Thermal Data (Nighttime)</td><td><code>vz-l1b-night</code></td><td><span data-option="Dw5T3x8V9AWU">Nighttime</span></td></tr></tbody></table>

## Data & Metadata

Each Level-1B item includes multiple STAC assets, including cloud-optimized geoTIFFs (COGs) along with ancillary metadata and quality information.

{% hint style="warning" %}
Because Level-1B products are published in separate daytime and nighttime collections, each collection exposes only the subset of assets relevant to that acquisition mode. For details, see the `Availability` column.
{% endhint %}

<table data-search="false"><thead><tr><th width="188.1953125">Asset</th><th width="309.07421875">Description</th><th width="111.16796875">File Type<select><option value="3dK0BqQftPBM" label="COG" color="blue"></option><option value="Rq3yBois12ha" label="PNG" color="blue"></option><option value="hV68Nh64l6wP" label="JSON" color="blue"></option></select></th><th>Availability<select multiple><option value="EGTxnloDfylu" label="vz-l1b" color="blue"></option><option value="12yOXRbCQSva" label="vz-l1b-night" color="blue"></option></select></th></tr></thead><tbody><tr><td><code>BLUE</code></td><td>Blue TOA reflectance</td><td><span data-option="3dK0BqQftPBM">COG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b</span></td></tr><tr><td><code>GREEN</code></td><td>Green TOA reflectance</td><td><span data-option="3dK0BqQftPBM">COG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b</span></td></tr><tr><td><code>RED</code></td><td>Red TOA reflectance</td><td><span data-option="3dK0BqQftPBM">COG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b</span></td></tr><tr><td><code>REDEDGE1</code></td><td>Red edge 1 TOA reflectance</td><td><span data-option="3dK0BqQftPBM">COG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b</span></td></tr><tr><td><code>REDEDGE2</code></td><td>Red edge 2 TOA reflectance</td><td><span data-option="3dK0BqQftPBM">COG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b</span></td></tr><tr><td><code>REDEDGE3</code></td><td>Red edge 3 TOA reflectance</td><td><span data-option="3dK0BqQftPBM">COG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b</span></td></tr><tr><td><code>NIR</code></td><td>NIR TOA reflectance</td><td><span data-option="3dK0BqQftPBM">COG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b</span></td></tr><tr><td><code>LWIR1</code></td><td>LWIR 1 brightness temperature</td><td><span data-option="3dK0BqQftPBM">COG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b, </span><span data-option="12yOXRbCQSva">vz-l1b-night</span></td></tr><tr><td><code>LWIR2</code></td><td>LWIR 2 brightness temperature</td><td><span data-option="3dK0BqQftPBM">COG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b, </span><span data-option="12yOXRbCQSva">vz-l1b-night</span></td></tr><tr><td><code>CLOUD_MASK</code></td><td>Cloud mask</td><td><span data-option="3dK0BqQftPBM">COG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b</span></td></tr><tr><td><code>QUALITY_ASSURANCE</code></td><td>Radiometric saturation mask</td><td><span data-option="3dK0BqQftPBM">COG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b, </span><span data-option="12yOXRbCQSva">vz-l1b-night</span></td></tr><tr><td><code>PREVIEW</code></td><td>Full-resolution preview image</td><td><span data-option="3dK0BqQftPBM">COG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b, </span><span data-option="12yOXRbCQSva">vz-l1b-night</span></td></tr><tr><td><code>THUMBNAIL</code></td><td>Low-resolution thumbnail</td><td><span data-option="Rq3yBois12ha">PNG</span></td><td><span data-option="EGTxnloDfylu">vz-l1b, </span><span data-option="12yOXRbCQSva">vz-l1b-night</span></td></tr><tr><td><code>MTA</code></td><td>Ancillary metadata file</td><td><span data-option="hV68Nh64l6wP">JSON</span></td><td><span data-option="EGTxnloDfylu">vz-l1b, </span><span data-option="12yOXRbCQSva">vz-l1b-night</span></td></tr></tbody></table>

The ancillary metadata file includes coefficients for converting Level-1B values back to radiance.&#x20;

* VNIR reflectance values can be converted to radiance by applying the per-band `LEVEL1_RADIANCE_SCALING` coefficient.
* LWIR brightness temperature values can be converted to radiance as L = K<sub>1</sub>/(e(K<sub>2</sub>/BT)-1), where K<sub>1</sub> and K<sub>2</sub> are per-band `LEVEL1_BT_TO_RADIANCE_CONSTANTS`.

## Specifications

<table data-header-hidden><thead><tr><th width="221">Item</th><th valign="top">Level-1B</th></tr></thead><tbody><tr><td><strong>Scene Size</strong></td><td valign="top">70 km x 70 km</td></tr><tr><td><strong>Pixel Size</strong></td><td valign="top">30 m</td></tr><tr><td><strong>Resampling Method</strong></td><td valign="top">Bilinear</td></tr><tr><td><strong>Map Projection</strong></td><td valign="top">Universal Transverse Mercator (UTM)</td></tr><tr><td><strong>No Data Value</strong></td><td valign="top">0</td></tr><tr><td><strong>Scale Factor</strong></td><td valign="top">VNIR: 0.0001<br>LWIR: 0.01</td></tr></tbody></table>

## Processing

At Level-1B, we apply additional radiometric and geometric processing. These steps include:

* Conversion of radiance to TOA reflectance and brightness temperature
* Co-registration of VNIR and LWIR imagery on a common 30 m grid
* Orthorectification using a digital elevation model to improve geometric accuracy
* Cloud mask generation for identifying cloudy pixels
* Resampling and clipping to produce a common spatial footprint for all bands


# Level-2 Products

At Level-2, we estimate what's happening at Earth's surface rather than what the satellite directly observed.

## Key Details

* [x] Our highest-level imagery product
* [x] Pixel values represent surface reflectance (SR) and land surface temperature (LST)
* [x] Includes atmospheric, terrain, and surface corrections
* [x] Best suited for environmental monitoring and scientific analysis

## Access

A single Level-2 STAC collection is available. You can access and explore this collection via either the [Discovery portal](https://discover.hydrosat.com) or the [STAC API](/data-discovery-platform/stac-api-documentation).

<table><thead><tr><th width="366.578125">Collection Name</th><th>Collection ID</th><th>Imaging Time<select><option value="FYAq5teYqZma" label="vz-viri-l1a" color="blue"></option><option value="EWecW3jOmwZt" label="vz-liri-l1a-night" color="blue"></option><option value="FtHXeinPQD91" label="vz-liri-l1a" color="blue"></option><option value="X5SCApiuC9oh" label="Daytime" color="blue"></option><option value="Dw5T3x8V9AWU" label="Nighttime" color="blue"></option></select></th></tr></thead><tbody><tr><td>Level-2 Surface Temperature &#x26; Surface Reflectance Data</td><td><code>vz-l2</code></td><td><span data-option="X5SCApiuC9oh">Daytime</span></td></tr></tbody></table>

## Data & Metadata

All of the following assets are available for every Level-2 item, since Level-2 products are distributed in a single STAC collection.

<table data-search="false"><thead><tr><th width="191.99609375">Asset</th><th width="438.12109375">Description</th><th>File Type<select><option value="3tframT0ionq" label="COG" color="blue"></option><option value="JEMKsYbGLJVS" label="PNG" color="blue"></option><option value="B1x1N2vNWRwo" label="JSON" color="blue"></option></select></th></tr></thead><tbody><tr><td><code>LST</code></td><td>Land surface temperature</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>BLUE_SR</code></td><td>Blue surface reflectance</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>GREEN_SR</code></td><td>Green surface reflectance</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>RED_SR</code></td><td>Red surface reflectance</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>REDEDGE1_SR</code></td><td>Red edge 1 surface reflectance</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>REDEDGE2_SR</code></td><td>Red edge 2 surface reflectance</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>REDEDGE3_SR</code></td><td>Red edge 3 surface reflectance</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>NIR_SR</code></td><td>NIR surface reflectance</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>LWIR1_EMIS</code></td><td>LWIR 1 emissivity</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>LWIR2_EMIS</code></td><td>LWIR 2 emissivity</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>LST_UNCERTAINTY</code></td><td>Land surface temperature uncertainty</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>CLOUD_MASK</code></td><td>Cloud mask</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>QUALITY_ASSURANCE</code></td><td>Radiometric saturation mask</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>PREVIEW</code></td><td>Full-resolution preview image</td><td><span data-option="3tframT0ionq">COG</span></td></tr><tr><td><code>THUMBNAIL</code></td><td>Low-resolution thumbnail</td><td><span data-option="JEMKsYbGLJVS">PNG</span></td></tr><tr><td><code>METADATA</code></td><td>Ancillary metadata file</td><td><span data-option="B1x1N2vNWRwo">JSON</span></td></tr></tbody></table>

## Specifications

<table data-header-hidden><thead><tr><th width="221">Item</th><th valign="top">Details</th></tr></thead><tbody><tr><td><strong>Scene Size</strong></td><td valign="top">70 km x 70 km</td></tr><tr><td><strong>Pixel Size</strong></td><td valign="top">30 m</td></tr><tr><td><strong>Map Projection</strong></td><td valign="top">Universal Transverse Mercator (UTM)</td></tr><tr><td><strong>No Data Value</strong></td><td valign="top">0</td></tr><tr><td><strong>Scale Factor</strong></td><td valign="top"><p>LST &#x26; LST uncertainty: 0.01</p><p>Surface reflectance &#x26; emissivity: 0.0001</p></td></tr></tbody></table>

## Processing

At Level-2, we apply the processing needed to derive surface reflectance and land surface temperature. This is an involved sequence that includes:

* Radiometric terrain correction to account for terrain-induced illumination effects
* Surface reflectance retrieval from TOA reflectance
* LST estimation from TOA brightness temperatures with emissivity correction
* Per-pixel LST uncertainty estimation based on radiometric, emissivity, atmospheric, and algorithm uncertainties


# Satellite Technology

Get to know Hydrosat's on-orbit sensors.

## VanZyl Constellation

{% columns %}
{% column width="75%" %}
VanZyl-1 (VZ-1) and VanZyl-2 (VZ-2) are Hydrosat's first two satellites. Launched in August 2024 (VZ-1) and June 2025 (VZ-2), the VanZyl satellites pave the way for our forthcoming constellation that will redefine space-based thermal infrared remote sensing by enabling daily continuous monitoring of any location on Earth.&#x20;

Both VZ-1 and VZ-2 host two imaging payloads: Hydrosat’s first-generation, proprietary longwave infrared imager (LIRI) along with its visible and near-infrared imager (VIRI).&#x20;
{% endcolumn %}

{% column width="25%" valign="middle" %}

<div align="center"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2Fh958VKH3aUHBwReSbuzy%2FYAM-7-pose-1.png?alt=media&amp;token=2759cbec-2816-4b78-adf4-2c18be3d2bb2" alt="" width="188"><figcaption><p>Hydrosat's VanZyl-1 satellite.</p></figcaption></figure></div>
{% endcolumn %}
{% endcolumns %}

### Spectral Bands

The LIRI sensor acquires thermal infrared imagery at wavelengths between 10.6 and 12.51 micrometers, similar to Landsat TIRS; VIRI has a total of 7 spectral bands ranging from 458 to 900 nanometers.

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FcRyNetLFCHT3nPntdeVU%2Fbands.png?alt=media&amp;token=25faf14d-0643-4f81-a688-c5fc1223dce9" alt="" width="563"><figcaption><p>Visual representation of the spectral bands for Hydrosat's VanZyl satellites.</p></figcaption></figure></div>

<table data-search="false"><thead><tr><th width="85.16796875">Sensor<select><option value="9gB76nWqO234" label="VIRI" color="blue"></option><option value="o2z3V3dfn5NN" label="LIRI" color="blue"></option></select></th><th width="318.92578125">Band Name</th><th width="215.796875">Wavelength</th><th data-type="number">GSD (m)</th></tr></thead><tbody><tr><td><span data-option="9gB76nWqO234">VIRI</span></td><td>Blue</td><td>458-523 nm</td><td>29.9</td></tr><tr><td><span data-option="9gB76nWqO234">VIRI</span></td><td>Green</td><td>543-578 nm</td><td>29.9</td></tr><tr><td><span data-option="9gB76nWqO234">VIRI</span></td><td>Red</td><td>650-680 nm</td><td>29.9</td></tr><tr><td><span data-option="9gB76nWqO234">VIRI</span></td><td>Red Edge 1</td><td>698-713 nm</td><td>29.9</td></tr><tr><td><span data-option="9gB76nWqO234">VIRI</span></td><td>Red Edge 2</td><td>733-748 nm</td><td>29.9</td></tr><tr><td><span data-option="9gB76nWqO234">VIRI</span></td><td>Red Edge 3</td><td>773-793 nm</td><td>29.9</td></tr><tr><td><span data-option="9gB76nWqO234">VIRI</span></td><td>Near-Infrared (NIR)</td><td>785-900 nm</td><td>29.9</td></tr><tr><td><span data-option="o2z3V3dfn5NN">LIRI</span></td><td>Longwave Infrared 1 (LWIR 1)</td><td>10.6-11.19 μm</td><td>68.8</td></tr><tr><td><span data-option="o2z3V3dfn5NN">LIRI</span></td><td>Longwave Infrared 2 (LWIR 2)</td><td>11.5-12.51 μm</td><td>68.8</td></tr></tbody></table>

### Other Specifications

VZ-1 and VZ-2 operate in low Earth orbit, collecting imagery at approximately the same local time each orbit. VZ-1's overpass time aligns approximately with that of Landsat, while VZ-2's is similar to VIIRS.

<table><thead><tr><th width="168.6796875">Orbit Type</th><th>Orbit Altitude</th><th>LTDN</th><th>LTAN</th><th>Swath Width</th></tr></thead><tbody><tr><td>Sun-synchronous</td><td>500-600 km</td><td>10:30 AM (VZ-1)<br>1:30 PM (VZ-2)</td><td>10:30 PM (VZ-1)<br>1:30 AM (VZ-2)</td><td>70 km</td></tr></tbody></table>


# Data Discovery Portal

The [Discovery Portal](https://discover.hydrosat.com/) is a web interface for visually browsing and downloading Hydrosat's satellite imagery catalog and complements the [Discovery STAC API](/data-discovery-platform/stac-api-documentation).

Interested in getting access to the Hydrosat Discovery Platform? Fill out the [Request Access form on our website](https://hydrosat.com/data-discovery-platform/).

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FiNxakGmfdCNQDIwaGsTR%2Fddportal.png?alt=media&amp;token=28f2f48b-04bb-4efe-b229-91e4e82db7a3" alt=""><figcaption></figcaption></figure></div>


# Getting Access

To access the Discovery Portal or use the API, you will need an account.

{% stepper %}
{% step %}

#### Request an account and get approved for access.

Fill out the [Request Access form on our website](https://hydrosat.com/data-discovery-platform/).
{% endstep %}

{% step %}

#### Receive your invitation email.

Once your account has been created, you will receive an email from <support@hydrosat.com> with your username and temporary password. Check your spam folder if you don't see your invitation email.
{% endstep %}

{% step %}

#### Reset your password.

Follow the instructions in the email to log in with the temporary password and choose a new password. You have 7 days to log in and reset your password. If your temporary password expires, contact [Hydrosat Support](mailto:support@hydrosat.com) to get a new temporary password.
{% endstep %}

{% step %}

#### You're all set!

Once you've reset your password, you will be able to use your new account to log into the [Discovery Portal](https://discover.hydrosat.com/). If you need to generate API credentials for use with our [STAC API](https://stac.hydrosat.com/), follow the instructions for [managing API clients](/data-discovery-platform/discovery-portal/managing-api-clients).

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2F2NcCqoFusYw7uZsOKbbU%2Floginpage.png?alt=media&amp;token=cdb98c40-8bd0-4ca0-bcd2-dd371adc708a" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


# Locating Downloadable Data

If your Discovery Platform account is configured to allow data downloads, your access is based on areas of interest and/or specific scene IDs. The Discovery Portal includes some helpful tools to help you locate, search, and understand your downloadable data.

For help locating downloadable data via the STAC API, check out this [separate article](/data-discovery-platform/stac-api-documentation/locating-downloadable-data).

### Viewing Downloadable Data

#### Imagery Searches

If you have access to downloadable data, the `Downloadable` toggle is available on the imagery search bar. Combine the `Downloadable` toggle with additional search filters, such as `Acquisition Date` or `Cloud Cover` , to find results for a subset of your downloadable data.

A Downloadable search includes results based on area of interest and specific scene ID, depending on how your account is configured.

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FWnnjrD1p8UcOFqGwFjoK%2Fdownloadable.png?alt=media&amp;token=35afeb35-e926-4312-9eb0-e9ce47c6131c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If the Downloadable toggle is not interactive, this means you don't yet have access to downloadable data. Contact our [sales](mailto:sales@hydrosat.com) team for access.
{% endhint %}

#### Download Access Areas

For accounts with area of interest-based download access, you can view your Download Access Areas on the map. When using the `Downloadable` search toggle, as discussed above, the search automatically looks for results matching your Download Access Areas.

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FsCEAZMnXTWLjUXShWvFs%2Flayers.png?alt=media&amp;token=3a53da75-17b0-4317-9377-f72360dc794b" alt=""><figcaption></figcaption></figure>


# Managing API Client Credentials

Creating an API client is required to use Hydrosat's [Discovery STAC API](/data-discovery-platform/stac-api-documentation). This article covers the workflow for managing API Clients in the Discovery Portal.

## Viewing the API Client Credentials Interface

The API Client Credentials interface is available only to users on your account with the `Org Admin` role. If there is already an `Org Admin` on your account, this person can generate API clients for you to use the API.

To view the API Client Credentials interface, click your user avatar in the top right corner of [Discovery Portal](https://discover.hydrosat.com/) and select `Account`.

Users with the requisite permissions will see the API Clients section on the Account page.

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FwW8vlA8EtilBRYuOB9wh%2Faccount.png?alt=media&amp;token=9f4aac00-e209-4baf-a961-0036fa3059f5" alt="" width="328"><figcaption></figcaption></figure>

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FPXOM9Wp4Dy1MzN6Y5Wjy%2Fapiclient.png?alt=media&amp;token=f9198136-9f74-47ee-93a2-f7ba320ad477" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you don't know who your team's Org Admin is, and you need access to the API Client Credentials interface, contact <support@hydrosat.com> for assistance.
{% endhint %}

## Creating an API Client

Each account is limited to 4 total API clients, so consider this limit when creating new API clients.

1. Click `New API Client` on the right side of the API Clients section.
2. Provide a name for the API client that is easily recognizable to you and other Org Admins. Name is required.
3. (Optional) Provide a description.
4. Click `Create API Client`
5. Immediately upon creation, the client secret for the API client is displayed. **This display is only temporary.** Store the client secret in a safe and secure location in your environment as you will not be able to retrieve it from Discovery Portal in the future.

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FyuZc1vONH2tkJmLOynGm%2Fcreatedscreen.png?alt=media&amp;token=d26c0885-5897-4ec9-b547-82d1c7c19a81" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you've lost the secret for your API client, Hydrosat is unable to retrieve it for you for security reasons. Instead, create a new API client, at which time a secret for the new API client will be provided to you. Delete any API clients you can no longer use.
{% endhint %}


# STAC API

Hydrosat's Data Discovery STAC API is available at <https://stac.hydrosat.com/>. The STAC API requires [authentication](/data-discovery-platform/stac-api-documentation/authentication) using a bearer token.

## SpatioTemporal Asset Catalog (STAC) API

This page includes high-level information on the basic features of the API and provides examples for a few methods of working with it.

{% hint style="info" %}
For more details, please review the STAC API specifications provided at <https://github.com/radiantearth/stac-api-spec>.
{% endhint %}

Through Hydrosat's STAC API, you can search for data that meets your needs. Data are stored as Cloud-Optimized GeoTIFFs (COGs), which means you can either download the full files or stream only the parts you need using standard web requests.

{% hint style="warning" %}
Once you’re authenticated, you can browse Hydrosat's STAC items and view thumbnail previews. However, only users who have ordered specific data can download the full COGs for their selected areas.
{% endhint %}

Learn more:

* STAC (SpatioTemporal Asset Catalog): [stacspec.org](https://stacspec.org)
* Cloud-Optimized GeoTIFFs (COGs): [cogeo.org](https://cogeo.org)

***

While you can use the STAC API directly, we recommend using one of the following tools to make it easier:

* Python library: [pystac-client documentation](https://pystac-client.readthedocs.io/en/stable/)

## STAC API Endpoints

<table><thead><tr><th width="350">Request</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:green;"><code>GET</code></mark> <code>/collections</code></td><td>Return list of available collections</td></tr><tr><td><mark style="color:green;"><code>GET</code></mark> <code>/collections/{collection_id}</code></td><td>Return metadata for a single collection</td></tr><tr><td><mark style="color:green;"><code>GET</code></mark> <code>/collections/{collection_id}/items</code></td><td>Return list of items in the specified collection</td></tr><tr><td><mark style="color:green;"><code>GET</code></mark> <code>/collections/{collection_id}/items/{item_id}</code></td><td>Retrieve a specific item in a specific collection</td></tr><tr><td><mark style="color:green;"><code>POST</code></mark> <code>/search</code></td><td>Search for items using filters (e.g., date, location)</td></tr></tbody></table>

## STAC Catalog Structure

Hydrosat's STAC catalog is organized into four collections.

<table data-header-hidden><thead><tr><th width="162"></th><th></th></tr></thead><tbody><tr><td><strong>Collection Name</strong></td><td><strong>Description</strong></td></tr><tr><td><code>vz-viri-l1a</code></td><td>Level-1A radiance data from the visible and near-infrared sensor (VIRI)</td></tr><tr><td><code>vz-liri-l1a</code></td><td>Level-1A radiance data from the longwave infrared thermal sensor (LIRI)</td></tr><tr><td><code>vz-liri-l1a-night</code></td><td>Level-1A LIRI radiance data, nighttime acquisitions only</td></tr><tr><td><code>vz-l1b</code></td><td>Level-1B data: top-of-atmosphere reflectance and brightness temperature, aligned and resampled to same resolution</td></tr><tr><td><code>vz-l1b-night</code></td><td>Level-1B brightness temperature data, nighttime acquisitions only</td></tr><tr><td><code>vz-l2</code></td><td>Level-2 data: surface reflectance and surface temperature</td></tr></tbody></table>

Each collection contains a series of items representing individual scenes. Within each item, you will find metadata and links to associated imagery.

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FDSLJBs6wvpsPJWpQfJkL%2FPicture1.png?alt=media&amp;token=f2608585-77aa-41f5-86f2-3946e7adc4da" alt=""><figcaption><p>Simplified structure of Hydrosat's STAC catalog.</p></figcaption></figure>

## STAC Query Examples

### pystac-client

We recommend using the `pystac-client` Python library. This library is specifically designed to interact with STAC catalogs and APIs. Complete documentation for this library can be found [here](https://pystac-client.readthedocs.io/en/latest/). More examples with `pystac` are included in our full [Github examples](broken://pages/sU1nSCvOYj1kpI6Q9vG4).

```python
import pystac
from pystac_client import Client

# Connect to the STAC catalog.
# See our page on authentication for how to set up your headers.
catalog = Client.open('https://stac.hydrosat.com/', headers=headers)

# Search for Level-2 data intersecting southern Australia from 19 April 2026
search = catalog.search(
        collections = ['vz-l2'],
        bbox = [140.173825, -37.63983, 149.28178, -34.929824],
        datetime = ["2026-01-19T00:00:00Z", "2026-04-19T00:00:00Z"]
    )

# Print a list of STAC items returned from the search    
items = list(search.items())
print(items)
```

### curl

The STAC server can also be queried directly from your terminal using `curl`. For example, you can use a POST request to perform a query, specifying the search parameters as JSON-formatted raw data. For more information, please see the curl [docs](https://curl.se/docs/manpage.html).

```sh
curl -X POST \
--header 'Content-Type: application/json' \
--data '{
    "collections": ["vz-l2"],
    "bbox": [140.173825, -37.63983, 149.28178, -34.929824],
    "datetime": "2026-04-01T00:00:00Z/2025-05-01T00:00:00Z"
}' \
https://stac.hydrosat.com/
```


# Authentication

Hydrosat's Discovery STAC API requires a bearer token for authentication and authorization.

This article covers the process of using a client ID and secret pair to generate a bearer token and then including that bearer token in requests to the STAC API.

For documentation on how to create an API client ID and secret, view the [Managing API Clients](/data-discovery-platform/discovery-portal/managing-api-clients) article for Discovery Portal. If you don't already have access to Discovery Portal, see [here](/data-discovery-platform/discovery-portal/getting-access).

### Using a Client ID and Secret to get a Token

When creating an API client in the Discovery Portal, you will be issued a `client ID` and `client secret` for that API client.

The client ID and secret are unique credentials that allow the client to generate a temporary bearer token which provides access to use the API with any permissions provided to that client.

The client can request a valid token by submitting its client ID and secret in a form POST payload to the following token url:

```
https://auth.hydrosat.com/oauth2/token
```

The response contains the values shown below, including the amount of time the token will live before expiring, in seconds. Because a token is only temporarily valid, the client must manage getting refreshed tokens regularly in order to have consistent access to the API.

```
{
    "access_token": "<token_value>",
    "expires_in": 3600,
    "token_type": "Bearer"
}
```

#### 'Get Token' Example

The example below assumes that the user has stored their API client ID and secret in a separate file called `creds.json` with the following structure:

```json
{
"client_id":"<clientID>",
"client_secret":"<clientsecret>"
}
```

For security, we suggest setting credential file permissions to 600 (`chmod 600 creds.json`) so that only the owner has read and write access. Consult with your organization's security team to ensure you are complying with preferred methods for storing and accessing API client credentials.

The Python example below covers using the credentials stored in `creds.json` to generate a new token for use with the Hydrosat Discovery STAC API and storing the resulting token in the `access_token` variable.

```python
tokenUrl = "https://auth.hydrosat.com/oauth2/token"

with open('creds.json') as f:
    creds = json.loads(f.read())

client_id = creds["client_id"]
client_secret = creds["client_secret"]

payload = f'grant_type=client_credentials&client_id={client_id}&client_secret={client_secret}'
headers = {
  'Content-Type': 'application/x-www-form-urlencoded',
}

token_response = requests.request("POST", tokenUrl, headers=headers, data=payload)
token_data = token_response.json()
access_token = token_data["access_token"]

```

### Using the Token to Make a STAC Request

Once the client has a valid token, it can make requests to the [STAC API](/data-discovery-platform/stac-api-documentation) as normal.

In the below example, the token is stored in the `access_token` variable from the previous code example and is used to make a request to the `/collections` endpoint using the `requests` Python library.

```python
STACheaders = {"Authorization":f"Bearer {access_token}"}
collection_response = requests.request("GET", 'https://stac.hydrosat.com/collections', headers=STACheaders)
collection_data = collection_response.json()
print(collection_data)
```

### Unauthenticated Requests

Unauthenticated requests to the STAC API will return an error (`401 Unauthorized Error)`

***

For lengthier examples and next steps, please see our [code examples in Github](/data-discovery-platform/stac-api-documentation/example-code-github-repo).


# Locating Downloadable Data (STAC API)

If your Discovery Platform account is configured to allow data downloads, your download entitlements are based on areas of interest and/or specific scene IDs. If you already know what your entitlement areas of interest ([Download Access Areas](/data-discovery-platform/discovery-portal/locating-downloadable-data#download-access-areas)) or scene IDs are, you can use that information to query data via the STAC API.

For help locating downloadable data in the Discovery Portal, check out this [separate article](/data-discovery-platform/discovery-portal/locating-downloadable-data).

If you don't know what your download entitlements are, you can look them up using Hydrosat's Accounts API.

If you would like to get access to downloadable data, contact our [sales](mailto:sales@hydrosat.com) team.

### Using Accounts API

Accounts API uses the same bearer token [Authentication](/data-discovery-platform/stac-api-documentation) and [API credentials](/data-discovery-platform/stac-api-documentation/authentication#using-a-client-id-and-secret-to-get-a-token) as the STAC API.

Use the following endpoint to GET the active access policy for your account, which includes information about your download entitlements.

```
https://accounts.hydrosat.com/v2/me/access-policies
```

The polygons for area of interest-based download entitlements are listed within `product_entitlements` and scene ID-based entitlements are listed within `scene_entitlements`. The `product_entitlements` and `scene_entitlements` also include information about which STAC collections are you entitled to download from.

```
meResponse = requests.request("GET",'https://accounts.hydrosat.com/v2/me/access-policies', headers=myheaders)
meContent = meResponse.json()
access_policy = meContent.get("access_policies", [])[0]
scene_entitlements = access_policy.get("scene_entitlements", [])
product_entitlements = access_policy.get("product_entitlements", [])
```

### Response Examples

A `product_entitlements` example with a single polygon `areas_of_interest` is shown below.

```
[
   {
      "id":"d1ab374b-7623-416d-9dc9-b62df7866625",
      "access_policy_id":"98ab1aa0-02a2-4a75-b5bf-19e95f5eb08e",
      "product_name":"archive",
      "configuration":{
         "product_name":"archive",
         "collections":[
            "vz-liri-l1a",
            "vz-viri-l1a",
            "vz-l1b",
            "vz-l2"
         ],
         "restrict_search":false,
         "restrict_items":true,
         "restrict_properties":true
      },
      "areas_of_interest":[
         {
            "id":"448e8a88-0c56-4406-b9ba-a64b2c946584",
            "product_entitlement_id":"d1ab374b-7623-416d-9dc9-b62df7866625",
            "name":"Lake",
            "geometry":{
               "type":"Polygon",
               "coordinates":[
                  [
                     [
                        -94.0733085212435,
                        31.98981826138629
                     ],
                     [
                        -93.82521380712805,
                        31.113313105933432
                     ],
                     [
                        -93.41658721917305,
                        31.01958485756203
                     ],
                     [
                        -93.38010270239135,
                        31.275556307422413
                     ],
                     [
                        -93.5260407695181,
                        31.704771952854895
                     ],
                     [
                        -93.82521380712805,
                        31.97125515504588
                     ],
                     [
                        -94.0733085212435,
                        31.98981826138629
                     ]
                  ]
               ]
            },
            "created":"2026-07-10T23:12:25.815575Z",
            "updated":"2026-07-10T23:12:25.815575Z"
         }
      ],
      "created":"2026-07-10T23:12:25.587717Z",
      "updated":"2026-07-10T23:12:25.587717Z"
   }
]
```

A `scene_entitlements` example containing 2 `scene_id`s is shown below.

```
[
   {
      "id":"5d756296-38d0-4c61-a256-1cfc4eeee411",
      "access_policy_id":"ffdf58c5-c527-4c32-98cf-933a2114f0c5",
      "collections":[
         "vz-liri-l1a",
         "vz-viri-l1a",
         "vz-l1b",
         "vz-l2"
      ],
      "scene_id":"VZ01_20260306_050940",
      "created":"2026-07-10T21:54:04.501632Z",
      "updated":"2026-07-10T21:54:04.501632Z"
   },
   {
      "id":"e9377d49-6342-4530-ad87-325cd3a04989",
      "access_policy_id":"ffdf58c5-c527-4c32-98cf-933a2114f0c5",
      "collections":[
         "vz-liri-l1a",
         "vz-viri-l1a",
         "vz-l1b",
         "vz-l2"
      ],
      "scene_id":"VZ02_20260514_073333",
      "created":"2026-07-10T21:54:04.391214Z",
      "updated":"2026-07-10T21:54:04.391214Z"
   }
]
```


# Example Code Github Repo

Visit our example code [Github repo](https://github.com/Hydrosat/vz-tutorials) for helpful tutorials for using our STAC API and imagery.


# API Status

Visit our [status page](https://status.hydrosat.com/) and sign up for notifications to get the latest information on our STAC API availability.

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FJ7uVq846Ahy9D4eMuYXR%2Fstatus.png?alt=media&amp;token=3d8d4782-e780-4387-8c73-eaeac1f6c628" alt=""><figcaption></figcaption></figure>


# Sample Data

Sample data is available to all users of the Discovery Platform. Don't have access to the Discovery Platform yet? Follow the [instructions to request access](/data-discovery-platform/discovery-portal/getting-access).

We currently offer sample data sets for the following use cases:

* Agriculture
* Energy / Industrial
* General Open Data Set
* Urban Heat
* Wildfire

Discovery Platform accounts are typically set up with one of these sample data sets based on the best match to the Industry provided in the access request. If you don't see sample data or would like to request access to a different set, contact <support@hydrosat.com> with your request.

Sample data is Downloadable to you, so it appears in the Discovery Portal search results when the Downloadable toggle is enabled or when [looking up your entitled scenes using the API](/data-discovery-platform/stac-api-documentation/locating-downloadable-data).

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2F36Qc959DeJhUbBhWWde0%2Fdownloadable.png?alt=media&amp;token=d5243aae-ef56-42b5-a9d4-85019d38711f" alt=""><figcaption></figcaption></figure>

We encourage you to explore and download our sample data.

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FMCjhtO8XC5iswFllYUPB%2Fsample.png?alt=media&amp;token=131b3048-8839-48ba-bb31-b930610c0dc7" alt=""><figcaption></figcaption></figure>


# Changelog

A list of product updates, including release dates and key features.

{% updates format="full" %}
{% update date="2026-10-30" tags="platform" %}

## Ease-of-use Improvements to Discovery Portal

This release includes improvements to the existing user interface:

* Refinements to the Acquisition Date picker including auto-saving of inputs, a Clear Dates button, a dropdown for picking the year, and retainment of previously used dates.
* Helpful links for users of the STAC API on the `API Client Credentials` section on the `Account` page.
* Addition of in-app tours covering key functionality.
  {% endupdate %}

{% update date="2026-10-07" tags="platform" %}

## Full Resolution Previews in Discovery Portal

For data you have download access to, including evaluation data, you can now see that imagery in full preview resolution on the map, to make understanding the data easier at a glance.

When zoomed in, there is now a clear visual indicator for imagery that is not available to you in full preview resolution. You can contact our sales team at <sales@hydrosat.com> for access to downloadable data.

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FPLu5mB0hHKJyGcJxBIv5%2Fpreviews.png?alt=media&amp;token=9c388ff5-e0a0-4a27-9ed8-15e0d077cb43" alt=""><figcaption></figcaption></figure>
{% endupdate %}

{% update date="2026-09-30" tags="platform,product-update" %}

## Nighttime Imagery Now Available

Nighttime thermal imagery is now available in Hydrosat's Discovery platform within the `vz-liri-l1a-night` and `vz-l1b-night` STAC collections.

To learn more about our nighttime products, see [Product Details](/thermal-data/product-details).

<div data-with-frame="true"><figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FUDvVxvKESWJ8fzUdMumU%2FScreenshot%202026-10-05%20at%2010.09.46%E2%80%AFAM.png?alt=media&amp;token=1b8c3dea-b2cd-4e3a-8c39-f720fc74c281" alt=""><figcaption><p>Nighttime imagery visualized in the Discovery portal.</p></figcaption></figure></div>
{% endupdate %}

{% update date="2026-09-08" tags="quality-control" %}

## Image Quality Logs

Quality logs are now available in STAC item metadata (`hydrosat:quality_log`).

These logs offer more context about acquisition and processing conditions so that users can better understand quality characteristics across scenes.

| Quality Log                          | What It Means                                                                                    |
| ------------------------------------ | ------------------------------------------------------------------------------------------------ |
| `Insufficient illumination for VNIR` | The sun's elevation was low during acquisition. This may reduce the quality of the VNIR imagery. |
| `Geolocation out of spec`            | Geolocation for the scene does not meet the expected accuracy.                                   |
| `Georeference failure`               | The nominal georeference procedure did not complete as expected.                                 |
| `Extreme cold values clipped`        | Some pixels contain fill values. Use the `QUALITY_ASSURANCE` mask for details.                   |
| {% endupdate %}                      |                                                                                                  |

{% update date="2026-08-25" tags="cloud-mask" %}

## Cloud Mask Improvements

We've deployed a new version of our cloud detection model using a significantly larger and more diverse training dataset. This results in fewer false positives in the cloud mask and improved detection performance across a wider range of cloud conditions.
{% endupdate %}

{% update date="2026-05-21" tags="processing" %}

## Footprint Geometry Correction

We've deployed a minor fix to ensure representativeness of STAC item footprint geometries with actual imaged area.
{% endupdate %}

{% update date="2026-03-31" tags="processing" %}

## Coregistration Improvements

We've refined our mutual information-based coregistration workflow for improved feature matching between the LWIR and VNIR data.
{% endupdate %}

{% update date="2026-02-24" tags="processing" %}

## Geometric Processing Improvements

We've updated our georeferencing and VNIR band alignment workflows to improve geolocation accuracy and band-to-band registration. This release includes:

1. An enhanced optical distortion correction to reduce residual along-track offsets
2. Use of a digital elevation model (DEM) to improve band-to-band registration over complex terrain
   {% endupdate %}

{% update date="2026-02-05" tags="product-update" %}

## Level-1 Unit Changes

We've modified the units for our Level-1A and Level-1B data products.

#### Before The Change

Previously, L1A and L1B imagery assets contained per-band digital number data. To arrive at radiance, the user needed to apply gain and offset coefficients provided in product metadata.

#### After The Change

**Level-1A Products**

* L1A imagery assets now natively contain per-band top-of-atmosphere (TOA) radiance values. Gain and offset coefficients are applied as part of Hydrosat's data processing.
  * Units: W/m<sup>2</sup>/sr/μm
  * Scaling factor: 0.01 (VNIR), 0.0001 (LWIR)

**Level-1B Products**

* L1B imagery assets contain per-band TOA reflectance data (for VNIR bands) and brightness temperature data (for LWIR bands).
  * Units: Unitless (VNIR); Kelvin (LWIR)
  * Scaling factor: 0.0001 (VNIR); 0.01 (LWIR)

**Conversions**

* Hydrosat provides a full suite of coefficients in product metadata for conversion between TOA radiance and reflectance (or brightness temperature). For more information on usage, see [this page](https://satdocs.hydrosat.com/product-details#conversions) or our product guide.
  {% endupdate %}

{% update date="2026-01-27" tags="thumbnails" %}

## Thumbnail Colorization Improvements (LWIR)

We've improved the contrast and visual consistency in our L1B and L2 thermal thumbnails and previews. This includes:

* Consistent scaling across the full imaging strip rather than within individual scenes.
* A switch from the `inferno` color ramp to a modified `RdYlBu_r` color ramp, where cooler pixels are shown in blue and warmer ones in red. These colors map to predictable temperatures; the breakpoint from blue to yellow occurs at approximately 0 degrees Celsius.

This change has no impacts on the underlying data.
{% endupdate %}

{% update date="2026-01-20" tags="processing" %}

## Noise Mitigation

We've implemented a minor correction for noise in the thermal products.
{% endupdate %}

{% update date="2026-01-14" tags="thumbnails" %}

## Thumbnail Colorization Improvements (RGB)

We've released a color curve approach that improves the visual contrast in our true color thumbnails. This change has no impacts on the underlying data.
{% endupdate %}

{% update date="2025-12-17" tags="cloud-mask" %}

## Updated Cloud Mask

We've released an improved cloud mask, which uses a U-Net convolutional neural network architecture. The new model outperforms our baseline Fmask approach across several key metrics.
{% endupdate %}
{% endupdates %}


# FAQs

Here are our answers to some frequently asked questions from users.

<details>

<summary>I didn't receive my Discovery Platform invitation email. What should I do?</summary>

Please check your spam inbox. If you still don't see the invitation email, reach out to <support@hydrosat.com> for assistance.

</details>

<details>

<summary>Can I browse the catalog even if I haven't ordered any data?</summary>

Yes! Fill out the Request Access form on [our website](https://hydrosat.com/data-discovery-platform/) in order to request browse access to the Discovery Platform.

</details>

<details>

<summary>What is STAC?</summary>

STAC stands for "SpatioTemporal Asset Catalog". It's a standardized framework for indexing, cataloging, and describing geospatial data. It makes Hydrosat data easier to work with, especially if you're integrating it with data from other sources.

</details>

<details>

<summary>What do the different assets in a STAC item represent?</summary>

Each STAC item includes several assets representing the individual data and metadata files associated with the scene. Items from different collections have different assets, as defined on our [Product Details](/thermal-data/product-details) page.

</details>

<details>

<summary>I can only download thumbnail assets for certain scenes. Where's the rest of the data?</summary>

You have full access to the scenes you've ordered and thumbnail-only access to the rest of the catalog.

</details>

<details>

<summary>What do the different values in the cloud mask mean?</summary>

The cloud mask encodes information about clear or cloudy conditions present within each pixel.

Specifically, the cloud mask contains bit-packed pixel values; each pixel value is a decimal representation of binary strings, in which each bit represents a different condition.

For simplicity, we recommend using the look-up table below. The table displays common pixel values and their meanings.

<table><thead><tr><th data-type="number">Value</th><th data-type="checkbox">Clear</th><th data-type="checkbox">No data</th><th data-type="checkbox">Cloud</th></tr></thead><tbody><tr><td>0</td><td>true</td><td>false</td><td>false</td></tr><tr><td>1</td><td>false</td><td>true</td><td>false</td></tr><tr><td>2</td><td>false</td><td>false</td><td>true</td></tr></tbody></table>

If you see a value of 2 in the cloud mask, for example, this would indicate cloudy conditions.

You can also review our how-to guide on using the cloud mask for additional information.

</details>

<details>

<summary>Where can I check the online status of the STAC API, Accounts API, or Discovery Portal?</summary>

Check out our [status page](https://status.hydrosat.com/) for information about whether our services are online. You can even subscribe to notifications about the online status.

If you are having issues with access, or you notice the services are offline for a prolonged period, don't hesitate to contact our [support team](mailto:support@hydrosat.com).

</details>

<details>

<summary>I want to learn more about Hydrosat's data products. Where can I find more information?</summary>

You can find additional details in our product guide. Please reach out to your organization point of contact if you don't already have this document.

</details>

<details>

<summary>Can I use the STAC API with QGIS?</summary>

Though we recommend using [Discovery Portal](/data-discovery-platform/discovery-portal) for a superior browsing experience, it is possible to connect to our STAC API from QGIS.

Begin by [getting access to a client ID and secret](/data-discovery-platform/stac-api-documentation/authentication). Then right-click the `STAC` option in the QGIS browser add a `New STAC Connection` . Fill out the Authentication form as shown to set up the connection and click `Save`. The `Token URL` is `https://auth.hydrosat.com/oauth2/token`

{% hint style="info" %}
If you do not see the Grant flow: Client Credentials option, update your installation of QGIS. The necessary authentication configuration is only supported on newer versions of QGIS.
{% endhint %}

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FgpW8EmHUSWo2wS7OW3ht%2Fqgis2.png?alt=media&amp;token=193053a9-a7d4-4e34-a66e-a641f9da46e3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FYWgI4edIIy2yOx1l2EtT%2Fpreview.png?alt=media&amp;token=936c9222-421c-4f46-87a8-f2c947e3d8db" alt=""><figcaption></figcaption></figure>

</details>


