Sources and attribution
Every sources id used in data/species.csv, data/tasks.json, or the engine's threshold tables is defined here with the credit text the license requires. This file is rendered on the site's Sources page verbatim. Add a source here before using its id anywhere. Status: active (in use), pending (permission or licensing question open), reference (consulted, not ingested).
| id | Source | What we use | License / required credit | Status |
|---|---|---|---|---|
npn-phenometrics | USA National Phenology Network, Nature's Notebook observational data (site and individual phenometrics), https://www.usanpn.org/data | First-open-flower onsets for threshold fitting and validation | CC BY 4.0. Required text: "Data were provided by the USA National Phenology Network and the many participants who contribute to its Nature's Notebook program." Cite DOI 10.5066/F78S4N1V. Send publication info to NPN. | active |
npn-agdd | USA-NPN gridded accumulated growing degree days and Spring Index products, https://www.usanpn.org/data/maps/AGDD | Current-year AGDD anomaly and 30-year mean where used | CC BY 4.0; same credit text; cite DOI 10.5066/F7SN0723 | active |
noaa-ncei | NOAA National Centers for Environmental Information, GHCN-Daily daily summaries and U.S. Climate Normals 1991–2020, https://www.ncei.noaa.gov/access/services/data/v1 | Daily temperatures for degree-day climatology and current-year accumulation | Public domain. Credit: "NOAA National Centers for Environmental Information, Global Historical Climatology Network–Daily." | active |
osu-phenology | Ohio State University Phenology Calendar (Herms phenological sequence, base 50 °F), https://weather.cfaes.osu.edu/gdd/ ; Herms, D.A. 2004, "Using degree-days and plant phenology to predict pest activity," in *IPM of Midwest Landscapes* | GDD50 first/full bloom thresholds for spring woody species | Cite: "Herms, D.A. (2004) and the Ohio State University Phenology Calendar." Thresholds are facts; no tables reproduced verbatim. | active |
psu-beekeeping-basics | Penn State Extension / MAAREC, *Beekeeping Basics* (AGRS-93), Collison, Frazier, Caron, pp. 82–83, "Primary and secondary floral sources in the Mid-Atlantic region" | Major/minor nectar and pollen ratings | © Penn State. Ratings cited as facts; text not reproduced. Credit: "Nectar and pollen ratings after Penn State Extension / MAAREC, *Beekeeping Basics*." | active |
rutgers-fs1222 | Rutgers NJAES Fact Sheet FS1222, "Blooms for Bees" (2015), https://njaes.rutgers.edu/fs1222/ | Bloom month ranges for Mid-Atlantic plants | © Rutgers. Cited as facts. | active |
vce-beekeepers-year | Virginia Cooperative Extension, "A Beekeeper's Year in a Virginia Apiary," https://carroll.ext.vt.edu/content/dam/carroll_ext_vt_edu/beekeepers_year_va_apiary.pdf | Monthly bloom sequence and task cues | © Virginia Tech. Cited as facts. | active |
cornell-ne-calendar | Cornell CALS Pollinator Network, "Beekeeping Calendar for the Northeast," https://cals.cornell.edu/pollinator-network/beekeeping/beekeeping-calendar-northeast | Task structure, varroa thresholds, and month-by-month bloom lists (Ithaca NY; runs 2–3 weeks behind the Delmarva coastal plain) | © Cornell. Cited; adapted, not copied. | active |
nova-annual-cycle | "The Annual Beekeeping Cycle in Northern Virginia" (R. Morris et al., 2013), https://buzzwordhoney.com/wp-content/uploads/2012/12/Northern-Virginia-Honeybee-Annual-Cycle.pdf | Month-by-month nectar and pollen sources for Northern Virginia (piedmont; close to Delmarva timing) | © authors; cited as facts. | active |
ncsba-central-nc-calendar | North Carolina State Beekeepers Association, "Calendar for Beekeeping in Central North Carolina" (N. Ruppert, rev. Dec 2023), https://www.ncbeekeepers.org/wp-content/uploads/2024/01/CALENDAR-FOR-BEEKEEPING-IN-CENTRAL-NORTH-CAROLINAupdate23.pdf | Sourwood flow timing, early pollen sources, dearth onset (piedmont NC; earlier than Delmarva) | © NCSBA; cited as facts. | active |
xerces-mid-atlantic | Xerces Society, "Pollinator Plants: Mid-Atlantic Region" (2017-049) | Native plant list with honey-bee value notes | © Xerces Society. Cited as facts. | active |
nass-cdl | USDA National Agricultural Statistics Service, Cropland Data Layer via CropScape, https://nassgeodata.gmu.edu/CropScape/ | County crop acreage for crop-row weighting | Public domain. Credit: "USDA NASS Cropland Data Layer." | active |
nass-quickstats | USDA NASS Quick Stats API | Orchard and berry acreage | Public domain. Required notice: "This product uses the NASS API but is not endorsed or certified by NASS." | active |
usda-plants | USDA NRCS PLANTS Database, https://plants.usda.gov | Symbols, native status, county presence | Public domain. Cite: "USDA, NRCS. 2026. The PLANTS Database." | active |
inat-community | iNaturalist community observations with flowering annotations, https://www.inaturalist.org | Weekly flowering histograms for threshold calibration (aggregate only) | Per-observer licenses (default CC BY-NC). Only aggregate counts used. Credit: "Calibration informed by iNaturalist community observations." | active |
honeybeenet | NASA Goddard HoneyBeeNet scale-hive records, https://honeybeenet.gsfc.nasa.gov | Maryland nectar-flow start/peak/end for flow-model calibration | Data-use agreement: acknowledge "NASA HoneyBeeNet and the volunteer beekeepers who contributed scale-hive data." | active |
honeybeenet-ayers-harman | HoneyBeeNet transcription of Ayers & Harman (1992) regional bloom tables | Not yet used | Underlying table © Dadant. Ask the Goddard curator before ingesting. | pending |
pollinator-partnership-ocp | Pollinator Partnership, "Selecting Plants for Pollinators: Outer Coastal Plain Mixed Forest Province" | Cross-check for coastal-plain species | © Pollinator Partnership; reuse permission not stated. Cross-check only until asked. | pending |
pellett-1920 | Pellett, F.C. *American Honey Plants* (1920; 1930 2nd ed.), https://archive.org/details/americanhoneypla00pell | Historical state honey-plant lists | Public domain. | reference |
lovell-1926 | Lovell, J.H. *Honey Plants of North America* (1926), HathiTrust full view | Historical regional lists | Public domain. | reference |
usda-hb335 | USDA Agriculture Handbook 335, *Beekeeping in the United States*, Oertel "Nectar and Pollen Plants" | Regional presence table for expansion beyond MAAREC | Public domain. | reference |
hud-zip-crosswalk | HUD USPS ZIP Code Crosswalk, https://www.huduser.gov/portal/datasets/usps_crosswalk.html , retrieved through the HUD USER API, https://www.huduser.gov/portal/dataset/uspszip-api.html | ZIP to county, apportioned by residential address ratio (primary path when a HUD API token is configured; otherwise the Census relationship file below is used) | HUD PD&R terms; credit "HUD USPS ZIP Code Crosswalk Files." | active |
census-zcta | U.S. Census Bureau ZCTA Gazetteer, https://www2.census.gov/geo/docs/maps-data/data/gazetteer/ , and the 2020 ZCTA-to-county relationship file, https://www2.census.gov/geo/docs/maps-data/data/rel2020/zcta520/ | ZIP centroids (gazetteer); ZIP-to-county assignment (relationship file) when the HUD crosswalk is unavailable | Public domain. Credit: "U.S. Census Bureau, ZIP Code Tabulation Area Gazetteer and 2020 ZCTA-county relationship files." | active |
usgs-physiography | U.S. Geological Survey, Physiographic Divisions of the Conterminous United States (after Fenneman, N.M. and Johnson, D.W., 1946), https://water.usgs.gov/GIS/dsdl/physio_shp.zip | County-to-region assignment: each county takes the physiographic province holding the most of its ZCTA land area (scripts/assign_county_provinces.py). Regions in this project follow physiography, not county lines. | Public domain. Credit: "Physiographic divisions after Fenneman and Johnson (1946), U.S. Geological Survey." | active |
tiger-coastline | U.S. Census Bureau, TIGER/Line Shapefile, 2024, nation, U.S., Coastline National Shapefile, https://www2.census.gov/geo/tiger/TIGER2024/COASTLINE/tl_2024_us_coastline.zip | Distance from every ZIP centroid and every climatology station to open water, for the coastal lag (ADR-001 D5). Only the linework whose NAME is Atlantic is used; the Gulf, Pacific and Great Lakes coastlines are ignored. See scripts/build_open_water.py. | Public domain. Credit: "U.S. Census Bureau, TIGER/Line Coastline Shapefile (2024)." | active |
geonames | GeoNames postal codes | Fallback ZIP lookup | CC BY 4.0; credit "GeoNames.org." | active |
open-meteo | Open-Meteo, https://open-meteo.com | Current-year temperatures and forecast (if used) | CC BY 4.0; credit "Weather data by Open-Meteo.com." Non-commercial use. | active |
nws | National Weather Service API, https://api.weather.gov | 6-day forecast degree days | Public domain. | active |
md-mesonet | Maryland Mesonet, University of Maryland Department of Atmospheric and Oceanic Science with the Maryland Department of Emergency Management, https://mesonet.umd.edu — station 011MD "Princess Anne 2 S", hosted on the UMES Eastern Shore Research, Extension and Teaching Farm, with 012MD (Quantico / LESREC) and 018MD (Salisbury) | **Not in use.** Investigated as a current-year temperature source for MD-lower-shore and as the instrument for measuring the Princess Anne coastal lag station-to-station. Never for the climatology: the oldest of the three stations has reported since June 2024. See docs/MESONET.md. | Terms (data-request form) disclaim warranty and liability and grant nothing: "All rights not expressly granted herein are reserved to the Maryland Mesonet and the Mesonet Parties." Data is stated to be "preliminary or provisional" and subject to removal. No redistribution right and no required credit line are stated, so reuse permission is an open question — ask mdmesonet@umd.edu before any use. | pending |
mybeecalendar-cross-check | mybeecalendar.com calendar for zip 21853, retrieved 2026-09-02 | Cross-check only; never a source of dates | Not a data source; AI-generated. Used only to flag species for reviewer attention. | reference |