dcc_data

A <code>dcc_data</code> object bundles the dataset with its metadata, the
level-0 read report, and an append-only provenance chain. Every DCC
stage (detect, execute, report) receives and returns this container;
stages append to the provenance chain and never rewrite it (raw data is
immutable; cleaning produces new versions).

Rule-driven, auditable cleaning of survey and assessment
response data, implementing the WeianData Detect-Execute-Report
workflow. Provides a multi-format, multi-encoding input layer
(CSV, 'Excel', 'SPSS', 'Stata', 'SAS', Parquet, JSON), the
dcc_data container with a provenance chain, level-0 structural
diagnostics, five built-in response-quality detectors (missing
items, straight-lining, response time, trap items, score
anomalies), a declarative YAML rule engine, an execution engine
with a cell-level audit log, answer-key scoring, multi-form to
master item bank mapping, a normalized report model rendered as bilingual
staff workbooks and HTML, complete statistical bundles, and versioned
machine JSON/JSONL with findings-to-changes reconciliation,
cell-level lineage tracing, and
manifest-based one-command reproduction. Includes a protected bilingual
strict project workbook and matching JSON contract with cell-addressed
validation, non-mutating preflight, preview-first execution, and localized
staff guidance. All formally supported input backends install with the
package; PDF is optional rather than a fixed report output.

Kunxiang Ma

Data Cleaning Center for Survey and Assessment Data

WEIAN DATA TECH (Beijing) Co., Ltd. 

dcc_data function

<dl><dt>data</dt>
<dd>A <code>data.frame</code> or <code>data.table</code>.</dd>
<dt>meta</dt>
<dd>Named list of source metadata (see <code>dcc_read</code>).</dd>
<dt>read_report</dt>
<dd>A <code>dcc_read_report</code> object, or <code>NULL</code>.</dd>
<dt>provenance</dt>
<dd>List of provenance records; normally created
internally.</dd>
<dt>dictionary</dt>
<dd>Canonical variable dictionary with unique <code>name</code>
values.</dd>
<dt>missing_states</dt>
<dd>Cell-level missing-state table using DCC's declared
missing-state vocabulary.</dd>
<dt>import_spec</dt>
<dd>The <code>dcc_import_spec</code> that produced the canonical
data, or <code>NULL</code> for data created directly in R.</dd></dl>

Arguments

The dcc_data container — dcc_data

<dl>

<dt>data</dt>
<dd>A <code>data.frame</code> or <code>data.table</code>.</dd>


<dt>meta</dt>
<dd>Named list of source metadata (see <code>dcc_read</code>).</dd>


<dt>read_report</dt>
<dd>A <code>dcc_read_report</code> object, or <code>NULL</code>.</dd>


<dt>provenance</dt>
<dd>List of provenance records; normally created
internally.</dd>


<dt>dictionary</dt>
<dd>Canonical variable dictionary with unique <code>name</code>
values.</dd>


<dt>missing_states</dt>
<dd>Cell-level missing-state table using DCC's declared
missing-state vocabulary.</dd>


<dt>import_spec</dt>
<dd>The <code>dcc_import_spec</code> that produced the canonical
data, or <code>NULL</code> for data created directly in R.</dd>

</dl>

dcc_data: The dcc_data container

Description

Usage

Value

Arguments

Examples