annotate GEMBASSY-1.0.3/doc/text/gsvalue.txt @ 0:8300eb051bea draft

Initial upload
author ktnyt
date Fri, 26 Jun 2015 05:19:29 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
1 gsvalue
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 Calculate the strength of selected codon usage bias (S)
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 gsvalue calculates the strength of selected codon usage bias (S), also
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
9 known as Sharp's S index. Using four codon pairs that are recognized by the
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
10 same tRNA anticodon, namely, Phe(UUC and UUU), Ile(AUC and AUU), Tyr(UAC and
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
11 UAU), and Asn(AAC and AAU), since the former in each of the pairs has
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
12 stronger Watson-Crick pairing, selection towards the former codon can be
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
13 observed for highly expressed genes. S index is therefore the weighted
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
14 average of such bias, giving an over-all value for a genome, indicating its
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
15 strength of selected codon usage bias. See Sharp et al. (2005) for details.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
16 Sharp originally defined 40 genes as the highly expressed gene group, with
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
17 tufA, tsf, fusA, rplA-rplF, rplI-rplT, rpsB-rpsT. Since the identificaiton
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
18 of these genes is not convenient for computational automation, by default,
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
19 this method uses ribosomal proteins as the highly expressed gene group,
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
20 as used by Viera-silva and Rocha (2010).
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
21 However, Sharp's gene group can be optionally used with -sharp option.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
22 With this option, all of the 40 genes must be named accordingly in the given
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
23 genome file.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
24
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
25 G-language SOAP service is provided by the
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
26 Institute for Advanced Biosciences, Keio University.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
27 The original web service is located at the following URL:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
28
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
29 http://www.g-language.org/wiki/soap
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
30
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
31 WSDL(RPC/Encoded) file is located at:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
32
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
33 http://soap.g-language.org/g-language.wsdl
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
34
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
35 Documentation on G-language Genome Analysis Environment methods are
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
36 provided at the Document Center
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
37
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
38 http://ws.g-language.org/gdoc/
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
39
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
40 Usage
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
41
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
42 Here is a sample session with gsvalue
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
43
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
44 % gsvalue refseqn:NC_000913
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
45 Calculate the strength of selected codon usage bias (S)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
46 Codon usage output file [nc_000913.gsvalue]:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
47
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
48 Go to the input files for this example
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
49 Go to the output files for this example
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
50
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
51 Command line arguments
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
52
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
53 Standard (Mandatory) qualifiers:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
54 [-sequence] seqall Nucleotide sequence(s) filename and optional
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
55 format, or reference (input USA)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
56 [-outfile] outfile [*.gsvalue] Codon usage output file
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
57
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
58 Additional (Optional) qualifiers: (none)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
59 Advanced (Unprompted) qualifiers:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
60 -sharp boolean [N] Include to use the 40 genes used by
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
61 Sharp instead of ribosomal proteins
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
62 -[no]accid boolean [Y] Include to use sequence accession ID as
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
63 query
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
64
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
65 Associated qualifiers:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
66
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
67 "-sequence" associated qualifiers
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
68 -sbegin1 integer Start of each sequence to be used
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
69 -send1 integer End of each sequence to be used
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
70 -sreverse1 boolean Reverse (if DNA)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
71 -sask1 boolean Ask for begin/end/reverse
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
72 -snucleotide1 boolean Sequence is nucleotide
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
73 -sprotein1 boolean Sequence is protein
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
74 -slower1 boolean Make lower case
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
75 -supper1 boolean Make upper case
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
76 -scircular1 boolean Sequence is circular
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
77 -sformat1 string Input sequence format
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
78 -iquery1 string Input query fields or ID list
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
79 -ioffset1 integer Input start position offset
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
80 -sdbname1 string Database name
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
81 -sid1 string Entryname
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
82 -ufo1 string UFO features
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
83 -fformat1 string Features format
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
84 -fopenfile1 string Features file name
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
85
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
86 "-outfile" associated qualifiers
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
87 -odirectory2 string Output directory
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
88
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
89 General qualifiers:
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
90 -auto boolean Turn off prompts
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
91 -stdout boolean Write first file to standard output
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
92 -filter boolean Read first file from standard input, write
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
93 first file to standard output
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
94 -options boolean Prompt for standard and additional values
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
95 -debug boolean Write debug output to program.dbg
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
96 -verbose boolean Report some/full command line options
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
97 -help boolean Report command line options and exit. More
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
98 information on associated and general
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
99 qualifiers can be found with -help -verbose
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
100 -warning boolean Report warnings
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
101 -error boolean Report errors
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
102 -fatal boolean Report fatal errors
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
103 -die boolean Report dying program messages
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
104 -version boolean Report version number and exit
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
105
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
106 Input file format
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
107
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
108 The database definitions for following commands are available at
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
109 http://soap.g-language.org/kbws/embossrc
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
110
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
111 gsvalue reads one or more nucleotide sequences.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
112
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
113 Output file format
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
114
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
115 The output from gsvalue is to a plain text file.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
116
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
117 File: nc_000913.gsvalue
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
118
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
119 Sequence: NC_000913 S-value: 1.23467100598485
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
120
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
121
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
122 Data files
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
123
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
124 None.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
125
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
126 Notes
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
127
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
128 None.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
129
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
130 References
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
131
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
132 Sharp PM et al. (2005) "Variation in the strength of selected codon usage
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
133 bias among bacteria", Nucleic Acids Research, 33(4):1141-1153
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
134
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
135 Vieira-Silva S and Rocha EPC (2010) "The systemic imprint of growth and its
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
136 uses in ecological (meta)genomics", PLoS Genetics, 6(1):e1000808
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
137
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
138 Arakawa, K., Mori, K., Ikeda, K., Matsuzaki, T., Konayashi, Y., and
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
139 Tomita, M. (2003) G-language Genome Analysis Environment: A Workbench
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
140 for Nucleotide Sequence Data Mining, Bioinformatics, 19, 305-306.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
141
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
142 Arakawa, K. and Tomita, M. (2006) G-language System as a Platform for
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
143 large-scale analysis of high-throughput omics data, J. Pest Sci.,
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
144 31, 7.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
145
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
146 Arakawa, K., Kido, N., Oshita, K., Tomita, M. (2010) G-language Genome
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
147 Analysis Environment with REST and SOAP Web Service Interfaces,
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
148 Nucleic Acids Res., 38, W700-W705.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
149
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
150 Warnings
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 Diagnostic Error Messages
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
155
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
156 None.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
157
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
158 Exit status
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
159
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
160 It always exits with a status of 0.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
161
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
162 Known bugs
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
163
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
164 None.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
165
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
166 See also
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
167
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
168 gcbi Calculates the codon bias index (CBI)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
169 gdelta_enc Calculate the codon usage bias related to translation optimization (delta ENC)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
170 gicdi Calculates the intrinsic codon deviation index (ICDI)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
171
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
172 Author(s)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
173
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
174 Hidetoshi Itaya (celery@g-language.org)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
175 Institute for Advanced Biosciences, Keio University
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
176 252-0882 Japan
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
177
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
178 Kazuharu Arakawa (gaou@sfc.keio.ac.jp)
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
179 Institute for Advanced Biosciences, Keio University
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
180 252-0882 Japan
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
181
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
182 History
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
183
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
184 2012 - Written by Hidetoshi Itaya
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
185 2013 - Fixed by Hidetoshi Itaya
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
186
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
187 Target users
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
188
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
189 This program is intended to be used by everyone and everything, from
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
190 naive users to embedded scripts.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
191
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
192 Comments
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
193
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
194 None.
8300eb051bea Initial upload
ktnyt
parents:
diff changeset
195