Conversion preservation measurements
cases.yaml declares inputs, explicit profiles/reference contexts and
expected outcomes. report.json is generated by
just conversion-report and must reproduce under just conversion-check in CI.
For reconstructed tabular outputs it records which column spellings changed and how
many records changed; GenBank measures normalized feature blocks. Both measurements
are separate from preservation of interpreted fields.
See the profile contract and worked commands.
| Case | Adapter outcome | Source recovery | Mapped-field reconstruction |
|---|---|---|---|
| RefSeq actinorhodin excerpt, 44 rows | Supported | Exact excerpt bytes | Same gene/CDS relationships, genomic coordinates and attributes |
| NMDC Pfam, 416 hits / 397 proteins | Supported with explicit CDS/protein context | Exact bytes | Same protein offsets, reference bindings and attributes; contextual CDSs are not emitted |
| NMDC Prodigal, six rows | Supported | Exact bytes | Same fields; escape/numeric spelling may normalize |
| NMDC CRT, four rows | Supported | Exact bytes | Same fields and parent links; escape spelling may normalize |
| RefSeq lambda GFF3, 308 rows | Supported | Exact bytes | Same fields/relationships; escape spelling may normalize |
| BLAT BED12, 19 rows / 23 blocks | Supported | Exact bytes | Same coordinates, ordered blocks and optional fields |
| RefSeq phiX174 GFF3 | Unsupported by linear adapter | Not attempted here | Circular-reference semantics rejected |
| RefSeq phage MS2 GFF3, RNA genome | Supported | Exact bytes | Same fields/relationships; escape spelling may normalize |
| RefSeq phage PRD1 GFF3 | Supported | Exact bytes | Same fields/relationships; escape spelling may normalize |
| RefSeq phage Qbeta GFF3, RNA genome | Supported | Exact bytes | Same fields/relationships; the readthrough CDS's transl_except is kept as an attribute |
| RefSeq Carjivirus communis GFF3, circular | Unsupported by linear adapter | Not attempted here | Circular-reference semantics rejected |
| RefSeq cauliflower mosaic virus GFF3, circular | Unsupported by linear adapter | Not attempted here | Circular-reference semantics rejected |
| RefSeq Cellulophaga phage phi17:2 GFF3, circular | Unsupported by linear adapter | Not attempted here | Circular-reference semantics rejected |
| RefSeq mimivirus GFF3 | Unsupported | Not attempted here | Spliced CDSs, one ID on several rows, rejected as duplicate feature IDs |
| RefSeq phage PSA GFF3 | Unsupported | Not attempted here | Ribosomal-slippage CDSs, one ID on two rows, rejected as duplicate feature IDs |
| RefSeq lambda GTF | No conversion adapter | Existing source-reader replay is separate | Not attempted |
| INSDC plant records, 38 features | Supported by bounded location profile | Exact bytes | Same joined/partial locations and repeated qualifiers |
| INSDC phiX174, 32 features | Supported by bounded location profile | Exact bytes | Same circular topology and six origin-crossing joins |
| Constructed repeated-ID GFF3 / empty BED | Unsupported controls | Not attempted | Rejected, as declared |
The GenBank source-text inspection finds six accession-versioned records, 38 feature
location lines, six containing join, seven with partial endpoints, and two repeated
qualifier keys within features. Those are observations of this file, not the results
of a full INSDC format validator. The executable location profile
now interprets them, with an independent Biopython comparison of original and
reconstructed sequence, feature locations and qualifiers. The format's expressive
power remains broader than this adapter.
Both exporters refuse edited instances. No lossy export is implemented, so rejected
cases have diagnostics and no converted output, rather than a fabricated lossless
result. The report records zero losses only for the operations actually performed;
not-attempted is not success. Nonfeature records are preserved by the source layer;
the separate reconstruction claim covers mapped feature fields and relationships.
Neither byte recovery nor a successful query establishes full biological equivalence.
Dependency versions and profile-file checksums are recorded in the report. Source versions, attribution, licenses and checksums live in the corpus index. Query timing is deliberately not part of this preservation report.
The protein-relative example retains the structural GFF and FASTA used to generate its context. The report records that context's SHA-256 as a conversion input; tests regenerate it from both companion sources. Its amino-acid coordinates remain separate from genomic CDS coordinates.