Replacing web site content with fresh version from JWS2 (JABAWS production ) branch
[jabaws.git] / website / man_client.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
3 <html xmlns="http://www.w3.org/1999/xhtml">\r
4 <head>\r
5 <meta name="Last-modified" content="Mon, 11 Dec 2010 01:03:33 GMT"/>\r
6 <title>Java Bioinformatics Analyses Web Services (JABAWS) Command Line Client manual</title>\r
7 <link href="ws.css" rel="stylesheet" type="text/css" media=\r
8 "screen, projection, handheld, tv" />\r
9 <link rel="stylesheet" type="text/css" media="print" href=\r
10 "print.css" />\r
11 <script type="text/javascript" src="prototype-1.6.0.3.js"></script>\r
12 </head>\r
13 <body>\r
14 <div id="page">\r
15 <div id="banner">\r
16 <table> \r
17 <tr><td style="width:130px;"><a href="http://www.dundee.ac.uk"><img class="logo" src="images/uod_lt.gif"  alt="University of Dundee"  title="University of Dundee" longdesc="http://www.dundee.ac.uk"/></a></td>\r
18 <td class="bg"><h1><span class="headeru">JA</span>va <span class=\r
19 "headeru">B</span>ioinformatics <span class="headeru">A</span>nalysis <span class="headeru">W</span>eb <span\r
20 class="headeru">S</span>ervices</h1></td>\r
21 </tr>\r
22 </table></div><!-- banner end-->\r
23 \r
24 <div id="wrapper">\r
25 <div id="panel"><a href="index.html">Home</a> \r
26  <a class="selected" href="manual.html">Manual</a> \r
27         <div id="submenu">\r
28                 <a href="manual.html">Quick Start Guide</a>\r
29                 <a href="man_about.html">About</a>\r
30                 <a href="man_servervm.html" title="JABAWS Server as Virtual Appliance">Server VA</a>\r
31                 <a href="man_serverwar.html" title="JABAWS Server as Web Application aRchive">Server WAR</a>\r
32                 <a href="man_configuration.html" >Server<br/>\r
33                 Configuration</a>\r
34                 <a class="selected" href="man_client.html" title="JABAWS Command Line Client">CMD Client</a>\r
35                 <a href="man_dev.html" title="Accessing JABAWS from your program">Accessing<br/>\r
36                 JABAWS</a>      \r
37         </div>\r
38 <a href="download.html">Download</a> \r
39 <a href="http://www.compbio.dundee.ac.uk">Barton Group</a> \r
40 </div>\r
41 \r
42 <!-- panel end-->\r
43 <div id="content">\r
44 <h2 id="headtitle">JABAWS MANUAL</h2>\r
45 \r
46 <h2><a name="usingcclient" id="usingcclient"></a>JABAWS Command Line Client Usage </h2>\r
47 <p>The command line client comes as a part of <a href="download.html"> client package</a> which you are welcome to download. The command line client can be used to align sequences using any of JABAWS supported web services. The client is OS independent and supports most of the functions which can be accessed programmatically via <a href="dm_javadoc/index.html">JABAWS API</a>. Using this client you could align sequences using presets or custom parameters, please see examples of this below. Here is the list of options supported by the command line client. </p>\r
48 <span class="code"><strong>Usage:</strong> java -jar &lt;path_to_jar_file&gt; -h=host_and_context -s=serviceName ACTION [OPTIONS]\r
49 -h=&lt;host_and_context&gt; - a full URL to the JABAWS web server including context path e.g. http://10.31.10.159:8080/ws<br />\r
50 -s=&lt;ServiceName&gt; - one of [MafftWS, MuscleWS, ClustalWS, TcoffeeWS, ProbconsWS]\r
51 </p>\r
52 <br />\r
53 <strong>ACTIONS:</strong><br />\r
54 -i=&lt;inputFile&gt; - full path to fasta formatted sequence file, from which to align sequences<br />\r
55 -parameters - lists parameters supported by web service<br />\r
56 -presets - lists presets supported by web service<br />\r
57 -limits - lists web services limits<br />\r
58 Please note that if input file is specified other actions are ignored\r
59 </p>\r
60 <br />\r
61 <strong> OPTIONS:</strong> (only for use with -i action):<br />\r
62 -r=&lt;presetName&gt; - name of the preset to use<br />\r
63 -o=&lt;outputFile&gt; - full path to the file where to write an alignment<br />\r
64 -f=&lt;parameterInputFile&gt; - the name of the file with the list of parameters to use.<br />\r
65 Please note that -r and -f options cannot be used together. Alignment is done with either preset or a parameters from the file, but not both!</span>\r
66 <p>Align sequences from input.fasta file using Mafft web service with default settings, print alignment in Clustal format to console. </p>\r
67 <p class="code">java -jar jabaws-min-client.jar -h=http://myhost.compbio.ac.uk:8080/jabaws -s=MafftWS -i=d:\input.fasta</p>\r
68 <p>Content of input.fasta file is show below (please note sequences has been trimmed for clarity)<span class="code">&gt;Foobar<br />\r
69   MTADGPRELLQLRAAVRHRPQDFVAWL <br />\r
70   &gt;Bar<br />\r
71   MGDTTAGEMAVQRGLALHQ<br />\r
72   QRHAEAAVLLQQASDAAPE<br />\r
73   &gt;Foofriend<br />\r
74   MTADGPRELLQLRAAV</span></p>\r
75 <p>Align as in above example, but write output alignment in a file out.clustal, using parameters defined in prm.in file</p>\r
76 <p><span class="code">java -jar jabaws-min-client.jar -h=http://myhost.compbio.ac.uk:8080/jabaws  -s=MafftWS -i=d:\input.fasta -o=d:\out.clustal -f=prm.in </span></p>\r
77 <p>The content of the prm.in file is shown below <span class="code">--nofft<br />\r
78   --noscore<br />\r
79   --fastaparttree<br />\r
80   --retree=10<br />\r
81   --op=2.2</span></p>\r
82 <p>The format of the file is the same for all JABAWS web services. Parameters are specified in exactly the same way as for native executables - alignment programs like Mafft etc. So parameters which you can use with command line version of an alignment program can be used with JABAWS. Most of the settings controlling alignment process are supported, but the setting controlling output are not. This is due to the fact the output have to be handled by JABAWS, so must remain within its control. For a list of parameters supported by a web service see the next example. In <span class="hightlight">prm.in</span> parameters are separated by the new line, and name of the parameter is separated from its value with an equal sign. This format is constant no matter which JABAWS web service is used. <br />\r
83     <span class="code"> java -jar jabaws-min-client.jar -h=http://myhost.compbio.ac.uk:8080/jabaws -s=MafftWS -parameters</span></p>\r
84 <p>The same client can be used to access JABAWS on different hosts. Just point the client to the host you want to use by changing the value of -h key. For example you used <span class="hightlight">-h=http://myhost.compbio.ac.uk:8080/jabaws</span> server, now you want to use another server to <span class="hightlight">-h=http://mylabserver.myuni.edu.</span> This comes handy if your favorite server is off and you need to do the job yesterday. </p>\r
85 </div>\r
86 \r
87 <!-- content end-->\r
88 <div id="copyright">Last update: 7 January 2011<br />\r
89  Peter Troshin, Jim Procter and Geoff Barton, The Barton Group, University of\r
90 Dundee, UK</div>\r
91 </div>\r
92 \r
93 <!-- wrapper end-->\r
94 </div>\r
95 <!-- page end-->\r
96 \r
97 <!-- Google analitics -->\r
98 <script type="text/javascript">\r
99 var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");\r
100 document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));\r
101 </script>\r
102 <script type="text/javascript">\r
103 try{\r
104 var pageTracker = _gat._getTracker("UA-5356328-1");\r
105 pageTracker._trackPageview();\r
106 } catch(err) {}\r
107 </script>\r
108 </body>\r
109 </html>\r
110 \r