3 * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
4 * Copyright (C) $$Year-Rel$$ The Jalview Authors
6 * This file is part of Jalview.
8 * Jalview is free software: you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * as published by the Free Software Foundation, either version 3
11 * of the License, or (at your option) any later version.
13 * Jalview is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty
15 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
16 * PURPOSE. See the GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with Jalview. If not, see <http://www.gnu.org/licenses/>.
20 * The Jalview Authors are detailed in the 'AUTHORS' file.
23 <title>Preferences</title>
28 <strong>Preferences</strong>
31 The preferences panel is opened from the Jalview Desktop’s <strong><em>Tools</em></strong>
34 <p>There are eight tabs in the Preferences dialog box:
36 <li>The <a href="#visual"><strong>"Visual"</strong>
37 Preferences</a> tab allows you to configure the default display for
38 a new alignment window.
40 <li>The <a href="#colours"><strong>"Colours"</strong>
41 Preferences</a> tab allows you to configure default colourschemes
42 for a new alignment window.
44 <li>The <a href="#overview"><strong>"Overview"</strong>
45 Preferences</a> tab configures defaults for the overview window.
47 <li>The <a href="#structure"><strong>"Structure"</strong>
48 Preferences</a> tab allows you to configure options for obtaining
49 and displaying structure information.
51 <li>The <a href="#connections"><strong>"Connections"</strong>
52 Preferences</a> tab allows you to configure Jalview's internet
53 settings and specify your default web browser.
55 <li>The <a href="#links"><strong>"Links"</strong>
56 Preferences</a> tab shows the currently configured <em>URL
57 Links</em> shown in the <strong>Link</strong> submenu in the Sequence
60 <li>The <a href="#output"><strong>"Output"</strong>
61 Preferences</a> tab contains settings affecting the export of
62 sequence alignments and EPS files.
64 <li>The <a href="#editing"><strong>"Editing"</strong>
65 Preferences</a> tab contains settings affecting behaviour when editing alignments.
67 <li>The <a href="#hmmer"><strong>"HMMER"</strong>
68 Preferences</a> tab allows you to configure locally installed HMMER tools.
70 <li>The <a href="../webServices/webServicesPrefs.html"><strong>"Web
71 Service"</strong> Preferences</a> tab allows you to configure the <a
72 href="http://www.compbio.dundee.ac.uk/jabaws">JABAWS</a>
73 servers that Jalview uses, and change the layout of the
74 alignment's Web Services menu.
79 <strong><a name="visual">Visual</a> Preferences tab</strong>
82 <em>Maximise Window</em> - If this is selected, a new alignment
83 window will stretch to fit the available space.
86 <em>Open Overview Window</em> - When this is selected, the <a
87 href="overview.html">alignment overview</a> panel is opened
88 by default for a new alignment window.
91 <em>Show Annotations</em> - If this is selected the new window will
92 display an annotation panel below the sequences. This annotation
93 panel may have several rows describing the whole alignment. The 4
94 standard annotations <em>Conservation</em>, <em>Quality</em>,
95 <em>Occupancy</em> and <em>Consensus</em> for the alignment may
96 be shown or hidden by default using the checkboxes adjacent and
100 <em>Show group: Conservation and Consensus</em> controls the display
101 of per-group automatic annotation.
104 <em>Consensus: Histogram and Logo</em> checkboxes control the
105 display of the consensus histogram and sequence logo for consensus
109 <em>Full Sequence ID</em> - If selected the ID panel will display
110 the name of a sequence plus the start and end residues in the format
111 name/start-end. If not selected, the displayed ID will be the name
115 <em>Right Align IDs</em> - select to align all sequence IDs to the
116 left-hand edge of the sequence alignment, rather than the left-hand
117 edge of the alignment display window.
120 <em>Font</em> - The default font name, size and style can be set for
121 a new alignment window.
124 <em>Sequence ID Tooltip</em>: Control the display of Database
125 References and Non-positional annotation in the tooltip displayed
126 when the mouse is over a sequence's ID.
129 <em>Show Unconserved</em> - When this is selected, all consensus
130 sequence symbols will be rendered as a '.', highlighting mutations
131 in highly conserved alignments.
134 <em>Sequence Name Italics</em> - select to apply the italicised
135 version of the font to sequence labels.
138 <em>Smooth Font</em> - Toggles anti-aliasing on / off for faster
139 rendering of the alignment.
142 <em>Gap Symbol</em> - The default gap symbol may be set to either
143 "-" or "."
146 <em>Wrap Alignment</em> - Select whether to open new alignment
147 windows in wrapped mode or not.
150 <em>Sort alignment by</em> - When the alignment is loaded in, it can
151 be ordered as read (No sort), or sorted by Id or pairwise identity.
154 <em>Sort annotations by</em> - Annotations can be unsorted, sorted
155 by the order of the related sequences in the alignment, or by label.
156 Autocalculated annotations (e.g. Consensus) can be shown either last
157 (below sequence annotations) or first (above sequence annotations).
158 <em>Since Jalview 2.8.2.</em>
161 <em>Open file</em> - If this is selected then the default alignment
162 file will be opened when Jalview is started. You can change the
163 default file by clicking on file name and either typing in the file
164 path or selecting it from the file chooser window.<br /> <em>Note:
165 The default example alignment is updated periodically to
166 demonstrate new features in Jalview.</em>
169 <a name="colours"><strong>"Colours"
170 Preferences tab</strong>
173 <em>Alignment Colour</em> - The default colour scheme for a new
174 alignment window. If the chosen option is "User Defined"
175 then the last User Defined Colour loaded or saved via the User
176 Defined Colours panel will be loaded.
179 <em>Annotation Shading Default</em> - set the default minimum and
180 maximum colours used when <a
181 href="../colourSchemes/annotationColouring.html">Colour
182 by Annotation...</a> is selected from the alignment window's colours
186 <a name="overview"><strong>"Overview"
187 Preferences tab</strong>
190 <em>Use legacy gap colouring (gaps are white)</em> - when enabled,
191 Jalview's overview shows gaps as white, and sequences with no
192 colourscheme applied as grey.
195 <em>Show Hidden regions when opening overview</em> - default setting
196 for inclusion of hidden regions.
199 <em>Gap Colour</em> - When legacy gap colouring is not enabled, this
200 configures the default colour for gaps in the overview.
203 <em>Hidden Colour</em> - colour used to highlight regions in the
204 overview that are hidden in the alignment.
207 <a name="structure"><strong>"Structure"
208 Preferences tab</strong></a><em> added in Jalview 2.8.2</em>
211 <em>Process secondary structure from PDB</em> - if selected, then
212 structure information read from PDB will be processed and annotation
213 added to associated sequences.
215 <em>Use RNAView for secondary structure</em> - if selected, the
216 pyRNA RNAView service (<a href="https://github.com/fjossinet/PyRNA">https://github.com/fjossinet/PyRNA</a>)
217 will be called to derive secondary structure information for RNA
220 <em>Add secondary structure annotation to alignment</em> - if
221 selected, <a href="http://swift.cmbi.ru.nl/gv/dssp/">Jmol's
222 implementation DSSP</a> will be used to add annotation to polypeptide
223 chains in the structure.
225 <em>Add Temperature Factor annotation to alignment</em> - if
226 selected, values extracted from the Temperature Factor column for
227 the backbone atoms in the PDB file will be extracted as annotation
228 lines shown on the alignment.<br/><em>Since 2.11.2, scores from the Temperature Column for structures imported via the 3D-Beacons network may be shown instead as model quality or reliability scores.</em>
230 <em>Default structure viewer</em> - choose Jmol, CHIMERA, CHIMERAX or PYMOL for
231 viewing 3D structures.
233 <em>Path to Chimera/X/Pymol program</em> - Optional, as Jalview will search
234 standard installation paths for Windows, Linux or MacOS. If Jalview cannot locate the installation for your selected structure viewer, a dialog will be shown. If you have
235 installed the chosen viewer in a non-standard location, you can specify it
236 here, by entering the full path to its executable.<br/>For Chimera, locate the path to the chimera program, similarly for ChimeraX and Pymol. Rather than typing in the path, you can also <em>double-click this field</em> to open a file chooser dialog.</p>
238 <em>PDB Fields shown in Search and Structure Summaries</em> - ticks
239 in this table indicate fields shown by default when browsing results
240 of a free text search via the PDB sequence fetcher, or 3D structures
241 offered by the 3D Structure Chooser.<p>
243 <a name="connections"><strong>"Connections"
244 Preferences tab</strong></a>
247 <em>Default Browser (Unix)</em><br> It's difficult in Java to
248 detect the default web browser for Unix users. If Jalview can't find
249 your default web browser, enter the name or full path to your web
253 <em>Proxy Server</em><br>
254 There are three settings to choose from:<br>
256 <li><em>No proxy servers</em> will configure Jalview to use a
257 direct internet connection.</li>
258 <li><em>System proxy servers</em> will configure Jalview to use
259 the proxy server passed to it by your system at startup.</li>
260 <li><em>Use these proxy servers:</em> allows you to set a custom
263 If you normally use a proxy server for using the internet, you must
264 choose one of <em>System proxy servers</em>, or if these have not been
265 passed correctly you should set your own proxy servers to use by selecting
266 <em>Use these proxy servers</em>.
267 You will then need to enter the host and port details as necessary.
268 Web Services will not work if you are using a proxy server and do
269 not choose the system proxy or enter your own settings here.<br>
270 There are separate host and port settings for HTTP and HTTPS proxies.
271 Often these are the same but you should enter the host and port into both
273 You can also check the <em>Authentication required</em> box if your proxy
274 requires username and password authentication. You can enter both the
275 <em>Username</em> and <em>Password</em> but only the <em>Username</em> will
276 be stored in Jalview's preferences file, the password will only be stored
277 until the end of the current Jalview session.<br>
278 This means that if the proxy settings are still valid, Jalview will ask for
279 the password when it starts the next session.
282 <em>Usage statistics, Questionnaire and Version checks</em><br>
283 Uncheck these options to prevent Jalview from submitting usage
284 statistics to google analytics, checking for Jalview questionnaires
285 or retrieving details of the latest release version (at
286 www.jalview.org). See the <a href="../privacy.html">user privacy
287 statement</a> for more information.
290 <a name="backups"><strong>The "Backups" Preferences Tab</strong></a>
292 <p>Since Jalview 2.11.0, overwriting an existing file when saving
293 or exporting data will by default trigger a backup file to be
294 created. Several options are provided to control how backup files
295 are named, and how many old versions will be kept.</p>
297 <em>Schemes</em> - select from three default schemes <em>Single Backup</em>, <em>Keep All Versions</em>, and <em>Rolled Backup Files</em>, or choose <em>Custom</em> to enable a previously defined custom scheme.
299 <em>Custom</em> - Check this box to adjust the parameters of the currently selected scheme. Once <em>OK</em> is selected these parameters will be saved as the <em>Custom</em> scheme in your user preferences. To revert changes hit <em>Cancel</em>.
301 <p><em>Scheme Examples</em> - shows how backup files will appear according to the currently selected scheme and parameters.
303 <p><em>Deleting Old Backup Files</em> - these settings control how many backups are kept.</p>
304 <p><em>Backup filename strategy</em> - specify the naming convention for numbered backups and how they are ordered.</p>
306 <a name="links"><strong>The "Links" Preferences
310 This panel shows a table, and two sections - <em>Edit</em> and <em>Filter</em>.
311 The table shows the available URL link definitions (consisting of a
312 database, Name, and URL template string), a checkbox <em>In
313 Menu</em> which indicates if the link is enabled, and <em>Double
314 Click</em> which marks the link that will be opened if a sequence's ID
315 is double clicked. The table can be sorted by clicking on the column headers.
317 <p><em>Edit Links</em><br /> This section contains three buttons,
318 <em>New</em>, <em>Edit</em> and <em>Delete</em>, which allow you to
319 create, modify and remove user-defined URL links from the Sequence
323 <em>Filter</em><br /> The <em>Filter text</em> box allows you to
324 quickly show rows in the table containing a particular text string.
325 The <em>Custom only</em> button limits the entries in the table to
326 just those you have configured yourself <em>via</em> the <em>Edit
327 Links</em> buttons. Press <em>Show all</em> to clear any filters.
329 <p>The links table is prepopulated with persistent URLs for many common
330 bioinformatics databases (since 2.10.2). These links are downloaded by Jalview from
331 the <em>identifiers.org</em> website, and the names and URLs are not
333 <a href="../webServices/urllinks.html#urllinks">Read more about configuring
337 <a name="output"><strong>Output Preferences tab</strong></a>
340 <em>EPS Rendering Style</em><br> This is a selection box which
341 allows the user to set a default rendering style for EPS export:
343 <li>"Prompt each time"<br> Choose this to be
344 asked to select between Lineart and Text each time you make an EPS
347 <li>"Lineart"<br> EPS files will accurately
348 reproduce the alignment view in Jalview and all characters will be
349 converted into line art. Files generated in this way are large and
350 are not easily editable, but have no font table dependencies.
352 <li>"Text"<br> EPS files will be a mixture of
353 text and lineart. This produces compact files that can be edited
354 easily in programs like Microsoft Word and Adobe Illustrator, but
355 can be problematic if the fonts available to Jalview are not
356 accessible by the program reading the EPS file.
359 <em>Automatically set ID width</em><br> When enabled, the
360 column containing sequence and annotation labels at the left hand
361 side of an exported figure will be made large enough to display each
362 sequence ID and annotation label in its own line. Enable this if you
363 have particularly long sequence IDs and need to generate EPS or PNG
364 figures or web pages.
367 <em>Figure ID column width</em><br> Manually specify the width
368 of the left hand column where sequence IDs and annotation labels
369 will be rendered in exported alignment figures. This setting will be
370 ignored if <em>"Automatically set ID width"</em> is set.
373 <em>Sequence/Start-End Numbering</em><br> The output tab also
374 has a group of checkboxes for each file format. If these are ticked,
375 then Jalview will write files with the start and end sequence
376 positions appended to each sequence id:
381 <p>If the boxes are left unchecked for a particular format, the
382 sequence limits will not be appended to the sequence id.</p>
384 <em>Embed BioJSON to HTML export</em>
387 When this option is enabled, Jalview embeds <a
388 href="bioJsonFormat.html">BioJSON</a> data within HTML files
389 exported from Jalview at generation time. This enables the exported
390 HTML files to be extracted and imported back into the Jalview
391 desktop application at a later time.
393 <em>Use Modeller Output</em>
396 This option only applies to PIR format output. Jalview automatically
397 reads PIR files with sequence descriptions compatible with the
398 program <a href="http://salilab.org/modeller/">Modeller</a>. If this
399 option is selected <a href="../io/modellerpir.html">Jalview will
400 write Modeller style PIR files</a> with correct start/end numbering
401 and PDB file association (if available). The Jalview id/start-end
402 option is ignored if Modeller output is selected.
404 <a name="editing"><strong>"Editing" Preferences tab</strong></a>
406 <p>There are currently three options available which can be
407 selected / deselected.</p>
409 <em>AutoCalculate Consensus</em> - For large alignments it can be
410 useful to deselect "Autocalculate Consensus" when editing.
411 This prevents lengthy calculations which are performed after each
412 sequence edit. New alignment windows will have their
413 "Autocalculate Consensus" option set according to this
417 <em>Pad Gaps when Editing</em> - New alignment windows will
418 "Pad Gaps" according to this setting.
421 <em>Sort with New Tree</em> - When selected, any trees calculated or
422 loaded onto the alignment will automatically sort the alignment.
425 <a name="hmmer"><strong>"HMMER" Preferences tab</strong></a>
427 <p>If you have installed HMMER tools (available from <a href="http://hmmerorg">hmmer.org</a>),
428 then you should specify on this screen the location of the installation (the path to the folder
429 containing binary executable programs). Double-click in the input field to open a file browser.</p>
430 <p>When this path is configured, the <a href="../menus/alwhmmer.html">HMMER menu</a> will be
431 enabled in the Alignment window.</p>
433 <em>Web Services Preferences</em> - documentation for this tab is
435 <a href="../webServices/webServicesPrefs.html">Web Services
436 Preferences section</a>.