detect_trap_items

Compares responses on designated trap (attention-check) items with
their expected values and flags respondents failing at least
<code>max_failed</code> traps. Trap definitions are typically maintained in
an external, versioned key file.

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. 

detect_trap_items function

<dl><dt>x</dt>
<dd>A <code>dcc_data</code> object or data.frame.</dd>
<dt>traps</dt>
<dd>Named list or named vector: names are trap item columns,
values the expected response.</dd>
<dt>max_failed</dt>
<dd>Number of failed traps that triggers a finding
(default 1).</dd>
<dt>id_var</dt>
<dd>Name of the record-id column, or <code>NULL</code> for row
numbers.</dd>
<dt>severity</dt>
<dd>Severity assigned to findings (default <code>"fail"</code>).</dd>
<dt>na_fails</dt>
<dd>Should a missing response on a trap item count as a
failure? (default <code>TRUE</code>).</dd></dl>

Arguments

Detect failed trap (attention-check) items — detect_trap_items

<dl>

<dt>x</dt>
<dd>A <code>dcc_data</code> object or data.frame.</dd>


<dt>traps</dt>
<dd>Named list or named vector: names are trap item columns,
values the expected response.</dd>


<dt>max_failed</dt>
<dd>Number of failed traps that triggers a finding
(default 1).</dd>


<dt>id_var</dt>
<dd>Name of the record-id column, or <code>NULL</code> for row
numbers.</dd>


<dt>severity</dt>
<dd>Severity assigned to findings (default <code>"fail"</code>).</dd>


<dt>na_fails</dt>
<dd>Should a missing response on a trap item count as a
failure? (default <code>TRUE</code>).</dd>

</dl>

detect_trap_items: Detect failed trap (attention-check) items

Description

Usage

Value

Arguments

Examples