Research Workflow

Publish a Results Table That Can Be Reused Without Guessing

Define one result per row

A machine-readable results file should identify the analysis, outcome, population, time point, contrast and effect measure for each estimate. A formatted cell such as 1.25 (0.90–1.73) is convenient for reading but difficult to validate or reuse without parsing. Store estimate, lower bound and upper bound in separate fields.

The W3C tabular-data model describes tables and associated metadata. Use that principle to pair a simple data file with a dictionary defining field types, units, allowed values and missing-value conventions.

Preserve meaning alongside numbers

Include the confidence level, interval method, analyzed sample size and model identifier where relevant. State whether estimates are adjusted, transformed or standardized. Separate a numeric estimate from its display string so rounding for the manuscript does not remove reusable precision.

Use explicit labels for missing, not applicable and not estimable results. Do not place zero in a numeric field merely to avoid an empty cell. If a field can legitimately be absent, document the condition and preserve a reason field.

Design a hypothetical row

Suppose an analysis estimates a risk ratio of 1.25 with 95% interval [0.90, 1.73] at 30 days. A reusable row contains effect_measure = risk_ratio, estimate = 1.25, lower = 0.90, upper = 1.73, confidence_level = 95, time_days = 30 and a comparator definition.

Without the comparator, the same values could be interpreted in reverse. Without the effect measure, a reader cannot know whether one or zero is the null. Without the time horizon, a risk ratio may be mistakenly compared with a result measured at another follow-up.

Validate before release

Check unique result identifiers, endpoint ordering, numeric types and consistency with the published display. Confirm that values from different models have not been joined using an incomplete key. A model-and-outcome key may still need population and time to be unique.

Review disclosure and permissions before sharing data. An aggregate results file can still contain sensitive small-cell information, so use the project’s approved release rules. Provide a version and source-analysis identifier. The final artifact should let another researcher reconstruct the reported table and understand each estimate without inferring hidden units, denominators or contrast directions from a PDF layout.

Source verification: 6 November 2026. Examples are hypothetical.

Related reading

Reading path: Write and report. Guide 19 of 27. Choose any guide to suit your project.

Research Workflow

Build Research Table Headers That Retain Their Meaning When Read Linearly

Use explicit row and column relationships instead of relying on visual position, merged cells, or color.

Manuscript Writing

Review Table Shells Before Filling Them with Results

Resolve populations, denominators, units, time points, and footnotes before generating research tables.

Browse this reading pathTools for this stageGuides and downloads for this stage