©2025, 2026 Gregory S Muhs, All Rights Reserved
Release 4-01 - 28 July 2026 (Build Date) - A new release that incorporates a full pipeline "Easy Button" and refines minor bugs (such as early termination). The new "MARS" metric is now included in this new release.
Release 3.18 - 26 December 2025 - Fixed a bug in Part 4A, which caused inflated similarities
The name Sequora comes from a Cherokee name meaning sparrow, and Matthew 10:29-31 which reads: Are not two sparrows sold for a penny? And not one of them will fall to the ground apart from your Father. But even the hairs of your head are all numbered. Fear not, therefore; you are of more value than many sparrows. (ESV Translation)
Version 4.04 Validation Beta 1 — Traditional Tree-Overlay Phylogenomics Web
The legacy placeholder is inserted only for matrix completion and is recorded in the report. It is never treated as a measured biological distance.
The reciprocal-direction, similarity-network nearest-extension, and exact-zero controls affect Parts 6–7 presentation and matrix construction; they do not rerun the underlying Part 3 alignments.
All ten recommended Desktop/Web metrics are selected by default. MARS Distance is listed first. Version 4.04 restores the traditional Sequora phylogenomics web: the Neighbor-Joining tree is drawn inside a circular all-measured-pairwise web, and pairwise line colors match the numerical matrix. The Complementary Similarity Network remains a separate force-directed summary.
Live workload accounting for the Easy Button analysis.
Each manual part uses the same stage service as the Easy Button.
Use the Query and Reference FASTA files selected on the Easy Button tab.
No completed project yet.
Sequora Small Genomes Pipeline · Version 4 Guide
This guide starts with the basic idea behind each stage, then keeps the exact formulas and implementation details available for readers who need them.
What happens when you press the Easy Button?
Upload the same multi-record FASTA collection as both Query and Reference when comparing every genome in the collection against the others.
Use different Query and Reference collections when the research question calls for unequal or directional comparisons.
The main screen reports stage status, planned pairs, k-mer-passed pairs, filtered pairs, completed alignments, warnings, failures, and elapsed time.
The preferred outputs are one interactive HTML report, one combined PDF report, and one project ZIP containing the scientific and technical files.
The Easy Button and the independent-part controls call the same stage functions. This avoids maintaining a second scientific implementation for the automatic workflow.
The current Version 4.02 beta runs in the browser and does not require genome sequences to be sent to a Sequora server. Users should still follow their institution’s rules for handling sensitive or restricted data.
Parts 1–2 prepare the sequence files
Query FASTA files, Reference FASTA files, chunk sizes, circular-genome settings, and whether Reference reverse complements should be included.
Checks the FASTA records, gives duplicate headers distinct labels, divides Query genomes into small pieces, and builds larger searchable Reference records.
Local alignment of whole genomes all at once is expensive. Smaller Query pieces make the search practical while preserving the original genome and chunk identity.
Processed FASTA files, Query-chunk counts, genome lengths, record manifests, duplicate-header records, and a Parts 1–2 manifest.
Part 3 screens and aligns sequence pairs
Every possible Query-chunk × Reference-record comparison before any filtering occurs.
Pairs with enough matching short sequence words to be sent to the more expensive alignment calculation.
Pairs that did not meet the selected k-mer threshold and therefore were not aligned.
Passing pairs successfully processed by affine-gap Smith–Waterman and written to the Part 3 table.
For each completed alignment, Sequora records the local-alignment score, aligned length, identity with and without gaps, gap count, and the Query and Reference labels.
The Version 4 engine has been regression-tested against the validated Desktop Part 3 implementation for alignment results and k-mer filter decisions on the tested fixtures.
Part 4A keeps the strongest chunk-level result
The complete Part 3 alignment-results table.
Sequora groups rows by individual Query Label and original Reference genome, finds the highest score, and keeps every row tied for that score.
The number of processed Reference records tied for the winning score. Ties may result from overlapping or circular Reference constructions.
A smaller Part 4A table containing the winning chunk-level evidence and its associated alignment measurements.
Reference labels are cleaned back to their original genome identity before grouping, while the full Query chunk label is retained. Every row tied at the maximum score is preserved so later stages can trace exactly which processed Reference records contributed.
Part 4B counts how much of the Query produced a qualifying match
The number of chunks created from the Query genome in Parts 1–2.
The number of distinct Query chunks that produced qualifying winning evidence against that Reference genome.
Total Query Chunks minus Aligned. These chunks did not produce qualifying evidence for that genome pair under the selected settings.
The Part 4A measurements plus total, aligned, unique, and unique-frequency fields.
Version 4 validates that Aligned is a non-negative integer, that a Query chunk count exists, and that Aligned cannot exceed Total Query Chunks. Invalid accounting stops the stage rather than producing a misleading value.
Part 5 summarizes the comparison at the genome level
Sequora averages the selected chunk-level measurements for each directional Query-genome → Reference-genome pair.
Aligned and Unique frequencies help distinguish a strong match across much of a genome from a strong match involving only a small part.
MARS combines cumulative alignment evidence from both directions and normalizes it using the original genome lengths.
Directional genome-pair averages, distance fields, Combined Metrics, cumulative scores, reciprocal checks, MARS, and MARS Distance where available.
Many legacy distance columns use the form (1 − observed value ÷ largest observed value in that run) × 100. Because this normalization depends on the current collection, the same genome pair can receive a somewhat different normalized legacy distance when analyzed within a different group of genomes.
Version 4 places MARS Distance before Combined Metric 1 in metric discovery and reports.
These formulas describe how the current code transforms the measured alignment results. They do not convert sequence difference into elapsed time or identify a historical ancestor.
Parts 6–7 organize the measured distances
Sequora turns directional genome-pair values into a symmetric distance table suitable for tree and network methods.
Version 4.02 provides rooted, unrooted, and circular Neighbor-Joining trees; full and nearest-K phylogenomics webs; a separate Complementary Similarity Network; heatmaps; numerical matrices; leaf legends; Newick; SVG; and tree-fit diagnostics for each selected metric.
The preferred output is one interactive HTML report and one combined PDF report rather than forcing users to open many separate metric files.
Separate matrices, trees, diagrams, and underlying files remain available inside the project ZIP.
When a distance is missing
A missing pair has no usable measured directional distance under the settings and outputs available for that metric.
The current placeholder equals 110% of the largest measured distance for that metric.
No placeholder is inserted. Sequora reports the pair and stops visualizations that require a complete matrix.
Every substitution is written to Missing_Distance_Substitutions.csv and counted in the report.
The placeholder is computed independently for each metric as 1.10 × the largest real, finite symmetric distance observed for that metric. When no positive measured value exists, the present implementation uses a fallback value of 1.
What most users should download
A self-contained report for moving between selected metrics and viewing trees, networks, heatmaps, matrices, parameters, and warnings.
A single printable visual report containing the selected Part 6–7 metric sections. Browser Print → Save as PDF remains a fallback.
The processed stage FASTA and CSV files, manifests, placeholder records, Newick/SVG outputs, reports, validation information, and run metadata. Keep the original uploaded FASTA files for complete end-to-end reproduction.
Advanced users can still run and download individual stages without using the Easy Button.
What Sequora can—and cannot—tell us