{
  "name": "HTSlib Alignment Inspection and Metrics Utility Matrix",
  "description": "A comparative technical matrix evaluating sequence alignment inspection and summary tools within the HTSlib samtools software ecosystem, detailing required index structures, computational complexity, stream compatibility, and output metric resolution across genomic analysis pipelines.",
  "page": "https://casrai.org/guides/samtools-idxstats",
  "publisher": "CASRAI",
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "dateModified": "2026-11-19T17:56:59Z",
  "temporalCoverage": "2026",
  "spatialCoverage": "Global",
  "columns": [
    {
      "name": "Tool Utility",
      "unit": "",
      "description": "Command-line tool name in SAMtools ecosystem"
    },
    {
      "name": "Primary Metrics Reported",
      "unit": "",
      "description": "Key statistics and metrics produced"
    },
    {
      "name": "Requires Coordinate Index",
      "unit": "Boolean",
      "description": "True if .bai or .csi index required for operation"
    },
    {
      "name": "Computational Complexity",
      "unit": "",
      "description": "Algorithmic time complexity relative to input records"
    },
    {
      "name": "Output Granularity",
      "unit": "",
      "description": "Scope of reported statistics"
    },
    {
      "name": "Stream Piped Input",
      "unit": "Boolean",
      "description": "True if stdin pipe supported natively without seek"
    }
  ],
  "rows": [
    {
      "Tool Utility": "samtools idxstats",
      "Primary Metrics Reported": "Per-contig mapped and unmapped read-segment counts and reference lengths",
      "Requires Coordinate Index": "1",
      "Computational Complexity": "O(1) index parse",
      "Output Granularity": "Per-chromosome tabular breakdown",
      "Stream Piped Input": ""
    },
    {
      "Tool Utility": "samtools flagstat",
      "Primary Metrics Reported": "Total reads, secondary alignments, supplementary, duplicates, and paired read flags",
      "Requires Coordinate Index": "",
      "Computational Complexity": "O(N) single-pass scan",
      "Output Granularity": "Whole-file library flag summary",
      "Stream Piped Input": "1"
    },
    {
      "Tool Utility": "samtools stats",
      "Primary Metrics Reported": "Exhaustive metrics including insert size distribution, mismatch rates, GC content, and read lengths",
      "Requires Coordinate Index": "",
      "Computational Complexity": "O(N) deep record scan",
      "Output Granularity": "Multi-section detailed report",
      "Stream Piped Input": "1"
    },
    {
      "Tool Utility": "samtools coverage",
      "Primary Metrics Reported": "Per-chromosome coverage percentage, mean depth, base quality, and mapping quality",
      "Requires Coordinate Index": "1",
      "Computational Complexity": "O(N) indexed scan",
      "Output Granularity": "Per-chromosome tabular metrics",
      "Stream Piped Input": ""
    },
    {
      "Tool Utility": "samtools depth",
      "Primary Metrics Reported": "Single-base position depth across specified genomic coordinates",
      "Requires Coordinate Index": "1",
      "Computational Complexity": "O(N) coordinate stream",
      "Output Granularity": "Per-base coordinate positions",
      "Stream Piped Input": "1"
    },
    {
      "Tool Utility": "samtools bedcov",
      "Primary Metrics Reported": "Total read count and base count overlapping specified BED intervals",
      "Requires Coordinate Index": "1",
      "Computational Complexity": "O(N) regional index lookup",
      "Output Granularity": "Per-interval summary counts",
      "Stream Piped Input": ""
    }
  ],
  "sources": [
    {
      "title": "HTSlib: samtools-idxstats(1) manual page",
      "url": "http://www.htslib.org/doc/samtools-idxstats.html",
      "accessed": "2026-11-19"
    },
    {
      "title": "HTSlib: samtools(1) manual page",
      "url": "http://www.htslib.org/doc/samtools.html",
      "accessed": "2026-11-19"
    },
    {
      "title": "HTSlib: samtools-index(1) manual page",
      "url": "http://www.htslib.org/doc/samtools-index.html",
      "accessed": "2026-11-19"
    }
  ]
}