Skip to content

Run Ingestion

Run the installed plugin once to write a local Zarr product, then open it to confirm the data cube looks the way you expect.

Prerequisites

  • The quickstart virtual environment is active.
  • The quickstart_plugin plugin from Install the Example Plugin is installed.
  • The four files from Prepare Source Data exist under sample_data/.
  • Commands run from the firecube-quickstart-plugin/ directory.

Run The Ingestion

firecube ingest quickstart_plugin \
  --input-data sample_data \
  --target "file://${PWD}/sample_data/quickstart_plugin_out.zarr" \
  --product-name quickstart_plugin \
  --storage-type local \
  --storage-driver fsspec \
  --output-format zarr \
  --write-mode staged

The final summary should identify the selected plugin, the quickstart_plugin product, four processed files, and the local stored_at path.

Verify The Run

Confirm that the Zarr directory exists:

test -d sample_data/quickstart_plugin_out.zarr && echo "Zarr product created"

Expected output:

Zarr product created

Inspect the product's control-plane records using the full product URI:

firecube chunks list \
  --product-name "file://${PWD}/sample_data/quickstart_plugin_out.zarr"

The result should contain at least one span record for the completed run. These are logical Firecube records, not physical Zarr array chunks.

Open And Inspect The Cube

Firecube writes the plugin's data into a default group inside the Zarr store:

python - <<'PY'
import xarray as xr

ds = xr.open_zarr(
    "sample_data/quickstart_plugin_out.zarr",
    group="default",
    consolidated=False,
)
print(ds)
print(ds["temperature_c"].isel(latitude=0, longitude=0).values.tolist())
PY

Expected output includes:

Dimensions:  (timestamp: 4, latitude: 2, longitude: 3)
[19.4, 22.8, 27.3, 24.1]

The timestamp dimension has length 4, latitude has length 2, and longitude has length 3. The four temperature values keep the timestamp order defined in the source files. The result also contains humidity_pct and Firecube's timestamp-state array.

This completes the quickstart: you installed Firecube, installed a plugin, staged source data, and produced a Zarr cube you can open with xarray.

Next Steps