Background

This page provides a simple example that visualizes the results of a GitHub Actions workflow when downloading daily chlorophyll-a (Chla) data from ERDDAP within territorial waters of US states bordering the Gulf of Mexico. Data validation is performed across pixels of the raster product within these waters, as well as for the average values per state. Validation results are summarized in reports based on user-defined conditional statements.

Given the lag in data availability for the nesdisVHNSQchlaDaily Chla product (9 days), the data accessed in this example will be accessed from 2 weeks prior (i.e., 2025-10-08).

This example process involves:

Approximating territorial waters by buffering a spatial layer of state boundaries
Access the Chla data for the region of interest
Masking the Chla data to territorial state waters in GoM
Calculating mean Chla values per state
Validating pixel-level and state-level Chla data to check for issues
Generate reports from data validation

Report output

Report for pixel-level data

		STEP	COLUMNS	VALUES	EVAL	UNITS	PASS	FAIL	W	S	N	EXT
Pointblank Validation
[2025-10-22\|10:45:51] data frame Gulf state daily Chl-a valuesWARN 0.01 STOP 0.25 NOTIFY 0.05
	1	`col_vals_not_null()`	`▮chla`	—	✓	`29504`	`4645` `0.15744`	`24859` `0.84256`	●	●	●
	2	`col_vals_between()`	`▮chla`	`[0.001, 100]`	✓	`29504`	`29504` `1`	`0` `0`	○	○	○	—
	3	`col_vals_lt()`	`▮chla`	`30`	✓	`29504`	`29045` `0.98444`	`459` `0.01556`	●	○	○
2025-10-22 10:45:51 UTC 1.3 s 2025-10-22 10:45:53 UTC

Report for state-level data

		STEP	COLUMNS	VALUES	EVAL	UNITS	PASS	FAIL	W	S	N	EXT
Pointblank Validation
[2025-10-22\|10:45:53] data frame Gulf state means for daily Chl-a dataWARN 0.20 STOP 0.25 NOTIFY 0.20
	1	`col_vals_not_null()`	`▮chla`	—	✓	`5`	`5` `1`	`0` `0`	○	○	○	—
	2	`col_vals_between()`	`▮chla`	`[2, 20]`	✓	`5`	`5` `1`	`0` `0`	○	○	○	—
	3	`col_vals_lt()`	`▮chla`	`20`	✓	`5`	`5` `1`	`0` `0`	○	○	○	—
2025-10-22 10:45:53 UTC < 1 s 2025-10-22 10:45:53 UTC

Maps of chl-a data

Figure 1: Boundaries of states and territorial waters (out to 12 nm) for states bordering the Gulf of Mexico.

Figure 2: Masked pixels of chlorophyll-a ERDDAP product within territorial waters. Gray values denote missing values for this dataset.

Figure 3: Mean chlorophyll-a per Gulf state within territorial waters.