help/help/html/features/preferences.html

   1 <html>
   2 <!--
   3  * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
   4  * Copyright (C) $$Year-Rel$$ The Jalview Authors
   5  *
   6  * This file is part of Jalview.
   7  *
   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.
  12  *
  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.
  17  *
  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.
  21  -->
  22 <head>
  23 <title>Preferences</title>
  24 </head>
  25
  26 <body>
  27   <p>
  28     <strong>Preferences</strong>
  29   </p>
  30   <p>
  31     The preferences panel is opened from the Jalview Desktop&rsquo;s <strong><em>Tools</em></strong>
  32     menu.
  33   </p>
  34   <p>There are eight tabs in the Preferences dialog box:
  35   <ul>
  36     <li>The <a href="#visual"><strong>&quot;Visual&quot;</strong>
  37         Preferences</a> tab allows you to configure the default display for
  38       a new alignment window.
  39     </li>
  40     <li>The <a href="#colours"><strong>&quot;Colours&quot;</strong>
  41         Preferences</a> tab allows you to configure default colourschemes
  42       for a new alignment window.
  43     </li>
  44     <li>The <a href="#overview"><strong>&quot;Overview&quot;</strong>
  45         Preferences</a> tab configures defaults for the overview window.
  46     </li>
  47     <li>The <a href="#structure"><strong>&quot;Structure&quot;</strong>
  48         Preferences</a> tab allows you to configure options for obtaining
  49       and displaying structure information.
  50     </li>
  51     <li>The <a href="#connections"><strong>&quot;Connections&quot;</strong>
  52         Preferences</a> tab allows you to configure Jalview's internet
  53       settings.
  54     </li>
  55     <li>The <a href="#links"><strong>&quot;Links&quot;</strong>
  56         Preferences</a> tab shows the currently configured <em>URL
  57         Links</em> shown in the <strong>Link</strong> submenu in the Sequence
  58       ID popup menu.
  59     </li>
  60     <li>The <a href="#output"><strong>&quot;Output&quot;</strong>
  61         Preferences</a> tab contains settings affecting the export of
  62       sequence alignments and EPS files.
  63     </li>
  64     <li>The <a href="#editing"><strong>&quot;Editing&quot;</strong>
  65         Preferences</a> tab contains settings affecting behaviour when editing alignments.
  66     </li>
  67     <li>The <a href="#startup"><strong>&quot;Startup&quot;</strong>
  68         Preferences</a> tab allows you to adjust how much memory is
  69       allocated to Jalview when it is launched.
  70     </li>
  71     <li>The <a href="#hmmer"><strong>&quot;HMMER&quot;</strong>
  72         Preferences</a> tab allows you to configure locally installed HMMER tools.
  73     </li>
  74     <li>The <a href="../webServices/webServicesPrefs.html"><strong>&quot;Web
  75           Service&quot;</strong> Preferences</a> tab allows you to configure the <a
  76       href="http://www.compbio.dundee.ac.uk/jabaws">JABAWS</a>
  77       servers that Jalview uses, and change the layout of the
  78       alignment's Web Services menu.
  79     </li>
  80   </ul>
  81   </p>
  82   <p>
  83     <strong><a name="visual">Visual</a> Preferences tab</strong>
  84   </p>
  85   <p>
  86     <em>Maximise Window</em> - If this is selected, a new alignment
  87     window will stretch to fit the available space.
  88   </p>
  89   <p>
  90     <em>Open Overview Window</em> - When this is selected, the <a
  91       href="overview.html">alignment overview</a> panel is opened
  92     by default for a new alignment window.
  93   </p>
  94   <p>
  95     <em>Show Annotations</em> - If this is selected the new window will
  96     display an annotation panel below the sequences. This annotation
  97     panel may have several rows describing the whole alignment. The 4
  98     standard annotations <em>Conservation</em>, <em>Quality</em>,
  99     <em>Occupancy</em> and <em>Consensus</em> for the alignment may
 100     be shown or hidden by default using the checkboxes adjacent and
 101     below.
 102   </p>
 103   <p>
 104     <em>Show group: Conservation and Consensus</em> controls the display
 105     of per-group automatic annotation.
 106   </p>
 107   <p>
 108     <em>Consensus: Histogram and Logo</em> checkboxes control the
 109     display of the consensus histogram and sequence logo for consensus
 110     annotation rows.
 111   </p>
 112   <p>
 113     <em>Full Sequence ID</em> - If selected the ID panel will display
 114     the name of a sequence plus the start and end residues in the format
 115     name/start-end. If not selected, the displayed ID will be the name
 116     of the sequence.
 117   </p>
 118   <p>
 119     <em>Right Align IDs</em> - select to align all sequence IDs to the
 120     left-hand edge of the sequence alignment, rather than the left-hand
 121     edge of the alignment display window.
 122   </p>
 123   <p>
 124     <em>Font</em> - The default font name, size and style can be set for
 125     a new alignment window.
 126   </p>
 127   <p>
 128     <em>Sequence ID Tooltip</em>: Control the display of Database
 129     References and Non-positional annotation in the tooltip displayed
 130     when the mouse is over a sequence's ID.
 131   </p>
 132   <p>
 133     <em>Show Unconserved</em> - When this is selected, all consensus
 134     sequence symbols will be rendered as a '.', highlighting mutations
 135     in highly conserved alignments.
 136   </p>
 137   <p>
 138     <em>Sequence Name Italics</em> - select to apply the italicised
 139     version of the font to sequence labels.
 140   </p>
 141   <p>
 142     <em>Smooth Font</em> - Toggles anti-aliasing on / off for faster
 143     rendering of the alignment.
 144   </p>
 145   <p>
 146     <em>Gap Symbol</em> - The default gap symbol may be set to either
 147     &quot;-&quot; or &quot;.&quot;
 148   </p>
 149   <p>
 150     <em>Wrap Alignment</em> - Select whether to open new alignment
 151     windows in wrapped mode or not.
 152   </p>
 153   <p>
 154     <em>Sort alignment by</em> - When the alignment is loaded in, it can
 155     be ordered as read (No sort), or sorted by Id or pairwise identity.
 156   </p>
 157   <p>
 158     <em>Sort annotations by</em> - Annotations can be unsorted, sorted
 159     by the order of the related sequences in the alignment, or by label.
 160     Autocalculated annotations (e.g. Consensus) can be shown either last
 161     (below sequence annotations) or first (above sequence annotations).
 162     <em>Since Jalview 2.8.2.</em>
 163   </p>
 164   <p>
 165     <em>Open file</em> - If this is selected then the default alignment
 166     file will be opened when Jalview is started. You can change the
 167     default file by clicking on file name and either typing in the file
 168     path or selecting it from the file chooser window.<br /> <em>Note:
 169       The default example alignment is updated periodically to
 170       demonstrate new features in Jalview.</em>
 171   </p>
 172   <p>
 173     <a name="colours"><strong>&quot;Colours&quot;
 174         Preferences tab</strong>
 175   </p>
 176   <p>
 177     <em>Alignment Colour</em> - The default colour scheme for a new
 178     alignment window. If the chosen option is &quot;User Defined&quot;
 179     then the last User Defined Colour loaded or saved via the User
 180     Defined Colours panel will be loaded.
 181   </p>
 182   <p>
 183     <em>Annotation Shading Default</em> - set the default minimum and
 184     maximum colours used when <a
 185       href="../colourSchemes/annotationColouring.html">Colour
 186       by Annotation...</a> is selected from the alignment window's colours
 187     menu.
 188   </p>
 189    <p>
 190     <a name="overview"><strong>&quot;Overview&quot;
 191         Preferences tab</strong>
 192   </p>
 193   <p>
 194     <em>Use legacy gap colouring (gaps are white)</em> - when enabled,
 195     Jalview's overview shows gaps as white, and sequences with no
 196     colourscheme applied as grey.
 197   </p>
 198   <p>
 199     <em>Show Hidden regions when opening overview</em> - default setting
 200     for inclusion of hidden regions.
 201   </p>
 202   <p>
 203     <em>Gap Colour</em> - When legacy gap colouring is not enabled, this
 204     configures the default colour for gaps in the overview.
 205   </p>
 206   <p>
 207     <em>Hidden Colour</em> - colour used to highlight regions in the
 208     overview that are hidden in the alignment.
 209   </p>
 210   <p>
 211     <a name="structure"><strong>&quot;Structure&quot;
 212         Preferences tab</strong></a><em> added in Jalview 2.8.2</em>
 213   </p>
 214   <p>
 215     <em>Process secondary structure from PDB</em> - if selected, then
 216     structure information read from PDB will be processed and annotation
 217     added to associated sequences.
 218   <p>
 219     <em>Add secondary structure annotation to alignment</em> - if
 220     selected, <a href="http://swift.cmbi.ru.nl/gv/dssp/">Jmol's
 221       implementation DSSP</a> will be used to add annotation to polypeptide
 222     chains in the structure.
 223   <p>
 224     <em>Add Temperature Factor annotation to alignment</em> - if
 225     selected, values extracted from the Temperature Factor column for
 226     the backbone atoms in the PDB file will be extracted as annotation
 227     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>
 228   <p>
 229     <em><strong>Default structure viewer</strong></em> - choose Jmol, CHIMERA, CHIMERAX or PYMOL for
 230     viewing 3D structures.
 231   <p>
 232     <em>Path to Chimera/X/Pymol program</em> - Optional, as Jalview will search
 233     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
 234     installed the chosen viewer in a non-standard location, you can specify it
 235     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>
 236   <p>
 237     <em>Sequence &lt;-&gt; Structure Mapping Method</em> - This setting controls whether
 238     Jalview attempts to retrieve mappings between Uniprot protein
 239     sequences and 3D structures in the PDBe with SIFTS, or constructs a
 240     mapping by conservative alignment between the sequences and chains
 241     in the 3D structure data using the Needleman and Wunsch algorithm.
 242     SIFTS is enabled by default.
 243   <p>
 244     <em>PDB Fields shown in Search and Structure Summaries</em> - ticks
 245     in this table indicate fields shown by default when browsing results
 246     of a free text search via the PDB sequence fetcher, or 3D structures
 247     offered by the 3D Structure Chooser.<p>
 248   <p>
 249     <a name="connections"><strong>&quot;Connections&quot;
 250         Preferences tab</strong></a>
 251   </p>
 252   <p>
 253     <em>Default Browser (Unix)</em><br> It's difficult in Java to
 254     detect the default web browser for Unix users. If Jalview can't find
 255     your default web browser, enter the name or full path to your web
 256     browser application.
 257   </p>
 258   <p>
 259     <em>Proxy Server</em><br>
 260     There are three settings to choose from:<br>
 261     <ul>
 262             <li><em>No proxy servers</em> will configure Jalview to use a
 263                     direct internet connection.</li>
 264             <li><em>System proxy servers</em> will configure Jalview to use
 265                     the proxy server passed to it by your system at startup.</li>
 266             <li><em>Use these proxy servers:</em> allows you to set a custom
 267                     proxy server.</li>
 268     </ul>
 269     If you normally use a proxy server for using the internet, you must
 270     choose one of <em>System proxy servers</em>, or if these have not been
 271     passed correctly you should set your own proxy servers to use by selecting
 272     <em>Use these proxy servers</em>.
 273     You will then need to enter the host and port details as necessary.
 274     Web Services will not work if you are using a proxy server and do
 275     not choose the system proxy or enter your own settings here.<br>
 276     There are separate host and port settings for HTTP and HTTPS proxies.
 277     Often these are the same but you should enter the host and port into both
 278     rows.<br>
 279     You can also check the <em>Authentication required</em> box if your proxy
 280     requires username and password authentication.  You can enter both the
 281     <em>Username</em> and <em>Password</em> but only the <em>Username</em> will
 282     be stored in Jalview's preferences file, the password will only be stored
 283     until the end of the current Jalview session.<br>
 284     This means that if the proxy settings are still valid, Jalview will ask for
 285     the password when it starts the next session.
 286   </p>
 287   <p>
 288     <em>Usage statistics, Questionnaire and Version checks</em><br>
 289     Uncheck these options to prevent Jalview from submitting usage
 290     statistics to google analytics, checking for Jalview questionnaires
 291     or retrieving details of the latest release version (at
 292     www.jalview.org). See the <a href="../privacy.html">user privacy
 293       statement</a> for more information.
 294   </p>
 295   <p>
 296   <a name="backups"><strong>The &quot;Backups&quot; Preferences Tab</strong></a>
 297   </p>
 298   <p>Since Jalview 2.11.0, overwriting an existing file when saving
 299     or exporting data will by default trigger a backup file to be
 300     created. Several options are provided to control how backup files
 301     are named, and how many old versions will be kept.</p>
 302     <p>
 303     <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.
 304     </p><p>
 305     <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>.
 306     </p>
 307     <p><em>Scheme Examples</em> - shows how backup files will appear according to the currently selected scheme and parameters.
 308     </p>
 309     <p><em>Deleting Old Backup Files</em> - these settings control how many backups are kept.</p>
 310     <p><em>Backup filename strategy</em> - specify the naming convention for numbered backups and how they are ordered.</p>
 311   <p>
 312     <a name="links"><strong>The &quot;Links&quot; Preferences
 313         tab</strong></a>
 314   </p>
 315   <p>
 316     This panel shows a table, and two sections - <em>Edit</em> and <em>Filter</em>.
 317     The table shows the available URL link definitions (consisting of a
 318     database, Name, and URL template string), a checkbox <em>In
 319       Menu</em> which indicates if the link is enabled, and <em>Double
 320       Click</em> which marks the link that will be opened if a sequence's ID
 321     is double clicked. The table can be sorted by clicking on the column headers.
 322   </p>
 323   <p><em>Edit Links</em><br /> This section contains three buttons,
 324     <em>New</em>, <em>Edit</em> and <em>Delete</em>, which allow you to
 325     create, modify and remove user-defined URL links from the Sequence
 326     ID's links submenu.
 327   </p>
 328   <p>
 329     <em>Filter</em><br /> The <em>Filter text</em> box allows you to
 330     quickly show rows in the table containing a particular text string.
 331     The <em>Custom only</em> button limits the entries in the table to
 332     just those you have configured yourself <em>via</em> the <em>Edit
 333       Links</em> buttons. Press <em>Show all</em> to clear any filters.
 334   </p>
 335   <p>The links table is prepopulated with persistent URLs for many common
 336     bioinformatics databases (since 2.10.2). These links are downloaded by Jalview from
 337     the <em>identifiers.org</em> website, and the names and URLs are not
 338     user editable.
 339     <a href="../webServices/urllinks.html#urllinks">Read more about configuring
 340       URL links.</a>
 341   </p>
 342   <p>
 343     <a name="output"><strong>Output Preferences tab</strong></a>
 344   </p>
 345   <p>
 346     <em>EPS Rendering Style</em><br> This is a selection box which
 347     allows the user to set a default rendering style for EPS export:
 348   <ul>
 349     <li>&quot;Prompt each time&quot;<br> Choose this to be
 350       asked to select between Lineart and Text each time you make an EPS
 351       file.
 352     </li>
 353     <li>&quot;Lineart&quot;<br> EPS files will accurately
 354       reproduce the alignment view in Jalview and all characters will be
 355       converted into line art. Files generated in this way are large and
 356       are not easily editable, but have no font table dependencies.
 357     </li>
 358     <li>&quot;Text&quot;<br> EPS files will be a mixture of
 359       text and lineart. This produces compact files that can be edited
 360       easily in programs like Microsoft Word and Adobe Illustrator, but
 361       can be problematic if the fonts available to Jalview are not
 362       accessible by the program reading the EPS file.
 363   </ul>
 364   <p>
 365     <em>Automatically set ID width</em><br> When enabled, the
 366     column containing sequence and annotation labels at the left hand
 367     side of an exported figure will be made large enough to display each
 368     sequence ID and annotation label in its own line. Enable this if you
 369     have particularly long sequence IDs and need to generate EPS or PNG
 370     figures or web pages.
 371   </p>
 372   <p>
 373     <em>Figure ID column width</em><br> Manually specify the width
 374     of the left hand column where sequence IDs and annotation labels
 375     will be rendered in exported alignment figures. This setting will be
 376     ignored if <em>&quot;Automatically set ID width&quot;</em> is set.
 377   </p>
 378   <p>
 379     <em>Sequence/Start-End Numbering</em><br> The output tab also
 380     has a group of checkboxes for each file format. If these are ticked,
 381     then Jalview will write files with the start and end sequence
 382     positions appended to each sequence id:
 383   <pre>
 384   >ID/1-10
 385   AACDEAAFEA
 386 </pre>
 387   <p>If the boxes are left unchecked for a particular format, the
 388     sequence limits will not be appended to the sequence id.</p>
 389   <p>
 390     <em>Embed BioJSON to HTML export</em>
 391   </p>
 392   <p>
 393     When this option is enabled, Jalview embeds <a
 394       href="bioJsonFormat.html">BioJSON</a> data within HTML files
 395     exported from Jalview at generation time. This enables the exported
 396     HTML files to be extracted and imported back into the Jalview
 397     desktop application at a later time.
 398   <p>
 399     <em>Use Modeller Output</em>
 400   </p>
 401   <p>
 402     This option only applies to PIR format output. Jalview automatically
 403     reads PIR files with sequence descriptions compatible with the
 404     program <a href="http://salilab.org/modeller/">Modeller</a>. If this
 405     option is selected <a href="../io/modellerpir.html">Jalview will
 406       write Modeller style PIR files</a> with correct start/end numbering
 407     and PDB file association (if available). The Jalview id/start-end
 408     option is ignored if Modeller output is selected.
 409   <p>
 410     <a name="editing"><strong>&quot;Editing&quot; Preferences tab</strong></a>
 411   </p>
 412   <p>There are currently three options available which can be
 413     selected / deselected.</p>
 414   <p>
 415     <em>AutoCalculate Consensus</em> - For large alignments it can be
 416     useful to deselect &quot;Autocalculate Consensus&quot; when editing.
 417     This prevents lengthy calculations which are performed after each
 418     sequence edit. New alignment windows will have their
 419     &quot;Autocalculate Consensus&quot; option set according to this
 420     setting.
 421   </p>
 422   <p>
 423     <em>Pad Gaps when Editing</em> - New alignment windows will
 424     &quot;Pad Gaps&quot; according to this setting.
 425   </p>
 426   <p>
 427     <em>Sort with New Tree</em> - When selected, any trees calculated or
 428     loaded onto the alignment will automatically sort the alignment.
 429   </p>
 430   <p>&nbsp;</p>
 431   <p>
 432     <a name="startup"><strong>Startup</strong></a>
 433   </p>
 434   <p>
 435     When Jalview is launched it by default examines the available memory
 436     and requests up to 90% to be allocated to the application, or 32G,
 437     which ever is smaller. The <em>Startup</em> tab allows you to adjust
 438     the maximum percentage and hard limits for Jalview memory allocation
 439     stored in your .jalview_properties file.
 440   </p>
 441   <p>&nbsp;</p>
 442   <p>
 443     <a name="hmmer"><strong>&quot;HMMER&quot; Preferences tab</strong></a>
 444   </p>
 445   <p>If you have installed HMMER tools (available from <a href="http://hmmerorg">hmmer.org</a>),
 446   then you should specify on this screen the location of the installation (the path to the folder
 447   containing binary executable programs). Double-click in the input field to open a file browser.</p>
 448   <p>When this path is configured, the <a href="../menus/alwhmmer.html">HMMER menu</a> will be
 449   enabled in the Alignment window.</p>
 450   <p>&nbsp;</p>
 451   <em>Web Services Preferences</em> - documentation for this tab is
 452   given in the
 453   <a href="../webServices/webServicesPrefs.html">Web Services
 454     Preferences section</a>.
 455   <p>&nbsp;</p>
 456 </body>
 457 </html>