annotate elastic_tool.Rmd @ 7:01eaa66fcc2e draft

planemo upload
author mingchen0919
date Tue, 27 Mar 2018 14:15:12 -0400
parents a936b1aff8d3
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
1 ---
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
2 title: 'Tool Report'
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
3 output: html_document
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
4 ---
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
5
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
6 <style>
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
7 pre code, pre, code {
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
8 white-space: pre !important;
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
9 overflow-x: scroll !important;
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
10 word-break: keep-all !important;
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
11 word-wrap: initial !important;
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
12 }
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
13 </style>
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
14
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
15 ```{r setup, include=FALSE, warning=FALSE, message=FALSE}
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
16 knitr::opts_chunk$set(error = TRUE)
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
17 ```
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
18
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
19 ## User input
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
20
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
21 ```{r, 'display user input'}
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
22 # get user input and save it into a data frame.
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
23 df = read.table(paste0(Sys.getenv('REPORT_FILES_PATH'), '/options_and_arguments.txt'),
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
24 sep = '|', header = TRUE)
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
25
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
26 # if the input type is 'path_relative_to_a_tool', prepend A_TOOL_OUTPUT_PATH to the value to make
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
27 # the value a full path.
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
28 if (nrow(df[df$type == 'path_relative_to_a_tool', ]) > 0) {
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
29 for (i in 1:nrow(df[df$type == 'path_relative_to_a_tool', ])) {
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
30 root_path = readLines(df[df$type == 'path_relative_to_a_tool', ][i, 'path_type'])[1]
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
31 df[df$type == 'path_relative_to_a_tool', ][i, 'value'] = paste(root_path,
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
32 df[df$type == 'path_relative_to_a_tool', ][i, 'value'],
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
33 sep = '/')
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
34 }
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
35 }
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
36
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
37 ## display user input as a table
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
38 knitr::kable(df)
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
39 ```
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
40
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
41
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
42 ```{r, 'build script', echo=FALSE}
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
43 ##-------- build script files -----------
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
44
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
45 # get tool name, the first line of the script is always the tool name.
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
46 tool_name = df[df$type == 'tool_name', 'value']
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
47
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
48 # if the number of option/argument pairs is larger than 0, build script file
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
49 df2 = df[df$type != 'tool_name', ]
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
50 if (nrow(df2) > 0) {
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
51 # write tool name as the first line of the script.sh
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
52 # before running the job, cd into the ${REPORT_FILES_PATH} directory
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
53 write(paste0(tool_name, ' \\'),
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
54 paste0(Sys.getenv('REPORT_FILES_PATH'), '/script.sh'))
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
55 df2 = df[df$type != 'tool_name', ]
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
56 write(paste(' ', df2$flag, df2$value, '\\', sep = ' '),
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
57 file = paste0(Sys.getenv('REPORT_FILES_PATH'), '/script.sh'),
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
58 append = TRUE )
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
59 # remember that after writing option/argument lines to the script.sh, the last line
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
60 # has an extra newline character '\' which causes a problem. We can either remove that extra
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
61 # '\' or add a new line to the end. We choose to add a new line.
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
62
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
63 # add an extra line to the end to redirect stdout to stdout.txt and stderr to stderr.txt
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
64 write(' > ${REPORT_FILES_PATH}/stdout.txt 2>${REPORT_FILES_PATH}/stderr.txt',
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
65 paste0(Sys.getenv('REPORT_FILES_PATH'), '/script.sh'), append = TRUE)
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
66 } else {
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
67 # if no option/argument input, simply display the help message
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
68 write(paste0(tool_name, ' -h'),
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
69 file = paste0(Sys.getenv('REPORT_FILES_PATH'), '/script.sh'))
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
70 }
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
71 ```
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
72
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
73
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
74 ```{r, 'create paths if they do not exist', echo=FALSE}
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
75 ## if the input type is 'path_relative_to_this_tool', that means
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
76 ## we need to create a directory or file path.
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
77
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
78 # create paths before running the job script
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
79 df_paths = df[df$type == 'path_relative_to_this_tool', ]
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
80
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
81 if (nrow(df_paths) > 0) {
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
82 for (i in 1:nrow(df_paths)) {
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
83 path = paste0(Sys.getenv('REPORT_FILES_PATH'), '/', df_paths[i, 'value'])
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
84 path_type = df_paths[i, 'path_type']
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
85
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
86 # create file paths
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
87 if ((path_type == 'file_path') & !file.exists(path)) {
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
88 dir_path = paste(head(strsplit(path, '/')[[1]], -1), collapse = '/' )
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
89 if (!dir.exists(dir_path)) {
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
90 dir.create(dir_path, recursive = TRUE)
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
91 }
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
92 file.create(path)
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
93 }
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
94
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
95 # create dir paths
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
96 if ((path_type == 'dir_path') & !dir.exists(path)) {
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
97 dir.create(path, recursive = TRUE)
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
98 }
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
99 }
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
100 }
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
101 ```
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
102
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
103
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
104 ```{bash, 'run jobs', echo=FALSE}
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
105 # run job script, always use absolute path.
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
106 # we want to run all jobs within the working path.
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
107 sh ${REPORT_FILES_PATH}/script.sh
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
108 ```
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
109
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
110
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
111 ```{bash, 'display script', results='asis', echo=FALSE}
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
112 echo '## Job script'
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
113 echo ''
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
114 echo ''
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
115 echo '```bash'
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
116 cat ${REPORT_FILES_PATH}/script.sh
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
117 echo '```'
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
118 ```
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
119
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
120
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
121 ```{r, 'display output directory contents', results='asis', echo=FALSE}
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
122 ## after the job is done, we list all files from the output directory.
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
123 ## full relative path to the output directory needs to be displayed.
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
124
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
125 cat('##All output files')
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
126 cat('\n\n')
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
127 all_files = list.files(path = Sys.getenv('REPORT_FILES_PATH'),
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
128 full.names = TRUE,
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
129 recursive = TRUE)
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
130
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
131 for (f in sub(Sys.getenv('REPORT_FILES_PATH'), '.', all_files) ) {
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
132 cat('* [', f, '](', f, ')\n')
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
133 }
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
134 cat('\n')
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
135 ```
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
136
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
137
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
138 ```{r, 'save output directory of this tool', echo=FALSE}
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
139 ## each elastic tool has a galaxy history output which contains the REPORT_FILES_PATH of this tool
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
140 ## so that other tools can reference the outputs from this tool.
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
141
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
142 ## obtain REPORT_FILES_PAHT and save it to a galaxy output.
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
143 database_root = paste(head(strsplit(Sys.getenv('TOOL_LOG'), '/')[[1]], -1), collapse = '/')
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
144 tool_output_dir_id = tail(strsplit(Sys.getenv('REPORT_FILES_PATH'), '/')[[1]], 1)
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
145 tool_output_dir = paste0(database_root, '/', tool_output_dir_id)
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
146 write(tool_output_dir, Sys.getenv('TOOL_OUTPUT_DIR'))
a936b1aff8d3 planemo upload
mingchen0919
parents:
diff changeset
147 ```