bioepic-data/ecosim-agent / .agents/skills/ameriflux-site-info
ameriflux-site-info
VerifiedExtract AmeriFlux site metadata and map it to EcoSIM JSON variables. Use when a task needs site latitude, longitude, elevation, mean annual temperature, Koppen climate code, or vegetation type for an AmeriFlux site ID or flux-site name.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.7 KB |
| extract_ameriflux_site_data.py | script | 30.4 KB |
| test_extract_ameriflux_site_data.py | script | 9.9 KB |
test_extract_ameriflux_site_data.py
View on GitHub#!/usr/bin/env python3
"""Tests for AmeriFlux site metadata parsing and location cross-checks."""
import io
import json
import sys
import tempfile
import unittest
from contextlib import redirect_stderr
from pathlib import Path
from unittest import mock
SKILL_DIR = Path(__file__).resolve().parent
if str(SKILL_DIR) not in sys.path:
sys.path.insert(0, str(SKILL_DIR))
import extract_ameriflux_site_data as site
def page(site_id, name, lat_long, elevation, koppen, mat, description="A flux site."):
"""Page text in the AmeriFlux siteinfo layout: label line, then value line."""
return "\n".join(
[
f"{site_id}: {name}",
"Lat, Long:",
lat_long,
"Elevation(m):",
elevation,
"Vegetation IGBP:",
"WET (Permanent Wetlands)",
"Climate Koppen:",
koppen,
"Mean Annual Temp (°C):",
mat,
"Description:",
description,
]
)
def ecosim(site_id, lat, lon, mat, koppen, description=None, sign_checks=None):
return {
"site_name": site_id,
"ALATG": lat,
"ALONG": lon,
"ALTIG": 100.0,
"ATCAG": mat,
"IETYPG": site.KOPPEN_MAP[koppen],
"IXTYP1": 10,
"_raw": {"climate_code": koppen, "description": description, "sign_checks": sign_checks or {}},
}
class SignParsingTests(unittest.TestCase):
def test_negative_values_on_their_own_line_keep_sign(self):
text = page(
"BR-Npw", "Northern Pantanal Wetland", "-16.4980, -56.4120", "120", "Aw (Tropical savanna)", "24.9",
"The site is located in the northern Pantanal in central South America.",
)
raw = site.parse_site_metadata_from_text(text, "BR-Npw", "test")
self.assertEqual((raw["latitude"], raw["longitude"]), (-16.498, -56.412))
self.assertEqual(raw["sign_checks"]["latitude"], "matched")
def test_negative_mat_and_elevation_keep_sign(self):
text = page("US-Brw", "Barrow", "71.3225, -156.6092", "-4", "ET (Tundra)", "-12.6")
raw = site.parse_site_metadata_from_text(text, "US-Brw", "test")
self.assertEqual(raw["MAT"], -12.6)
self.assertEqual(raw["elevation"], -4.0)
def test_bullet_dash_is_still_removed(self):
self.assertEqual(site.clean_line("- Site description "), "Site description")
self.assertEqual(site.clean_line("-16.4980, -56.4120"), "-16.4980, -56.4120")
self.assertEqual(site.clean_line("Lat, Long: |"), "Lat, Long")
def test_sign_check_flags_lost_sign(self):
text = page("CL-SDF", "Senda Darwin", "-41.8830, -73.6760", "50", "Cfb", "10")
raw = {"latitude": 41.883, "longitude": -73.676, "elevation": 50.0, "MAT": 10.0}
checks = site.check_signs_against_page(text, raw)
self.assertEqual(checks["latitude"], "sign_mismatch")
self.assertEqual(checks["longitude"], "matched")
class PrecipitationMetadataTests(unittest.TestCase):
def test_sourced_optional_map_is_preserved(self):
text = page('US-Ne1', 'Mead', '41.1651, -96.4766', '361', 'Dfa', '10.07')
text += '\nMean Annual Precip. (mm):\n790.37\n'
raw = site.parse_site_metadata_from_text(text, 'US-Ne1', 'https://example.org/site')
data = site.raw_to_ecosim('US-Ne1', raw)
self.assertEqual(data['mean_annual_precip_mm'], 790.37)
self.assertEqual(data['precipitation_reference'], 'https://example.org/site')
def test_missing_precipitation_does_not_consume_other_field(self):
for lines in [['Mean Annual Precip. (mm)', 'NA', 'Mean Annual Temp', '10.07'],
['Mean Annual Precip. (mm)', 'Elevation(m)', '361']]:
self.assertIsNone(site.extract_precip_climatology(lines))
class LocationValidationTests(unittest.TestCase):
def test_correct_southern_site_passes(self):
data = ecosim("BR-Npw", -16.498, -56.412, 24.9, "Aw", "northern Pantanal in central South America")
result = site.validate_site_location("BR-Npw", data)
self.assertEqual(result["status"], "passed")
self.assertEqual(result["checks"]["description_region"], "passed")
def test_lost_latitude_sign_fails_country_envelope_with_hint(self):
data = ecosim("BR-Npw", 16.498, -56.412, 24.9, "Aw", "northern Pantanal in central South America")
result = site.validate_site_location("BR-Npw", data)
self.assertEqual(result["status"], "failed")
self.assertEqual(result["checks"]["country_bounds"], "failed")
self.assertIn("opposite sign", result["errors"][0])
self.assertEqual(result["checks"]["description_region"], "failed")
def test_page_sign_mismatch_is_an_error(self):
data = ecosim("US-Myb", 38.05, -121.77, 15.9, "Csa", sign_checks={"elevation": "sign_mismatch"})
result = site.validate_site_location("US-Myb", data)
self.assertEqual(result["status"], "failed")
self.assertIn("elevation", result["errors"][0])
def test_lost_mat_sign_warns_for_tundra(self):
data = ecosim("US-Brw", 71.3225, -156.6092, 12.6, "ET")
result = site.validate_site_location("US-Brw", data)
self.assertEqual(result["status"], "warnings")
self.assertEqual(result["checks"]["koppen_consistency"], "failed")
def test_unknown_country_prefix_is_skipped(self):
data = ecosim("XX-Abc", 10.0, 10.0, 25.0, "Aw")
result = site.validate_site_location("XX-Abc", data)
self.assertTrue(result["checks"]["country_bounds"].startswith("skipped"))
def write_koppen_raster(path):
"""1-degree toy map: Aw band 10-20 S, ocean 10-20 N, Dfb band 40-50 N; lon -60 to -50."""
import numpy as np
from netCDF4 import Dataset
labels = ["Aw", "Cfb", "Dfb"]
lats = np.arange(59.5, -60.0, -1.0)
lons = np.arange(-59.5, -50.0, 1.0)
ids = np.full((len(lats), len(lons)), -1, dtype="i8")
ids[(lats < -10) & (lats > -20), :] = 0
ids[(lats > 40) & (lats < 50), :] = 2
with Dataset(path, "w") as ds:
ds.createDimension("lat", len(lats))
ds.createDimension("lon", len(lons))
ds.createDimension("labels", len(labels))
ds.createVariable("lat", "f8", ("lat",))[:] = lats
ds.createVariable("lon", "f8", ("lon",))[:] = lons
variable = ds.createVariable("ids", "i8", ("lat", "lon"), fill_value=-1)
variable[:] = np.ma.masked_equal(ids, -1)
label_var = ds.createVariable("labels", str, ("labels",))
for index, label in enumerate(labels):
label_var[index] = label
class KoppenFromCoordinatesTests(unittest.TestCase):
def setUp(self):
self.tmp = tempfile.TemporaryDirectory()
self.raster = str(Path(self.tmp.name, "Koppen.nc"))
write_koppen_raster(self.raster)
def tearDown(self):
self.tmp.cleanup()
def test_matching_class_passes(self):
data = ecosim("XX-Aaa", -15.0, -55.0, 25.0, "Aw")
result = site.validate_site_location("XX-Aaa", data, self.raster)
self.assertEqual(result["checks"]["koppen_from_coordinates"], "passed")
self.assertEqual(result["koppen_from_coordinates"]["center"], "Aw")
def test_lost_latitude_sign_gets_sign_hint(self):
data = ecosim("XX-Aaa", 15.0, -55.0, 25.0, "Aw")
result = site.validate_site_location("XX-Aaa", data, self.raster)
self.assertEqual(result["checks"]["koppen_from_coordinates"], "failed")
self.assertIn("opposite-sign latitude", result["warnings"][-1])
self.assertEqual(result["status"], "warnings")
def test_plain_mismatch_is_a_warning_without_sign_hint(self):
data = ecosim("XX-Aaa", 45.0, -55.0, 12.0, "Cfb")
result = site.validate_site_location("XX-Aaa", data, self.raster)
self.assertEqual(result["checks"]["koppen_from_coordinates"], "failed")
self.assertNotIn("opposite-sign", result["warnings"][-1])
self.assertIn("Dfb", result["warnings"][-1])
def test_missing_raster_is_not_available(self):
data = ecosim("XX-Aaa", -15.0, -55.0, 25.0, "Aw")
result = site.validate_site_location("XX-Aaa", data, None)
self.assertEqual(result["checks"]["koppen_from_coordinates"], "not_available")
class CacheTests(unittest.TestCase):
def test_cached_metadata_failing_checks_is_refetched(self):
with tempfile.TemporaryDirectory() as tmp:
bad = ecosim("BR-Npw", 16.498, -56.412, 24.9, "Aw")
Path(tmp, "BR-Npw_ecosim_site.json").write_text(json.dumps(bad))
fresh_raw = {
"site_name": "Northern Pantanal Wetland", "latitude": -16.498, "longitude": -56.412,
"elevation": 120.0, "MAT": 24.9, "climate_code": "Aw", "igbp_type": "WSA",
"description": None, "source": "test", "sign_checks": {},
}
with mock.patch.object(site, "fetch_and_parse", return_value=fresh_raw) as fetch, \
redirect_stderr(io.StringIO()) as stderr:
result = site.extract_site_info("BR-Npw", output_dir=tmp)
fetch.assert_called_once()
self.assertIn("refetching", stderr.getvalue())
self.assertEqual(result["ALATG"], -16.498)
saved = json.loads(Path(tmp, "BR-Npw_ecosim_site.json").read_text())
self.assertEqual(saved["ALATG"], -16.498)
def test_failed_fresh_extraction_is_not_written(self):
with tempfile.TemporaryDirectory() as tmp:
wrong_raw = {
"site_name": "Senda Darwin", "latitude": 41.883, "longitude": -73.676,
"elevation": 50.0, "MAT": 10.0, "climate_code": "Cfb", "igbp_type": "EBF",
"description": None, "source": "test", "sign_checks": {},
}
with mock.patch.object(site, "fetch_and_parse", return_value=wrong_raw):
with self.assertRaises(ValueError):
site.extract_site_info("CL-SDF", output_dir=tmp, force_refresh=True)
self.assertFalse(Path(tmp, "CL-SDF_ecosim_site.json").exists())
if __name__ == "__main__":
unittest.main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |