annotate napq.xml @ 28:6107b74eeb11 default tip

improved documentation
author pieter.lukasse@wur.nl
date Fri, 30 Jan 2015 14:53:10 +0100
parents 34c4e7e0f23b
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
17
40ec8770780d * Added support for pepxml (and more specifically for
pieter.lukasse@wur.nl
parents: 16
diff changeset
1 <tool name="NapQ" id="napq" version="0.0.3">
5
5d99c9d0615d performance improvements for MsFilt
pieter.lukasse@wur.nl
parents: 4
diff changeset
2 <description>'no alignment' (alignment-free) peptide quantification</description>
0
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
3 <!--
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
4 For remote debugging start you listener on port 8000 and use the following as command interpreter:
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
5 java -jar -Xdebug -Xrunjdwp:transport=dt_socket,address=D0100564.wurnet.nl:8000
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
6 //////////////////////////
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
7 -->
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
8 <command interpreter="java -jar ">
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
9 NapQ.jar
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
10 -identificationsConfigFile $identificationsConfigFile
6
d1edc7971d48 fixes in tool forms (<when> tags)
pieter.lukasse@wur.nl
parents: 5
diff changeset
11 -namingConventionCodesForSamples "$namingConventionCodesForSamples"
0
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
12 #if $is2D_LC_MS.fractions == True
6
d1edc7971d48 fixes in tool forms (<when> tags)
pieter.lukasse@wur.nl
parents: 5
diff changeset
13 -namingConventionCodesForFractions "$is2D_LC_MS.namingConventionCodesForFractions"
0
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
14 #end if
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
15 -outputApml $outputApml
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
16 -outputTsv $outputTsv
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
17 -outReport $htmlReportFile
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
18 -outReportPicturesPath $htmlReportFile.files_path
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
19 </command>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
20
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
21 <inputs>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
22
28
6107b74eeb11 improved documentation
pieter.lukasse@wur.nl
parents: 27
diff changeset
23 <repeat name="identificationFileList" title="(Filtered) Peptide identification files" help="Set of MS/MS peptide identification files that have some form of
6107b74eeb11 improved documentation
pieter.lukasse@wur.nl
parents: 27
diff changeset
24 quantification data coupled to it (e.g. MSE identifications&amp;intensity). This list of peptide identifications is
6107b74eeb11 improved documentation
pieter.lukasse@wur.nl
parents: 27
diff changeset
25 preferably pre-processed by a tool (e.g. MsFilt) that filters out as much as possible false-positive peptide identifications.">
6107b74eeb11 improved documentation
pieter.lukasse@wur.nl
parents: 27
diff changeset
26 <param name="identificationsFile" type="data" format="apml,prims.fileset.zip" label="Identifications file ([APML] or [MZIDENTML fileSet])"
6107b74eeb11 improved documentation
pieter.lukasse@wur.nl
parents: 27
diff changeset
27 help="When using MsFilt, select MsFilt's APML output file here."/>
0
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
28 </repeat>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
29
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
30 <param name="namingConventionCodesForSamples" type="text" size="100" value=""
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
31 label="Part of run/file name that identifies the sample"
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
32 help="Add the CSV list of codes that occur in the file names
19
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
33 and that stand for a sample code. E.g. '_S1,_S2,_S3,etc.' "> <!-- could do regular expressions as well but this would be hard for biologists, e.g. _F\d\b -->
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
34 <sanitizer>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
35 <!-- adding more characters to the set of "valid" ones: -->
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
36 <valid>
23
pieter.lukasse@wur.nl
parents: 22
diff changeset
37 <add preset="string.printable"/>
19
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
38 <add value="#"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
39 <add value="@"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
40 <add value="$"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
41 <add value="%"/>
23
pieter.lukasse@wur.nl
parents: 22
diff changeset
42 <add value="&amp;"/>
19
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
43 <add value="*"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
44 <add value="["/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
45 <add value="]"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
46 <add value="|"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
47 <add value="{"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
48 <add value="}"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
49 </valid>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
50 </sanitizer>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
51 </param>
0
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
52
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
53 <conditional name="is2D_LC_MS">
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
54 <param name="fractions" type="boolean" truevalue="Yes" falsevalue="No" checked="false"
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
55 label="Data is from 2D LC-MS"
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
56 help="Data acquisition was done in multiple fractions."/>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
57 <when value="Yes">
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
58 <param name="namingConventionCodesForFractions" type="text" size="100" value=""
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
59 label="Part of run/file name that identifies the 2D LC-MS fraction"
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
60 help="Add the CSV list of codes that occur in the file names
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
61 and that stand for a fraction code. E.g. '_F1,_F2,_F3,etc.' Use this to avoid
19
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
62 that each (fraction) file is seen as a separate run."> <!-- could do regular expressions as well but this would be hard for biologists, e.g. _F\d\b -->
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
63 <sanitizer>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
64 <!-- adding more characters to the set of "valid" ones: -->
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
65 <valid>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
66 <add preset="string.printable"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
67 <add value="#"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
68 <add value="@"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
69 <add value="$"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
70 <add value="%"/>
23
pieter.lukasse@wur.nl
parents: 22
diff changeset
71 <add value="&amp;"/>
19
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
72 <add value="*"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
73 <add value="["/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
74 <add value="]"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
75 <add value="|"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
76 <add value="{"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
77 <add value="}"/>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
78 </valid>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
79 </sanitizer>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
80 </param>
d31c6978d9d0 fixes for NapQ
pieter.lukasse@wur.nl
parents: 17
diff changeset
81
0
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
82 </when>
6
d1edc7971d48 fixes in tool forms (<when> tags)
pieter.lukasse@wur.nl
parents: 5
diff changeset
83 <when value="No">
d1edc7971d48 fixes in tool forms (<when> tags)
pieter.lukasse@wur.nl
parents: 5
diff changeset
84 </when>
0
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
85 </conditional>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
86
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
87 </inputs>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
88 <configfiles>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
89 <configfile name="identificationsConfigFile">## start comment
27
34c4e7e0f23b type fix
pieter.lukasse@wur.nl
parents: 26
diff changeset
90 ## iterate over the selected files and store their names in the config file
34c4e7e0f23b type fix
pieter.lukasse@wur.nl
parents: 26
diff changeset
91 #for $i, $s in enumerate( $identificationFileList )
34c4e7e0f23b type fix
pieter.lukasse@wur.nl
parents: 26
diff changeset
92 ${s.identificationsFile}
34c4e7e0f23b type fix
pieter.lukasse@wur.nl
parents: 26
diff changeset
93 ## also print out the datatype in the next line, based on previously configured datatype
34c4e7e0f23b type fix
pieter.lukasse@wur.nl
parents: 26
diff changeset
94 #if isinstance( $s.identificationsFile.datatype, $__app__.datatypes_registry.get_datatype_by_extension('apml').__class__):
34c4e7e0f23b type fix
pieter.lukasse@wur.nl
parents: 26
diff changeset
95 apml
34c4e7e0f23b type fix
pieter.lukasse@wur.nl
parents: 26
diff changeset
96 #else:
34c4e7e0f23b type fix
pieter.lukasse@wur.nl
parents: 26
diff changeset
97 mzid
34c4e7e0f23b type fix
pieter.lukasse@wur.nl
parents: 26
diff changeset
98 #end if
34c4e7e0f23b type fix
pieter.lukasse@wur.nl
parents: 26
diff changeset
99 #end for
0
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
100 ## end comment</configfile>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
101 </configfiles>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
102 <outputs>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
103 <data name="outputApml" format="apml" label="${tool.name} on ${on_string}: peptide quantifications (APML)"/>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
104 <data name="outputTsv" format="tabular" label="${tool.name} on ${on_string}: peptide quantifications (TSV)"/>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
105 <!-- in tsv we can have cols like: pep, avg_m/z, avg rt, m/z window, rt window, i_s1, i_s2, ...-->
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
106 <data name="htmlReportFile" format="html" label="${tool.name} on ${on_string} - HTML report"/>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
107 <!-- here we show the samples extracted and the files used to 'build up' each sample -->
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
108 </outputs>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
109 <tests>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
110 </tests>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
111 <help>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
112
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
113 .. class:: infomark
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
114
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
115 This tool takes in multiple peptide identification result files that have peptide identifications
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
116 coupled to some quantification (e.g. precursor intensity information or for example data coming
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
117 from MS^E acquisition where peptide identification and quantification are done in the same run and reported together).
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
118 Then, based on the given experiment design parameters (i.e. how the result files related back to
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
119 replicate runs and samples), it produces a new file in which the peptides are reported with
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
120 their calculated quantifications at the sample level.
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
121
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
122 The figure below explains this:
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
123
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
124 .. image:: $PATH_TO_IMAGES/napq_overview.png
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
125
4
73c7c6589202 small fixes
pieter.lukasse@wur.nl
parents: 0
diff changeset
126 .
0
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
127
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
128
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
129
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
130
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
131 </help>
d50f079096ee Push to main toolshed
pieter.lukasse@wur.nl
parents:
diff changeset
132 </tool>