@aguacerowx/mapsgl

Mapbox GL weather layers for Aguacero. Model grids, NEXRAD, and satellite all go through WeatherLayerManager. Satellite uses the same tiled catalog and WebGL layer as aguacero.com.

Satellite

import { WeatherLayerManager } from '@aguacerowx/mapsgl';
import {
  SATELLITE_INSTRUMENTS,
  SATELLITE_IMAGERY_CHANNELS,
  SATELLITE_L2_CHANNELS,
  GOES_SATELLITE_CHANNEL_LABELS,
} from '@aguacerowx/javascript-sdk';

await weatherManager.switchMode({
  mode: 'satellite',
  satelliteId: 'GOES19-EAST',
  satelliteSector: 'GOES-EAST CONUS',
  satelliteProduct: 'C13',
});

setSatelliteSelection({ satelliteId, sector, satelliteProduct }) accepts the same ids. Short sector tokens (conus, pacific, m1, japan, rapid_scan, indian_ocean, q4) resolve to the labels below.

Frames come from the processing catalog. The map layer uploads each BMX tile and the GPU expands it, including multi-band recipes. This is not the old full-frame KTX path.

Sectors

| Instrument id | Sectors | | --- | --- | | GOES19-EAST | GOES-EAST FULL DISK, GOES-EAST CONUS, GOES-EAST MESOSCALE 1, GOES-EAST MESOSCALE 2 | | GOES18-WEST | GOES-WEST FULL DISK, GOES-WEST PACIFIC, GOES-WEST MESOSCALE 1, GOES-WEST MESOSCALE 2 | | HIMAWARI9 | HIMAWARI FULL DISK, HIMAWARI JAPAN, HIMAWARI TARGET | | METEOSAT12 | EUMETSAT FULL DISK, EUMETSAT EUROPE, EUMETSAT AFRICA, EUMETSAT QUARTER 1, EUMETSAT QUARTER 2, EUMETSAT QUARTER 3 | | METEOSAT11 | EUMETSAT RAPID SCAN | | METEOSAT9 | EUMETSAT INDIAN OCEAN |

Europe and Rapid Scan use the mesoscale timeline (2 minutes). Full disk, Africa, and Indian Ocean use 10 minutes. CONUS, Pacific, Japan, and quarters 1–3 use 5 minutes.

Products

Imagery channels (SATELLITE_IMAGERY_CHANNELS) are C01–C16 plus the RGB recipes: true_color, false_color, natural_color, geocolor, overview, day_land_cloud_fire, day_cloud_phase, day_cloud_type, day_snow_fog, day_convection, day_microphysics, cloud_phase_eumetsat, sandwich, air_mass, tropical_airmass, dust, dust_cvd, volcanic_ash, so2, fire_temperature, microphysics_24h, ntmicro, blowing_snow, rocket_plume, simple_water_vapor, differential_water_vapor.

GOES Level-2 products (SATELLITE_L2_CHANNELS) match the website menus:

• Clouds: ACHA_HT, ACHP_PRES, ACTP_PHASE, ACM_BCM, ACM_PROB, CCL_TCF, CCL_CL, CCL_CF1, CCL_CF2, CCL_CF3, CCL_CF4, CCL_CF5
• Fire: FDC_MASK, FDC_FRP, FDC_TEMP, FDC_AREA
• Stability: DSI_CAPE, DSI_LI, DSI_TT, DSI_KI, DSI_SI
• Atmosphere: TPW, AOD, ADP_SMOKE, ADP_DUST, RRQPE
• Land: LST, LSA, FSC

Level-2 products are GOES-East and GOES-West only. Labels for every id are GOES_SATELLITE_CHANNEL_LABELS.

Layer controls

• setSatelliteColormapOverrides({ colormap, colormapIR, colormapWV, interpolate }) replaces the default enhancement for bands. Level-2 products keep their own physical-unit ramps unless colormap is set explicitly.
• setSatellite3dSettings({ enabled, height }) turns on cloud-top relief for single bands C07 and above. Recipes and Level-2 products stay flat.
• shaderSmoothingEnabled / setShaderSmoothing is the satellite fill smoothing flag (0 or 1 on the tiled layer).
• onStateChange includes satelliteSource (frames for the current product) and satelliteTimeToFileMap (timestamp → source key).