bio-crispr-screens-hit-calling
Cross-method decision tree for calling hits in pooled CRISPR screens. Catalogs statistical models (MAGeCK RRA, MAGeCK MLE, BAGEL2, drugZ, JACKS, Chronos, CERES), experimental designs each is built for, failure modes outside design domain, reconciliation when methods disagree, multiple-testing and effect-size thresholds, the order of operations (count -> QC -> CN-correct -> hit-call -> validate), the second-best-sgRNA conservative rule, and consensus-hit strategy. Use when choosing among MAGeCK / BAGEL2 / drugZ / JACKS / Chronos for a given design, reconciling disagreement across two or three methods on the same screen, deciding whether to require consensus, gating downstream validation by hit-confidence tier, or interpreting unstable hit lists across reruns.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-12
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- bio-crispr-screens-hit-calling
- tool_type
- mixed
- description
- Cross-method decision tree for calling hits in pooled CRISPR screens. Catalogs statistical models (MAGeCK RRA, MAGeCK MLE, BAGEL2, drugZ, JACKS, Chronos, CERES), experimental designs each is built for, failure modes outside design domain, reconciliation when methods disagree, multiple-testing and effect-size thresholds, the order of operations (count -> QC -> CN-correct -> hit-call -> validate), the second-best-sgRNA conservative rule, and consensus-hit strategy. Use when choosing among MAGeCK / BAGEL2 / drugZ / JACKS / Chronos for a given design, reconciling disagreement across two or three methods on the same screen, deciding whether to require consensus, gating downstream validation by hit-confidence tier, or interpreting unstable hit lists across reruns.
- primary_tool
- MAGeCK
02 资源文件 2
- 脚本examples/consensus_hits.py2.3 KB
- 参考文档usage-guide.md8.9 KB
03 SKILL.md 正文
Version Compatibility
Reference examples tested with: MAGeCK 0.5.9+, BAGEL2 2.0, drugZ Aug 2019+, JACKS 0.2.0+, Chronos 2.0+ (DepMap), CERES 1.0+, pandas 2.2+, numpy 1.26+, scipy 1.12+, statsmodels 0.14+.
Before using code patterns, verify installed versions match. If versions differ:
- CLI:
mageck --version,BAGEL.py version,python drugz.py --help - Python:
pip show crispr_chronos(JACKS installs from GitHub, not PyPI)
If code throws ImportError, AttributeError, or TypeError, introspect the installed package and adapt the example to match the actual API rather than retrying.
Hit Calling Decision Tree
"Identify significant hits in my CRISPR screen" -> Choose the analysis method that matches the experimental design, statistical assumptions, and quality grade of the screen. Reconcile across methods when high-stakes hits must be validated.
The primary hit-calling methods cover non-overlapping niches; the decision is not "which is best" but "which matches the design."
| Design / question | Primary method | Why | Secondary check |
|---|---|---|---|
| Two-condition essentiality, one cell line, no CN concerns | MAGeCK RRA | Robust, fast, gold-standard for ranked analysis | BAGEL2 (Bayes factor on same data) |
| Time course (3+ timepoints) | MAGeCK MLE | RRA cannot model multi-condition | JACKS (efficacy-aware) |
| Multi-cell-line panel (cancer dependency) | Chronos | Models CN bias + screen quality jointly | MAGeCK MLE per line + meta-analysis |
| Drug screen (vehicle vs drug) | drugZ | Bidirectional Z; vehicle-anchored | MAGeCK MLE with dose covariate |
| Multi-screen joint, same library | JACKS | Shared efficacy; enables ~2.5x smaller screens | MAGeCK MLE; results should converge |
| Essentiality classification with reference sets | BAGEL2 | Bayes factor with CEGv2/NEGv1 calibration | MAGeCK RRA |
| Combinatorial / paired guide | MAGeCK MLE with GI scoring | Models interaction term; see [[combinatorial-screens]] | Custom GI scoring |
| Single-cell perturbation (Perturb-seq) | SCEPTRE | NB GLM + permutation; see [[perturb-seq-analysis]] | Mixscape pre-filter |
| Cancer-line copy-number screen | Chronos (preferred) or CERES | Joint CN-bias + gene-effect modeling; see [[copy-number-correction]] | CRISPRcleanR pre-hoc + MAGeCK |
Statistical Models Compared
| Method | Year | Statistical model | Tests | Best for | Fails when |
|---|---|---|---|---|---|
| MAGeCK RRA | 2014 | NB per-sgRNA -> alpha-RRA per gene | Two-sided | General two-condition | >40% guides change (median norm breaks); time course; cancer-line CN |
| MAGeCK MLE | 2015 | NB GLM with design matrix; per-gene beta | Wald per condition | Multi-condition / time course | Cell-line specific essentiality; CN bias |
| BAGEL2 | 2021 | Bayes factor from log-likelihood ratio | Essential vs non-essential | Essentiality classification | Non-essentiality screens; drug screens |
| drugZ | 2019 | Bidirectional Z-score on guide-level LFC | Sensitizer vs suppressor | Drug-modifier / chemogenomic | Essentiality (no biological prior); time-course |
| JACKS | 2019 | Variational Bayes: LFC = gene * efficacy | Per-gene posterior | Multi-screen joint, library calibration | Single screen; cross-chemistry |
| Chronos | 2021 | Cell-population dynamics ODE + NB | Gene effect adjusted for screen quality | Cancer-line panels, longitudinal | Single screen; non-cancer applications |
| CERES | 2017 | Nonlinear model decoupling CN-bias from gene effect | Per-gene effect | Cancer-line panel with CN profile | Superseded by Chronos at DepMap |
RRA vs MLE Within MAGeCK
| Property | RRA (mageck test) |
MLE (mageck mle) |
|---|---|---|
| Conditions supported | 2 | Multiple (design matrix) |
| Statistical test | Robust rank aggregation | Wald on beta from NB GLM |
| Output | neg/pos score, FDR per direction | beta per condition |
| sgRNA efficiency | Not modeled (optional fixed input) | Modeled via --sgrna-efficiency |
| Outlier robustness | High (rank-based) | Lower (likelihood-based) |
| Best for | Standard 2-condition screen | Time course, drug screen, multi-cell-line, paired |
| Speed | Fast | Slow (per-gene optimization) |
Algorithmic Taxonomy: Why Each Was Built
| Method | Designed to solve |
|---|---|
| MAGeCK RRA | First robust statistical framework for CRISPR-screen ranking; alpha-RRA borrowed from RRA in microarray meta-analysis |
| MAGeCK MLE | Extend MAGeCK to multi-condition; explicit beta scores allow direct LFC interpretation |
| BAGEL2 | Reference-set-anchored Bayesian classification; precision-recall calibrated; tumor-suppressor sensitivity (BAGEL1 was uni-directional) |
| drugZ | Drug-modifier screens have low effect sizes and need bidirectional sensitivity; STARS/MAGeCK miss synthetic-lethal hits |
| JACKS | Sample-size reduction via library-shared efficacy; library calibration as side product |
| Chronos | DepMap-scale (1000+ cell lines, billions of cell-divisions) needs population-dynamics model; CN bias + screen quality first-class |
| CERES | First to formally decouple CN from gene effect at DepMap scale; superseded but historically important |
Run All Five on the Same Data (Consensus Strategy)
Goal: For high-stakes hits (drug-target nomination, paper-level claims), require agreement across 2-3 orthogonal methods.
Approach: Run MAGeCK + BAGEL2 + (drugZ or JACKS) on the same count matrix; rank by each; classify hits as called by 1, 2, or 3 methods.
import pandas as pd
from scipy.stats import hypergeom
def _check_comparable(merged, hit_cols):
'''Warn if any pair of method hit-sets shows no statistical enrichment for
overlap -- the signature of merging results that answer different questions
(e.g. a real essentiality MAGeCK+BAGEL2 pair merged against a drugZ table from
an unrelated drug-vs-vehicle screen) rather than genuine method disagreement on
the same comparison. Verified on real data: matched MAGeCK/BAGEL2 hit sets give
p=0 (highly enriched overlap); a mismatched drugZ table against either gives
p=1.0 (no enrichment) -- see the Failure Modes entry below.'''
n = len(merged)
warnings = []
for i, col_a in enumerate(hit_cols):
for col_b in hit_cols[i + 1:]:
a, b = merged[col_a].fillna(False), merged[col_b].fillna(False)
k, K, N = int((a & b).sum()), int(a.sum()), int(b.sum())
if K == 0 or N == 0:
continue
p = hypergeom.sf(k - 1, n, K, N)
if p > 0.05:
warnings.append(f'{col_a} vs {col_b}: overlap not enriched above chance '
f'(observed={k}, expected~{K * N / n:.1f}, p={p:.3f}) -- '
'check these came from the SAME experimental comparison '
'before trusting consensus.')
for w in warnings:
print(f'WARNING: {w}')
return warnings
def consensus_hits(mageck_path, bagel_path, drugz_path,
mageck_fdr_thresh=0.05, bagel_bf_thresh=6, drugz_fdr_thresh=0.05):
'''Build consensus across MAGeCK / BAGEL2 / drugZ on the same screen.
Each hit gets a count of supporting methods. Defaults match the Quantitative
Thresholds table below -- keep this function and examples/consensus_hits.py in
sync with that table, not with each other.'''
mageck = pd.read_csv(mageck_path, sep='\t')[['id', 'neg|fdr']].rename(columns={'id': 'gene', 'neg|fdr': 'mageck_neg_fdr'})
bagel = pd.read_csv(bagel_path, sep='\t')[['GENE', 'BF']].rename(columns={'GENE': 'gene', 'BF': 'bagel_bf'})
drugz = pd.read_csv(drugz_path, sep='\t')[['GENE', 'fdr_synth']].rename(columns={'GENE': 'gene', 'fdr_synth': 'drugz_synth_fdr'})
merged = mageck.merge(bagel, on='gene', how='outer').merge(drugz, on='gene', how='outer')
merged['mageck_hit'] = merged['mageck_neg_fdr'] < mageck_fdr_thresh
merged['bagel_hit'] = merged['bagel_bf'] > bagel_bf_thresh
merged['drugz_hit'] = merged['drugz_synth_fdr'] < drugz_fdr_thresh
_check_comparable(merged, ['mageck_hit', 'bagel_hit', 'drugz_hit'])
merged['consensus_count'] = (merged[['mageck_hit', 'bagel_hit', 'drugz_hit']].astype(int)).sum(axis=1)
return merged.sort_values('consensus_count', ascending=False)
Confidence tiers:
| Tier | Definition | Validation requirement |
|---|---|---|
| Tier 1 (high) | Called by 3/3 methods | Arrayed validation; orthogonal modality (CRISPRi if originally Cas9) |
| Tier 2 (medium) | Called by 2/3 methods | Arrayed validation in matched line |
| Tier 3 (exploratory) | Called by 1/3 methods | Treat as hypothesis; further screens before publication |
Reconciliation: When Two Methods Disagree
| Pattern | Likely cause | Action |
|---|---|---|
| MAGeCK significant, BAGEL2 not | BAGEL2 trained on CEGv2/NEGv1; gene is essential but not in reference | Trust MAGeCK; flag for follow-up |
| BAGEL2 significant, MAGeCK not | BAGEL2 has tumor-suppressor sensitivity MAGeCK lacks | Investigate sgrna_summary for one weak guide |
| MAGeCK significant, JACKS not | JACKS down-weighted one outlier guide | Trust JACKS if guides agree; outlier may be off-target |
| Chronos and MAGeCK disagree on cancer line | Chronos accounts for CN; MAGeCK does not | Trust Chronos; apply [[copy-number-correction]] |
| drugZ significant, MAGeCK not on drug screen | drugZ bidirectional Z is more sensitive | Trust drugZ for chemogenomic; MAGeCK may miss small effects |
| MAGeCK MLE significant, MAGeCK RRA not in 2-condition | Beta-score effect size is significant but rank-based not | Trust MLE if guides consistent; RRA may be over-conservative |
| All methods disagree | Either no real biology or all methods are mis-applied | Stop. Re-audit QC; check chemistry / library / design matrix |
| BAGEL2 BF changes between reruns on identical input -- not a real method disagreement, but easy to mistake for one | BAGEL2's bf step defaults to a clock-derived random seed; two unseeded runs on the same real HAP1 TKOv3 data differed by up to 26.7 BF and flipped 33/18,053 genes across BF>6 |
Always pass a fixed -s <int> seed to fc/bf/pr and verify two reruns are byte-identical before trusting any single BF table or treating a rerun difference as new biology -- see [[bagel-essentiality]]'s "Reproducibility: Fixing the Random Seed" section |
Second-Best sgRNA Conservative Rule
Goal: Reduce false positives from single outlier sgRNAs by requiring the second-most-extreme guide per gene to also be a hit.
Approach: For each gene, sort sgRNAs by LFC; require the second-best LFC to exceed a threshold. Rejects genes that depend on one extreme guide.
def second_best_lfc(sgrna_lfc_df, genes_series, direction='neg'):
'''Return per-gene LFC of the second-best sgRNA in the direction of interest,
and flag genes with fewer than 2 sgRNAs. For dropout (direction="neg"),
second-most-negative LFC. A gene with only one sgRNA has no second guide to
check at all -- return NaN and single_guide=True for it rather than silently
falling back to the lone guide's own LFC, which would read as "passing" the
rule with no corroborating guide involved.'''
results = []
for gene in genes_series.unique():
gene_lfc = sgrna_lfc_df[genes_series == gene].sort_values()
n = len(gene_lfc)
if n >= 2:
second = gene_lfc.iloc[1] if direction == 'neg' else gene_lfc.iloc[-2]
single = False
else:
second = float('nan')
single = True
results.append({'gene': gene, 'second_best_lfc': second, 'single_guide': single})
return pd.DataFrame(results)
Rule: A high-confidence hit has second-best LFC also passing the threshold. A guide-of-one hit has only one extreme guide and should be flagged for orthogonal validation. This rule predates JACKS and is implicit in MAGeCK RRA but explicit elsewhere. Genes with single_guide=True (fewer than 2 sgRNAs in the library) have no second guide to check by construction -- always send these to orthogonal validation rather than treating a NaN second-best LFC as a pass.
Multiple-Testing Correction Conventions
| Method | Native correction | Cross-method comparison |
|---|---|---|
| MAGeCK RRA | BH per direction | `neg |
| MAGeCK MLE | BH per condition | `<cond> |
| BAGEL2 | Bootstrap BF; reports BF threshold | BF > 6 ≈ 90% posterior (Hart 2017); ~5% FDR by convention |
| drugZ | BH per direction | fdr_synth, fdr_supp |
| JACKS | Posterior probability + BH | fdr_log10 (log10 FDR) |
| Chronos | DepMap gene-effect probability | effect_probability |
Reconciliation: BF >6 in BAGEL2 corresponds to ~90% posterior probability (Hart 2017 G3, by overlap with CEGv2) and is commonly used as a stringent cutoff roughly comparable to MAGeCK FDR 0.05. Treat that equivalence as an approximate convention, not an exact calibration. drugZ FDR is per-direction; the fdr_synth and fdr_supp columns are independent BH corrections.
Correlating MAGeCK and BAGEL2 Scores (Sign/Scale Caution)
neg|score (MAGeCK RRA) is p-value-like: smaller = more essential. BF (BAGEL2) is a
log-likelihood ratio: larger = more essential. The two statistics run in opposite directions on
the same biology. Computing Spearman rho directly between the raw columns therefore produces a
strongly negative number even when the methods agree strongly -- sign-correct one column first
(use -neg|score) before comparing rho to a disagreement threshold.
Worked example, real HAP1 TKOv3 T0-vs-T18 data (n=18,053 genes with both scores):
| Comparison | Spearman rho |
|---|---|
| `neg | scorevsBF`, uncorrected |
| `-neg | scorevsBF`, sign-corrected |
Both rows describe the same real agreement between MAGeCK and BAGEL2 on this screen -- only the
sign flips. Applying a literal "rho <0.6 means disagreement" rule to the uncorrected row would
falsely flag two methods that in fact concur strongly. Always sign-correct before comparing rho
to a threshold, and note it in whatever you report ("rho = 0.81 after sign-correcting neg|score
to make both statistics increase with essentiality").
Order of Operations
1. Library design (see library-design) <- design quality dictates hit calling
2. Plasmid pool sequencing <- baseline; non-negotiable
3. Run screen at MOI 0.3, 500x coverage
4. Sequence endpoint
5. Run mageck count <- generates raw + normalized counts
6. Screen QC (see screen-qc) <- gates downstream method choice
7. Copy-number correction if cancer line <- CRISPRcleanR or Chronos; see copy-number-correction
8. Batch correction if multi-batch <- see batch-correction
9. Hit calling (this skill) <- choose method by design
10. Consensus across 2-3 methods <- for high-stakes hits
11. Orthogonal validation <- arrayed; different chemistry
12. Pathway analysis <- see pathway-analysis/gsea
Custom z-score Hit Calling (when standard tools don't fit)
Goal: Compute gene-level z-scores when neither MAGeCK nor BAGEL2 fits the experimental design.
Approach: RPM-normalize, compute per-sgRNA log2 fold-changes, aggregate to gene level, derive z-score from the null distribution of non-targeting controls (cleanest) or all genes (assumes <40% changing), apply BH correction.
import pandas as pd
import numpy as np
from scipy import stats
from statsmodels.stats.multitest import multipletests
def custom_zscore_hit_calling(counts_df, ctrl_cols, treat_cols, genes_series, ntc_genes=None):
'''Z-score gene-level hit calling. If ntc_genes provided, null derived from NTCs only;
otherwise from all genes (assumes <40% changing).'''
def rpm(df):
return df.div(df.sum(axis=0), axis=1) * 1e6
ctrl_rpm = rpm(counts_df[ctrl_cols])
treat_rpm = rpm(counts_df[treat_cols])
lfc_per_sgrna = np.log2((treat_rpm.mean(axis=1) + 1) / (ctrl_rpm.mean(axis=1) + 1))
gene_lfc = pd.DataFrame({'gene': genes_series, 'lfc': lfc_per_sgrna}).groupby('gene')['lfc'].agg(['mean', 'std', 'count'])
gene_lfc.columns = ['mean_lfc', 'std_lfc', 'n_sgrnas']
if ntc_genes is not None:
null = gene_lfc.loc[gene_lfc.index.isin(ntc_genes), 'mean_lfc']
null_mean, null_std = null.median(), null.std()
else:
null_mean = gene_lfc['mean_lfc'].median()
null_std = gene_lfc['mean_lfc'].std()
gene_lfc['z'] = (gene_lfc['mean_lfc'] - null_mean) / null_std
gene_lfc['p'] = 2 * stats.norm.sf(np.abs(gene_lfc['z']))
gene_lfc['fdr'] = multipletests(gene_lfc['p'], method='fdr_bh')[1]
return gene_lfc.sort_values('z')
Failure Modes
MAGeCK and BAGEL2 disagree by 200+ hits at FDR 0.05
Trigger: Heavy-selection screen (>40% guides change) or cancer-line CN bias.
Mechanism: MAGeCK median normalization breaks; BAGEL2 is robust due to reference-set anchoring.
Symptom: MAGeCK hit list inflated; BAGEL2 list closer to expected size.
Fix: Run MAGeCK with --norm-method control; apply CN correction; trust BAGEL2 for essentiality.
Chronos and MAGeCK disagree at the top 10 in a cancer line
Trigger: Top hits are at amplified loci. Mechanism: Chronos models CN bias; MAGeCK does not. Symptom: ERBB2 in HER2+, MYC in MYC-amplified, etc. are top hits in MAGeCK but not Chronos. Fix: Apply [[copy-number-correction]] before MAGeCK or switch to Chronos.
drugZ and MAGeCK disagree on small-effect drug-modifier screen
Trigger: Effect size is small; MAGeCK rank-based test is less sensitive than drugZ bidirectional Z. Mechanism: drugZ specifically optimized for small effects in drug screens (Colic et al. 2019); MAGeCK RRA loses sensitivity at small effects. Symptom: At matched FDR, drugZ calls small-effect chemogenomic interactions (e.g. DDR genes) that MAGeCK RRA misses, with stronger expected-pathway enrichment. Fix: Use drugZ as primary for chemogenomic; MAGeCK as confirmatory. See [[drugz-chemogenomic]].
JACKS down-weights efficiency, MAGeCK doesn't, disagreement
Trigger: A gene has one or two strong sgRNAs and 2-3 weak ones; MAGeCK averages them, JACKS down-weights the weak. Mechanism: JACKS variational Bayes correctly identifies low-efficacy guides; MAGeCK aggregates without this prior. Symptom: Gene is JACKS hit but not MAGeCK. Fix: Inspect per-sgRNA LFC; if strong guides are consistent, JACKS is correct. Validate gene orthogonally.
Consensus across 3 methods is empty (no hits)
Trigger: Either no real biology, each method hits a different failure mode, or -- easy to
overlook -- the merged files are not from the same experimental comparison.
Mechanism: Screen quality is low and signal-to-noise across all methods is poor; OR each
input file is individually valid but answers a different question (e.g. a real essentiality
MAGeCK+BAGEL2 pair merged against a drugZ table from an unrelated drug-vs-vehicle screen run on
the same library). consensus_hits() merges without error either way -- verified on real data:
merging matched MAGeCK/BAGEL2 essentiality output with a real but unrelated drugZ drug-screen
table produced a 0-gene Tier-1 consensus even though the underlying essentiality screen has
100% precision against CEGv2/NEGv1 (see Input 1's numbers).
Symptom: Tier 1 consensus list is empty.
Fix: Check each input file's own QC first (screen-qc PR-AUC, precision/recall against
CEGv2/NEGv1) -- a high-precision screen with an empty 3-method consensus points to a mismatched
file, not a bad screen. consensus_hits()'s _check_comparable() warning (above) also fires
when a pair's hit-set overlap is no better than chance, the statistical signature of a
mismatched comparison. Only re-audit QC once a same-comparison mismatch has been ruled out.
Quantitative Thresholds
| Threshold | Value | Source / Rationale |
|---|---|---|
| MAGeCK RRA FDR (gene-level) | <0.05 | Li 2014; standard publication |
| MAGeCK RRA LFC | abs(LFC) >1 | 2-fold; biological |
| BAGEL2 Bayes Factor | >6 standard; >12 stricter | Hart 2017; BAGEL convention |
| drugZ FDR | <0.05 per direction | Colic et al. 2019 |
| JACKS fdr_log10 | <-1 (FDR <0.1); <-2 (FDR <0.01) | Standard FDR convention |
| Chronos dependency probability | >0.5 | DepMap convention (dependency-probability cutoff) |
| Tier 1 consensus (3 methods) | 100% agreement | High confidence; minimal validation needed |
| Tier 2 consensus (2 of 3) | 67% agreement | Arrayed validation required |
| Tier 3 (1 method only) | Hypothesis; flag for follow-up | Multiple screens or arrayed required |
| Second-best sgRNA rule | Second-best LFC also passes threshold | Reduces single-guide outliers |
This table is the canonical source for MAGeCK-FDR/BAGEL-BF defaults: consensus_hits() in this
file and examples/consensus_hits.py must both use FDR<0.05/BF>6 to match it. On real HAP1
TKOv3 data, FDR<0.05/BF>6 gives 844 Tier-1 consensus genes; the looser FDR<0.1/BF>5 pairing gives
1131 (+34%) -- pick one number, not whichever default a given script happens to hardcode.
Common Errors
| Error / symptom | Cause | Solution |
|---|---|---|
| All genes significant in MAGeCK RRA | Heavy selection breaks median norm | --norm-method control; or use BAGEL2 |
| BAGEL2 returns no hits despite known essentials | Wrong reference gene set | Verify CEGv2/NEGv1 files match library |
| drugZ output empty | Used Day 0 as control instead of vehicle | Re-run with vehicle as control |
| Chronos errors out | Missing CN profile for cell line | Use CRISPRcleanR (unsupervised) instead |
| Methods disagree by orders of magnitude | Quality issue or design mismatch | Re-audit QC; reconcile via tier consensus |
| Empty tier 1 consensus | No real biology, QC failure, OR merged files are not from the same experimental comparison | Check per-method QC (screen-qc) and _check_comparable()'s overlap-enrichment warning first; verify all inputs are the same comparison; only then re-audit QC |
| Single-guide-driven hits, or genes with only 1 sgRNA in the library | Outlier sgRNA, or library design has no second guide to check | Apply second-best rule; treat single_guide=True the same as a failed check; orthogonal validate |
| BAGEL2 BF differs between two runs on the same input | bf step unseeded by default (clock-derived) |
Always pass -s <fixed-int>; see [[bagel-essentiality]] Reproducibility section |
References
- Li W et al. 2014. Genome Biol 15:554. MAGeCK alpha-RRA.
- Li W et al. 2015. Genome Biol 16:281. MAGeCK MLE.
- Kim E & Hart T. 2021. Genome Med 13:2. BAGEL2.
- Colic M et al. 2019. Genome Med 11:52. drugZ.
- Allen F et al. 2019. Genome Res 29:464. JACKS.
- Dempster J et al. 2021. Genome Biol 22:343. Chronos.
- Meyers R et al. 2017. Nat Genet 49:1779. CERES.
- Hart T & Moffat J. 2016. BMC Bioinformatics 17:164. BAGEL Bayes factor framework.
- Hart T et al. 2017. G3 7:2719. CEGv2/NEGv1 calibration.
Related Skills
- crispr-screens/mageck-analysis - Full MAGeCK RRA + MLE detail
- crispr-screens/bagel-essentiality - Full BAGEL2 detail
- crispr-screens/drugz-chemogenomic - Full drugZ detail for drug screens
- crispr-screens/jacks-analysis - Full JACKS detail and library calibration
- crispr-screens/copy-number-correction - Chronos, CERES, CRISPRcleanR
- crispr-screens/screen-qc - Quality gates that drive method choice
- crispr-screens/library-design - Library type dictates analysis method
- crispr-screens/combinatorial-screens - GI scoring (synthetic lethality)
- crispr-screens/perturb-seq-analysis - SCEPTRE for single-cell screens
- crispr-screens/batch-correction - Multi-batch normalization upstream of hit calling
- pathway-analysis/gsea - Downstream pathway enrichment
- pathway-analysis/go-enrichment - GO enrichment of hit lists
04 同仓库更多 Skills
bio-workflows-metabolomics-pipeline
Orchestrates the untargeted LC-MS metabolomics pipeline end-to-end (xcms 4.x feature extraction, QC/drift/normalization, confidence-stratified annotation, permutation-validated statistics, background-aware pathway mapping), naming what each stage decides and where it silently fails. Use when running a full LC-MS metabolomics study from raw mzML to enriched pathways and needing the honest handoffs between stages. Each stage defers to its component skill for parameters and traps; for stable-isotope flux (a separate branch, not this untargeted flow) see metabolomics/isotope-tracing.
bio-metabolomics-xcms-preprocessing
Programmatic untargeted LC-MS feature extraction in R with the modern xcms 4.x MsExperiment/XcmsExperiment API, taking raw mzML to a feature table via CentWave peak detection, retention-time alignment, peak-density correspondence, gap-filling, CAMERA redundancy collapse, and built-in QC feature filtering. Use when converting centroided LC-MS runs into a features-by-samples matrix and deciding centWave/grouping/alignment parameters. For drift correction and QC/CV filtering execution see metabolomics/normalization-qc; for metabolite identification see metabolomics/metabolite-annotation; for the MS-DIAL GUI alternative with MS2Dec deconvolution see metabolomics/msdial-preprocessing; for downstream statistics see metabolomics/statistical-analysis.
bio-metabolomics-statistical-analysis
Decision-grade statistical analysis for metabolomics intensity tables. Covers transformation and scaling (Pareto vs unit-variance as a hidden hypothesis), unsupervised structure (PCA/HCA for QC), permutation-validated PLS-DA/OPLS-DA (R2 vs Q2, double CV, VIP as heuristic), univariate testing (Welch/Mann-Whitney/ANOVA/LMM with covariate adjustment), and dependence-aware multiple testing. Use when testing which metabolites differ, building or validating a discriminant model, choosing a scaling, or correcting many correlated tests. For sample-wise normalization/drift correction see metabolomics/normalization-qc; for ML classifiers and selection-inside-CV leakage see machine-learning/biomarker-discovery and machine-learning/model-validation; for pathway interpretation see metabolomics/pathway-mapping; for design/power/multiplicity regime see experimental-design/multiple-testing.
bio-metabolomics-pathway-mapping
Maps metabolomics results to biological pathways via over-representation (ORA), metabolite-set enrichment (MSEA/QEA), mummichog/PSEA on raw m/z peaks, and network-diffusion enrichment (FELLA), with correct background-set construction and honest interpretive ceilings. Use when interpreting differential metabolites or an untargeted LC-MS feature table in pathway context, choosing ORA vs MSEA vs mummichog vs topology, or setting the reference/background set. For annotation confidence levels feeding ORA see metabolomics/metabolite-annotation; for gene-set concepts see pathway-analysis/go-enrichment and pathway-analysis/gsea; for joint gene+metabolite pathways see multi-omics-integration/mofa-integration.
bio-metabolomics-normalization-qc
Designs QC, corrects signal drift, removes batch effects, filters features, normalizes samples, and imputes missing values for untargeted LC-MS/GC-MS metabolomics, framing each step as a measurement model that can create or erase biological signal. Use when processing a peak/feature table before statistical analysis, choosing a drift-correction or sample-normalization method, deciding QC RSD vs D-ratio filtering, or handling left-censored missing values. The feature table is produced by metabolomics/xcms-preprocessing or metabolomics/msdial-preprocessing; transformation/scaling for modeling defers to metabolomics/statistical-analysis; cross-study design issues link to experimental-design/batch-design.
bio-metabolomics-msdial-preprocessing
Runs the MS-DIAL preprocessing workflow (peak picking, MS2Dec spectral deconvolution, alignment, gap-filling) and imports the alignment-result table into R or Python with honest filtering. Use when preprocessing LC-MS DDA/DIA (SWATH) or GC-MS raw data with MS-DIAL, deciding MS-DIAL vs XCMS, configuring the MSDIALCUI console run, or parsing an MS-DIAL export into a clean feature matrix. For programmatic R peak detection and the feature-table-as-artifact framing see metabolomics/xcms-preprocessing; for lipid annotation mode see metabolomics/lipidomics; for MSI-level confidence honesty see metabolomics/metabolite-annotation; for drift correction and QC see metabolomics/normalization-qc.