annotate mageck_mle.xml @ 0:79cfebdd24c8 draft

planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
author iuc
date Wed, 14 Feb 2018 06:09:32 -0500
parents
children 157b8bc9510a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
1 <?xml version="1.0"?>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
2 <tool id="mageck_mle" name="MAGeCK mle" version="@VERSION@" >
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
3 <description>- perform maximum-likelihood estimation of gene essentiality scores</description>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
4 <macros>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
5 <import>mageck_macros.xml</import>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
6 </macros>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
7 <expand macro="requirements" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
8 <expand macro="version" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
9 <command detect_errors="exit_code"><![CDATA[
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
10
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
11 mageck mle
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
12
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
13 -k '$count_table'
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
14
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
15 #if $samples.sample_select == "dmatrix":
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
16 -d '$samples.design_matrix'
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
17 #elif $samples.sample_select == "labels":
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
18 --day0-label '$samples.day0_label'
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
19 -i '$samples.include_samples'
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
20 -b '$samples.beta_labels'
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
21 #end if
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
22
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
23 -n output
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
24
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
25 #if $adv.control_sgrna:
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
26 --control-sgrna $adv.control_sgrna
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
27 #end if
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
28
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
29 #if $adv.cnv_norm:
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
30 --cnv-norm $adv.cnv_norm
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
31 #end if
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
32
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
33 --norm-method $adv.norm_method
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
34 --genes-varmodeling $adv.genes_var
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
35 --permutation-round $adv.permutation
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
36 --adjust-method $adv.adjust_method
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
37
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
38 #if $adv.sgrnaeff_file:
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
39 --sgrna-efficiency $adv.sgrnaeff_file
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
40 --sgrna-eff-name-column $adv.sgrnaid_col
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
41 --sgrna-eff-score-column $adv.sgrnaeff_col
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
42 #end if
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
43
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
44 $adv.remove_outliers
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
45 $adv.update_eff
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
46 --threads \${GALAXY_SLOTS:-1}
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
47
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
48 ]]></command>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
49 <inputs>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
50 <param name="count_table" argument="--count-table" type="data" format="tabular" label="Counts file"
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
51 help="Provide a tab-separated count table. Each line in the table should include sgRNA name (1st column), target gene (2nd column) and read counts in each sample. See Help below for more information" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
52 <conditional name="samples">
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
53 <param name="sample_select" type="select" label="Design matrix or sample labels" help="You can choose to either provide a design matrix or specify the samples">
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
54 <option value="dmatrix">Design matrix</option>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
55 <option value="labels">Specify samples</option>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
56 </param>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
57 <when value="dmatrix">
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
58 <param name="design_matrix" argument="--design-matrix" type="data" format="tabular" label="Design Matrix file" help="Provide a design matrix, either a file name or a quoted string of the design matrix. For example, 1,1;1,0. The row of the design matrix must match the order of the samples in the count table (if --include-samples is not specified), or the order of the samples by the --include-samples option" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
59 </when>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
60 <when value="labels">
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
61 <param name="include_samples" argument="--include-samples" type="text" label="Sample labels" help="Specify the sample labels if the design matrix is not given by file in the --design-matrix option. Sample labels are separated by comma (,) and must match the labels in the count table" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
62 <param name="day0_label" argument="--day0-label" type="text" format="tabular" optional="true" value="" label="Control sample" help="Specify the control sample label (usually day 0 or plasmid). For every other sample label, the MLE module will treat it as a single condition and generate an corresponding design matrix" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
63 <param name="beta_labels" argument="--beta-labels" type="text" label="Variables" help="Specify the labels of the variables (i.e., beta), if the design matrix is not given by file in the --design-matrix option. Should be separated by commas (,), and the number of labels must equal to the number of columns of design matrix), including baseline labels. Default: bata_0,beta_1,beta_2,...." />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
64 </when>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
65 </conditional>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
66
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
67 <section name="adv" title="Advanced Options">
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
68 <param name="control_sgrna" argument="--control-sgrna" type="data" format="tabular" optional="true" label="Control sgRNAs file" help="A list of control sgRNAs for normalization and for generating the null distribution of RRA" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
69 <param name="cnv_norm" argument="--cnv-norm" type="data" format="tabular" optional="true" label="CNV profile file" help="A matrix of copy number variation data across cell lines to normalize CNV-biased BetaScores" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
70 <param name="norm_method" argument="--norm-method" type="select" label="Method for normalization" help="If control is specified, the size factor will be estimated using control sgRNAs specified in --control-sgrna option. Default: Median" >
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
71 <option value="none">None</option>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
72 <option value="median" selected="True">Median</option>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
73 <option value="total">Total</option>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
74 <option value="control">Control</option>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
75 </param>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
76 <param name="genes_var" argument="--genes-varmodeling" type="integer" value="1000" label="Number of genes for mean-variance modeling" help="Default: 1000" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
77 <param name="permutation" argument="--permutation-round" type="integer" value="10" label="Number of permutations" help="The rounds for permutation. The permutation time is (# genes) * x for x rounds of permutation. Suggested value: 100 (may take longer time). Default: 10" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
78 <param name="remove_outliers" argument="--remove-outliers" type="boolean" truevalue="--remove-outliers" falsevalue="" checked="false" optional="true" label="Try to remove outliers" help="Turning this option on will slow the algorithm" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
79 <param name="adjust_method" argument="--adjust-method" type="select" label="P-Value Adjustment Method" help="Method for sgRNA-level p-value adjustment, including False Discovery Rate (FDR), Holm's method (Holm), or Pounds's method (Pounds). Default: FDR">
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
80 <option value="fdr" selected="True">FDR</option>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
81 <option value="holm">Holm</option>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
82 <option value="pounds">Pounds</option>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
83 </param>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
84 <param name="sgrnaeff_file" argument="--sgrna-efficiency" type="data" format="tabular" optional="true" label="sgRNA efficiency file" help="An optional file of sgRNA efficiency prediction. The efficiency prediction will be used as an initial guess of the probability an sgRNA is efficient. Must contain at least two columns, one containing sgRNA ID, the other containing sgRNA efficiency prediction" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
85 <param name="sgrnaeff_name_col" argument="--sgrna-eff-score-column" type="data_column" data_ref="sgrnaeff_file" value="1" optional="true" label="sgRNA score column" help="The sgRNA efficiency prediction column in sgRNA efficiency prediction file (specified by the --sgrna-efficiency option). Default is 1 (the second column)." />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
86 <param name="sgrnaeff_score_col" argument="--sgrna-eff-name-column" type="data_column" data_ref="sgrnaeff_file" value="0" optional="true" label="sgRNA ID column" help="The sgRNA ID column in sgRNA efficiency prediction file (specified by the --sgrna-efficiency option). Default is 0 (the first column)" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
87 <param name="update_eff" argument="--update-efficiency" type="boolean" truevalue="--update-efficiency" falsevalue="" checked="false" optional="true"
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
88 label="Update efficiency" help="Iteratively update sgRNA efficiency during EM iteration" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
89 <param name="out_log" type="boolean" truevalue="True" falsevalue="" checked="false"
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
90 label="Output logfile" help="This file includes the logging information during the execution. For count command, it will list some basic statistics of the dataset at the end, including the number of reads, the number of reads mapped to the library, the number of zero-count sgRNAs, etc. Default: No" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
91 </section>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
92 </inputs>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
93 <outputs>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
94 <data name="gene_summary" format="tabular" from_work_dir="*.gene_summary.txt" label="${tool.name} on ${on_string}: Gene Summary (MLE)" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
95 <data name="sgrna_summary" format="tabular" from_work_dir="*.sgrna_summary.txt" label="${tool.name} on ${on_string}: sgRNA Summary (MLE)" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
96 <data name="log" format="tabular" from_work_dir="output.log" label="${tool.name} on ${on_string}: Log (MLE)" >
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
97 <filter>adv['out_log'] is True</filter>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
98 </data>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
99 </outputs>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
100 <tests>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
101 <test><!-- Ensure MAGeCK's demo1 test works -->
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
102 <param name="count_table" value="demo/demo1/sample.txt" ftype="tabular" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
103 <param name="design_matrix" ftype="tabular" value="in.mle.design_matrix.txt" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
104 <param name="out_log" value="True"/>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
105 <output name="gene_summary" file="out.mle.gene_summary.txt" compare="sim_size"/>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
106 <output name="sgrna_summary" file="out.mle.sgrna_summary.txt"/>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
107 <output name="log" file="out.mle.log.txt" compare="sim_size"/>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
108 </test>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
109 </tests>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
110
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
111 <help><![CDATA[
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
112 .. class:: infomark
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
113
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
114 **What it does**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
115
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
116 **MAGeCK mle** calculates gene essentiality from CRISPR screens. Compared with the original algorithm in **MAGeCK test**,
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
117 MAGeCK mle uses a measurement called beta score to call gene essentialities: a positive beta score means a gene is positively selected,
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
118 and a negative beta score means a gene is negatively selected. It is similar to the term log-fold change in differential expression,
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
119 and compared with the original robust ranking aggregation (RRA) algorithm, this measurement has the following advantages:
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
120
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
121 * It has only one score for one gene, instead of two scores in RRA: one for positive selection, one for negative selection;
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
122 * It allows a direct comparison across multiple conditions, or even experiments;
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
123 * It is able to incorporate sgRNA efficiency information.
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
124
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
125 -----
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
126
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
127 **Inputs**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
128
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
129 **sgRNA count file**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
130
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
131 The sgRNA read count file will be used in -k parameter in the mle command. The read count file should list the names of the sgRNA, the gene it is targeting, followed by the read counts in each sample. Each item should be separated by the tab ('\t'). A header line is optional. For example in the studies of T. Wang et al. Science 2014, there are 4 CRISPR screening samples, and they are labeled as: HL60.initial, KBM7.initial, HL60.final, KBM7.final. Here are a few lines of the read count file:
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
132
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
133 ============== ======== ================ ================ ============== ==============
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
134 **sgRNA** **gene** **HL60.initial** **KBM7.initial** **HL60.final** **KBM7.final**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
135 -------------- -------- ---------------- ---------------- -------------- --------------
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
136 A1CF_m52595977 A1CF 213 274 883 175
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
137 A1CF_m52596017 A1CF 294 412 1554 1891
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
138 A1CF_m52596056 A1CF 421 368 566 759
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
139 A1CF_m52603842 A1CF 274 243 314 855
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
140 A1CF_m52603847 A1CF 0 50 145 266
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
141 ============== ======== ================ ================ ============== ==============
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
142
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
143 **Design matrix file**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
144
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
145 Either the sample labels can be specified in the tool form above, or alternatively, a `design matrix` file can be provided. The design matrix indicates which sample is affected by which condition. It is generally a binary matrix indicating which sample (indicated by the first column) is affected by which condition (indicated by the first row). For the meanings of the design matrix, check the input file format page.
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
146
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
147 ============ ======== ==== ====
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
148 **Samples** baseline HL60 KBM7
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
149 ------------ -------- ---- ----
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
150 HL60.initial 1 0 0
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
151 KBM7.initial 1 0 0
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
152 HL60.final 1 1 0
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
153 KBM7.final 1 0 1
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
154 ============ ======== ==== ====
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
155
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
156 The following are the rules for the design matrix file:
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
157
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
158 * The design matrix file must include a header line of condition labels
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
159 * The first column is the sample labels that must match sample labels in read count file
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
160 * The second column must be a "baseline" column that sets all values to "1"
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
161 * The element in the design matrix is either "0" or "1"
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
162 * You must have at least one sample of "initial state" (e.g., day 0 or plasmid) that has only one "1" in the corresponding row. That only "1" must be in the baseline column.
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
163 * In the design matrix above, there are four samples, two corresponding to the initial states of two cell lines, and two corresponding to the final states of two cell lines. We design two conditions (HL60 and KBM7) that model the cell type-specific effects.
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
164
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
165 **Control sgRNA file**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
166
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
167 The optional Control sgRNAs file is used to generate null distribution when calculating the p values. If this option is not specified, MAGeCK generates the null distribution of RRA scores by assuming all of the genes in the library are non-essential, see **More Information** below. This approach is sometimes over-conservative, and you can improve this if you know some genes are not essential. By providing the corresponding sgRNA IDs in this option, MAGeCK will have a better estimation of p values. To use this option, you need to prepare a text file specifying the IDs of control sgRNAs, one line for one sgRNA ID.
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
168
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
169 **Outputs**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
170
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
171 If successful, MAGeCK mle will generate two files, the gene_summary file (including gene beta scores), and the sgrna_summary file (including sgRNA efficiency probability predictions).
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
172
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
173 **Gene summary file (including beta scores)**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
174
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
175 An example of the gene summary output file is below. This file includes the beta scores in two conditions specified in the design matrix (HL60|beta and KBM7|beta), and the associated statistics. For more information, check the output format specification of the **mageck test** *Gene Summary* file.
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
176
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
177 ======== ========= ============= ========== ================ ============ ===================== ================= ============= =========== ================ ============ ===================== =================
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
178 **Gene** **sgRNA** **HL60|beta** **HL60|z** **HL60|p-value** **HL60|fdr** **HL60|wald-p-value** **HL60|wald-fdr** **KBM7|beta** **KBM7|ze** **KBM7|p-value** **KBM7|fdr** **KBM7|wald-p-value** **KBM7|wald-fdr**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
179 -------- --------- ------------- ---------- ---------------- ------------ --------------------- ----------------- ------------- ----------- ---------------- ------------ --------------------- -----------------
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
180 RNF14 10 0.24927 0.72077 0.36256 0.75648 0.47105 0.9999 0.57276 1.6565 0.06468 0.32386 0.097625 0.73193
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
181 RNF10 10 0.10159 0.29373 0.92087 0.98235 0.76896 0.9999 0.11341 0.32794 0.90145 0.97365 0.74296 0.98421
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
182 RNF11 10 3.6354 10.513 0.00028 0.021739 7.5197e-26 1.3376e-22 2.5928 7.4925 0.0014898 0.032024 6.7577e-14 1.33e-11
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
183 ======== ========= ============= ========== ================ ============ ===================== ================= ============= =========== ================ ============ ===================== =================
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
184
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
185
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
186 **sgRNA summary file (including sgRNA efficiency probability predictions)**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
187
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
188 An example of the sgRNA ranking output is as follows:
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
189
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
190 ================ ======== ================= =================== ================ ============== ======= =============== =========== ========= ========= =========== ============== =========== =====================
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
191 **sgrna** **Gene** **control_count** **treatment_count** **control_mean** **treat_mean** **LFC** **control_var** **adj_var** **score** **p.low** **p.high** **p.twosided** **FDR** **high_in_treatment**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
192 ---------------- -------- ----------------- ------------------- ---------------- -------------- ------- --------------- ----------- --------- --------- ----------- -------------- ----------- ---------------------
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
193 INO80B_m74682554 INO80B 0.0/0.0 1220.15/1476.14 0.810860 1348.15 10.70 0.0 19.0767 308.478 1.0 1.11022e-16 2.22044e-16 1.57651e-14 True
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
194 NHS_p17705966 NHS 1.62172/3.90887 2327.09/1849.95 2.76529 2088.52 9.54 2.61554 68.2450 252.480 1.0 1.11022e-16 2.22044e-16 1.57651e-14 True
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
195 ================ ======== ================= =================== ================ ============== ======= =============== =========== ========= ========= =========== ============== =========== =====================
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
196
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
197 The contents of each column are as follows:
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
198
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
199 * **sgrna** sgRNA ID
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
200 * **Gene** The targeting gene
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
201 * **control_count** Normalized read counts in control samples
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
202 * **treatment_count** Normalized read counts in treatment samples
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
203 * **control_mean** Mean read counts in control samples
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
204 * **treat_mean** Mean read counts in treatment samples
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
205 * **LFC** The log fold change of sgRNA
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
206 * **control_var** The raw variance in control samples
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
207 * **adj_var** The adjusted variance in control samples
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
208 * **score** The score of this sgRNA
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
209 * **p.low** p-value (lower tail)
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
210 * **p.high** p-value (higher tail)
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
211 * **p.twosided** p-value (two sided)
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
212 * **FDR** false discovery rate
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
213 * **high_in_treatment** Whether the abundance is higher in treatment samples
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
214
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
215 -----
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
216
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
217 **More Information**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
218
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
219 **Overview of the MAGeCK algorithm**
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
220
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
221 Briefly, read counts from different samples are first median-normalized to adjust for the effect of library sizes and read count distributions. Then the variance of read counts is estimated by sharing information across features, and a negative binomial (NB) model is used to test whether sgRNA abundance differs significantly between treatments and controls. This approach is similar to those used for differential RNA-Seq analysis. We rank sgRNAs based on P-values calculated from the NB model, and use a modified robust ranking aggregation (RRA) algorithm named α-RRA to identify positively or negatively selected genes. More specifically, α-RRA assumes that if a gene has no effect on selection, then sgRNAs targeting this gene should be uniformly distributed across the ranked list of all the sgRNAs. α-RRA ranks genes by comparing the skew in rankings to the uniform null model, and prioritizes genes whose sgRNA rankings are consistently higher than expected. α-RRA calculates the statistical significance of the skew by permutation, and a detailed description of the algorithm is presented in the Materials and methods section of the `MAGeCK paper`_. Finally, MAGeCK reports positively and negatively selected pathways by applying α-RRA to the rankings of genes in a pathway.
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
222
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
223 For more information on using MAGeCK, see the `MAGeCK website here`_.
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
224
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
225 .. _`design matrix`: https://sourceforge.net/p/mageck/wiki/input/#design-matrix-file
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
226 .. _`MAGeCK paper`: https://genomebiology.biomedcentral.com/articles/10.1186/s13059-014-0554-4
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
227 .. _`MAGeCK website here`: https://sourceforge.net/p/mageck/wiki/QA/#using-mageck
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
228
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
229 ]]></help>
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
230 <expand macro="citations" />
79cfebdd24c8 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/mageck commit 3a58259cd0f035510963d470ea8ddbe551aea058-dirty
iuc
parents:
diff changeset
231 </tool>