The time-aware counterpart to audit_coverage(). A join can succeed and
still be wrong about history: South Sudan with 1995 data, Czechoslovakia with
2001 data, the USSR with 2010 data. Those rows survive every check the package
had, because the country resolves and the year is a number.
Arguments
- data
A panel with
iso3candyear.- quiet
Suppress the console summary and return the table silently. (Unlike
audit_coverage(), which returns a printable object and emits nothing until you print it, this one reports as it goes – a clean panel is the common case and worth confirming out loud.)
Value
A tibble of the offending rows: iso3c, country, year, issue
("before_existence" or "after_dissolution") and existed (a
human-readable span). Zero rows means the panel is clean.
What it can and cannot see
Dissolution dates come from historical_codes, which covers the entities the package curates (USSR, Yugoslavia, Czechoslovakia and the rest). Independence dates come from the same table read in reverse: a successor state is treated as not existing before its predecessor dissolved. Countries with no entry in the crosswalk – most of the world – are assumed to have existed throughout, so a clean result means "nothing the crosswalk knows about is wrong", not "every date is right".
Examples
panel <- data.frame(
iso3c = c("SSD", "CZE", "FRA"),
year = c(1995L, 2001L, 2001L),
gdp = c(1, 2, 3)
)
audit_time_coverage(panel)
#> ! 1 row falls outside the country's existence.
#> ℹ Inspect the returned table; `dissolve_country()` resolves historical entities
#> to successors.
#> # A tibble: 1 × 5
#> iso3c country year issue existed
#> <chr> <chr> <int> <chr> <chr>
#> 1 SSD South Sudan 1995 before_existence from 2011