Pandonia Global Network (PGN)¶

The pandonia gatherer downloads direct-sun and zenith-sky spectrometer measurements of atmospheric trace gas column densities from the Pandonia Global Network.

Overview¶

Provider: Pandonia Global Network (NASA / ESA / LuftBlick)
Official Network Website: pandonia-global-network.org
Data Archive & Realtime Portal: data.pandonia-global-network.org
API Key Request: PGN Contact / Access Request Form
Coverage: Global network of ~150 Pandora spectrometer instruments
Observations: Total and tropospheric vertical column densities (VCD)
Authentication: Requires free PGN API key
Output Format: ASCII / BZ2 compressed data tables

Supported Trace Gas Products¶

Product Code	Gas Name	Description
`fnvh3`	Nitrogen Dioxide (NO₂)	Total & tropospheric NO₂ vertical column
`fzo3`	Ozone (O₃)	Total column ozone
`fvh3`	Formaldehyde (HCHO)	Formaldehyde column density
`fsh3`	Sulfur Dioxide (SO₂)	Total column sulfur dioxide
`fwh3`	Water Vapor (H₂O)	Total column water vapor

Parameters Reference¶

Parameter	Type	Default	Description
`station`	`str`	required	Station name (e.g. `"Thessaloniki"`, `"Innsbruck"`, `"Granada"`, `"Rome-TorVergata"`)
`product`	`str \\| list[str]`	`["fnvh3"]`	Trace gas product code(s)
`start_date`	`str`	required	Start date in `YYYY-MM-DD` format
`end_date`	`str`	required	End date in `YYYY-MM-DD` format
`instrument_id`	`str \\| None`	`None`	Optional Pandora instrument ID (e.g. `"Pandora45"`, auto-resolved if omitted)
`level`	`str`	`"L2Fit"`	Processing level (`"L2Fit"`, `"L2Tot"`, `"L1"`)
`spectrometer`	`str`	`"1"`	Spectrometer number (`"1"` or `"2"`)
`api_key`	`str \\| None`	`None`	PGN API key (defaults to `PANDONIA_API_KEY` env var)
`overwrite_cache`	`bool`	`False`	Force re-download even if cached

Authentication Setup¶

Request a free API key via the PGN Contact Form. Alternatively, direct public archive downloads are available on data.pandonia-global-network.org.

# Save to credentials.yaml
gathering auth login pandonia -p "your_api_key"

# Or set in environment
export PANDONIA_API_KEY="your_api_key"

Python API Usage¶

from gathering import Task

task = Task.pandonia(
    station="Thessaloniki",
    start_date="2023-05-01",
    end_date="2023-05-21",
    product=["fnvh3", "fzo3"],
)

results = task.run()

CLI Usage¶

gathering pandonia \
  --station Thessaloniki \
  --product fnvh3 fzo3 \
  --start_date 2023-05-01 \
  --end_date 2023-05-21

YAML Configuration¶

# ==============================================================================
# Pandonia Global Network (PGN / Pandora) — Atmospheric Trace Gases
# ==============================================================================

source: pandonia

# --- Authentication (Optional inline; alternatively use PANDONIA_API_KEY or credentials.yaml) ---
# api_key: "your_pandonia_api_key"

# Station name (e.g. 'Innsbruck', 'Granada', 'Madrid', 'Rome-TorVergata')
station: "Innsbruck"

# Instrument identifier (optional, auto-resolved if omitted)
instrument_id: "Pandora45"

# Observation date range
start_date: "2023-07-01"
end_date: "2023-07-03"

# Products to download
product:
  - "fnvh3"   # Nitrogen Dioxide (NO2)
  - "fzo3"    # Ozone (O3)
  - "fvh3"    # Formaldehyde (HCHO)

# Processing level & spectrometer
level: "L2Fit"
spectrometer: "1"

overwrite_cache: false

Download Directory Structure¶

/workspace/.cache/gathering/pandonia/
└── Innsbruck/
    └── Pandora45/
        ├── Pandora45s1_Innsbruck_L2Fit_rnvs3p1-8.txt
        └── Pandora45s1_Innsbruck_L2Fit_ro3s3p1-8.txt