Produce a human-readable breakdown of a reconciliation object:
how many names matched exactly, how many were rescued by
normalisation, synonymy, or fuzzy matching, and which names remain
unresolved. Usually the second function you call after
reconcile_tree() or reconcile_data().
Arguments
- reconciliation
A reconciliation object returned by
reconcile_tree(),reconcile_data(), or a related matcher.- detail
A length-1 character vector. How much to show:
"full"(default)Every match category, with the names belonging to each category listed out.
"brief"Counts only — a one-screen overview.
"mismatches_only"Non-exact matches and unresolved names. Useful once the easy cases are out of the way and you want to focus on what still needs review.
- format
A length-1 character vector. Where the summary goes:
"console"(default)Pretty-printed to the screen.
"data.frame"Returns a list of tibbles silently; useful when writing a report or table in a larger script.
- file
A length-1 character vector or
NULL. If non-NULL, writes the console report to this file path in addition to printing it.- ...
Additional arguments (currently unused).
Value
A reconciliation_summary object. The formatted report
is attached to the object and rendered by
print.reconciliation_summary(). R's REPL auto-printing means
that calling the function at the prompt without assignment shows
the full report; assigning the result to a variable shows
nothing until you print(x) (or auto-print x). Use
invisible(reconcile_summary(rec)) to suppress display at the
prompt entirely.
See also
reconcile_plot() for a visual summary;
reconcile_report() for a shareable HTML audit trail;
reconcile_mapping() for the full per-name tibble.
Other reconciliation functions:
reconcile_apply(),
reconcile_augment(),
reconcile_crosswalk(),
reconcile_data(),
reconcile_diff(),
reconcile_export(),
reconcile_mapping(),
reconcile_merge(),
reconcile_multi(),
reconcile_override(),
reconcile_override_batch(),
reconcile_plot(),
reconcile_report(),
reconcile_review(),
reconcile_splits_lumps(),
reconcile_suggest(),
reconcile_to_trees(),
reconcile_tree(),
reconcile_trees()
Examples
data(avonet_subset)
data(tree_jetz)
rec <- reconcile_tree(avonet_subset, tree_jetz,
x_species = "Species1", authority = NULL)
#> ℹ Reconciling 919 data names vs 657 tree tips
#> ℹ Matching 919 x 657 names through 2 stages...
#> ℹ Stage 1/2: Exact matching...
#> ℹ Stage 2/2: Normalised matching (0 matched so far)...
#> ✔ Matched 657/919 data names to tree tips
reconcile_summary(rec, detail = "brief")
#>
#> === Reconciliation Report ===
#> Type: data_tree
#> Timestamp: 2026-06-16 10:09:57
#> Package: prepR4pcm 0.4.0.9000
#> Authority: NONE (version: latest)
#> Rank: species
#>
#> --- Match Summary ---
#> Exact: 0 / 919
#> Normalized: 657 / 919
#> Synonym: 0 / 919
#> Fuzzy: 0 / 919
#> Manual: 0 / 919
#> Unresolved: 262 (x only) + 0 (y only)
#>
reconcile_summary(rec, detail = "mismatches_only")
#>
#> === Reconciliation Report ===
#> Type: data_tree
#> Timestamp: 2026-06-16 10:09:57
#> Package: prepR4pcm 0.4.0.9000
#> Authority: NONE (version: latest)
#> Rank: species
#>
#> --- Match Summary ---
#> Exact: 0 / 919
#> Normalized: 657 / 919
#> Synonym: 0 / 919
#> Fuzzy: 0 / 919
#> Manual: 0 / 919
#> Unresolved: 262 (x only) + 0 (y only)
#>
#> --- Normalized Matches (657) ---
#> "Acanthiza apicalis" -> "Acanthiza_apicalis" ['Acanthiza apicalis' normalised to 'Acanthiza apicalis']
#> "Acanthiza chrysorrhoa" -> "Acanthiza_chrysorrhoa" ['Acanthiza chrysorrhoa' normalised to 'Acanthiza chrysorrhoa']
#> "Acanthiza ewingii" -> "Acanthiza_ewingii" ['Acanthiza ewingii' normalised to 'Acanthiza ewingii']
#> "Acanthiza inornata" -> "Acanthiza_inornata" ['Acanthiza inornata' normalised to 'Acanthiza inornata']
#> "Acanthiza iredalei" -> "Acanthiza_iredalei" ['Acanthiza iredalei' normalised to 'Acanthiza iredalei']
#> "Acanthiza katherina" -> "Acanthiza_katherina" ['Acanthiza katherina' normalised to 'Acanthiza katherina']
#> "Acanthiza lineata" -> "Acanthiza_lineata" ['Acanthiza lineata' normalised to 'Acanthiza lineata']
#> "Acanthiza murina" -> "Acanthiza_murina" ['Acanthiza murina' normalised to 'Acanthiza murina']
#> "Acanthiza nana" -> "Acanthiza_nana" ['Acanthiza nana' normalised to 'Acanthiza nana']
#> "Acanthiza pusilla" -> "Acanthiza_pusilla" ['Acanthiza pusilla' normalised to 'Acanthiza pusilla']
#> "Acanthiza reguloides" -> "Acanthiza_reguloides" ['Acanthiza reguloides' normalised to 'Acanthiza reguloides']
#> "Acanthiza robustirostris" -> "Acanthiza_robustirostris" ['Acanthiza robustirostris' normalised to 'Acanthiza robustirostris']
#> "Acanthiza uropygialis" -> "Acanthiza_uropygialis" ['Acanthiza uropygialis' normalised to 'Acanthiza uropygialis']
#> "Acanthornis magna" -> "Acanthornis_magna" ['Acanthornis magna' normalised to 'Acanthornis magna']
#> "Aphelocephala leucopsis" -> "Aphelocephala_leucopsis" ['Aphelocephala leucopsis' normalised to 'Aphelocephala leucopsis']
#> "Aphelocephala nigricincta" -> "Aphelocephala_nigricincta" ['Aphelocephala nigricincta' normalised to 'Aphelocephala nigricincta']
#> "Aphelocephala pectoralis" -> "Aphelocephala_pectoralis" ['Aphelocephala pectoralis' normalised to 'Aphelocephala pectoralis']
#> "Calamanthus campestris" -> "Calamanthus_campestris" ['Calamanthus campestris' normalised to 'Calamanthus campestris']
#> "Calamanthus fuliginosus" -> "Calamanthus_fuliginosus" ['Calamanthus fuliginosus' normalised to 'Calamanthus fuliginosus']
#> "Crateroscelis murina" -> "Crateroscelis_murina" ['Crateroscelis murina' normalised to 'Crateroscelis murina']
#> ... and 637 more
#>
#> --- Unresolved: In x But Not In y (262) ---
#> Acanthiza cinerea
#> Calamanthus cautus
#> Calamanthus montanellus
#> Calamanthus pyrrhopygius
#> Gerygone citrina
#> Pyrrholaemus sagittatus
#> Artamus leucoryn
#> Cracticus argenteus
#> Melloria quoyi
#> Ceblepyris caesius
#> Ceblepyris cinereus
#> Ceblepyris cucullatus
#> Ceblepyris graueri
#> Ceblepyris pectoralis
#> Celebesica abbotti
#> Coracina dobsoni
#> Coracina panayensis
#> Coracina welchmani
#> Cyanograucalus azureus
#> Edolisoma anale
#> Edolisoma ceramense
#> Edolisoma coerulescens
#> Edolisoma dispar
#> Edolisoma dohertyi
#> Edolisoma grayi
#> Edolisoma holopolium
#> Edolisoma incertum
#> Edolisoma insperatum
#> Edolisoma melas
#> Edolisoma meyerii
#> ... and 232 more
#>