[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ECEZGC8JKXDN2G8SA5ME9J":3,"skill-same:01M7ECEZGC8JKXDN2G8SA5ME9J":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},"01M7ECEZGC8JKXDN2G8SA5ME9J","bio-copy-number-subclonal-copy-number",null,"Resolve subclonal copy number, whole-genome doubling, and copy-number tumor evolution from bulk sequencing with Battenberg, TITAN, and MEDICC2. Covers clonal versus subclonal copy-number states, haplotype phasing for subclonal resolution, cancer cell fraction, whole-genome-doubling detection and timing relative to mutations, mirrored subclonal allelic imbalance, and copy-number phylogenies. Use when a tumor is heterogeneous and bulk data shows non-integer copy number, when calling subclonal CNAs, detecting or timing whole-genome doubling, reconstructing copy-number evolution, or deciding between Battenberg and TITAN.","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-copy-number-subclonal-copy-number\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: bio-copy-number-subclonal-copy-number\ndescription: Resolve subclonal copy number, whole-genome doubling, and copy-number tumor evolution from bulk sequencing with Battenberg, TITAN, and MEDICC2. Covers clonal versus subclonal copy-number states, haplotype phasing for subclonal resolution, cancer cell fraction, whole-genome-doubling detection and timing relative to mutations, mirrored subclonal allelic imbalance, and copy-number phylogenies. Use when a tumor is heterogeneous and bulk data shows non-integer copy number, when calling subclonal CNAs, detecting or timing whole-genome doubling, reconstructing copy-number evolution, or deciding between Battenberg and TITAN.\ntool_type: mixed\nprimary_tool: battenberg\nsource: \"https:\u002F\u002Fgithub.com\u002FGPTomics\u002FbioSkills\"\nsource_repository: \"GPTomics\u002FbioSkills\"\nsource_path: \"copy-number\u002Fsubclonal-copy-number\u002FSKILL.md\"\nlicense: \"MIT\"\nimported_at: \"2026-09-20\"\n---\n\n## Version Compatibility\n\nReference examples tested with: R 4.3+ with Battenberg 2.2.10+ and TitanCNA 1.40+, MEDICC2 1.0+, Python 3.10+; impute2\u002FBeagle phasing reference panels.\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- R: `packageVersion('Battenberg')` \u002F `'TitanCNA')` then `?function`\n- CLI: `medicc2 --help`\n- Battenberg is GitHub-only (`Wedge-lab\u002Fbattenberg`) and needs a 1000 Genomes impute\u002Fphasing reference and allele-counter; confirm reference data is installed\n\nBattenberg and TITAN both consume allele-specific data (logR + BAF at heterozygous SNPs); they cannot run on relative copy ratio alone.\n\n# Subclonal Copy Number and Tumor Evolution\n\n**\"This copy number is non-integer — is it noise, or are there subclones\"** -> A tumor is a mixture of cell populations. When a copy-number change is present in only some cancer cells, bulk sequencing averages it into a *non-integer* state. A long non-integer segment is not noise — it is a subclonal copy-number alteration, and resolving it reveals the tumor's clonal architecture.\n\n- R: `Battenberg` (phased clonal + subclonal CN), `TitanCNA` (HMM mixture of cell populations)\n- CLI: `medicc2` (whole-genome-doubling-aware copy-number phylogenies)\n- Input: allele-specific data — see allele-specific-copy-number for the clonal layer\n\n## Clonal vs Subclonal — What the Tools Output\n\n| Concept | Meaning |\n|---------|---------|\n| Clonal CNA | Present in all cancer cells; one copy-number state per segment |\n| Subclonal CNA | Present in a fraction of cancer cells; the segment needs two states plus a fraction |\n| Cancer cell fraction (CCF) | Fraction of cancer cells carrying the event |\n| Mirrored subclonal allelic imbalance | Different subclones lose opposite haplotypes of the same region |\n\nBattenberg fits a clonal allele-specific profile (ASCAT internally), then where a segment fits poorly as a single integer state, it models it as a mixture of two states with a subclonal fraction. TITAN uses an HMM whose states span multiple clonal clusters, jointly estimating per-cluster cellular prevalence. Both need haplotype phasing — subclonal allelic imbalance is only resolvable when SNPs are phased.\n\n## Tool Selection\n\n| Tool | Model | Best for | Fails when |\n|------|-------|----------|------------|\n| Battenberg | Phased clonal fit + per-segment subclonal mixture | WGS, subclonal CN to ~3% of cells, clonal-evolution studies | Low depth\u002Fpurity; heavy compute; needs phasing reference |\n| TITAN | HMM mixture across clonal clusters | WGS\u002FWES, joint CN+LOH+subclonal prevalence, few clusters | Many subclones; cluster number must be chosen and swept |\n| MEDICC2 | WGD-aware minimum-event copy-number phylogeny | Multi-sample \u002F multi-region evolution | Single sample (no tree to build) |\n| ASCAT\u002FFACETS | Clonal allele-specific only | When subclonal resolution is not needed | Treats subclonal segments as noisy clonal — see allele-specific-copy-number |\n\n## Whole-Genome Doubling — Detection and Timing\n\nWhole-genome doubling (WGD) is a discrete, common (~30% of advanced cancers) evolutionary event, and it must be called explicitly because it changes how every copy number is read.\n\n- **Detection:** A tumor has undergone WGD if more than ~50% of the autosomal genome has a major (more frequent) allele copy number >= 2. WGD tumors have median ploidy ~3.3 versus ~2.1 for non-WGD.\n- **Relative vs absolute:** Depth gives *relative* copy number; WGD calling needs *absolute* allele-specific copy number (BAF anchors ploidy). A depth-only profile cannot distinguish a WGD genome from a non-WGD genome — this is the identifiability problem of allele-specific-copy-number in another guise.\n- **Timing:** WGD is timeable relative to point mutations. Mutations that arose before WGD are carried at multiple copies (mutation copy number ~2); mutations after WGD sit at one copy. This dates WGD within the tumor's mutational history.\n\n## Calling Subclonal CN with Battenberg\n\n**Goal:** Fit clonal and subclonal allele-specific copy number genome-wide.\n\n**Approach:** Generate phased allele counts against a 1000 Genomes reference, run the Battenberg pipeline; segments that fit poorly as one integer state are split into a two-state subclonal mixture with a cellular fraction.\n\n```r\nlibrary(Battenberg)\n\n# Battenberg orchestrates allele counting, phasing, ASCAT clonal fit, and the\n# subclonal mixture step. Reference data (1000G impute panel) must be installed.\nbattenberg(\n    samplename          = 'tumour_id',\n    normalname          = 'normal_id',\n    sample_data_file    = 'tumour.bam',\n    normal_data_file    = 'normal.bam',\n    ismale              = TRUE,\n    imputeinfofile      = 'impute_info.txt',\n    g1000prefix         = '1000G_loci\u002F1000genomesloci2012_chr',     # SNP loci data\n    g1000allelesprefix  = '1000G_alleles\u002F1000genomesAlleles2012_chr', # SNP alleles (WGS)\n    problemloci         = 'probloci.txt',\n    gccorrectprefix     = 'GC_correction_hg38_chr',\n    repliccorrectprefix = 'RT_correction_hg38_chr',\n    genomebuild         = 'hg38',                                   # default is hg19\n    nthreads            = 8)\n# Output *_subclones.txt: per segment, nMaj1\u002FnMin1 (state 1) + frac1, and nMaj2\u002FnMin2 +\n# frac2 when the segment is subclonal (two states).\n```\n\n## Calling Subclonal CN with TITAN\n\n**Goal:** Jointly infer copy number, LOH, and the cellular prevalence of clonal clusters.\n\n**Approach:** TITAN needs both allele counts (het SNPs) and corrected read depth. Load the allele counts; correct tumour\u002Fnormal read depth for GC and mappability bias; overlay the resulting logR onto the het positions and log-transform; filter; then run the EM and sweep the cluster number — model selection picks the best.\n\n```r\nlibrary(TitanCNA)\n\n# Allele counts at het SNPs.\ndata \u003C- loadAlleleCounts('tumour.allelicCounts.tsv', genomeStyle = 'UCSC')\n\n# Read-depth correction is mandatory: correctReadDepth needs tumour + normal coverage\n# WIGs and GC + mappability WIGs. genomeStyle MUST match loadAlleleCounts above\n# (default 'NCBI' vs 'UCSC') or getPositionOverlap matches no chromosomes and logR is NA.\ncnData \u003C- correctReadDepth('tumour.wig', 'normal.wig', 'gc.wig', 'map.wig',\n                           genomeStyle = 'UCSC')\ndata$logR \u003C- log(2 ^ getPositionOverlap(data$chr, data$posn, cnData))\ndata \u003C- filterData(data, 1:24, minDepth = 10, maxDepth = 200, map = NULL)\n\nparams \u003C- loadDefaultParameters(copyNumber = 8, numberClonalClusters = 2,\n                                symmetric = TRUE, data = data)\nconv \u003C- runEMclonalCN(data, params, maxiter = 20, txnExpLen = 1e15)\nresults \u003C- viterbiClonalCN(data, conv)\n# Sweep numberClonalClusters (1..5) and compare model fit; the S_Dbw validity index\n# or the model log-likelihood selects the cluster number.\n```\n\n## Failure Modes\n\n### Subclonal call from insufficient depth or purity\n\n**Trigger:** Calling subclonal CN on shallow WGS or a low-purity tumor.\n\n**Mechanism:** A subclonal segment's signal is the clonal deviation scaled by the subclone's cell fraction — already small, and below the noise floor at low depth\u002Fpurity.\n\n**Symptom:** Many \"subclonal\" segments with implausibly low fractions; calls not reproducible across reruns or regions.\n\n**Fix:** Battenberg's ~3%-of-cells sensitivity assumes adequate WGS depth and purity. For low-depth or low-purity samples, treat only clonal CN as reliable and report subclonal calls as exploratory.\n\n### Mirrored subclonal allelic imbalance misread\n\n**Trigger:** A region where different subclones lost opposite haplotypes.\n\n**Mechanism:** Bulk BAF averages the two opposite losses toward 0.5, so the region can look balanced (clonal, no LOH) when it is in fact subclonally rearranged on both haplotypes.\n\n**Symptom:** A segment called clonal-balanced that conflicts with multi-region or single-cell data; BAF near 0.5 with an odd logR.\n\n**Fix:** Phasing (Battenberg) is required to detect mirrored subclonal allelic imbalance. Multi-region or single-cell data resolves it definitively; a single bulk sample can miss it.\n\n### WGD not called — every copy number off by a factor\n\n**Trigger:** Interpreting copy number without first establishing WGD status.\n\n**Mechanism:** The likelihood surface has near-equal modes at ploidy P and 2P; missing a WGD halves all copy numbers and mis-times every mutation.\n\n**Symptom:** Copy numbers and mutation copy numbers inconsistent; \"subclonal\" gains that are actually clonal post-WGD states.\n\n**Fix:** Call WGD explicitly (>50% of autosomes at major CN >= 2) from absolute allele-specific copy number. Cross-check ploidy against the odd\u002Feven CN fraction and clonal-SNV multiplicity before any subclonal interpretation.\n\n### Over-interpreting one subclonal segment as a subclone\n\n**Trigger:** Declaring a distinct tumor subclone from a single subclonal copy-number segment.\n\n**Mechanism:** A single segment at an intermediate fraction can arise from segmentation error, a mis-fit clonal state, or genuine subclonality — one segment cannot distinguish these.\n\n**Symptom:** A \"subclone\" supported by exactly one segment; clonal architecture claims that do not replicate.\n\n**Fix:** Require multiple concordant subclonal segments at a consistent cell fraction, ideally corroborated by SNV-based subclonal reconstruction (cancer cell fraction clustering) and multi-region sampling.\n\n### Single-region sampling misses spatial subclones\n\n**Trigger:** Inferring clonal architecture from one biopsy of a spatially heterogeneous tumor.\n\n**Mechanism:** A subclone confined to an unsampled region is invisible; a single region cannot capture branching evolution.\n\n**Symptom:** Apparently simple clonal architecture contradicted by a second biopsy.\n\n**Fix:** For evolution and architecture claims, use multi-region sampling and a phylogeny method (MEDICC2 for copy-number trees). Single-region subclonal calls describe that region only.\n\n## Reconciliation\n\n| Pattern | Likely cause | Action |\n|---------|--------------|--------|\n| Battenberg subclonal vs TITAN clonal | Different mixture models; cluster number | Sweep TITAN clusters; compare cell fractions |\n| WGD called by one tool, not another | Integer-multiple ploidy ambiguity | Check odd\u002Feven CN fraction and SNV multiplicity |\n| Many low-fraction subclonal segments | Depth\u002Fpurity too low | Trust only clonal CN; flag subclonal as exploratory |\n| Subclonal CN vs SNV-based CCF disagree | CN and SNV subclones need not coincide | Integrate both; they answer different questions |\n\n**Operational rule:** Report subclonal copy number as confident only when (1) depth and purity support it, (2) WGD status is established from absolute allele-specific CN, (3) multiple concordant segments support a subclone at a consistent fraction, and (4) for evolution claims, multi-region data and a copy-number phylogeny are used. A single subclonal segment is a hypothesis, not a subclone.\n\n## Quantitative Thresholds\n\n| Threshold | Value | Source \u002F Rationale |\n|-----------|-------|--------------------|\n| Battenberg subclonal sensitivity | ~3% of cells | Nik-Zainal 2012; requires adequate WGS depth\u002Fpurity |\n| WGD definition | > 50% of autosomes at major CN >= 2 | Bielski 2018; the operational WGD call |\n| WGD median ploidy | ~3.3 (WGD) vs ~2.1 (non-WGD) | Bielski 2018 pan-cancer |\n| Pre-WGD mutation copy number | >= ~1.75 | Pre-doubling mutations carried at multiple copies |\n| TITAN clonal clusters | sweep 1-5, select by fit | Few clusters resolvable from one bulk sample |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| Battenberg install\u002Frun fails | GitHub-only; missing 1000G reference | Install from GitHub; set up the impute reference |\n| Non-integer segments treated as noise | Subclonal CNA not modeled | Use Battenberg\u002FTITAN, not a clonal-only caller |\n| All copy numbers half\u002Fdouble expected | WGD not called | Establish WGD from absolute CN; check SNV multiplicity |\n| Subclones not reproducible | Low depth\u002Fpurity, single segment | Require depth, concordant segments, multi-region |\n| Balanced region conflicts with other data | Mirrored subclonal allelic imbalance | Use phased (Battenberg) or single-cell data |\n| TITAN cluster number arbitrary | Cluster count not swept | Sweep 1-5; select by model fit |\n\n## References\n\n- Nik-Zainal S et al 2012. The life history of 21 breast cancers (Battenberg). Cell 149:994\n- Ha G et al 2014. TITAN: inference of copy number architectures in clonal cell populations from tumor whole-genome sequence data. Genome Res 24:1881\n- Bielski CM et al 2018. Genome doubling shapes the evolution and prognosis of advanced cancers. Nat Genet 50:1189\n- Dewhurst SM et al 2014. Tolerance of whole-genome doubling propagates chromosomal instability. Cancer Discov 4:175\n- Kaufmann TL et al 2022. MEDICC2: whole-genome doubling aware copy-number phylogenies for cancer evolution. Genome Biol 23:241\n\n## Related Skills\n\n- copy-number\u002Fallele-specific-copy-number - Clonal allele-specific CN, purity, ploidy\n- copy-number\u002Fcopy-ratio-segmentation - Segmentation feeding subclonal callers\n- copy-number\u002Fhrd-scoring - Whole-genome-doubling correction for LST\n- copy-number\u002Frecurrent-cnv - Copy-number signatures including WGD and chromothripsis\n- copy-number\u002Fcnv-visualization - Visualizing subclonal segments and BAF\n- variant-calling\u002Fvcf-basics - SNV calls for cancer cell fraction and WGD timing\n","## Version Compatibility\n\nReference examples tested with: R 4.3+ with Battenberg 2.2.10+ and TitanCNA 1.40+, MEDICC2 1.0+, Python 3.10+; impute2\u002FBeagle phasing reference panels.\n\nBefore using code patterns, verify installed versions match. If versions differ:\n- R: `packageVersion('Battenberg')` \u002F `'TitanCNA')` then `?function`\n- CLI: `medicc2 --help`\n- Battenberg is GitHub-only (`Wedge-lab\u002Fbattenberg`) and needs a 1000 Genomes impute\u002Fphasing reference and allele-counter; confirm reference data is installed\n\nBattenberg and TITAN both consume allele-specific data (logR + BAF at heterozygous SNPs); they cannot run on relative copy ratio alone.\n\n# Subclonal Copy Number and Tumor Evolution\n\n**\"This copy number is non-integer — is it noise, or are there subclones\"** -> A tumor is a mixture of cell populations. When a copy-number change is present in only some cancer cells, bulk sequencing averages it into a *non-integer* state. A long non-integer segment is not noise — it is a subclonal copy-number alteration, and resolving it reveals the tumor's clonal architecture.\n\n- R: `Battenberg` (phased clonal + subclonal CN), `TitanCNA` (HMM mixture of cell populations)\n- CLI: `medicc2` (whole-genome-doubling-aware copy-number phylogenies)\n- Input: allele-specific data — see allele-specific-copy-number for the clonal layer\n\n## Clonal vs Subclonal — What the Tools Output\n\n| Concept | Meaning |\n|---------|---------|\n| Clonal CNA | Present in all cancer cells; one copy-number state per segment |\n| Subclonal CNA | Present in a fraction of cancer cells; the segment needs two states plus a fraction |\n| Cancer cell fraction (CCF) | Fraction of cancer cells carrying the event |\n| Mirrored subclonal allelic imbalance | Different subclones lose opposite haplotypes of the same region |\n\nBattenberg fits a clonal allele-specific profile (ASCAT internally), then where a segment fits poorly as a single integer state, it models it as a mixture of two states with a subclonal fraction. TITAN uses an HMM whose states span multiple clonal clusters, jointly estimating per-cluster cellular prevalence. Both need haplotype phasing — subclonal allelic imbalance is only resolvable when SNPs are phased.\n\n## Tool Selection\n\n| Tool | Model | Best for | Fails when |\n|------|-------|----------|------------|\n| Battenberg | Phased clonal fit + per-segment subclonal mixture | WGS, subclonal CN to ~3% of cells, clonal-evolution studies | Low depth\u002Fpurity; heavy compute; needs phasing reference |\n| TITAN | HMM mixture across clonal clusters | WGS\u002FWES, joint CN+LOH+subclonal prevalence, few clusters | Many subclones; cluster number must be chosen and swept |\n| MEDICC2 | WGD-aware minimum-event copy-number phylogeny | Multi-sample \u002F multi-region evolution | Single sample (no tree to build) |\n| ASCAT\u002FFACETS | Clonal allele-specific only | When subclonal resolution is not needed | Treats subclonal segments as noisy clonal — see allele-specific-copy-number |\n\n## Whole-Genome Doubling — Detection and Timing\n\nWhole-genome doubling (WGD) is a discrete, common (~30% of advanced cancers) evolutionary event, and it must be called explicitly because it changes how every copy number is read.\n\n- **Detection:** A tumor has undergone WGD if more than ~50% of the autosomal genome has a major (more frequent) allele copy number >= 2. WGD tumors have median ploidy ~3.3 versus ~2.1 for non-WGD.\n- **Relative vs absolute:** Depth gives *relative* copy number; WGD calling needs *absolute* allele-specific copy number (BAF anchors ploidy). A depth-only profile cannot distinguish a WGD genome from a non-WGD genome — this is the identifiability problem of allele-specific-copy-number in another guise.\n- **Timing:** WGD is timeable relative to point mutations. Mutations that arose before WGD are carried at multiple copies (mutation copy number ~2); mutations after WGD sit at one copy. This dates WGD within the tumor's mutational history.\n\n## Calling Subclonal CN with Battenberg\n\n**Goal:** Fit clonal and subclonal allele-specific copy number genome-wide.\n\n**Approach:** Generate phased allele counts against a 1000 Genomes reference, run the Battenberg pipeline; segments that fit poorly as one integer state are split into a two-state subclonal mixture with a cellular fraction.\n\n```r\nlibrary(Battenberg)\n\n# Battenberg orchestrates allele counting, phasing, ASCAT clonal fit, and the\n# subclonal mixture step. Reference data (1000G impute panel) must be installed.\nbattenberg(\n    samplename          = 'tumour_id',\n    normalname          = 'normal_id',\n    sample_data_file    = 'tumour.bam',\n    normal_data_file    = 'normal.bam',\n    ismale              = TRUE,\n    imputeinfofile      = 'impute_info.txt',\n    g1000prefix         = '1000G_loci\u002F1000genomesloci2012_chr',     # SNP loci data\n    g1000allelesprefix  = '1000G_alleles\u002F1000genomesAlleles2012_chr', # SNP alleles (WGS)\n    problemloci         = 'probloci.txt',\n    gccorrectprefix     = 'GC_correction_hg38_chr',\n    repliccorrectprefix = 'RT_correction_hg38_chr',\n    genomebuild         = 'hg38',                                   # default is hg19\n    nthreads            = 8)\n# Output *_subclones.txt: per segment, nMaj1\u002FnMin1 (state 1) + frac1, and nMaj2\u002FnMin2 +\n# frac2 when the segment is subclonal (two states).\n```\n\n## Calling Subclonal CN with TITAN\n\n**Goal:** Jointly infer copy number, LOH, and the cellular prevalence of clonal clusters.\n\n**Approach:** TITAN needs both allele counts (het SNPs) and corrected read depth. Load the allele counts; correct tumour\u002Fnormal read depth for GC and mappability bias; overlay the resulting logR onto the het positions and log-transform; filter; then run the EM and sweep the cluster number — model selection picks the best.\n\n```r\nlibrary(TitanCNA)\n\n# Allele counts at het SNPs.\ndata \u003C- loadAlleleCounts('tumour.allelicCounts.tsv', genomeStyle = 'UCSC')\n\n# Read-depth correction is mandatory: correctReadDepth needs tumour + normal coverage\n# WIGs and GC + mappability WIGs. genomeStyle MUST match loadAlleleCounts above\n# (default 'NCBI' vs 'UCSC') or getPositionOverlap matches no chromosomes and logR is NA.\ncnData \u003C- correctReadDepth('tumour.wig', 'normal.wig', 'gc.wig', 'map.wig',\n                           genomeStyle = 'UCSC')\ndata$logR \u003C- log(2 ^ getPositionOverlap(data$chr, data$posn, cnData))\ndata \u003C- filterData(data, 1:24, minDepth = 10, maxDepth = 200, map = NULL)\n\nparams \u003C- loadDefaultParameters(copyNumber = 8, numberClonalClusters = 2,\n                                symmetric = TRUE, data = data)\nconv \u003C- runEMclonalCN(data, params, maxiter = 20, txnExpLen = 1e15)\nresults \u003C- viterbiClonalCN(data, conv)\n# Sweep numberClonalClusters (1..5) and compare model fit; the S_Dbw validity index\n# or the model log-likelihood selects the cluster number.\n```\n\n## Failure Modes\n\n### Subclonal call from insufficient depth or purity\n\n**Trigger:** Calling subclonal CN on shallow WGS or a low-purity tumor.\n\n**Mechanism:** A subclonal segment's signal is the clonal deviation scaled by the subclone's cell fraction — already small, and below the noise floor at low depth\u002Fpurity.\n\n**Symptom:** Many \"subclonal\" segments with implausibly low fractions; calls not reproducible across reruns or regions.\n\n**Fix:** Battenberg's ~3%-of-cells sensitivity assumes adequate WGS depth and purity. For low-depth or low-purity samples, treat only clonal CN as reliable and report subclonal calls as exploratory.\n\n### Mirrored subclonal allelic imbalance misread\n\n**Trigger:** A region where different subclones lost opposite haplotypes.\n\n**Mechanism:** Bulk BAF averages the two opposite losses toward 0.5, so the region can look balanced (clonal, no LOH) when it is in fact subclonally rearranged on both haplotypes.\n\n**Symptom:** A segment called clonal-balanced that conflicts with multi-region or single-cell data; BAF near 0.5 with an odd logR.\n\n**Fix:** Phasing (Battenberg) is required to detect mirrored subclonal allelic imbalance. Multi-region or single-cell data resolves it definitively; a single bulk sample can miss it.\n\n### WGD not called — every copy number off by a factor\n\n**Trigger:** Interpreting copy number without first establishing WGD status.\n\n**Mechanism:** The likelihood surface has near-equal modes at ploidy P and 2P; missing a WGD halves all copy numbers and mis-times every mutation.\n\n**Symptom:** Copy numbers and mutation copy numbers inconsistent; \"subclonal\" gains that are actually clonal post-WGD states.\n\n**Fix:** Call WGD explicitly (>50% of autosomes at major CN >= 2) from absolute allele-specific copy number. Cross-check ploidy against the odd\u002Feven CN fraction and clonal-SNV multiplicity before any subclonal interpretation.\n\n### Over-interpreting one subclonal segment as a subclone\n\n**Trigger:** Declaring a distinct tumor subclone from a single subclonal copy-number segment.\n\n**Mechanism:** A single segment at an intermediate fraction can arise from segmentation error, a mis-fit clonal state, or genuine subclonality — one segment cannot distinguish these.\n\n**Symptom:** A \"subclone\" supported by exactly one segment; clonal architecture claims that do not replicate.\n\n**Fix:** Require multiple concordant subclonal segments at a consistent cell fraction, ideally corroborated by SNV-based subclonal reconstruction (cancer cell fraction clustering) and multi-region sampling.\n\n### Single-region sampling misses spatial subclones\n\n**Trigger:** Inferring clonal architecture from one biopsy of a spatially heterogeneous tumor.\n\n**Mechanism:** A subclone confined to an unsampled region is invisible; a single region cannot capture branching evolution.\n\n**Symptom:** Apparently simple clonal architecture contradicted by a second biopsy.\n\n**Fix:** For evolution and architecture claims, use multi-region sampling and a phylogeny method (MEDICC2 for copy-number trees). Single-region subclonal calls describe that region only.\n\n## Reconciliation\n\n| Pattern | Likely cause | Action |\n|---------|--------------|--------|\n| Battenberg subclonal vs TITAN clonal | Different mixture models; cluster number | Sweep TITAN clusters; compare cell fractions |\n| WGD called by one tool, not another | Integer-multiple ploidy ambiguity | Check odd\u002Feven CN fraction and SNV multiplicity |\n| Many low-fraction subclonal segments | Depth\u002Fpurity too low | Trust only clonal CN; flag subclonal as exploratory |\n| Subclonal CN vs SNV-based CCF disagree | CN and SNV subclones need not coincide | Integrate both; they answer different questions |\n\n**Operational rule:** Report subclonal copy number as confident only when (1) depth and purity support it, (2) WGD status is established from absolute allele-specific CN, (3) multiple concordant segments support a subclone at a consistent fraction, and (4) for evolution claims, multi-region data and a copy-number phylogeny are used. A single subclonal segment is a hypothesis, not a subclone.\n\n## Quantitative Thresholds\n\n| Threshold | Value | Source \u002F Rationale |\n|-----------|-------|--------------------|\n| Battenberg subclonal sensitivity | ~3% of cells | Nik-Zainal 2012; requires adequate WGS depth\u002Fpurity |\n| WGD definition | > 50% of autosomes at major CN >= 2 | Bielski 2018; the operational WGD call |\n| WGD median ploidy | ~3.3 (WGD) vs ~2.1 (non-WGD) | Bielski 2018 pan-cancer |\n| Pre-WGD mutation copy number | >= ~1.75 | Pre-doubling mutations carried at multiple copies |\n| TITAN clonal clusters | sweep 1-5, select by fit | Few clusters resolvable from one bulk sample |\n\n## Common Errors\n\n| Error \u002F symptom | Cause | Solution |\n|-----------------|-------|----------|\n| Battenberg install\u002Frun fails | GitHub-only; missing 1000G reference | Install from GitHub; set up the impute reference |\n| Non-integer segments treated as noise | Subclonal CNA not modeled | Use Battenberg\u002FTITAN, not a clonal-only caller |\n| All copy numbers half\u002Fdouble expected | WGD not called | Establish WGD from absolute CN; check SNV multiplicity |\n| Subclones not reproducible | Low depth\u002Fpurity, single segment | Require depth, concordant segments, multi-region |\n| Balanced region conflicts with other data | Mirrored subclonal allelic imbalance | Use phased (Battenberg) or single-cell data |\n| TITAN cluster number arbitrary | Cluster count not swept | Sweep 1-5; select by model fit |\n\n## References\n\n- Nik-Zainal S et al 2012. The life history of 21 breast cancers (Battenberg). Cell 149:994\n- Ha G et al 2014. TITAN: inference of copy number architectures in clonal cell populations from tumor whole-genome sequence data. Genome Res 24:1881\n- Bielski CM et al 2018. Genome doubling shapes the evolution and prognosis of advanced cancers. Nat Genet 50:1189\n- Dewhurst SM et al 2014. Tolerance of whole-genome doubling propagates chromosomal instability. Cancer Discov 4:175\n- Kaufmann TL et al 2022. MEDICC2: whole-genome doubling aware copy-number phylogenies for cancer evolution. Genome Biol 23:241\n\n## Related Skills\n\n- copy-number\u002Fallele-specific-copy-number - Clonal allele-specific CN, purity, ploidy\n- copy-number\u002Fcopy-ratio-segmentation - Segmentation feeding subclonal callers\n- copy-number\u002Fhrd-scoring - Whole-genome-doubling correction for LST\n- copy-number\u002Frecurrent-cnv - Copy-number signatures including WGD and chromothripsis\n- copy-number\u002Fcnv-visualization - Visualizing subclonal segments and BAF\n- variant-calling\u002Fvcf-basics - SNV calls for cancer cell fraction and WGD timing\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","mixed","2026-09-20","copy-number\u002Fsubclonal-copy-number\u002FSKILL.md","battenberg","GPTomics\u002FbioSkills","main","2d1750717747097b602acf30bd09a7cbd4b4c6ea","awesome_skills\u002Fbiology\u002Fbio-copy-number-subclonal-copy-number","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-copy-number-subclonal-copy-number",{"tool":42,"command":43},"bunx","bunx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-copy-number-subclonal-copy-number",{"tool":45,"command":46},"pnpm","pnpm dlx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill bio-copy-number-subclonal-copy-number","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-copy-number-subclonal-copy-number\u002FSKILL.md",true,[50,56],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"examples\u002Frun_titan.R","OTHER","其他",3903,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-copy-number-subclonal-copy-number\u002Fexamples\u002Frun_titan.R",{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"usage-guide.md","REFERENCE","参考文档",4210,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fbiology\u002Fbio-copy-number-subclonal-copy-number\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",[],[]]