annotate scanpy-normalise-data.xml @ 1:5704635cef67 draft

"planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
author ebi-gxa
date Thu, 12 Mar 2020 09:08:10 +0000
parents 19805a556cd6
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
1 <?xml version="1.0" encoding="utf-8"?>
1
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
2 <tool id="scanpy_normalise_data" name="Scanpy NormaliseData" version="@TOOL_VERSION@+galaxy10" profile="@PROFILE@">
0
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
3 <description>to make all cells having the same total expression</description>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
4 <macros>
1
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
5 <import>scanpy_macros2.xml</import>
0
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
6 </macros>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
7 <expand macro="requirements"/>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
8 <command detect_errors="exit_code"><![CDATA[
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
9 ln -s '${input_obj_file}' input.h5 &&
1
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
10 PYTHONIOENCODING=utf-8 scanpy-normalise-data
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
11 --normalize-to ${scale_factor}
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
12 --fraction ${fraction}
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
13 --save-raw ${save_raw}
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
14 ${log_transform}
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
15 @INPUT_OPTS@
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
16 @OUTPUT_OPTS@
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
17 @EXPORT_MTX_OPTS@
0
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
18 ]]></command>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
19
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
20 <inputs>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
21 <expand macro="input_object_params"/>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
22 <expand macro="output_object_params"/>
1
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
23 <param name="scale_factor" argument="--normalize-to" type="float" value="1e4" min="0"
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
24 label="Target number to normalise to" help="Aimed counts per cell after normalisation."/>
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
25 <param name="fraction" argument="--fraction" type="float" value="1" min="0" max="1"
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
26 label="Exclude top expressed genes until the remaining account for no greater than specified fraction of total counts"
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
27 help="Only non-excluded genes will sum up the target number."/>
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
28 <param name="log_transform" argument="--no-log-transform" type="boolean" truevalue="" falsevalue="--no-log-transform" checked="True"
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
29 label="Apply log transform?" help="If enabled, will apply a log transformation following normalisation."/>
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
30 <param name="save_raw" argument="--save-raw" type="boolean" truevalue="yes" falsevalue="no" checked="true"
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
31 label="Save normalised data in `.raw`" help="The saved normalised data are log1p transformed."/>
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
32 <expand macro="export_mtx_params"/>
0
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
33 </inputs>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
34
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
35 <outputs>
1
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
36 <expand macro="output_data_obj" description="Normalised data"/>
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
37 <expand macro="export_mtx_outputs"/>
0
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
38 </outputs>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
39
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
40 <tests>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
41 <test>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
42 <param name="input_obj_file" value="filter_genes.h5"/>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
43 <param name="input_format" value="anndata"/>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
44 <param name="output_format" value="anndata"/>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
45 <param name="scale_factor" value="1e4"/>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
46 <param name="save_raw" value="false"/>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
47 <output name="output_h5" file="normalise_data.h5" ftype="h5" compare="sim_size"/>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
48 </test>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
49 </tests>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
50
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
51 <help><![CDATA[
1
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
52 =============================================================
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
53 Normalise total counts per cell (`scanpy.pp.normalize_total`)
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
54 =============================================================
0
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
55
1
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
56 Normalise each cell by total counts over all genes (excluding top expressed
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
57 genes if so required), so that every cell has the same total count after
5704635cef67 "planemo upload for repository https://github.com/ebi-gene-expression-group/container-galaxy-sc-tertiary/tree/develop/tools/tertiary-analysis/scanpy commit ba0c88ab1b077a0b1c60c8d3c529e72ca6946226"
ebi-gxa
parents: 0
diff changeset
58 normalisation.
0
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
59
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
60 Similar functions are used, for example, by Seurat, Cell Ranger or SPRING.
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
61
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
62 @HELP@
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
63
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
64 @VERSION_HISTORY@
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
65 ]]></help>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
66 <expand macro="citations"/>
19805a556cd6 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/scanpy-scripts commit dca9be719ceb86abad7589c240b1bb7656826c48-dirty
ebi-gxa
parents:
diff changeset
67 </tool>