Explicit paired specimen tables

A reproducible walkthrough of sewloreSpecimenTables, by Sewlore.

All measurements shown here are invented, synthetic demonstrations. They are not laboratory observations, fabric performance results or academic research. Do not use them to select care instructions or predict a fabric's behavior.

1. Start with identifiable observations

Record a cohort, specimen identifier, cycle number, axis, stage, value and physical unit. Pairing uses cohort, specimen, cycle and axis together. The original unit remains visible after normalization.

2. Pair only the intended before and after measurements

This example treats cycle 2 as incremental: its before value is the measurement before that particular wash. To analyze cumulative change, supply the original baseline explicitly for every cycle. The package never guesses which interpretation you intended.

Delta is after_mm - before_mm. Change percent divides that delta by the explicitly supplied before value. Contraction gives negative change percent and positive shrinkage percent; expansion reverses those signs.

3. Summarize comparable specimens

Cohorts must reflect actual comparability chosen by the operator. A mean across unrelated fabrics or procedures would still be mathematically computable but would lack the intended interpretation. A single complete specimen has no sample standard deviation.

The displayed standard deviation is descriptive variation among these synthetic specimen percentages. It is not instrument uncertainty, a confidence interval or evidence of material performance.

4. Keep incomplete observations visible

The default pairing mode rejects incomplete pairs. Reporting mode retains a status and leaves computed changes missing. Repeated stages are errors even when their values agree; they are never silently averaged.

5. Export with the intended identifiers

write_specimen_pairs(pairs, "my-pairs.csv")

By default, possible spreadsheet formula markers in text cells are prefixed with an apostrophe in the export. Numeric changes keep their signs. This means an affected exported identifier differs from its original; the in-memory object is unchanged. An existing chosen file is overwritten.

Method notes and scope

Use the fabric measurement methods guide when planning measuring-point labels, baselines and recording precision. This package validates structure and arithmetic; it does not establish a standardized testing protocol or substitute for observing a real specimen.

R uses floating-point arithmetic. Preserve full numeric results for analysis, then round displayed values to match the precision of your measurements. Do not add decimal precision that your recording method did not supply.

MIT licensed. Developed with AI assistance; all source, tests and synthetic fixtures are provided. This self-contained HTML page has no tracking, remote images or external fonts.