Export an ENA Reproducibility Bundle
Use the shared synthetic design-talk dataset to practise packaging enough data, metadata, decisions, code, and outputs for another analyst to audit and rerun the model, document the decision, test a defensible alternative, and keep every interpretation tied to source evidence.
经审核的教程正文目前以英文提供。
方法来源
完整教程
Export an ENA Reproducibility Bundle addresses packaging enough data, metadata, decisions, code, and outputs for another analyst to audit and rerun the model. This decision belongs in the evidence model, not in a late formatting pass. It affects which coded observations can contribute to a network, what the plotted coordinates represent, and how confidently a comparison can be interpreted. The lesson extends the same eight-team synthetic design-talk case used throughout the Academy so that only the target decision changes while the broader learning context remains stable.
You will work from the source CSV, codebook, and blank decision record. The synthetic file is intentionally small and balanced; it supports transparent inspection but no real-world inference. Your goal is to leave an audit trail that another analyst can rerun: the primary choice, its theoretical rationale, one prespecified sensitivity check, the resulting network evidence, and the claim boundary.
教学案例
Export an ENA Reproducibility Bundle in the design-talk case
Eight fictional teacher-design teams discuss goals, student evidence, strategies, tradeoffs, and revisions. Four are labeled baseline and four scaffolded, with six ordered utterances per team. The recurring question is whether the two conditions organize these ideas differently. For this lesson, the analytic focus is packaging enough data, metadata, decisions, code, and outputs for another analyst to audit and rerun the model; the tiny balanced file makes every contributing row inspectable while preventing invented population claims.
练习数据集
步骤 1
Restate the relational estimand
Write one sentence naming the unit network, the comparison, and the contextual relation represented by a connection. Then explain how packaging enough data, metadata, decisions, code, and outputs for another analyst to audit and rerun the model can change that estimand. Keep the distinction between raw observation, coded evidence, accumulated connection, normalized vector, projected coordinate, and substantive claim visible. If the target choice cannot be linked to the question, pause before opening a model.
检查点The decision record names one unit, one bounded context, one comparison, and the exact relation a weighted edge represents.步骤 2
Freeze the shared baseline specification
Record the dataset filename and hash; team_id as unit; conversation_id as conversation; line_number as order; condition as metadata; the five binary code columns; the current window, weighting, normalization, and rotation; exclusions; and software version. This frozen baseline prevents an apparent change from being attributed to packaging enough data, metadata, decisions, code, and outputs for another analyst to audit and rerun the model when another setting changed at the same time.
检查点A second analyst can recreate the baseline model without relying on interface memory or undocumented defaults.步骤 3
Implement the primary decision
Apply this prespecified procedure: export de-identified source-ready data, codebook, decision record, software lockfile, executable script, settings, edge tables, unit coordinates, diagnostics, exclusions, and a manifest with hashes. Save the configuration before inspecting the preferred group pattern. Export unit coordinates, accumulated and normalized edge tables, group summaries, and diagnostics rather than keeping only a screenshot. Mark any manual judgment with a date and rationale so later review can distinguish planned configuration from reactive adjustment.
检查点The primary run has a dated configuration, machine-readable outputs, and a rationale written before substantive interpretation.步骤 4
Inspect units before group averages
Review all eight unit networks, their coded-row exposure, connection magnitudes, and positions. Identify all-zero, sparse, or influential cases and verify that every unit belongs to the intended condition. A mean network can look coherent even when only one team supplies an edge, so record unit coverage for the strongest visible relations and inspect whether within-group heterogeneity contradicts a simple group story.
检查点Every interpreted group edge has a unit-coverage count, and no case was silently dropped because its pattern was inconvenient.步骤 5
Run the planned sensitivity check
Without changing unrelated settings, rerun the bundle in a clean directory or environment and compare intermediate tables and model outputs within documented tolerances. Save the primary and alternative outputs side by side and compare connection ranks, unit coordinates, group means, diagnostics, and the wording of the conclusion. Sensitivity analysis is not a search for the most separated plot; report stable, weakened, reversed, and ambiguous patterns with equal visibility.
检查点The record states exactly what changed, what stayed fixed, and whether the main interpretation survives the alternative.步骤 6
Return from edges to evidence
Close the interpretive loop: include stable source-row identifiers and an access-controlled route to qualitative evidence so public reproducibility does not compromise participant confidentiality. Read enough surrounding rows to recover the conversational context and examine counterexamples, not only quotations that fit the network. Preserve team, conversation, and row identifiers in the audit output. If the edge interpretation conflicts with the excerpts, revise the interpretation or investigate the coding and window rather than trusting the graph.
检查点The interpretation cites traceable rows from multiple units and records at least one contradictory or boundary case.步骤 7
Write the decision and claim boundary
Write three layers in order: the observed source evidence, the modeled pattern under the primary specification, and the explanation the synthetic design cannot establish. Include the sensitivity outcome and this boundary: A bundle is not reproducible if it depends on hidden clicks, mutable URLs, undocumented manual edits, private fonts, or unavailable source fields. Openness must still respect consent and privacy. End with the exact files needed to reproduce the lesson and a note that the exercise demonstrates workflow logic rather than a finding about real teachers or scaffolds.
检查点The final paragraph separates observation, model output, interpretation, uncertainty, and non-causal limitation in explicit language.