compass.utilities.jurisdictions.load_jurisdictions_from_fp

load_jurisdictions_from_fp(jurisdiction_fp)

Load jurisdiction metadata for entries listed in a CSV file

This loader trims whitespace, deduplicates request rows, and filters out jurisdictions not present in the canonical data set.

Parameters:

jurisdiction_fp (path-like) – Path to csv file containing “County” and “State” columns that define the jurisdictions for which info should be loaded.

Returns:

pandas.DataFrame – Jurisdiction information, including FIPS codes and websites, for every matching entry in the lookup table.

Raises:

COMPASSValueError – If the input file is missing required columns (State or Jurisdiction Type when subdivisions are provided).

Notes

Missing jurisdictions trigger warnings with a tabular summary.