# Data provenance

Generated 2026-11-20 by `scripts/refresh-facilities.py`.

All facility data on this site comes from **Loudoun County GIS**, published as
public, unauthenticated ArcGIS services. Geometry, area and GIS status retain the county values. Pipeline display names
are joined to exact county application numbers in the LOLA plans layer; the
original GIS name remains in `name`, and the source and check date accompany
each verified `display_name`. The Hyde Park alias identifies CyrusOne Broadlands.
A source match is not independent verification of an operator or active operation.

## Sources

| File | Source layer | Publisher |
|---|---|---|
| `facilities.geojson` (operational, under construction) | [`Existing_Data_Center_Parcel/FeatureServer/1`](https://services1.arcgis.com/MxjRokvPm7bjslyR/arcgis/rest/services/Existing_Data_Center_Parcel/FeatureServer/1) | Loudoun County GIS |
| `facilities.geojson` (proposed) | [`Pipeline_Data_Center_Areas/FeatureServer/1`](https://services1.arcgis.com/MxjRokvPm7bjslyR/arcgis/rest/services/Pipeline_Data_Center_Areas/FeatureServer/1) | Loudoun County GIS |
| `facility-buildings.geojson` | [`Data_Center_Building_Outlines/FeatureServer/0`](https://services1.arcgis.com/MxjRokvPm7bjslyR/arcgis/rest/services/Data_Center_Building_Outlines/FeatureServer/0) | Loudoun County GIS |
| `districts.geojson`, `localities.json` | [`COL/ElectionDistricts/MapServer/8`](https://logis.loudoun.gov/gis/rest/services/COL/ElectionDistricts/MapServer/8) | Loudoun County GIS |

Basemap tiles are © [OpenStreetMap](https://www.openstreetmap.org/copyright)
contributors, used under the Open Database License.

## What we changed

The raw county data is used as-is except for these mechanical transformations:

1. **Parcel polygons reduced to points.** Each parcel's map marker sits at the
   area-weighted centroid of its largest ring. The full polygons are kept in
   `facility-outlines.geojson` for the optional overlay.
2. **Status normalized.** The county's `Built_Status` field is mapped to three
   public statuses. `BUILT` becomes *operational*; anything containing
   `UNDER CONSTRUCTION` becomes *under construction*; every pipeline record
   becomes *proposed*. Note the source contains one typo'd value
   (`BULT/UNDER CONSTRUCTION`), which is why the match is substring-based.
   The original string is preserved in `status_raw`. A `BUILT` label alone
   does not independently prove active operation.
3. **Source-backed display names.** Exact application matches supply project
   names and separate application statuses, with direct county record links.
   Closed applications can remain in the GIS pipeline and are flagged rather
   than silently counted as active proposals in nearby results. Unmatched names
   remain county labels. See `facility-label-audit.json` for gaps.
4. **Text title-cased.** County fields are stored in all caps. Short all-caps
   tokens (LLC, LP, DC, II) are left alone.
5. **Geometry simplified.** Douglas-Peucker at ~4 m tolerance, coordinates
   rounded to 5 decimal places, purely to keep the committed files small.
6. **Districts assigned by point-in-polygon** for pipeline records, which do not
   carry an election-district field. Existing parcels use the county's own
   `ELECTION_DISTRICT` value.

Records whose centroid falls outside the Loudoun County bounding box are dropped.

## Current snapshot

- 224 **GIS layer records**: 103 classified as built,
  36 under construction, and 85 pipeline
- Of the existing-source records, 139 contain tax parcel IDs,
  representing **137 distinct PINs**; 2
  records reuse an existing PIN (0 lack one)
- The 85 pipeline records are mapped application areas, not a count
  of independently verified unique parcels, projects or buildings
- 271 older GIS building outlines; these are not the official building census

## Refreshing

The county updates the parcel layers roughly every six months. To pull the
latest:

```bash
python3 scripts/refresh-facilities.py
```

It only needs Python 3.9+ and network access — no dependencies to install.
Review the diff before committing; a large unexpected change usually means the
county altered a field name rather than that 50 data centers appeared overnight.

## A note on facility ownership

The `operator` field is the property owner recorded in Loudoun County land
records. It is often a holding company rather than the brand operating the
facility, it can be out of date, and it does not establish who is responsible
for any condition a resident reports. Treat it as a pointer for further
research, not as an accusation.
