2e1cf433c006f27c433c1e8a2238cca7827ae584
[jalview.git] / help / html / features / preferences.html
1 <html>
2
3 <head>
4 <title>Preferences</title>
5 </head>
6
7 <body>
8 <p><strong>Preferences</strong></p>
9 <p>There are four tabs in the Preferences dialog box: 
10 <ul>
11         <li>The <a href="#visual"><strong>&quot;Visual&quot;</strong>
12         Preferences</a> tab allows you to configure the default display for a new
13         alignment window.</li>
14         <li>The <a href="#connections"><strong>&quot;Connections&quot;</strong>
15         Preferences</a> tab allows you to change the links made from Jalview to
16         your default web browser.</li>
17         <li>The <a href="#output"><strong>&quot;Output&quot;</strong>
18         Preferences</a> tab contains settings affecting the export of sequence
19         alignments and EPS files.</li>
20         <li>The <a href="#editing"><strong>&quot;Editing&quot;</strong>
21         Preferences</a> tab contains settings affecting the export of sequence
22         alignments and EPS files.</li>
23         <li>The <a href="#editing"><strong>&quot;DAS
24         Settings&quot;</strong> Preferences</a> tab allows you to select which DAS sources
25         to use when fetching DAS Features.</li>
26 </ul>
27 </p>
28 <p><strong><a name="visual">Visual</a> Preferences tab</strong></p>
29 <p><em>Maximise Window</em> - If this is selected, a new alignment
30 window will stretch to fit the available space.</p>
31 <p><em>Open Overview Window</em> - When this is selected, the <a
32         href="overview.html">alignment overview</a> panel is opened by default
33 for a new alignment window.</p>
34 <p><em>Show Annotations</em> - If this is selected the new window
35 will display an annotation panel below the sequences. This annotation
36 panel may have several rows describing the whole alignment. The 3
37 standard annotations <em>Conservation</em>, <em>Quality</em> and <em>Consensus</em>
38   may be shown or hidden by default.</p>
39 <p><em>Full Sequence ID</em> - If selected the ID panel will display
40 the name of a sequence plus the start and end residues in the format
41 name/start-end. If not selected, the displayed ID will be the name of
42 the sequence.</p>
43 <p><em>Right Align IDs</em> - select to align all sequence IDs to
44 the left-hand edge of the sequence alignment, rather than the left-hand
45 edge of the alignment display window.</p>
46 <p><em>Font</em> - The default font name, size and style can be set
47 for a new alignment window.</p>
48 <p><em>Sequence Name Italics</em> - select to apply the italicised
49 vbersion of the font to sequence labels.</p>
50 <p><em>Smooth Font</em> - Toggles anti-aliasing on / off for faster
51 rendering of the alignment.</p>
52 <p><em>Wrap Alignment</em> - Select whether to open new alignment
53 windows in wrapped mode or not.</p>
54 <p><em>Gap Symbol</em> - The default gap symbol may be set to either
55 &quot;-&quot; or &quot;.&quot;</p>
56 <p><em>Colour</em> - The default colour scheme for a new alignment
57 window. If the chosen option is &quot;User Defined&quot; then the last
58 User Defined Colour loaded or saved via the User Defined Colours panel
59 will be loaded.</p>
60 <p><em>Sort by</em> - When the alignment is loaded in, it will can
61 be sorted by Id or pairwise identity.</p>
62 <p><em>Open file</em> - If this is selected then the default
63 alignment file will be opened when Jalview is started. You can change
64 the default file by clicking on file name and either typing in the file
65 path or selecting it from the file chooser window.</p>
66 <p><a name="connections"><strong>&quot;Connections&quot;
67 Preferences tab</strong></a></p>
68 <p><em>URL Link From Sequence ID</em><br>
69 These definitions are used to generate URLs from a sequence's ID or
70 database cross references. Read more about <a
71         href="../webServices/urllinks.html#urllinks">configuring URL links
72 here</a>.</p>
73 <p><em>Default Browser (Unix)</em><br>
74 Its difficult in Java to detect the default web browser for Unix users.
75 If Jalview can't find your default web browser, enter the name or full
76 path to your web browser application.</p>
77 <p><em>Proxy Server</em><br>
78 If you normally use a proxy server for using the internet, you must tick
79 the box &quot;Use a Proxy Server&quot; and enter the address and port
80 details as necessary. Web Services will not work if you are using a
81 proxy server and do not enter the settings here.</p>
82 <p><em>Usage statistics, Questionnaire and Version checks</em><br>
83 Uncheck these options to prevent Jalview from submitting usage
84 statistics to google analytics, checking for jalview questionnaires or
85 retrieving details of the latest release version (at www.jalview.org).
86 See the <a href="../privacy.html">user privacy statement</a> for more
87 information.</p>
88 <p><a name="output"><strong>Output Preferences tab</strong></a></p>
89 <p><em>EPS Rendering Style</em><br>
90 This is a selection box which allows the user to set a default rendering
91 style for EPS export:
92 <ul>
93         <li>&quot;Lineart&quot;<br>
94         EPS files will accurately reproduce the alignment view in Jalview and
95         all characters will be converted into line art. Files generated in this
96         way are large and are not easily editable, but have no font table
97         dependencies.</li>
98         <li>&quot;Text&quot;<br>
99         EPS files will be a mixture of text and lineart. This produces compact
100         files that can be edited easily in programs like Microsoft Word and
101         Adobe Illustrator, but can be problematic if the fonts available to
102         jalview are not accessible by the program reading the EPS file.
103         <li>&quot;Prompt each time&quot;<br>
104         Choose this to be asked select between Lineart and Text each time you
105         make an EPS file.</li>
106 </ul>
107 </p>
108 <p><em>Sequence//Start-End Numbering</em><br>
109 The output tab also has a group of checkboxes for each file format. If
110 these are ticked, then Jalview will write files with the start and end
111 sequence positions appended to each sequence id:
112 <pre>
113   >ID/1-10
114   AACDEAAFEA
115 </pre>
116 <p>If the boxes are left unchecked for a particular format, the
117 sequence limits will not be appended to the sequence id.</p>
118 </p>
119 <p><em>Use Modeller Output</em></p>
120 <p>This option only applies to PIR format output. Jalview
121 automatically reads PIR files with sequence descriptions compatible with
122 the program <a href="http://salilab.org/modeller/">Modeller</a>. If this
123 option is selected <a href="../io/modellerpir.html">Jalview will
124 write Modeller style PIR files</a> with correct start/end numbering and PDB
125 file association (if available). The Jalview id/start-end option is
126 ignored if Modeller output is selected.
127 <p><a name="editing"><strong>Editing Preferences tab</strong></a></p>
128 <p>There are currently 2 options available which can be selected /
129 deselected.</p>
130 <p><em>AutoCalculate Consensus</em> - For large alignments it can be
131 useful to deselect &quot;Autocalculate Consensus&quot; when editing.
132 This prevents lengthy calculations which are performed after each
133 sequence edit. New alignment windows will have their &quot;Autocalculate
134 Consensus&quot; option set according to this setting.</p>
135 <p><em>Pad gaps when editing</em> - New alignment windows will
136 &quot;Pad Gaps&quot; according to this setting.</p>
137 <p><a name="editing"><strong>DAS Settings </strong></a></p>
138 <p>See <a href="dassettings.html">DAS Settings</a></p>
139 <p>&nbsp;</p>
140 <p>&nbsp;</p>
141 </body>
142 </html>