annotate GEMBASSY-1.0.3/doc/text/gbasezvalue.txt @ 1:84a17b3fad1f draft

Uploaded
author ktnyt
date Fri, 26 Jun 2015 05:20:29 -0400
parents 8300eb051bea
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
1 gbasezvalue
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
2 Function
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
3
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
4 Extracts conserved oligomers per position using Z-score
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
5
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
6 Description
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
7
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
8 This function calculates and extracts conserved oligomers per position using
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
9 Z-score, in regions around the start/stop codons. The oligomers are returned
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
10 in ranking order up to "-limit" number.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
11
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
12 The Z-score for mean m and standard error SE is calculated as follows:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
13 z = (x - m) / SE
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
14 where SE for standard deviation s and number of samples s is as follows:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
15 SE = s/sqrt(n)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
16
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
17 G-language SOAP service is provided by the
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
18 Institute for Advanced Biosciences, Keio University.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
19 The original web service is located at the following URL:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
20
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
21 http://www.g-language.org/wiki/soap
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
22
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
23 WSDL(RPC/Encoded) file is located at:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
24
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
25 http://soap.g-language.org/g-language.wsdl
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
26
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
27 Documentation on G-language Genome Analysis Environment methods are
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
28 provided at the Document Center
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
29
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
30 http://ws.g-language.org/gdoc/
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
31
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
32 Usage
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
33
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
34 Here is a sample session with gbasezvalue
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
35
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
36 % gbasezvalue refseqn:NC_000913
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
37 Extracts conserved oligomers per position using Z-score
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
38 Program compseq output file (optional) [nc_000913.gbasezvalue]:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
39
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
40 Go to the input files for this example
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
41 Go to the output files for this example
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
42
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
43 Command line arguments
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
44
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
45 Standard (Mandatory) qualifiers:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
46 [-sequence] seqall Nucleotide sequence(s) filename and optional
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
47 format, or reference (input USA)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
48 [-outfile] outfile [*.gbasezvalue] Program compseq output file
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
49 (optional)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
50
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
51 Additional (Optional) qualifiers: (none)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
52 Advanced (Unprompted) qualifiers:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
53 -limit integer [5] Rank threshold for showing the conserved
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
54 oligomer (Any integer value)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
55 -position selection [start] Either 'start' (around start codon)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
56 or 'end' (around stop codon) to create the
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
57 PWM
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
58 -patlen integer [3] Length of oligomer to count (Any integer
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
59 value)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
60 -upstream integer [30] Length upstream of specified position
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
61 to create PWM (Any integer value)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
62 -downstream integer [30] Length downstream of specified position
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
63 to create PWM (Any integer value)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
64 -[no]accid boolean [Y] Include to use sequence accession ID as
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
65 query
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
66
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
67 Associated qualifiers:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
68
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
69 "-sequence" associated qualifiers
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
70 -sbegin1 integer Start of each sequence to be used
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
71 -send1 integer End of each sequence to be used
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
72 -sreverse1 boolean Reverse (if DNA)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
73 -sask1 boolean Ask for begin/end/reverse
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
74 -snucleotide1 boolean Sequence is nucleotide
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
75 -sprotein1 boolean Sequence is protein
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
76 -slower1 boolean Make lower case
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
77 -supper1 boolean Make upper case
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
78 -scircular1 boolean Sequence is circular
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
79 -sformat1 string Input sequence format
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
80 -iquery1 string Input query fields or ID list
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
81 -ioffset1 integer Input start position offset
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
82 -sdbname1 string Database name
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
83 -sid1 string Entryname
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
84 -ufo1 string UFO features
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
85 -fformat1 string Features format
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
86 -fopenfile1 string Features file name
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
87
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
88 "-outfile" associated qualifiers
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
89 -odirectory2 string Output directory
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
90
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
91 General qualifiers:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
92 -auto boolean Turn off prompts
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
93 -stdout boolean Write first file to standard output
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
94 -filter boolean Read first file from standard input, write
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
95 first file to standard output
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
96 -options boolean Prompt for standard and additional values
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
97 -debug boolean Write debug output to program.dbg
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
98 -verbose boolean Report some/full command line options
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
99 -help boolean Report command line options and exit. More
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
100 information on associated and general
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
101 qualifiers can be found with -help -verbose
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
102 -warning boolean Report warnings
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
103 -error boolean Report errors
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
104 -fatal boolean Report fatal errors
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
105 -die boolean Report dying program messages
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
106 -version boolean Report version number and exit
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
107
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
108 Input file format
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
109
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
110 The database definitions for following commands are available at
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
111 http://soap.g-language.org/kbws/embossrc
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
112
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
113 gbasezvalue reads one or more nucleotide sequences.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
114
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
115 Output file format
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
116
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
117 The output from gbasezvalue is to a plain text file.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
118
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
119 File: nc_000913.gbasezvalue
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
120
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
121 Sequence: NC_000913
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
122 position:-30,1,taa,-0.76525
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
123 2,aga,-0.79101
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
124 3,tta,-1.14174
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
125 4,cta,-1.18831
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
126 5,aat,-1.86652
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
127 position:-29,1,cta,-0.18368
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
128 2,aat,-0.71851
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
129 3,gac,-1.26182
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
130 4,taa,-1.39455
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
131
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
132 [Part of this file has been deleted for brevity]
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
133
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
134 position:29,1,gct,1.66288
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
135 2,act,1.26637
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
136 3,tat,0.66721
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
137 4,cct,-0.43158
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
138 5,tgt,-0.59254
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
139 position:30,1,ctg,3.12072
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
140 2,att,0.04193
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
141 3,ctc,-0.12416
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
142 4,cta,-0.38461
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
143 5,tta,-0.76413
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
144
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
145
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
146 Data files
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
147
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
148 None.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
149
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
150 Notes
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
151
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
152 None.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
153
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
154 References
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
155
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
156 Arakawa, K., Mori, K., Ikeda, K., Matsuzaki, T., Konayashi, Y., and
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
157 Tomita, M. (2003) G-language Genome Analysis Environment: A Workbench
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
158 for Nucleotide Sequence Data Mining, Bioinformatics, 19, 305-306.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
159
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
160 Arakawa, K. and Tomita, M. (2006) G-language System as a Platform for
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
161 large-scale analysis of high-throughput omics data, J. Pest Sci.,
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
162 31, 7.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
163
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
164 Arakawa, K., Kido, N., Oshita, K., Tomita, M. (2010) G-language Genome
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
165 Analysis Environment with REST and SOAP Web Service Interfaces,
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
166 Nucleic Acids Res., 38, W700-W705.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
167
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
168 Warnings
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
169
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
170 None.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
171
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
172 Diagnostic Error Messages
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
173
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
174 None.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
175
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
176 Exit status
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
177
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
178 It always exits with a status of 0.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
179
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
180 Known bugs
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
181
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
182 None.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
183
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
184 See also
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
185
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
186 gbasecounter Creates a position weight matrix of oligomers around start
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
187 codon
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
188 gviewcds Displays a graph of nucleotide contents around start and stop
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
189 codons
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
190
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
191 Author(s)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
192
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
193 Hidetoshi Itaya (celery@g-language.org)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
194 Institute for Advanced Biosciences, Keio University
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
195 252-0882 Japan
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
196
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
197 Kazuharu Arakawa (gaou@sfc.keio.ac.jp)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
198 Institute for Advanced Biosciences, Keio University
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
199 252-0882 Japan
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
200
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
201 History
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
202
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
203 2012 - Written by Hidetoshi Itaya
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
204 2013 - Fixed by Hidetoshi Itaya
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
205
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
206 Target users
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
207
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
208 This program is intended to be used by everyone and everything, from
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
209 naive users to embedded scripts.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
210
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
211 Comments
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
212
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
213 None.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
214