annotate data_reader.xml @ 2:3911ee1a0078 draft default tip

Uploaded
author brenninc
date Fri, 17 Jun 2016 11:30:23 -0400
parents 1487421505f1
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
1 <tool id="directory_table_reader" name="Directory Data Reader" version="0.2">
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
2 <description>Reads data from preconfigured directories table.</description>
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
3 <command interpreter="python">
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
4 <![CDATA[
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
5 directory_copier.py
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
6 --ending .${directory.fields.original_extension}
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
7 --new_ending .${directory.fields.galaxy_extension}
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
8 #if $results.required=="data"
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
9 --new_ending .${directory.fields.galaxy_extension}
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
10 --decompress ${directory.fields.decompress}
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
11 #if $results.start
2
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
12 --start "$results.start"
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
13 #end if
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
14 #if $results.last
2
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
15 --last "$results.last"
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
16 #end if
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
17 #if $results.regex
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
18 --regex "$results.regex"
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
19 #end if
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
20 #end if
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
21 --path ${directory.fields.path}
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
22 --list ${listing}
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
23 ]]>
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
24 </command>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
25 <inputs>
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
26 <param name="directory" type="select" label="Directory to import data from">
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
27 <options from_data_table="directory_data"/>
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
28 <validator type="no_options" message="No Data Directory Setup"/>
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
29 </param>
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
30 <param name="list_name" type="text" size="25" label="output name" value="input data"/>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
31 <conditional name="results">
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
32 <param name="required" type="select" label="Download data or just directory listing" help="Select type of action required.">
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
33 <option value="data" selected="true">Data and listing of selected type</option>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
34 <option value="listing">Get listing of selected file types </option>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
35 </param>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
36 <when value="data">
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
37 <param name="start" type="text" value="" label="String which must be at the start of each file name" />
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
38 <param name="last" type="text" value="" label="String which must be at the end of the file name (excluding the file type)" />
2
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
39 <param name="regex" type="text" value="" label="Regex pattern which must somewhere in the file name (excluding the file type)" >
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
40 <sanitizer>
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
41 <valid initial="string.printable"/>
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
42 </sanitizer>
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
43 </param>
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
44 </when>
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
45 <when value="listing"/>
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
46 </conditional>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
47 </inputs>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
48 <outputs>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
49 <data format="txt" name="listing" label="List of files in $list_name">
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
50 </data>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
51 <!-- Ideally galaxy can get the type based on the file extensions. If so just add the type here -->
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
52 <collection type="list" label="$list_name" name="data_collection">
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
53 <filter>(results['required'] == 'data')</filter>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
54 <discover_datasets pattern="__designation_and_ext__" directory="output" visible="true" />
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
55 </collection>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
56 </outputs>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
57 <tests>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
58 <test>
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
59 <param name="directory" value="fastq.gz_files_id" />
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
60 <param name="list_name" value="test_files" />
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
61 <param name="results|required" value="listing"/>
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
62 <output name="listing">
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
63 <assert_contents>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
64 <has_line line="sample1.fastqsanger" />
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
65 <has_line line="other.fastqsanger" />
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
66 </assert_contents>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
67 </output>
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
68 </test>
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
69 <test>
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
70 <param name="directory" value="fastq.gz_files_id" />
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
71 <output name="listing_fastq_gz">
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
72 <assert_contents>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
73 <has_line line="sample1.fastqsanger" />
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
74 </assert_contents>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
75 </output>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
76 <output_collection name="data_collection" type="list">
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
77 <element name="sample1" ftype="fastqsanger" file="sample1.fastq" />
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
78 <element name="other" ftype="fastqsanger" file="other.fastq" />
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
79 </output_collection>
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
80 </test>
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
81 <test>
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
82 <param name="directory" value="fastq_files_id" />
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
83 <param name="results|start" value="sam" />
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
84 <output name="listing_fastq">
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
85 <assert_contents>
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
86 <has_line line="sample1.fastq" />
2
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
87 <not_has_text text="other.fastq" />
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
88 </assert_contents>
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
89 </output>
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
90 <output_collection name="data_collection" type="list">
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
91 <element name="sample1" ftype="fastq" file="sample1.fastq" />
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
92 </output_collection>
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
93 </test>
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
94 <test>
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
95 <param name="directory" value="fastq_files_id" />
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
96 <param name="results|regex" value="le.?" />
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
97 <output name="listing_fastq">
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
98 <assert_contents>
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
99 <has_line line="sample1.fastq" />
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
100 <not_has_text text="other.fastq" />
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
101 </assert_contents>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
102 </output>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
103 <output_collection name="data_collection" type="list">
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
104 <element name="sample1" ftype="fastq" file="sample1.fastq" />
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
105 </output_collection>
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
106 </test>
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
107 </tests>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
108
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
109 <help>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
110 <![CDATA[
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
111 This tool will lookup files on the Galaxy server machine, including mounted directories.
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
112
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
113 Only directories and ending combinations set up by a Galaxy admin can be listed or loaded in this way.
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
114 These endings are case senitive.
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
115
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
116 ====
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
117
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
118 The data options will look for all files that have a particular ending in the selected directory.
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
119
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
120 The tool will return two things.
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
121
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
122 1. A Dataset collection of all the detected files. (If data requested)
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
123
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
124 2. A file with the names of all the detected files. These will be sorted in the same order as galaxy builds the dataset collection.
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
125
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
126 The files can be filtered by setting a specific start string for the file name.
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
127 Only files that start with this string (case senstive) will be included.
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
128
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
129 Files can also be filter for the last part before the file extsentions.
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
130
2
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
131 Files can also be filtered by a regex pattern.
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
132 Only files that contain the regex string will be included.
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
133 This uses the python search funtion so as long as the Regex pattern is found somewhere in file name (excluding extension).
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
134
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
135 The three filter start, last and regex if supplied work indepently, so only files that pass all supplied test will be included.
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
136
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
137 Note: Before applying the last and regex test the ending (includig the . just before the ending are removed)
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
138
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
139 Assuming the directory has:
2
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
140 C01_R1_001.fasta C01_R2_001.fatsa C02_R1_001.fasta C02_R2_002.fatsa
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
141
2
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
142 Setting start C01 will return just the C01 files: C01_R1_001.fasta C01_R2_002.fatsa
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
143
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
144 Setting last R1_001 will return the read1 files: C01_R1_001.fasta C02_R1_001.fasta
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
145
2
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
146 Setting regex R2_00.$ will return the R2 files: C01_R2_001.fatsa C02_R2_002.fatsa
3911ee1a0078 Uploaded
brenninc
parents: 1
diff changeset
147
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
148 As Galaxy detects the file type based on the extension this tool will change the exstension as setup by the admin.
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
149
1
1487421505f1 Uploaded correct tool this time
brenninc
parents: 0
diff changeset
150 This tool will unzip gz files if requested to by the admin,
0
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
151
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
152 ]]>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
153 </help>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
154 <citations>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
155 </citations>
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
156
25b07ce180d4 Uploaded first version
brenninc
parents:
diff changeset
157 </tool>