-<html>\r
-<!--\r
- * Jalview - A Sequence Alignment Editor and Viewer (Version 2.7)\r
- * Copyright (C) 2011 J Procter, AM Waterhouse, G Barton, M Clamp, S Searle\r
- * \r
- * This file is part of Jalview.\r
- * \r
- * Jalview is free software: you can redistribute it and/or\r
- * modify it under the terms of the GNU General Public License \r
- * as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.\r
- * \r
- * Jalview is distributed in the hope that it will be useful, but \r
- * WITHOUT ANY WARRANTY; without even the implied warranty \r
- * of MERCHANTABILITY or FITNESS FOR A PARTICULAR \r
- * PURPOSE. See the GNU General Public License for more details.\r
- * \r
- * You should have received a copy of the GNU General Public License along with Jalview. If not, see <http://www.gnu.org/licenses/>.\r
--->\r
-<head>\r
-<title>Groovy Shell</title>\r
-</head>\r
-<body>\r
- <p>\r
- <strong>The Groovy Shell</strong>\r
- </p>\r
- <p>\r
- <a href="http://groovy.codehaus.org/">Groovy</a> is an "<em>agile\r
- and dynamic language for the Java platform</em>". The groovy\r
- scripting language makes it extremely easy to programmatically\r
- interact with Java programs, in much the same way that Javascript is\r
- used to generate and interact with applets and other objects on the\r
- page.\r
- </p>\r
- <p>\r
- <strong><em>Getting Groovy...</em>\r
- </strong><br> Jalview Groovy support is only possible if the core groovy\r
- jars which include the GroovyShell are present on the CLASSPATH when\r
- Jalview is started.\r
- </p>\r
- <p>\r
- The jars are obtained from the <em>embedded</em> directory within the\r
- <a href="http://dist.codehaus.org/groovy/distributions">groovy\r
- distribution</a>. The easiest way of adding them to the Jalview classpath\r
- is to download and build jalview from it's source distribution, and\r
- then add the groovy-all-*.jar to the lib directory whose path is given\r
- in the java.ext.dirs property.\r
- </p>\r
- <p>\r
- <strong>Opening Jalview's Groovy Console</strong><br>If groovy is\r
- available, then the <strong>Tools→Groovy Console...</strong>\r
- menu entry will be available from the Jalview Desktop's drop-down\r
- menu. Selecting this will open the <a\r
- href="http://groovy.codehaus.org/Groovy+Console">Groovy Console</a>\r
- which allows you to interactively execute Groovy scripts within the\r
- Jalview run-time environment.\r
- </p>\r
- <p>\r
- <strong>Executing groovy scripts on Jalview startup</strong><br>\r
- The -groovy <script> option on the <a href="commandline.html" />\r
- Jalview command line</a> will execute the contents of <script>.\r
- <script> may be a file, a URL, or alternatively if it is\r
- "STDIN" then the standard input will be used.<br>\r
- <em>Note: The groovy script will be executed <strong>after</strong>\r
- any data is loaded, and <strong>before</strong> images or any output\r
- files are written. This allows you to perform customised jalview\r
- analysis workflows with groovy.</em>\r
- </p>\r
- <p>\r
- <strong>Access to Jalview's functions from Groovy Scripts</strong><br>\r
- There is as yet no properly defined scripting interface to Jalview,\r
- but all the public methods of the jalview class hierarchy can be\r
- called from Groovy scripts. The access point for this is the <strong>Jalview</strong>\r
- object defined in the groovy environent which corresponds to the\r
- <pre>jalview.gui.Desktop</pre>\r
- object which manages all the Jalview windows.\r
- </p>\r
- Here's an example to get you started:\r
- <br>\r
- <ul>\r
- <li>Getting the title, alignment and first sequence from the\r
- current alignFrame<br> <pre>\r
-def alf = Jalview.getAlignframes();\r
-print alf[0].getTitle();\r
-def alignment = alf[0].viewport.alignment;\r
-def seq = alignment.getSequenceAt(0);\r
-</pre></li>\r
-<li>When running a groovy script from the command line, the alignment that was just loaded can be referred to like so:<br><pre>\r
-print currentAlFrame.getTitle();</pre>\r
- </ul>\r
- </p>\r
-\r
- <p> </p>\r
-</body>\r
-</html>\r
+<html>
+<!--
+ * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
+ * Copyright (C) $$Year-Rel$$ The Jalview Authors
+ *
+ * This file is part of Jalview.
+ *
+ * Jalview is free software: you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation, either version 3
+ * of the License, or (at your option) any later version.
+ *
+ * Jalview is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty
+ * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+ * PURPOSE. See the GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with Jalview. If not, see <http://www.gnu.org/licenses/>.
+ * The Jalview Authors are detailed in the 'AUTHORS' file.
+ -->
+<head>
+<title>Groovy Shell</title>
+</head>
+<body>
+ <p>
+ <strong>The Groovy Shell</strong>
+ </p>
+ <p>
+ Groovy (<a href="http://www.groovy-lang.org/">www.groovy-lang.org</a>)
+ is an "<em>agile and dynamic language for the Java
+ platform</em>". The groovy scripting language makes it extremely
+ easy to programmatically interact with Java programs, in much the
+ same way that Javascript is used to generate and interact with
+ applets and other objects on the page.
+ </p>
+ <p>
+ <em>Getting Groovy...</em><br> Jalview comes with an embedded
+ installation of Groovy. Just select <strong>Tools→Groovy
+ Console...</strong> from the Jalview Desktop's drop-down menu. After a
+ short pause, you should then see the <a
+ href="http://groovy-lang.org/groovyconsole.html">Groovy
+ Console</a> appear. This allows you to interactively execute Groovy
+ scripts whilst Jalview is running. We've also provided a <strong>Calculations→Execute
+ Groovy Script</strong> button so you can execute the currently loaded
+ groovy script whilst viewing an alignment.
+ </p>
+ <p>
+ <strong>Executing groovy scripts on Jalview startup</strong><br>
+ The -groovy <script> option on the <a href="commandline.html">
+ Jalview command line</a> will execute the contents of <script>.
+ <script> may be a file, a URL, or alternatively if it is
+ "STDIN" then the standard input will be used.<br> <em>Note:
+ The groovy script will be executed <strong>after</strong> any data
+ is loaded, and <strong>before</strong> images or any output files
+ are written. This allows you to perform customised Jalview
+ analysis workflows with groovy.
+ </em>
+ </p>
+ <p>
+ <strong>Access to Jalview's functions from Groovy Scripts</strong><br>
+ The scripting interface to Jalview is still a work in progress, so
+ we recommend you also take a look at Jalview's source, since all the
+ public methods of the jalview class hierarchy can be called from
+ Groovy scripts. In addition, the following objects are also defined:
+
+
+
+ <ul>
+ <li><strong>Jalview</strong> - this is bound to <code>jalview.bin.Jalview</code>.<br />Useful
+ methods include:
+ <ul>
+ <li>Jalview.getAlignFrames() - returns a list of
+ jalview.gui.AlignFrame objects</li>
+ <li>Jalview.getCurrentAlignFrame() - returns the alignment
+ window which is currently being looked at by the user</li>
+ </ul></li>
+ <li><strong>currentAlFrame</strong> - this is only defined when
+ running a Groovy script via the -groovy command line argument. It
+ returns the first alignment window created after acting on the
+ other arguments passed on the command line.</li>
+ </ul>
+ <p>
+ <em>A simple script</em><br />
+ <ul>
+ <li>Getting the title, alignment and first sequence from the
+ current alignFrame<br> <pre>
+def alf = Jalview.getAlignFrames();
+print alf[0].getTitle();
+def alignment = alf[0].viewport.alignment;
+def seq = alignment.getSequenceAt(0);
+</pre>
+ </li>
+ <li>If you wanted to do the same thing from the command line,
+ you can refer to alignment that was just loaded with
+ currentAlFrame:<br> <pre>
+print currentAlFrame.getTitle();</pre>
+ </ul>
+ <p>
+ <em>Example scripts</em><br />If you have downloaded the
+ InstallAnywhere version of Jalview, you can find additional groovy
+ scripts in the examples/groovy subfolder of the installation
+ directory. The examples are also available at <a
+ href="http://www.jalview.org/examples/groovy">http://www.jalview.org/examples/groovy</a>.
+ </p>
+ <p>
+ <em>Using Groovy to add new Alignment Calculations</em><br />We've
+ simplified the alignment analysis programming interface in Jalview
+ 2.10 to make it easy for you to add your own dynamic annotation
+ tracks with Groovy. Have a look at the <a
+ href="../groovy/featureCounter.html">featureCounter.groovy</a>
+ example for more information.
+ </p>
+
+</body>
+</html>
git://source.jalview.org / jalview.git / blobdiff