[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EECT7T1WJ9E2C6090RQW5P":3,"skill-same:01M7EECT7T1WJ9E2C6090RQW5P":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":14,"repositoryHtmlUrl":33,"repositoryHomepageUrl":33,"ownerHtmlUrl":34,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":35,"install":36,"resources":49},"01M7EECT7T1WJ9E2C6090RQW5P","bio-methylation-calling",null,"Extracts per-cytosine methylation calls from aligned bisulfite\u002FEM-seq reads with bismark_methylation_extractor (Bismark BAM) or the aligner-agnostic MethylDackel\u002FBISCUIT (bwa-meth BAM), producing the beta value M\u002F(M+U) as a coverage file, bedGraph, or genome-wide cytosine report across CpG\u002FCHG\u002FCHH context. Covers conversion-rate QC as the first gate, the 5mC vs 5hmC summed caveat, variant-aware calling so a C\u002FT SNP does not masquerade as unmethylation, paired-end --no_overlap double-counting, symmetric CpG dyad collapse, and the 0-based vs 1-based coordinate trap. Use when extracting methylation levels from a bisulfite\u002FEM-seq alignment, choosing an extractor for a non-Bismark BAM, QC-ing conversion efficiency, or producing coverage\u002Fcytosine-report input for testing. For long-read MM\u002FML modification calling see long-read-sequencing\u002Fnanopore-methylation; for the upstream BAM see bismark-alignment; for per-CpG statistics see differential-cpg-testing.","Mr-Nobody-Anonymous\u002FAll-skills","Mr-Nobody-Anonymous","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F184253119?v=4","01M7AEXFJHKTYQW5R0ZCQQTWFV","anonymous","01M7C00M3GQR4QKP9GZA42GFAK",0,"MIT","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-methylation-calling\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: bio-methylation-calling\ndescription: Extracts per-cytosine methylation calls from aligned bisulfite\u002FEM-seq reads with bismark_methylation_extractor (Bismark BAM) or the aligner-agnostic MethylDackel\u002FBISCUIT (bwa-meth BAM), producing the beta value M\u002F(M+U) as a coverage file, bedGraph, or genome-wide cytosine report across CpG\u002FCHG\u002FCHH context. Covers conversion-rate QC as the first gate, the 5mC vs 5hmC summed caveat, variant-aware calling so a C\u002FT SNP does not masquerade as unmethylation, paired-end --no_overlap double-counting, symmetric CpG dyad collapse, and the 0-based vs 1-based coordinate trap. Use when extracting methylation levels from a bisulfite\u002FEM-seq alignment, choosing an extractor for a non-Bismark BAM, QC-ing conversion efficiency, or producing coverage\u002Fcytosine-report input for testing. For long-read MM\u002FML modification calling see long-read-sequencing\u002Fnanopore-methylation; for the upstream BAM see bismark-alignment; for per-CpG statistics see differential-cpg-testing.\ntool_type: cli\nprimary_tool: Bismark\nsource: \"https:\u002F\u002Fgithub.com\u002FGPTomics\u002FbioSkills\"\nsource_repository: \"GPTomics\u002FbioSkills\"\nsource_path: \"methylation-analysis\u002Fmethylation-calling\u002FSKILL.md\"\nlicense: \"MIT\"\nimported_at: \"2026-09-20\"\n---\n\n## Version Compatibility\n\nReference examples tested with: Bismark 0.24+, MethylDackel 0.6+, samtools 1.19+.\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- CLI: `\u003Ctool> --version` then `\u003Ctool> --help` to confirm flags\n- Python: `pip show \u003Cpackage>` then `help(module.function)` to check signatures\n\nIf code throws ImportError, AttributeError, or TypeError, introspect the installed\npackage and adapt the example to match the actual API rather than retrying.\n\nThe extractor must match the aligner: bismark_methylation_extractor reads Bismark's own XM call string and CANNOT process a bwa-meth BAM (no XM tag); MethylDackel and BISCUIT recompute the call from BAM + reference and are aligner-agnostic. The genome FASTA build (hg38 vs T2T-CHM13) defines every coordinate downstream, and BISCUIT\u002FBis-SNP need a SNP-aware reference workflow. Always run `\u003Ctool> --help` on the installed build before quoting a default; MethylDackel `--maxVariantFrac` and EM-seq end-trim recommendations have no universal value.\n\n# Methylation Calling\n\n**\"Get methylation levels from my bisulfite BAM\"** -> Count converted-vs-unconverted bases at each reference cytosine and divide - because a methylation level is a per-cytosine COUNT RATIO, not a measurement, and every number is hostage to conversion completeness, SNPs, overlap, and the 5mC\u002F5hmC conflation.\n- CLI (Bismark BAM): `bismark_methylation_extractor -p --comprehensive --bedGraph --cytosine_report --genome_folder genome\u002F sample_pe.bam`\n- CLI (bwa-meth BAM): `MethylDackel extract --mergeContext ref.fa sample.bam`\n\nScope: per-cytosine M\u002FU counting from a short-read bisulfite\u002FEM-seq\u002FTAPS alignment, the conversion\u002FM-bias\u002Fvariant QC gates, and the coverage\u002Fcytosine-report handoff. Native long-read MM\u002FML modification calling -> long-read-sequencing\u002Fnanopore-methylation. The aligned BAM -> bismark-alignment. Per-CpG statistics on the counts -> differential-cpg-testing. Region calling -> dmr-detection. Array (EPIC\u002F450K) beta-from-intensity is a different readout entirely and is not this skill.\n\n## The Single Most Important Modern Insight -- A Methylation Level Is a Count Ratio, Not a Measurement\n\nThe extractor does not measure methylation. Bisulfite\u002FEM-seq turns an epigenetic state into a sequence state (an unmethylated C converts to T; a methylated C stays C), and the extractor tallies, at each reference cytosine, M reads that show C and U reads that show T, then reports `beta = M \u002F (M + U)`. Every beta is therefore hostage to four upstream choices the extractor cannot fix:\n\n1. **Whether conversion was complete.** An unconverted unmethylated C is byte-for-byte identical to a methylated C, so incomplete conversion inflates EVERY beta and is invisible per-site. It must be measured globally before any beta is trusted (CHH rate or a lambda spike-in).\n2. **Whether a C\u002FT SNP is hiding as unmethylation.** The reference says C, the sample carries a T allele, the read shows T, and the extractor scores \"converted\" = unmethylated. Polymorphic CpGs are silently miscalled and can fabricate SNP-driven DMRs.\n3. **Whether the paired-end overlap was double-counted.** A cytosine in the R1\u002FR2 overlap is one molecule observed twice; counting both votes inflates coverage and biases beta when the mates disagree.\n4. **Whether \"5mC\" is actually 5mC+5hmC.** 5hmC is also protected from conversion, so a standard WGBS\u002FEM-seq beta is the SUM 5mC+5hmC. In brain\u002FESC\u002Fliver this is a real misattribution that no extractor flag can undo.\n\nOrganize the analysis around defending these four (conversion QC -> overlap -> M-bias -> variant-awareness -> what context\u002Fchemistry am I even calling), not around listing flags. And one deeper caveat: beta is itself a lossy average - collapsing reads to a `.cov` matrix discards the read-level epiallele, the strand (hemimethylation), and the allele (ASM); see the last sections.\n\n## Tool Taxonomy\n\n| Tool | Citation | Mechanism \u002F role | When |\n|------|----------|------------------|------|\n| bismark_methylation_extractor | Krueger & Andrews 2011 *Bioinformatics* 27:1571 | reads Bismark's own XM call string; ecosystem standard | input is a Bismark BAM; want the genome-wide cytosine report \u002F methylKit `.cov`; plant `--CX` |\n| MethylDackel | github.com\u002Fdpryan79\u002FMethylDackel (no journal) | recomputes calls from BAM + reference; fast; aligner-agnostic | bwa-meth BAM; want built-in M-bias `--OT\u002F--OB` bounds and `--maxVariantFrac` SNP guard |\n| BISCUIT | github.com\u002Fhuishenlab\u002Fbiscuit (no journal) | aligner + JOINT methylation\u002FSNP\u002FASM caller; VCF + epiBED | human population \u002F allele-specific work needing SNP-aware betas |\n| Bis-SNP | Liu 2012 *Genome Biol* 13:R61 | Bayesian joint genotype + methylation | the original SNP-aware caller; mask C\u002FT SNPs from betas |\n| methylpy | github.com\u002Fyupenghe\u002Fmethylpy (no journal) | allc format + binomial methylated-flag | the allc \u002F ALLCools ecosystem; built-in per-site significance |\n| asTair | bitbucket.org\u002Fbsblabludwig\u002Fastair (no journal) | polarity-aware caller (mCtoT \u002F CtoT) | TAPS data (inverted polarity); explicit per-context stats |\n\nEM-seq extraction arithmetic is identical to bisulfite (unmodified C reads as T either way) - the same Bismark\u002FMethylDackel command works. TAPS INVERTS the polarity (modified C->T), so a bisulfite extractor reports 1-beta; use ASTAIR `--mod_mapping mCtoT`.\n\n## Decision Tree by Scenario\n\n| Scenario | Recommended | Why |\n|----------|-------------|-----|\n| Bismark-aligned BAM, mammalian CpG | `bismark_methylation_extractor -p --comprehensive --cytosine_report` | reads the XM tag; cytosine report is the bsseq\u002FmethylKit input |\n| bwa-meth-aligned WGBS\u002FEM-seq | `MethylDackel extract --mergeContext` | bismark extractor cannot read a bwa-meth BAM (no XM tag) |\n| Human population \u002F polymorphic CpGs \u002F ASM | BISCUIT (or Bis-SNP) | joint SNP+methylation; C\u002FT SNP recognized as a variant, not unmethylation |\n| Plant methylome (CHG\u002FCHH real) | `--CX` (Bismark) \u002F `--CHG --CHH` (MethylDackel) + lambda spike-in | non-CpG is biology; CHH-as-conversion-proxy fails |\n| TAPS data | ASTAIR `--mod_mapping mCtoT` | polarity inverted; a bisulfite extractor reports 1-beta |\n| Need 5hmC resolved from 5mC | second chemistry (oxBS\u002FTAB\u002FACE) -> route, not a flag | WGBS\u002FEM-seq sums them; the extractor cannot split |\n| Read-level heterogeneity \u002F clonality \u002F cfDNA | keep reads (epiread\u002FepiBED), do NOT collapse to `.cov` | the epiallele dies in the per-CpG average |\n| Long-read modBAM with MM\u002FML tags | -> long-read-sequencing\u002Fnanopore-methylation | native modification tags, not conversion counting |\n\n## Conversion-Rate QC -- the First Gate\n\n**Goal:** Reject a methylome whose betas are inflated by incomplete conversion before computing anything.\n\n**Approach:** Measure non-conversion globally, two ways. In mammals, genome-wide CHH methylation is near-zero biology, so the observed CHH rate IS the non-conversion rate (~2% CHH implies ~98% conversion). Where non-CpG methylation is real (plants, ESCs, neurons - Schultz 2015), spike in unmethylated lambda phage DNA and align to it: all its cytosines are unmethylated, so its observed \"methylation\" is the non-conversion rate. Require conversion >=99% (community convention; Shirane 2013 is a representative source). Extract CHH at least once even for a CpG-only mammalian study, purely for this number.\n\n```bash\n# Bismark: extract all contexts, then read the CHH methylation rate from the splitting report\nbismark_methylation_extractor -p --comprehensive --CX --genome_folder genome\u002F sample_pe.bam\n# The *_splitting_report.txt prints C methylated in CHH context %; (100 - that) ~ conversion efficiency in mammals.\n\n# Lambda spike-in (the gold standard, mandatory in plants\u002FESC\u002Fneurons):\n# align to the lambda genome, extract, and treat its global methylation as the non-conversion rate.\nbismark --genome lambda_genome\u002F -1 R1.fq.gz -2 R2.fq.gz -o lambda_qc\u002F\n```\n\nMethylDackel `--minConversionEfficiency` can additionally drop individual reads whose own conversion (from non-CpG Cs) is too low - a per-read complement to the global gate, not a replacement for it.\n\n## Extract from a Bismark BAM\n\n```bash\nbismark_methylation_extractor \\\n    -p \\                                # paired-end (--no_overlap is ON BY DEFAULT for -p)\n    --comprehensive \\                   # merge OT\u002FOB\u002FCTOT\u002FCTOB into one file per context\n    --bedGraph --cytosine_report \\      # coverage\u002FbedGraph + genome-wide every-C report\n    --genome_folder genome\u002F \\           # MANDATORY for --cytosine_report (scans the FASTA for all Cs)\n    --ignore_r2 2 \\                     # trim R2 5' end-repair artifact (set from M-bias; near-universal for EM-seq\u002FPBAT)\n    --parallel 4 --gzip \\\n    -o methylation\u002F sample_pe.bam\n# Outputs: sample_pe.bismark.cov.gz (1-BASED), sample_pe.bedGraph.gz (0-BASED), sample_pe.CpG_report.txt.gz (1-BASED).\n```\n\nCollapse the symmetric CpG dyad with `coverage2cytosine --merge_CpG` (NOT `--merge_non_CpG`, which merges the CHG+CHH files). `--merge_CpG` adds the + strand C at position p and the - strand C at p+1 into one dyad entry, doubling effective coverage; it is CpG-only and incompatible with `--CX`.\n\n## Extract from a bwa-meth BAM (MethylDackel)\n\n```bash\nMethylDackel mbias ref.fa sample.bam mbias_prefix   # inspect the SVGs; it SUGGESTS --OT\u002F--OB bounds (do NOT accept blindly)\nMethylDackel extract \\\n    --mergeContext \\                   # collapse the symmetric CpG dyad (the MethylDackel equivalent of --merge_CpG)\n    --maxVariantFrac 0.25 \\            # exclude a C if the opposite-strand non-G fraction exceeds this (cheap SNP guard)\n    --OT 3,0,0,98 --OB 3,0,0,98 \\     # inclusion bounds from mbias: first\u002Flast bp to keep on read1,read2\n    ref.fa sample.bam\n# Output sample_CpG.bedGraph is 0-BASED, half-open: chr start end round(%meth) count_M count_U. CpG ONLY by default;\n# add --CHG --CHH for plants. Default --minDepth 1, -q (MAPQ) 10, -p (Phred) 5.\n```\n\n## Coverage, Precision, and the Handoff -- Pass Counts, Not Betas\n\nA beta is a binomial proportion: at coverage n its granularity is 1\u002Fn and its SE is ~sqrt(beta(1-beta)\u002Fn). At n=1 beta is only 0 or 1; at n=4 it lands on {0,.25,.5,.75,1}. A 1\u002F2 site and a 50\u002F100 site both read beta=0.5 but carry wildly different evidence. The extractors impose no biological floor (MethylDackel `--minDepth` and Bismark `.cov` both default to >=1). Do NOT pre-threshold to a single beta and t-test it - that discards the coverage information. Hand the COUNT data (M and total) forward; the downstream DMR callers (DSS\u002FmethylKit\u002Fbsseq) model the beta-binomial and USE n. A common per-CpG floor is >=10x AFTER symmetric merge, but it is a tradeoff (site count vs precision), not a magic constant.\n\n## 5mC vs 5hmC and the Oxidation Cascade -- a Chemistry Decision, Not a Flag\n\nStandard bisulfite AND standard EM-seq protect BOTH 5mC and 5hmC from conversion, so the \"methylated\" bin is 5mC+5hmC, never 5mC alone. Worse, bisulfite DEAMINATES the downstream TET-oxidation products 5fC and 5caC, so they read as T and land in the \"unmethylated\" bin - both bins are biochemically impure at TET-active loci (ESC, early embryo, neurons, some tumors). The full cascade is 5mC -> 5hmC -> 5fC -> 5caC. Resolving any derivative requires a SECOND wet-lab chemistry, not an extractor flag: 5hmC via oxBS-seq (Booth 2012; 5hmC = BS - oxBS by subtraction), TAB-seq (Yu 2012; direct 5hmC), or ACE-seq (Schutsky 2018; enzymatic, low-input); the bisulfite-free TAPS (Liu 2019) sidesteps the harsh chemistry but inverts polarity. Never let a plain WGBS\u002FEM-seq beta be labeled \"5mC\" or its complement \"unmodified C.\"\n\n## Read-Level Heterogeneity -- the Epiallele Dies in the Average\n\nbeta=0.5 is consistent with three opposite biologies that beta cannot distinguish: a 50\u002F50 mixture of fully-methylated and fully-unmethylated cells, every cell ~50% methylated with CpGs scattered differently per molecule (stochastic disorder), or a true uniform intermediate. The discriminator lives in the JOINT CpG pattern on a single read - intramolecular co-methylation - which the per-CpG average integrates out. Read-level metrics (PDR, Landau 2014; epipolymorphism, Landan 2012; methylation entropy; MHL for cfDNA tissue-of-origin, Guo 2017; FDRP\u002FqFDRP) measure clonal\u002Fepigenetic instability and power liquid-biopsy deconvolution, and they require a READ-PRESERVING format (BISCUIT epiread\u002FepiBED or the raw BAM) plus tools like Metheor or methclone - none of which are extractors. The moment the pipeline collapses to a `.cov` beta matrix, the epiallele is gone. If the question is heterogeneity, clonality, or cfDNA deconvolution, do NOT collapse to beta; this deeper analysis may warrant its own workflow, but at minimum the calling stage must flag that beta discards it.\n\n## Hemimethylation and Allele-Specific Methylation -- two more things the average hides\n\n**Hemimethylation (the strand axis).** `--merge_CpG` \u002F `--mergeContext` is not a neutral coverage optimization: it bakes in the assumption that the two strands of a dyad agree and silently zeroes the hemimethylation channel (one strand methylated, the other not). Hemimethylation is real biology - the obligate post-replication maintenance intermediate, and a stable heritable mark at CTCF\u002Fcohesin sites required for chromatin looping (Xu & Corces 2018). Default destranding ON for bulk symmetric-CpG DMR work; turn it OFF (strand-specific extraction) and budget high per-strand coverage the moment strand asymmetry is the question. Per-molecule dyad state needs hairpin-bisulfite (Laird 2004).\n\n**Allele-specific methylation (the allele axis).** The same C\u002FT SNP that corrupts a beta (insight #2) becomes the measurement axis once reads are phased: assign each read's methylation to the SNP allele it carries and compare beta per allele (BISCUIT `epiread -B snps.bed` then `biscuit asm`; or Bis-SNP). The headline trap: a stable ~50% beta at a KNOWN imprinted control region (H19\u002FIGF2, KCNQ1OT1, SNRPN, GNAS, MEG3) is NOT intermediate methylation and NOT a conversion artifact - it is two superimposed monoallelic states (one allele ~100%, one ~0%) averaged into a deceptive midpoint, a signature to PHASE, not a value to model. Sequence-dependent ASM is the mQTL bridge to causal-genomics\u002Fmendelian-randomization; produce the allele-phased betas here, do the colocalization there.\n\n## Per-Method Failure Modes\n\n### No conversion-rate gate\n**Trigger:** reporting betas without checking CHH rate or a lambda spike-in. **Mechanism:** an unconverted unmethylated C is identical to a methylated C; non-conversion inflates every beta. **Symptom:** uniformly elevated methylation, fabricated low-methylation regions. **Fix:** require >=99% conversion (CHH-proxy in mammals; lambda spike-in in plants\u002FESC\u002Fneurons).\n\n### bismark extractor on a bwa-meth BAM\n**Trigger:** `bismark_methylation_extractor` on a non-Bismark BAM. **Mechanism:** it reads Bismark's XM tag, absent from bwa-meth output. **Symptom:** error or empty\u002Fgarbage calls. **Fix:** use MethylDackel or BISCUIT, which recompute from BAM + reference.\n\n### C\u002FT SNP read as unmethylation\n**Trigger:** extracting human population data with no variant-awareness. **Mechanism:** a T allele at a reference C is scored as converted. **Symptom:** spurious hypomethylation at polymorphic CpGs; SNP-driven false DMRs. **Fix:** BISCUIT\u002FBis-SNP joint calling, or MethylDackel `--maxVariantFrac`, or mask dbSNP\u002Fsample-VCF CpGs.\n\n### Paired-end overlap double-counted\n**Trigger:** single-end mode on paired data, or a non-default tool. **Mechanism:** the R1\u002FR2 overlap counts one molecule twice. **Symptom:** inflated coverage, biased beta on mate disagreement. **Fix:** `-p` (Bismark `--no_overlap` is on by default for paired-end); MethylDackel handles overlap automatically.\n\n### M-bias not trimmed\n**Trigger:** extracting without inspecting the M-bias plot. **Mechanism:** end-repair fill-in introduces unmethylated Cs at fragment ends; the per-position methylation deviates near read ends. **Symptom:** a non-flat M-bias curve; biased calls in the trimmable region. **Fix:** trim with `--ignore`\u002F`--ignore_r2` (Bismark) or `--OT\u002F--OB` bounds (MethylDackel). The diagnostic is FLATNESS\u002Fpositional stability, not any particular global level.\n\n### Coordinate base mismatch on a join\n**Trigger:** joining a MethylDackel bedGraph (0-based) to a Bismark `.cov` (1-based). **Mechanism:** the two formats index differently. **Symptom:** every site shifts by one; strands silently mismatch. **Fix:** pick one format end-to-end or convert explicitly; the cytosine report and allc are 1-based, both bedGraphs are 0-based.\n\n### --merge_non_CpG mistaken for dyad collapse\n**Trigger:** using `--merge_non_CpG` to merge the symmetric CpG strands. **Mechanism:** `--merge_non_CpG` merges the CHG+CHH output files, NOT the CpG dyad. **Symptom:** strand-specific CpG report unchanged; CpG coverage not doubled. **Fix:** symmetric CpG collapse is `coverage2cytosine --merge_CpG` \u002F MethylDackel `--mergeContext`.\n\n## Quantitative Thresholds\n\n| Threshold | Source | Rationale |\n|-----------|--------|-----------|\n| Conversion efficiency >=99% | Shirane 2013 *PLoS Genet* 9:e1003439; community | below it, residual unconverted Cs inflate every beta |\n| CHH rate ~= (1 - conversion) in mammals | Schultz 2015 *Nature* 523:212 | true mammalian CHH is near-zero, so it reads out non-conversion |\n| Per-CpG coverage >=10x (after merge) | community | granularity 1\u002Fn; SE of an intermediate beta ~0.16 at 10x |\n| `--ignore_r2` ~2 for EM-seq\u002FPBAT | M-bias plot | R2 5' end-repair fill-in adds unmethylated Cs; set from the plot |\n| MethylDackel `-q` 10 \u002F `-p` 5 | MethylDackel defaults | MAPQ\u002Fbase-quality minima; defaults, confirm with `--help` |\n| `--maxVariantFrac` no universal value | MethylDackel docs | set per-experiment against known-SNP density |\n| `--merge_CpG` doubles dyad coverage | Bismark docs | + and - strand of a symmetric CpG are co-methylated; merge then threshold |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| Empty\u002Fgarbage calls from bismark extractor | bwa-meth BAM (no XM tag) | use MethylDackel\u002FBISCUIT |\n| Uniformly high methylation | incomplete conversion | check CHH rate \u002F lambda; require >=99% |\n| Spurious hypomethylation at SNPs | C\u002FT SNP read as conversion | `--maxVariantFrac`; BISCUIT\u002FBis-SNP; mask dbSNP |\n| Inflated coverage on overlaps | single-end mode on paired data | `-p`; MethylDackel handles it automatically |\n| Sites shifted by one after a join | 0-based vs 1-based format mix | reconcile coordinate base; one format end-to-end |\n| Plant CHH\u002FCHG methylome missing | CpG-only default | `--CX` (Bismark) \u002F `--CHG --CHH` (MethylDackel) |\n| `coverage2cytosine: option --merge_CpG` ignored | used `--merge_non_CpG` instead, or paired with `--CX` | `--merge_CpG` is CpG-only, incompatible with `--CX` |\n| Inverted (1-beta) methylome | bisulfite extractor on TAPS data | ASTAIR `--mod_mapping mCtoT` |\n\n## References\n\n- Krueger F, Andrews SR. 2011. Bismark: a flexible aligner and methylation caller for Bisulfite-Seq applications. *Bioinformatics* 27:1571-1572.\n- Liu Y, Siegmund KD, Laird PW, Berman BP. 2012. Bis-SNP: combined DNA methylation and SNP calling for Bisulfite-seq data. *Genome Biol* 13:R61.\n- Vaisvila R, Ponnaluri VKC, Sun Z, et al. 2021. Enzymatic methyl sequencing detects DNA methylation at single-base resolution from picograms of DNA. *Genome Res* 31:1280-1289.\n- Booth MJ, Branco MR, Ficz G, et al. 2012. Quantitative sequencing of 5-methylcytosine and 5-hydroxymethylcytosine at single-base resolution. *Science* 336:934-937.\n- Yu M, Hon GC, Szulwach KE, et al. 2012. Base-resolution analysis of 5-hydroxymethylcytosine in the mammalian genome. *Cell* 149:1368-1380.\n- Schutsky EK, DeNizio JE, Hu P, et al. 2018. Nondestructive, base-resolution sequencing of 5-hydroxymethylcytosine using a DNA deaminase. *Nat Biotechnol* 36:1083-1090.\n- Liu Y, Siejka-Zielinska P, Velikova G, et al. 2019. Bisulfite-free direct detection of 5-methylcytosine and 5-hydroxymethylcytosine at base resolution. *Nat Biotechnol* 37:424-429.\n- Schultz MD, He Y, Whitaker JW, et al. 2015. Human body epigenome maps reveal noncanonical DNA methylation variation. *Nature* 523:212-216.\n- Shirane K, Toh H, Kobayashi H, et al. 2013. Mouse oocyte methylomes at base resolution reveal genome-wide accumulation of non-CpG methylation and role of DNA methyltransferases. *PLoS Genet* 9:e1003439.\n- Landau DA, Clement K, Ziller MJ, et al. 2014. Locally disordered methylation forms the basis of intratumor methylome variation in chronic lymphocytic leukemia. *Cancer Cell* 26:813-825.\n- Landan G, Cohen NM, Mukamel Z, et al. 2012. Epigenetic polymorphism and the stochastic formation of differentially methylated regions in normal and cancerous tissues. *Nat Genet* 44:1207-1214.\n- Guo S, Diep D, Plongthongkum N, et al. 2017. Identification of methylation haplotype blocks aids in deconvolution of heterogeneous tissue samples and tumor tissue-of-origin mapping from plasma DNA. *Nat Genet* 49:635-642.\n- Xu C, Corces VG. 2018. Nascent DNA methylome mapping reveals inheritance of hemimethylation at CTCF\u002Fcohesin sites. *Science* 359:1166-1170.\n- Laird CD, Pleasant ND, Clark AD, et al. 2004. Hairpin-bisulfite PCR: assessing epigenetic methylation patterns on complementary strands of individual DNA molecules. *PNAS* 101:204-209.\n- MethylDackel. github.com\u002Fdpryan79\u002FMethylDackel (no associated journal publication).\n- BISCUIT. github.com\u002Fhuishenlab\u002Fbiscuit (no associated journal publication).\n\n## Related Skills\n\n- bismark-alignment - Produces the aligned BAM consumed here\n- differential-cpg-testing - Per-CpG statistical testing on the counts\n- dmr-detection - Region-level methods downstream\n- methylkit-analysis - methylKit import of the coverage\u002Fcytosine report\n- long-read-sequencing\u002Fnanopore-methylation - Native long-read MM\u002FML modification calling (the wall)\n- causal-genomics\u002Fmendelian-randomization - mQTL \u002F causal follow-up of allele-specific methylation\n- workflows\u002Fmethylation-pipeline - End-to-end bisulfite pipeline\n","## Version Compatibility\n\nReference examples tested with: Bismark 0.24+, MethylDackel 0.6+, samtools 1.19+.\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- CLI: `\u003Ctool> --version` then `\u003Ctool> --help` to confirm flags\n- Python: `pip show \u003Cpackage>` then `help(module.function)` to check signatures\n\nIf code throws ImportError, AttributeError, or TypeError, introspect the installed\npackage and adapt the example to match the actual API rather than retrying.\n\nThe extractor must match the aligner: bismark_methylation_extractor reads Bismark's own XM call string and CANNOT process a bwa-meth BAM (no XM tag); MethylDackel and BISCUIT recompute the call from BAM + reference and are aligner-agnostic. The genome FASTA build (hg38 vs T2T-CHM13) defines every coordinate downstream, and BISCUIT\u002FBis-SNP need a SNP-aware reference workflow. Always run `\u003Ctool> --help` on the installed build before quoting a default; MethylDackel `--maxVariantFrac` and EM-seq end-trim recommendations have no universal value.\n\n# Methylation Calling\n\n**\"Get methylation levels from my bisulfite BAM\"** -> Count converted-vs-unconverted bases at each reference cytosine and divide - because a methylation level is a per-cytosine COUNT RATIO, not a measurement, and every number is hostage to conversion completeness, SNPs, overlap, and the 5mC\u002F5hmC conflation.\n- CLI (Bismark BAM): `bismark_methylation_extractor -p --comprehensive --bedGraph --cytosine_report --genome_folder genome\u002F sample_pe.bam`\n- CLI (bwa-meth BAM): `MethylDackel extract --mergeContext ref.fa sample.bam`\n\nScope: per-cytosine M\u002FU counting from a short-read bisulfite\u002FEM-seq\u002FTAPS alignment, the conversion\u002FM-bias\u002Fvariant QC gates, and the coverage\u002Fcytosine-report handoff. Native long-read MM\u002FML modification calling -> long-read-sequencing\u002Fnanopore-methylation. The aligned BAM -> bismark-alignment. Per-CpG statistics on the counts -> differential-cpg-testing. Region calling -> dmr-detection. Array (EPIC\u002F450K) beta-from-intensity is a different readout entirely and is not this skill.\n\n## The Single Most Important Modern Insight -- A Methylation Level Is a Count Ratio, Not a Measurement\n\nThe extractor does not measure methylation. Bisulfite\u002FEM-seq turns an epigenetic state into a sequence state (an unmethylated C converts to T; a methylated C stays C), and the extractor tallies, at each reference cytosine, M reads that show C and U reads that show T, then reports `beta = M \u002F (M + U)`. Every beta is therefore hostage to four upstream choices the extractor cannot fix:\n\n1. **Whether conversion was complete.** An unconverted unmethylated C is byte-for-byte identical to a methylated C, so incomplete conversion inflates EVERY beta and is invisible per-site. It must be measured globally before any beta is trusted (CHH rate or a lambda spike-in).\n2. **Whether a C\u002FT SNP is hiding as unmethylation.** The reference says C, the sample carries a T allele, the read shows T, and the extractor scores \"converted\" = unmethylated. Polymorphic CpGs are silently miscalled and can fabricate SNP-driven DMRs.\n3. **Whether the paired-end overlap was double-counted.** A cytosine in the R1\u002FR2 overlap is one molecule observed twice; counting both votes inflates coverage and biases beta when the mates disagree.\n4. **Whether \"5mC\" is actually 5mC+5hmC.** 5hmC is also protected from conversion, so a standard WGBS\u002FEM-seq beta is the SUM 5mC+5hmC. In brain\u002FESC\u002Fliver this is a real misattribution that no extractor flag can undo.\n\nOrganize the analysis around defending these four (conversion QC -> overlap -> M-bias -> variant-awareness -> what context\u002Fchemistry am I even calling), not around listing flags. And one deeper caveat: beta is itself a lossy average - collapsing reads to a `.cov` matrix discards the read-level epiallele, the strand (hemimethylation), and the allele (ASM); see the last sections.\n\n## Tool Taxonomy\n\n| Tool | Citation | Mechanism \u002F role | When |\n|------|----------|------------------|------|\n| bismark_methylation_extractor | Krueger & Andrews 2011 *Bioinformatics* 27:1571 | reads Bismark's own XM call string; ecosystem standard | input is a Bismark BAM; want the genome-wide cytosine report \u002F methylKit `.cov`; plant `--CX` |\n| MethylDackel | github.com\u002Fdpryan79\u002FMethylDackel (no journal) | recomputes calls from BAM + reference; fast; aligner-agnostic | bwa-meth BAM; want built-in M-bias `--OT\u002F--OB` bounds and `--maxVariantFrac` SNP guard |\n| BISCUIT | github.com\u002Fhuishenlab\u002Fbiscuit (no journal) | aligner + JOINT methylation\u002FSNP\u002FASM caller; VCF + epiBED | human population \u002F allele-specific work needing SNP-aware betas |\n| Bis-SNP | Liu 2012 *Genome Biol* 13:R61 | Bayesian joint genotype + methylation | the original SNP-aware caller; mask C\u002FT SNPs from betas |\n| methylpy | github.com\u002Fyupenghe\u002Fmethylpy (no journal) | allc format + binomial methylated-flag | the allc \u002F ALLCools ecosystem; built-in per-site significance |\n| asTair | bitbucket.org\u002Fbsblabludwig\u002Fastair (no journal) | polarity-aware caller (mCtoT \u002F CtoT) | TAPS data (inverted polarity); explicit per-context stats |\n\nEM-seq extraction arithmetic is identical to bisulfite (unmodified C reads as T either way) - the same Bismark\u002FMethylDackel command works. TAPS INVERTS the polarity (modified C->T), so a bisulfite extractor reports 1-beta; use ASTAIR `--mod_mapping mCtoT`.\n\n## Decision Tree by Scenario\n\n| Scenario | Recommended | Why |\n|----------|-------------|-----|\n| Bismark-aligned BAM, mammalian CpG | `bismark_methylation_extractor -p --comprehensive --cytosine_report` | reads the XM tag; cytosine report is the bsseq\u002FmethylKit input |\n| bwa-meth-aligned WGBS\u002FEM-seq | `MethylDackel extract --mergeContext` | bismark extractor cannot read a bwa-meth BAM (no XM tag) |\n| Human population \u002F polymorphic CpGs \u002F ASM | BISCUIT (or Bis-SNP) | joint SNP+methylation; C\u002FT SNP recognized as a variant, not unmethylation |\n| Plant methylome (CHG\u002FCHH real) | `--CX` (Bismark) \u002F `--CHG --CHH` (MethylDackel) + lambda spike-in | non-CpG is biology; CHH-as-conversion-proxy fails |\n| TAPS data | ASTAIR `--mod_mapping mCtoT` | polarity inverted; a bisulfite extractor reports 1-beta |\n| Need 5hmC resolved from 5mC | second chemistry (oxBS\u002FTAB\u002FACE) -> route, not a flag | WGBS\u002FEM-seq sums them; the extractor cannot split |\n| Read-level heterogeneity \u002F clonality \u002F cfDNA | keep reads (epiread\u002FepiBED), do NOT collapse to `.cov` | the epiallele dies in the per-CpG average |\n| Long-read modBAM with MM\u002FML tags | -> long-read-sequencing\u002Fnanopore-methylation | native modification tags, not conversion counting |\n\n## Conversion-Rate QC -- the First Gate\n\n**Goal:** Reject a methylome whose betas are inflated by incomplete conversion before computing anything.\n\n**Approach:** Measure non-conversion globally, two ways. In mammals, genome-wide CHH methylation is near-zero biology, so the observed CHH rate IS the non-conversion rate (~2% CHH implies ~98% conversion). Where non-CpG methylation is real (plants, ESCs, neurons - Schultz 2015), spike in unmethylated lambda phage DNA and align to it: all its cytosines are unmethylated, so its observed \"methylation\" is the non-conversion rate. Require conversion >=99% (community convention; Shirane 2013 is a representative source). Extract CHH at least once even for a CpG-only mammalian study, purely for this number.\n\n```bash\n# Bismark: extract all contexts, then read the CHH methylation rate from the splitting report\nbismark_methylation_extractor -p --comprehensive --CX --genome_folder genome\u002F sample_pe.bam\n# The *_splitting_report.txt prints C methylated in CHH context %; (100 - that) ~ conversion efficiency in mammals.\n\n# Lambda spike-in (the gold standard, mandatory in plants\u002FESC\u002Fneurons):\n# align to the lambda genome, extract, and treat its global methylation as the non-conversion rate.\nbismark --genome lambda_genome\u002F -1 R1.fq.gz -2 R2.fq.gz -o lambda_qc\u002F\n```\n\nMethylDackel `--minConversionEfficiency` can additionally drop individual reads whose own conversion (from non-CpG Cs) is too low - a per-read complement to the global gate, not a replacement for it.\n\n## Extract from a Bismark BAM\n\n```bash\nbismark_methylation_extractor \\\n    -p \\                                # paired-end (--no_overlap is ON BY DEFAULT for -p)\n    --comprehensive \\                   # merge OT\u002FOB\u002FCTOT\u002FCTOB into one file per context\n    --bedGraph --cytosine_report \\      # coverage\u002FbedGraph + genome-wide every-C report\n    --genome_folder genome\u002F \\           # MANDATORY for --cytosine_report (scans the FASTA for all Cs)\n    --ignore_r2 2 \\                     # trim R2 5' end-repair artifact (set from M-bias; near-universal for EM-seq\u002FPBAT)\n    --parallel 4 --gzip \\\n    -o methylation\u002F sample_pe.bam\n# Outputs: sample_pe.bismark.cov.gz (1-BASED), sample_pe.bedGraph.gz (0-BASED), sample_pe.CpG_report.txt.gz (1-BASED).\n```\n\nCollapse the symmetric CpG dyad with `coverage2cytosine --merge_CpG` (NOT `--merge_non_CpG`, which merges the CHG+CHH files). `--merge_CpG` adds the + strand C at position p and the - strand C at p+1 into one dyad entry, doubling effective coverage; it is CpG-only and incompatible with `--CX`.\n\n## Extract from a bwa-meth BAM (MethylDackel)\n\n```bash\nMethylDackel mbias ref.fa sample.bam mbias_prefix   # inspect the SVGs; it SUGGESTS --OT\u002F--OB bounds (do NOT accept blindly)\nMethylDackel extract \\\n    --mergeContext \\                   # collapse the symmetric CpG dyad (the MethylDackel equivalent of --merge_CpG)\n    --maxVariantFrac 0.25 \\            # exclude a C if the opposite-strand non-G fraction exceeds this (cheap SNP guard)\n    --OT 3,0,0,98 --OB 3,0,0,98 \\     # inclusion bounds from mbias: first\u002Flast bp to keep on read1,read2\n    ref.fa sample.bam\n# Output sample_CpG.bedGraph is 0-BASED, half-open: chr start end round(%meth) count_M count_U. CpG ONLY by default;\n# add --CHG --CHH for plants. Default --minDepth 1, -q (MAPQ) 10, -p (Phred) 5.\n```\n\n## Coverage, Precision, and the Handoff -- Pass Counts, Not Betas\n\nA beta is a binomial proportion: at coverage n its granularity is 1\u002Fn and its SE is ~sqrt(beta(1-beta)\u002Fn). At n=1 beta is only 0 or 1; at n=4 it lands on {0,.25,.5,.75,1}. A 1\u002F2 site and a 50\u002F100 site both read beta=0.5 but carry wildly different evidence. The extractors impose no biological floor (MethylDackel `--minDepth` and Bismark `.cov` both default to >=1). Do NOT pre-threshold to a single beta and t-test it - that discards the coverage information. Hand the COUNT data (M and total) forward; the downstream DMR callers (DSS\u002FmethylKit\u002Fbsseq) model the beta-binomial and USE n. A common per-CpG floor is >=10x AFTER symmetric merge, but it is a tradeoff (site count vs precision), not a magic constant.\n\n## 5mC vs 5hmC and the Oxidation Cascade -- a Chemistry Decision, Not a Flag\n\nStandard bisulfite AND standard EM-seq protect BOTH 5mC and 5hmC from conversion, so the \"methylated\" bin is 5mC+5hmC, never 5mC alone. Worse, bisulfite DEAMINATES the downstream TET-oxidation products 5fC and 5caC, so they read as T and land in the \"unmethylated\" bin - both bins are biochemically impure at TET-active loci (ESC, early embryo, neurons, some tumors). The full cascade is 5mC -> 5hmC -> 5fC -> 5caC. Resolving any derivative requires a SECOND wet-lab chemistry, not an extractor flag: 5hmC via oxBS-seq (Booth 2012; 5hmC = BS - oxBS by subtraction), TAB-seq (Yu 2012; direct 5hmC), or ACE-seq (Schutsky 2018; enzymatic, low-input); the bisulfite-free TAPS (Liu 2019) sidesteps the harsh chemistry but inverts polarity. Never let a plain WGBS\u002FEM-seq beta be labeled \"5mC\" or its complement \"unmodified C.\"\n\n## Read-Level Heterogeneity -- the Epiallele Dies in the Average\n\nbeta=0.5 is consistent with three opposite biologies that beta cannot distinguish: a 50\u002F50 mixture of fully-methylated and fully-unmethylated cells, every cell ~50% methylated with CpGs scattered differently per molecule (stochastic disorder), or a true uniform intermediate. The discriminator lives in the JOINT CpG pattern on a single read - intramolecular co-methylation - which the per-CpG average integrates out. Read-level metrics (PDR, Landau 2014; epipolymorphism, Landan 2012; methylation entropy; MHL for cfDNA tissue-of-origin, Guo 2017; FDRP\u002FqFDRP) measure clonal\u002Fepigenetic instability and power liquid-biopsy deconvolution, and they require a READ-PRESERVING format (BISCUIT epiread\u002FepiBED or the raw BAM) plus tools like Metheor or methclone - none of which are extractors. The moment the pipeline collapses to a `.cov` beta matrix, the epiallele is gone. If the question is heterogeneity, clonality, or cfDNA deconvolution, do NOT collapse to beta; this deeper analysis may warrant its own workflow, but at minimum the calling stage must flag that beta discards it.\n\n## Hemimethylation and Allele-Specific Methylation -- two more things the average hides\n\n**Hemimethylation (the strand axis).** `--merge_CpG` \u002F `--mergeContext` is not a neutral coverage optimization: it bakes in the assumption that the two strands of a dyad agree and silently zeroes the hemimethylation channel (one strand methylated, the other not). Hemimethylation is real biology - the obligate post-replication maintenance intermediate, and a stable heritable mark at CTCF\u002Fcohesin sites required for chromatin looping (Xu & Corces 2018). Default destranding ON for bulk symmetric-CpG DMR work; turn it OFF (strand-specific extraction) and budget high per-strand coverage the moment strand asymmetry is the question. Per-molecule dyad state needs hairpin-bisulfite (Laird 2004).\n\n**Allele-specific methylation (the allele axis).** The same C\u002FT SNP that corrupts a beta (insight #2) becomes the measurement axis once reads are phased: assign each read's methylation to the SNP allele it carries and compare beta per allele (BISCUIT `epiread -B snps.bed` then `biscuit asm`; or Bis-SNP). The headline trap: a stable ~50% beta at a KNOWN imprinted control region (H19\u002FIGF2, KCNQ1OT1, SNRPN, GNAS, MEG3) is NOT intermediate methylation and NOT a conversion artifact - it is two superimposed monoallelic states (one allele ~100%, one ~0%) averaged into a deceptive midpoint, a signature to PHASE, not a value to model. Sequence-dependent ASM is the mQTL bridge to causal-genomics\u002Fmendelian-randomization; produce the allele-phased betas here, do the colocalization there.\n\n## Per-Method Failure Modes\n\n### No conversion-rate gate\n**Trigger:** reporting betas without checking CHH rate or a lambda spike-in. **Mechanism:** an unconverted unmethylated C is identical to a methylated C; non-conversion inflates every beta. **Symptom:** uniformly elevated methylation, fabricated low-methylation regions. **Fix:** require >=99% conversion (CHH-proxy in mammals; lambda spike-in in plants\u002FESC\u002Fneurons).\n\n### bismark extractor on a bwa-meth BAM\n**Trigger:** `bismark_methylation_extractor` on a non-Bismark BAM. **Mechanism:** it reads Bismark's XM tag, absent from bwa-meth output. **Symptom:** error or empty\u002Fgarbage calls. **Fix:** use MethylDackel or BISCUIT, which recompute from BAM + reference.\n\n### C\u002FT SNP read as unmethylation\n**Trigger:** extracting human population data with no variant-awareness. **Mechanism:** a T allele at a reference C is scored as converted. **Symptom:** spurious hypomethylation at polymorphic CpGs; SNP-driven false DMRs. **Fix:** BISCUIT\u002FBis-SNP joint calling, or MethylDackel `--maxVariantFrac`, or mask dbSNP\u002Fsample-VCF CpGs.\n\n### Paired-end overlap double-counted\n**Trigger:** single-end mode on paired data, or a non-default tool. **Mechanism:** the R1\u002FR2 overlap counts one molecule twice. **Symptom:** inflated coverage, biased beta on mate disagreement. **Fix:** `-p` (Bismark `--no_overlap` is on by default for paired-end); MethylDackel handles overlap automatically.\n\n### M-bias not trimmed\n**Trigger:** extracting without inspecting the M-bias plot. **Mechanism:** end-repair fill-in introduces unmethylated Cs at fragment ends; the per-position methylation deviates near read ends. **Symptom:** a non-flat M-bias curve; biased calls in the trimmable region. **Fix:** trim with `--ignore`\u002F`--ignore_r2` (Bismark) or `--OT\u002F--OB` bounds (MethylDackel). The diagnostic is FLATNESS\u002Fpositional stability, not any particular global level.\n\n### Coordinate base mismatch on a join\n**Trigger:** joining a MethylDackel bedGraph (0-based) to a Bismark `.cov` (1-based). **Mechanism:** the two formats index differently. **Symptom:** every site shifts by one; strands silently mismatch. **Fix:** pick one format end-to-end or convert explicitly; the cytosine report and allc are 1-based, both bedGraphs are 0-based.\n\n### --merge_non_CpG mistaken for dyad collapse\n**Trigger:** using `--merge_non_CpG` to merge the symmetric CpG strands. **Mechanism:** `--merge_non_CpG` merges the CHG+CHH output files, NOT the CpG dyad. **Symptom:** strand-specific CpG report unchanged; CpG coverage not doubled. **Fix:** symmetric CpG collapse is `coverage2cytosine --merge_CpG` \u002F MethylDackel `--mergeContext`.\n\n## Quantitative Thresholds\n\n| Threshold | Source | Rationale |\n|-----------|--------|-----------|\n| Conversion efficiency >=99% | Shirane 2013 *PLoS Genet* 9:e1003439; community | below it, residual unconverted Cs inflate every beta |\n| CHH rate ~= (1 - conversion) in mammals | Schultz 2015 *Nature* 523:212 | true mammalian CHH is near-zero, so it reads out non-conversion |\n| Per-CpG coverage >=10x (after merge) | community | granularity 1\u002Fn; SE of an intermediate beta ~0.16 at 10x |\n| `--ignore_r2` ~2 for EM-seq\u002FPBAT | M-bias plot | R2 5' end-repair fill-in adds unmethylated Cs; set from the plot |\n| MethylDackel `-q` 10 \u002F `-p` 5 | MethylDackel defaults | MAPQ\u002Fbase-quality minima; defaults, confirm with `--help` |\n| `--maxVariantFrac` no universal value | MethylDackel docs | set per-experiment against known-SNP density |\n| `--merge_CpG` doubles dyad coverage | Bismark docs | + and - strand of a symmetric CpG are co-methylated; merge then threshold |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| Empty\u002Fgarbage calls from bismark extractor | bwa-meth BAM (no XM tag) | use MethylDackel\u002FBISCUIT |\n| Uniformly high methylation | incomplete conversion | check CHH rate \u002F lambda; require >=99% |\n| Spurious hypomethylation at SNPs | C\u002FT SNP read as conversion | `--maxVariantFrac`; BISCUIT\u002FBis-SNP; mask dbSNP |\n| Inflated coverage on overlaps | single-end mode on paired data | `-p`; MethylDackel handles it automatically |\n| Sites shifted by one after a join | 0-based vs 1-based format mix | reconcile coordinate base; one format end-to-end |\n| Plant CHH\u002FCHG methylome missing | CpG-only default | `--CX` (Bismark) \u002F `--CHG --CHH` (MethylDackel) |\n| `coverage2cytosine: option --merge_CpG` ignored | used `--merge_non_CpG` instead, or paired with `--CX` | `--merge_CpG` is CpG-only, incompatible with `--CX` |\n| Inverted (1-beta) methylome | bisulfite extractor on TAPS data | ASTAIR `--mod_mapping mCtoT` |\n\n## References\n\n- Krueger F, Andrews SR. 2011. Bismark: a flexible aligner and methylation caller for Bisulfite-Seq applications. *Bioinformatics* 27:1571-1572.\n- Liu Y, Siegmund KD, Laird PW, Berman BP. 2012. Bis-SNP: combined DNA methylation and SNP calling for Bisulfite-seq data. *Genome Biol* 13:R61.\n- Vaisvila R, Ponnaluri VKC, Sun Z, et al. 2021. Enzymatic methyl sequencing detects DNA methylation at single-base resolution from picograms of DNA. *Genome Res* 31:1280-1289.\n- Booth MJ, Branco MR, Ficz G, et al. 2012. Quantitative sequencing of 5-methylcytosine and 5-hydroxymethylcytosine at single-base resolution. *Science* 336:934-937.\n- Yu M, Hon GC, Szulwach KE, et al. 2012. Base-resolution analysis of 5-hydroxymethylcytosine in the mammalian genome. *Cell* 149:1368-1380.\n- Schutsky EK, DeNizio JE, Hu P, et al. 2018. Nondestructive, base-resolution sequencing of 5-hydroxymethylcytosine using a DNA deaminase. *Nat Biotechnol* 36:1083-1090.\n- Liu Y, Siejka-Zielinska P, Velikova G, et al. 2019. Bisulfite-free direct detection of 5-methylcytosine and 5-hydroxymethylcytosine at base resolution. *Nat Biotechnol* 37:424-429.\n- Schultz MD, He Y, Whitaker JW, et al. 2015. Human body epigenome maps reveal noncanonical DNA methylation variation. *Nature* 523:212-216.\n- Shirane K, Toh H, Kobayashi H, et al. 2013. Mouse oocyte methylomes at base resolution reveal genome-wide accumulation of non-CpG methylation and role of DNA methyltransferases. *PLoS Genet* 9:e1003439.\n- Landau DA, Clement K, Ziller MJ, et al. 2014. Locally disordered methylation forms the basis of intratumor methylome variation in chronic lymphocytic leukemia. *Cancer Cell* 26:813-825.\n- Landan G, Cohen NM, Mukamel Z, et al. 2012. Epigenetic polymorphism and the stochastic formation of differentially methylated regions in normal and cancerous tissues. *Nat Genet* 44:1207-1214.\n- Guo S, Diep D, Plongthongkum N, et al. 2017. Identification of methylation haplotype blocks aids in deconvolution of heterogeneous tissue samples and tumor tissue-of-origin mapping from plasma DNA. *Nat Genet* 49:635-642.\n- Xu C, Corces VG. 2018. Nascent DNA methylome mapping reveals inheritance of hemimethylation at CTCF\u002Fcohesin sites. *Science* 359:1166-1170.\n- Laird CD, Pleasant ND, Clark AD, et al. 2004. Hairpin-bisulfite PCR: assessing epigenetic methylation patterns on complementary strands of individual DNA molecules. *PNAS* 101:204-209.\n- MethylDackel. github.com\u002Fdpryan79\u002FMethylDackel (no associated journal publication).\n- BISCUIT. github.com\u002Fhuishenlab\u002Fbiscuit (no associated journal publication).\n\n## Related Skills\n\n- bismark-alignment - Produces the aligned BAM consumed here\n- differential-cpg-testing - Per-CpG statistical testing on the counts\n- dmr-detection - Region-level methods downstream\n- methylkit-analysis - methylKit import of the coverage\u002Fcytosine report\n- long-read-sequencing\u002Fnanopore-methylation - Native long-read MM\u002FML modification calling (the wall)\n- causal-genomics\u002Fmendelian-randomization - mQTL \u002F causal follow-up of allele-specific methylation\n- workflows\u002Fmethylation-pipeline - End-to-end bisulfite pipeline\n",{"name":5,"source":24,"license":15,"tool_type":25,"description":7,"imported_at":26,"source_path":27,"primary_tool":28,"source_repository":29},"https:\u002F\u002Fgithub.com\u002FGPTomics\u002FbioSkills","cli","2026-09-20","methylation-analysis\u002Fmethylation-calling\u002FSKILL.md","Bismark","GPTomics\u002FbioSkills","main","2d1750717747097b602acf30bd09a7cbd4b4c6ea","awesome_skills\u002Fbiology\u002Fbio-methylation-calling","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous","2026-11-09 11:45:36",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-methylation-calling",{"tool":42,"command":43},"bunx","bunx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-methylation-calling",{"tool":45,"command":46},"pnpm","pnpm dlx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-methylation-calling","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-methylation-calling\u002FSKILL.md",true,[50,56],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"examples\u002Fextract_methylation.sh","SCRIPT","脚本",2947,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-methylation-calling\u002Fexamples\u002Fextract_methylation.sh",{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"usage-guide.md","REFERENCE","参考文档",6509,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-methylation-calling\u002Fusage-guide.md",[63,71,78,85,92,99],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":70},"01M7FFFZPC2025JQQHPHDX154J","dei-assessment","Assess diversity, equity, and inclusion with metrics. TRIGGERS - Use when user needs help with dei-assessment related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fdei-assessment\u002FSKILL.md",[],[],"2026-11-16 10:05:34",{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":70},"01M7FFFWN8H4WA7A6Y398QKB6J","dei-action-plan","Create DEI action plans with goals and initiatives. TRIGGERS - Use when user needs help with dei-action-plan related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fdei-action-plan\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":70},"01M7FFFSHTM0QZRVZ2NRJTJ0PY","culture-fit-assessment","Design culture add assessment processes. TRIGGERS - Use when user needs help with culture-fit-assessment related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fculture-fit-assessment\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":70},"01M7FFFMA12RKEQA38KHJSXXPS","cowork-to-code-bridge","Use an already-installed, independently verified cowork-to-code bridge to run narrowly approved actions on the user's own macOS, Linux, or WSL2 machine through a local file queue.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcowork-to-code-bridge\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":70},"01M7FFFH1F6M8YRGW5V487GH1K","counter-offer-response","Draft counter-offer responses for retention. TRIGGERS - Use when user needs help with counter-offer-response related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcounter-offer-response\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":70},"01M7FFFDGEHV8Y7J9N40HZXW52","continuous-feedback-system","Design continuous feedback systems. TRIGGERS - Use when user needs help with continuous-feedback-system related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcontinuous-feedback-system\u002FSKILL.md",[],[]]