
Normalize extracted ConQuest overlap tables to the mfrmr review contract
Source: R/api-export-bundles.R
normalize_conquest_overlap_tables.RdNormalize extracted ConQuest overlap tables to the mfrmr review contract
Usage
normalize_conquest_overlap_tables(
conquest_population,
conquest_item_estimates,
conquest_case_eap,
conquest_population_term = "auto",
conquest_population_estimate = "auto",
conquest_item_id = "auto",
conquest_item_estimate = "auto",
conquest_case_person = "auto",
conquest_case_estimate = "auto",
keep_extra_columns = TRUE
)Arguments
- conquest_population
Extracted ConQuest population-parameter table as a data.frame.
- conquest_item_estimates
Extracted ConQuest item-estimate table as a data.frame.
- conquest_case_eap
Extracted ConQuest case-level EAP table as a data.frame.
- conquest_population_term
Column in
conquest_populationthat stores parameter names."auto"tries conservative aliases such asParameterandTerm.- conquest_population_estimate
Column in
conquest_populationthat stores parameter estimates."auto"tries aliases such asEstimateandEst.- conquest_item_id
Column in
conquest_item_estimatesthat stores the item identifier as exported or extracted by the user."auto"tries aliases such asResponseVar,ItemID,Item, andLabel.- conquest_item_estimate
Column in
conquest_item_estimatesthat stores item estimates."auto"triesEstimateandEst. Other columns must be specified explicitly and converted to difficulty logits before review.- conquest_case_person
Column in
conquest_case_eapthat stores person IDs."auto"tries conservative aliases such asPerson,PID, andSequence ID.- conquest_case_estimate
Column in
conquest_case_eapthat stores case EAP estimates."auto"tries conservative aliases such asEstimate,EAP_1, andEAP.- keep_extra_columns
If
TRUE, keep all remaining columns after the standardized identifier and estimate columns.
Details
This helper does not parse raw ConQuest text output. It standardizes already
extracted tables to the contract used by review_conquest_overlap():
population parameters become columns
Parameter,Estimate, andEstimateNonNumeric;item estimates become columns
ItemID,Estimate, andEstimateNonNumeric;case summaries become columns
Person,Estimate, andEstimateNonNumeric.
The resulting object is intentionally conservative. It does not infer
whether item IDs correspond to exported response variables or original item
levels; that matching step remains part of review_conquest_overlap(), where
the standardized ConQuest tables are compared against a concrete overlap
bundle.
Output
The returned object has class mfrm_conquest_overlap_tables and includes:
summary: one-row normalization summaryconquest_population: standardized population tableconquest_item_estimates: standardized item tableconquest_case_eap: standardized case tablesettings: source-column metadatanotes: interpretation notes
Read summary(normalized)$normalization_scope before review to confirm
that the object contains extracted tabular inputs, not parsed raw ConQuest
report text, and to check duplicate-ID / non-numeric-estimate pre-review
flags.
Examples
normalized <- normalize_conquest_overlap_tables(
conquest_population = data.frame(
Term = c("(Intercept)", "GroupB", "sigma2"),
Est = c(0, 0.2, 1)
),
conquest_item_estimates = data.frame(
Item = c("I1", "I2"),
Est = c(-0.2, 0.2)
),
conquest_case_eap = data.frame(
PID = c("P001", "P002"),
EAP = c(-0.1, 0.1)
),
conquest_population_term = "Term",
conquest_population_estimate = "Est",
conquest_item_id = "Item",
conquest_item_estimate = "Est",
conquest_case_person = "PID",
conquest_case_estimate = "EAP"
)
summary(normalized)$normalization_scope
#> Area Status
#> 1 Extracted table normalization active
#> 2 Raw ConQuest text parsing not performed
#> 3 Bundle matching deferred to review
#> 4 Pre-review table check none detected
#> 5 Generated estimation metadata unknown
#> Evidence
#> 1 7 standardized row(s)
#> 2 estimates are extracted from CSV/TSV/TXT or data.frame inputs
#> 3 review_conquest_overlap() matches rows against the exported bundle
#> 4 0 duplicate ID(s); 0 non-numeric estimate cell(s)
#> 5 optional report_file in normalize_conquest_overlap_exports()
#> Interpretation
#> 1 Population, item, and case tables have been converted to the mfrmr review contract.
#> 2 No general report parser is used; optional generated estimation metadata are described separately below.
#> 3 Identifier matching and numerical comparison are intentionally handled by the review step.
#> 4 Resolve duplicate IDs or non-numeric estimates before treating the review as clean.
#> 5 Stopping/model metadata are separate from estimate extraction; they do not establish numerical precision or common input data.