skunkworks: rgToolFactory.xml annotate

annotate rgToolFactory.xml @ 19:4bfe405f76ed draft

Uploaded

author	fubar
date	Sun, 23 Mar 2014 07:46:57 -0400
parents	e052aadae3e9
children	8aab0f66cd5f

rev	line source
9 e4e097a41064 Uploaded fubar parents: 8 diff changeset	1 <tool id="rgTF" name="Tool Factory" version="1.10">
7 1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	2 <description>Makes scripts into tools</description>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	3 <requirements>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	4 <requirement type="package" version="9.10">ghostscript</requirement>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	5 <requirement type="package" version="1.3.18">graphicsmagick</requirement>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	6 </requirements>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	7 <command interpreter="python">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	8 #if ( $__user_email__ not in $__admin_users__ ):
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	9 rgToolFactory.py --bad_user $__user_email__
16 e052aadae3e9 Uploaded fubar parents: 10 diff changeset	10 #else:
7 1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	11 rgToolFactory.py --script_path "$runme" --interpreter "$interpreter"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	12 --tool_name "$tool_name" --user_email "$__user_email__"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	13 #if $make_TAB.value=="yes":
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	14 --output_tab "$tab_file"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	15 #end if
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	16 #if $makeMode.make_Tool=="yes":
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	17 --make_Tool "$makeMode.make_Tool"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	18 --tool_desc "$makeMode.tool_desc"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	19 --tool_version "$makeMode.tool_version"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	20 --new_tool "$new_tool"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	21 --help_text "$helpme"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	22 #end if
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	23 #if $make_HTML.value=="yes":
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	24 --output_dir "$html_file.files_path" --output_html "$html_file" --make_HTML "yes"
16 e052aadae3e9 Uploaded fubar parents: 10 diff changeset	25 #else:
e052aadae3e9 Uploaded fubar parents: 10 diff changeset	26 --output_dir "."
7 1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	27 #end if
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	28 #if $input1 != 'None':
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	29 --input_tab "$input1"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	30 #end if
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	31 #end if
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	32 </command>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	33 <inputs>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	34 <param name="input1" type="data" label="Select an input file from your history" optional="true" size="120"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	35 help="Most scripts will need an input - your script MUST be ready for whatever format you choose"/>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	36 <param name="tool_name" type="text" value="My dynamic script" label="New tool ID and title for outputs" size="60"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	37 help="This will become the toolshed repository name so please choose thoughtfully to avoid namespace clashes with other tool writers">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	38 <sanitizer invalid_char="">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	39 <valid initial="string.letters,string.digits"/>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	40 </sanitizer>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	41 </param>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	42 <conditional name="makeMode">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	43 <param name="make_Tool" type="select" label="Create a tar.gz file ready for local toolshed entry" help="Ready to deploy securely!" size="60">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	44 <option value="yes">Generate a Galaxy ToolShed compatible toolshed.gz</option>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	45 <option value="" selected="true">No. Just run the script please</option>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	46 </param>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	47 <when value = "yes">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	48 <param name="tool_version" label="Tool Version - bump this to warn users trying to redo old analyses" type="text" value="0.01"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	49 help="If you change your script and regenerate the 'same' tool, you should inform Galaxy (and users) by changing (bumping is traditional) this number"/>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	50 <param name="tool_desc" label="Tool Description" type="text" value="" size="40"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	51 help="Supply a brief tool description for the Galaxy tool menu entry (optional - appears after the tool name)" />
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	52 <param name="help_text" label="Tool form documentation and help text for users" type="text" area="true"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	53 size="8x120" value="What it Does"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	54 help="Supply the brief user documentation to appear on the new tool form as reStructured text - http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html" >
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	55 <sanitizer>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	56 <valid initial="string.printable">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	57 </valid>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	58 <mapping initial="none"/>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	59 </sanitizer>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	60 </param>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	61 </when>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	62 <when value = "">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	63 </when>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	64 </conditional>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	65 <param name="make_HTML" type="select" label="Create an HTML report with links to all output files and thumbnail links to PDF images" size="60"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	66 help="Recommended for presenting complex outputs in an accessible manner. Turn off for simple tools so they just create one output">
9 e4e097a41064 Uploaded fubar parents: 8 diff changeset	67 <option value="yes">Yes, arrange all outputs produced by my script as an HTML output</option>
7 1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	68 <option value="" selected="true">No, no HTML output file thanks</option>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	69 </param>
9 e4e097a41064 Uploaded fubar parents: 8 diff changeset	70 <param name="make_TAB" type="select" label="Create a new (default tabular) history output with or without an HTML file specified above"
7 1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	71 help="This is useful if your script creates a single new tabular file you want to appear in the history after the tool executes">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	72 <option value="yes" selected="true">My script writes to a new history output</option>
9 e4e097a41064 Uploaded fubar parents: 8 diff changeset	73 <option value="">I do not want a new history output file</option>
7 1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	74 </param>
9 e4e097a41064 Uploaded fubar parents: 8 diff changeset	75 <param name="out_format" type="select" label="Galaxy datatype for your tool's output file if any" help="You may need to edit the xml to extend this list">
7 1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	76 <option value="tabular" selected="true">Tabular</option>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	77 <option value="interval">Interval</option>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	78 <option value="gz">gz</option>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	79 <option value="text">text</option>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	80 </param>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	81 <param name="interpreter" type="select" label="Select the interpreter for your code. This must be available on the path of the execution host">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	82 <option value="Rscript" selected="true">Rscript</option>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	83 <option value="python">python</option>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	84 <option value="perl">perl</option>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	85 <option value="sh">sh</option>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	86 </param>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	87 <param name="dynScript" label="Cut and paste the script to be executed here" type="text" value="" area="True" size="8x120"
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	88 help="Script must deal with two command line parameters: Path to input tabular file path (or 'None' if none selected) and path to output tabular history file (or 'None').">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	89 <sanitizer>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	90 <valid initial="string.printable">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	91 </valid>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	92 <mapping initial="none"/>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	93 </sanitizer>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	94 </param>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	95 </inputs>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	96 <outputs>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	97 <data format="tabular" name="tab_file" label="${tool_name}.${out_format}">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	98 <filter>make_TAB=="yes"</filter>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	99 <change_format>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	100 <when input="out_format" value="interval" format="interval" />
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	101 <when input="out_format" value="gz" format="gz" />
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	102 <when input="out_format" value="text" format="text" />
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	103 </change_format>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	104 </data>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	105 <data format="html" name="html_file" label="${tool_name}.html">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	106 <filter>make_HTML == "yes"</filter>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	107 </data>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	108 <data format="toolshed.gz" name="new_tool" label="${tool_name}.toolshed.gz">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	109 <filter>makeMode['make_Tool'] == "yes"</filter>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	110 </data>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	111 </outputs>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	112 <configfiles>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	113 <configfile name="runme">$dynScript</configfile>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	114 <configfile name="helpme">
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	115 #if $makeMode.make_Tool == "yes":
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	116 ${makeMode.help_text}
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	117 #end if
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	118 </configfile>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	119 </configfiles>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	120 <help>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	121
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	122 .. class:: warningmark
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	123
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	124 Details and attribution GTF_
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	125
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	126 Local Admins ONLY Only users whose IDs found in the local admin_user configuration setting in universe_wsgi.ini can run this tool.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	127
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	128 If you find a bug please raise an issue at the bitbucket repository GTFI_
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	129
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	130 What it does This tool enables a user to paste and submit an arbitrary R/python/perl script to Galaxy.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	131
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	132 Input options This version is limited to simple transformation or reporting requiring only a single input file selected from the history.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	133
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	134 Output options Optional script outputs include one single new history tabular file, or for scripts that create multiple outputs,
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	135 a new HTML report linking all the files and images created by the script can be automatically generated.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	136
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	137 Tool Generation option Once the script is working with test data, this tool will optionally generate a new Galaxy tool in a gzip file
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	138 ready to upload to your local toolshed for sharing and installation. Provide a small sample input when you run generate the tool because
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	139 it will become the input for the generated functional test.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	140
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	141 .. class:: warningmark
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	142
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	143 Note to system administrators This tool offers NO built in protection against malicious scripts. It should only be installed on private/personnal Galaxy instances.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	144 Admin_users will have the power to do anything they want as the Galaxy user if you install this tool.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	145
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	146 .. class:: warningmark
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	147
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	148 Use on public servers is STRONGLY discouraged for obvious reasons
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	149
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	150 The tools generated by this tool will run just as securely as any other normal installed Galaxy tool but like any other new tools, should always be checked carefully before installation.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	151 We recommend that you follow the good code hygiene practices associated with safe toolshed.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	152
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	153 Scripting conventions The pasted script will be executed with the path to the (optional) input tabular data file path or NONE if you do not select one, and the path to the optional
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	154 output file or None if none is wanted, as the first and second command line parameters. The script must deal appropriately with these - see Rscript examples below.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	155 Note that if an optional HTML output is selected, all the output files created by the script will be nicely presented as links, with pdf images linked as thumbnails in that output.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	156 This can be handy for complex scripts creating lots of output.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	157
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	158 Examples
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	159 <![CDATA[
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	160
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	161 Each of these following trivial examples can be cut and pasted into the script box for testing.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	162 Please make sure you choose the appropriate interpreter and upload and select a suitable small matching test data input
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	163
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	164 A simple Rscript "filter" showing how the command line parameters can be handled, takes an input file, does something (transpose in this case) and
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	165 writes the results to a new tabular file. Note the use of colClasses to ensure that no fiddling takes place with numeric values by treating everything
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	166 as a string::
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	167
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	168 # transpose a tabular input file and write as a tabular output file
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	169 ourargs = commandArgs(TRUE)
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	170 inf = ourargs[1]
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	171 outf = ourargs[2]
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	172 inp = read.table(inf,head=F,row.names=NULL,sep='\t',colClasses="character")
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	173 outp = t(inp)
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	174 write.table(outp,outf, quote=FALSE, sep="\t",row.names=F,col.names=F)
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	175
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	176 Calculate a multiple test adjusted p value from a column of p values - for this script to be useful, it needs the right column for the input to be specified in the code for the
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	177 given input file type(s) specified when the tool is generated ::
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	178
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	179 # use p.adjust - assumes a HEADER row and column 1 - please fix for any real use
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	180 column = 1 # adjust if necessary for some other kind of input
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	181 ourargs = commandArgs(TRUE)
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	182 inf = ourargs[1]
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	183 outf = ourargs[2]
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	184 inp = read.table(inf,head=T,row.names=NULL,sep='\t')
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	185 p = inp[,column]
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	186 q = p.adjust(p,method='BH')
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	187 outp = cbind(inp,'BH Adjusted p-value'=q)
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	188 write.table(outp,outf, quote=FALSE, sep="\t",row.names=F,col.names=T)
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	189
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	190
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	191 A demonstration Rscript example takes no input file but generates some random data based pdf images
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	192 You must make sure the option to create an HTML output file is
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	193 turned on for this to work. Images (pdf) are linked via thumbnails and
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	194 all files have a link on the resulting HTML page::
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	195
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	196 # note this script takes NO input or output because it generates random data
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	197 for (i in 1:10) {
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	198 foo = runif(100)
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	199 bar = rnorm(100)
10 59bce2efadfe Uploaded fubar parents: 9 diff changeset	200 bar = foo + 0.05*bar
7 1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	201 pdf(paste('yet',i,"anotherplot.pdf",sep='_'))
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	202 plot(foo,bar,main=paste("Foo by Bar plot #",i),col="maroon", pch=3,cex=0.6)
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	203 dev.off()
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	204 foo = data.frame(a=runif(100),b=runif(100),c=runif(100),d=runif(100),e=runif(100),f=runif(100))
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	205 bar = as.matrix(foo)
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	206 pdf(paste('yet',i,"anotherheatmap.pdf",sep='_'))
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	207 heatmap(bar,main='Random Heatmap')
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	208 dev.off()
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	209 }
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	210
10 59bce2efadfe Uploaded fubar parents: 9 diff changeset	211 A slight variation taking an input tabular file from which we read the first number as nreps
59bce2efadfe Uploaded fubar parents: 9 diff changeset	212
59bce2efadfe Uploaded fubar parents: 9 diff changeset	213 # note this script takes a single parameter
59bce2efadfe Uploaded fubar parents: 9 diff changeset	214 # number of replicates
59bce2efadfe Uploaded fubar parents: 9 diff changeset	215 ourargs = commandArgs(TRUE)
59bce2efadfe Uploaded fubar parents: 9 diff changeset	216 infname = ourargs[1]
59bce2efadfe Uploaded fubar parents: 9 diff changeset	217 nreps = read.table(infname,head=F)
59bce2efadfe Uploaded fubar parents: 9 diff changeset	218 nreps = unlist(nreps)[1]
59bce2efadfe Uploaded fubar parents: 9 diff changeset	219 nreps = max(c(1,nreps))
59bce2efadfe Uploaded fubar parents: 9 diff changeset	220 nreps = min(c(20,nreps))
59bce2efadfe Uploaded fubar parents: 9 diff changeset	221 print(paste("Using nreps=",nreps))
59bce2efadfe Uploaded fubar parents: 9 diff changeset	222 for (i in 1:nreps) {
59bce2efadfe Uploaded fubar parents: 9 diff changeset	223 foo = runif(100)
59bce2efadfe Uploaded fubar parents: 9 diff changeset	224 bar = rnorm(100)
59bce2efadfe Uploaded fubar parents: 9 diff changeset	225 bar = foo + 0.2*bar
59bce2efadfe Uploaded fubar parents: 9 diff changeset	226 pdf(paste("yet",i,"anotherplot.pdf",sep="_"))
59bce2efadfe Uploaded fubar parents: 9 diff changeset	227 plot(foo,bar,main=paste("Foo by Bar plot ",i),col="maroon", pch=3,cex=0.6)
59bce2efadfe Uploaded fubar parents: 9 diff changeset	228 dev.off()
59bce2efadfe Uploaded fubar parents: 9 diff changeset	229 foo = data.frame(a=runif(100),b=runif(100),c=runif(100),d=runif(100),e=runif(100),f=runif(100))
59bce2efadfe Uploaded fubar parents: 9 diff changeset	230 bar = as.matrix(foo)
59bce2efadfe Uploaded fubar parents: 9 diff changeset	231 pdf(paste("yet",i,"anotherheatmap.pdf",sep="_"))
59bce2efadfe Uploaded fubar parents: 9 diff changeset	232 heatmap(bar,main="Random Heatmap")
59bce2efadfe Uploaded fubar parents: 9 diff changeset	233 dev.off()
59bce2efadfe Uploaded fubar parents: 9 diff changeset	234 }
7 1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	235
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	236 A Python example that reverses each row of a tabular file (you'll need to remove the leading spaces
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	237 for this to work if cut and pasted into the script box)::
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	238
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	239 # reverse order of columns in a tabular file
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	240 import sys
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	241 inp = sys.argv[1]
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	242 outp = sys.argv[2]
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	243 i = open(inp,'r')
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	244 o = open(outp,'w')
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	245 for row in i:
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	246 rs = row.rstrip().split('\t')
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	247 rs.reverse()
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	248 o.write('\t'.join(rs))
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	249 o.write('\n')
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	250 i.close()
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	251 o.close()
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	252
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	253 A trivial shell script example to show that it works::
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	254
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	255 #!/bin/bash
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	256 INF=$1
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	257 OUTF=$2
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	258 cut -c2,4,6,8,10,12 $INF > $OUTF
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	259
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	260 A trivial perl script example to show that even perl works::
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	261
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	262 #
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	263 # change all occurances of a string in a file to another string
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	264 #
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	265 $oldfile = $ARGV[0];
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	266 $newfile = $ARGV[1];
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	267 $old = "gene";
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	268 $new = "foo";
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	269 open(OF, $oldfile);
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	270 open(NF, ">$newfile");
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	271 # read in each line of the file
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	272 while ($line = <OF>) {
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	273 $line =~ s/$old/$new/;
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	274 print NF $line;
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	275 }
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	276 close(OF);
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	277 close(NF);
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	278
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	279 ]]>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	280
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	281 Citation
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	282
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	283
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	284 Paper_ :
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	285
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	286 Creating re-usable tools from scripts: The Galaxy Tool Factory
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	287 Ross Lazarus; Antony Kaspi; Mark Ziemann; The Galaxy Team
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	288 Bioinformatics 2012; doi: 10.1093/bioinformatics/bts573
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	289
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	290
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	291 Licensing
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	292
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	293 Copyright Ross Lazarus (ross period lazarus at gmail period com) May 2012
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	294 All rights reserved.
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	295 Licensed under the LGPL_
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	296
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	297 .. _LGPL: http://www.gnu.org/copyleft/lesser.html
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	298 .. _GTF: https://bitbucket.org/fubar/galaxytoolfactory
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	299 .. _GTFI: https://bitbucket.org/fubar/galaxytoolfactory/issues
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	300 .. _Paper: http://bioinformatics.oxfordjournals.org/cgi/reprint/bts573?ijkey=lczQh1sWrMwdYWJ&keytype=ref
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	301
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	302
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	303 </help>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	304
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	305 </tool>
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	306
1fcf3fda325f major fixes with GS and graphicsmagick dependencies included fubar parents: diff changeset	307

Mercurial > repos > fubar > toolfactory

annotate rgToolFactory.xml @ 19:4bfe405f76ed draft