Skip to content

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.