Mapping methods · reproducibility
Updating a surgical workforce map requires more than replacing an old number with a new one. The data vintage, provider definition, geography and denominator must be preserved so readers can tell change from a change in method.
Why AHRF is useful—and not self-explanatory
The Area Health Resources Files provide current and historical county variables plus state and national data. HRSA describes more than 6,000 variables covering facilities, health professions, resource scarcity, health status, training programs and socioeconomic or environmental context. Geographic codes make linkage possible, but they do not decide which comparison is valid.
A map should therefore begin with a data specification, not a color scale. Name the AHRF release, variable code and label, source year, unit, population denominator, county definition and treatment of missing or suppressed values.
A six-step reproducible update
- Archive the legacy map, legend, notes and source citation without altering the historical artifact.
- Write the old measure as a formal definition: numerator, denominator, provider category, geography and year.
- Select the current AHRF variable only after confirming that those fields are comparable.
- Save the unmodified source file and a field-level extraction log.
- Apply the same geographic crosswalk and rate calculation, documenting every exception.
- Publish the new map as a dated edition with a visible comparability note.
Different bin boundaries, county definitions, denominators or provider categories can move a county between map classes even when the underlying observation did not change.
Comparability tests before a trend claim
Check whether specialty definitions changed, whether a count represents active clinicians or another category, and whether the same source feeds both periods. Confirm that county boundaries or codes align. If the earlier map used fixed thresholds, retain them for the comparison view; if a new distribution-based legend is useful, show it separately.
Do not infer local procedure availability from a workforce count. A county-level provider value does not show hospital privileges, practice location within the county, hours, referral acceptance, anesthesia support or operating-room capacity.
Minimum public methods note
- Source file, release and retrieval date
- Variable code and plain-language definition
- Geography and crosswalk version
- Rate formula and population vintage
- Missing-data and suppression rules
- Legend boundaries and software transformation
- Known breaks from the historical edition
The Surgical Workforce and Care Access hub provides the surrounding evidence framework for reading maps as research tools rather than proof of local service availability.