1. 1. Quick Start guides
    1. 1.1. Constructing bedMethyl tables
    2. 1.2. Make hemi-methylation bedMethyl tables
    3. 1.3. Updating and adjusting MM tags
    4. 1.4. Inspecting base modification probabilities
    5. 1.5. Summarizing a modBAM
    6. 1.6. Calculating modification statistics in regions
    7. 1.7. Calling mods in a modBAM
    8. 1.8. Removing modification calls at the ends of reads
    9. 1.9. Repair MM/ML tags on trimmed reads
    10. 1.10. Working with sequence motifs
      1. 1.10.1. Making a motif BED file
      2. 1.10.2. Find highly modified motif sequences
      3. 1.10.3. Evaluate and refine a table of known motifs
      4. 1.10.4. Structured logging schema
    11. 1.11. Extracting read information to a table
    12. 1.12. Investigating patterns with localise
    13. 1.13. Perform differential methylation scoring
    14. 1.14. Validate ground truth results
    15. 1.15. Calculating methylation entropy
    16. 1.16. Narrow output to specific positions
    17. 1.17. Manipulate bedMethyl files
    18. 1.18. Check modified base tags
  2. 2. Extended subcommand help
  3. 3. Troubleshooting
  4. 4. Frequently asked questions
  5. 5. Current limitations
  6. 6. Performance considerations
  7. 7. Algorithm details
    1. 7.1. Pass/fail base modification calls
      1. 7.1.1. Threshold examples
      2. 7.1.2. Numeric details
    2. 7.2. DMR model and scoring details
    3. 7.3. Ignoring and combining calls

Modkit

Basic Usage

modkit is a bioinformatics tool for working with modified bases from Oxford Nanopore.

ONT_logo

Installation

Pre-compiled binaries are provided for Linux from the release page. We recommend the use of these in most circumstances. As a rust-based project, modkit can also be installed with cargo.

git clone https://github.com/nanoporetech/modkit.git
cd modkit
cargo install --path .
# or
cargo install --git https://github.com/nanoporetech/modkit.git

Common Use Cases

  1. Creating a bedMethyl table with pileup
  2. Updating and Adjusting MM tags with adjust-mods and update-tags
  3. Summarizing a modBAM with summary
  4. Making a motif BED file with motif-bed
  5. Extracting per-read base modification data into a table
  6. Convert modification probabilities into hard calls
  7. Removing base modification calls at the ends of reads
  8. Narrow analysis to only specific positions with a BED file
  9. Repairing/adding MM/ML tags to reads with clipped sequences
  10. Creating hemi-methylation pattern bedMethyl tables with pileup-hemi
  11. Performing differential methylation scoring with dmr
  12. Checking modified base tags in a modBAM
  13. Convert bedMethyl files to bigWig for visualization

Notes and troubleshooting

  1. General troubleshooting
  2. Threshold evaluation examples (for advanced users)
  3. Querying the logs in motif search