<body>
<p>
- <strong>Sequence feature colour schemes</strong>
- </p>
- <p>
- Jalview can visualize annotation present on parts of a sequence by
- overlaying colours according to the annotation present at each
- position. It allows features to be colored either according to type,
- or for a particular type, according to an individual feature's
- associated label or score. The <a href="featuresettings.html">Feature
- Settings dialog box</a> controls the order and display of each
- sequence annotation type, and also allows the colour scheme used for
- the the feature to be changed <em>via</em> the 'Graduated Colour'
- option in the sequence feature pop-up menu (obtained by
- right-clicking on a sequence feature).
+ <strong>Visualisation of Sequence Features</strong>
</p>
+ <p>Jalview can visualize sequence features - the positional
+ annotation present on parts of a sequence, as colours overlaid on
+ corresponding positions in the alignment. Features may be coloured
+ either according to their type, or for a particular type, according to
+ each feature's associated label, score, or other attributes.</p>
+ <p>
+ The <a href="featuresettings.html">Feature Settings dialog box</a>
+ controls the order and display of each feature type, and
+ also allows filters and colour schemes to be configured.
+ </p>
- <center>
- <img src="featurecoloursettings.gif"><br />Graduated feature
- colour scheme settings dialog box</img>
- </center>
- <p>The Graduated Feature Colour dialog box has the following
- controls:
- <ul>
- <li><em>Colour by Label</em> - when checked this derives a
- colour for each feature based on the label text.</li>
- <li><em>Min and Max Color boxes</em> - Click on these boxes to
- set the minimum and maximum colours used to shade features by
- their associated score.</li>
- <li><em>Threshold type combo box</em> - Allows features to be
- hidden features if their score is below or above a given
- threshold.<br /> <em>Set the threshold using the slider or
- type it in to the text box. The threshold cannot be set outside
- the available range of feature scores.</em></li>
- <li><em>Threshold is Min/Max</em> - When checked, the threshold
- will be used as the upper or lower limit when shading the features
- according to their score using the Min and Max colour.</li>
- </ul>
- </p>
- <p>
- <strong>Icon styles for graduated feature styles</strong><br />
- <p>
- When a graduated colourscheme is applied to a feature, it is
- indicated in the feature settings or amend feature dialog box by the
- following types of icon:<br />
- <center>
- <table width="50%" border="1">
- <tr>
- <td><strong>Type of Colouring</strong></td>
- <td><strong>Icon</strong></td>
- </tr>
- <tr>
- <td><em>Graduated colour by Feature Score</em></td>
- <td><img src="fcsminmax.gif" /></td>
- </tr>
- <tr>
- <td><em>Graduated colour thresholded (less than) by
- feature Score</em></td>
- <td><img src="fcsltthan.gif" /></td>
- </tr>
- <tr>
- <td><em>Graduated colour thresholded (greater than) by
- feature Score</em></td>
- <td><img src="fcsgtthan.gif" /></td>
- </tr>
- <tr>
- <td><em>Colour by Feature Label (may also be
- thresholded)</em></td>
- <td><img src="fcsntlabel.gif" /></td>
- </tr>
- <tr>
- <td align="center" colspan="2"><em> <strong>The
- current threshold is given in the icon's tooltip.</strong>
- </em></td>
- </tr>
- </table>
- </center>
- </p>
- <em>Graduated feature colours were introduced in Jalview 2.5</em>
+
+ <div align="center">
+ <img src="featureDisplaySettings.png" /><br />
+ <em>Feature Display Settings dialog for 'sequence_variant'
+ features imported from VCF</em>
+ </div>
+ <p>The Feature Display Settings has the following controls:
+ <p><strong>Colour</strong></p>
+ <ul>
+ <li><em>Simple Colour</em> - select this to assign a given colour
+ to any features of this type. The assigned colour can be changed by
+ clicking on the colour box.</li>
+ <li><em>Colour by text</em> - this option derives a colour for
+ each feature based on its label, or any other attributes presented <em>via</em>
+ the drop-down menu.</li>
+ <li><em>Graduated Colour</em> - shade features according to
+ associated score, or other numeric attribute.
+ <ul>
+ <li><em>Min and Max Color boxes</em> - Click on these boxes to
+ set the minimum and maximum colours for the shading scheme.</li>
+ <li><em>Threshold type combo box</em> - Specify an exclusion
+ threshold.<br />Set the threshold using the slider or
+ type it in to the text box. The threshold cannot be set outside
+ the available range of values observed for the selected attribute.</li>
+ <li><em>Threshold is Min/Max</em> - When checked, the threshold
+ will be used as the upper or lower limit for shading using the Min
+ and Max colour.</li>
+ </ul></li>
+ </ul>
+ <p>
+ <strong><em>Filters</em></strong><br /> Any number of filter
+ conditions may be specified to select features based on one or more
+ attributes. The <strong>join</strong> condition specifies whether all
+ filters must apply (<strong><em>And</em></strong>) or whether any one
+ filter must apply (<strong><em>Or</em></strong>) for a feature to be
+ selected.
+ </p>
+ <p>The filters available depend on the type of attribute:</p>
+ <ul>
+ <li><strong>Numeric</strong> - specify a threshold above, equal
+ to or below which a feature will be selected or ignored.</li>
+ <li><strong>String</strong> - select or ignore features based on
+ presence, absence, equivalence, or containment of a string.</li>
+ </ul>
+ <p>
+ The filters and colour schemes active for a particular feature type
+ are shown in the <em>Colour</em> and <em>Configuration</em> columns in
+ the feature settings dialog. Styles and filters can be saved as a
+ Jalview Feature Colours file, and are also exported and imported via <a
+ href="featuresFormat.html">Jalview Feature files</a>.
+
+ <p>
+ <strong>Icon styles for feature rendering styles</strong><br />
+
+ <p>
+ When a graduated colour scheme is applied to a feature according to
+ the value of a particular attribute, it is indicated in the feature
+ settings or amend feature dialog box by the following types of icon:<br />
+
+ <div align="center">
+ <table width="50%" border="1">
+ <tr>
+ <td><strong>Type of Colouring</strong></td>
+ <td><strong>Icon</strong></td>
+ </tr>
+ <tr>
+ <td><em>Graduated colour by Feature Score</em></td>
+ <td><img src="fcsminmax.gif" /></td>
+ </tr>
+ <tr>
+ <td><em>Graduated colour thresholded (less than) by
+ feature Score</em></td>
+ <td><img src="fcsltthan.gif" /></td>
+ </tr>
+ <tr>
+ <td><em>Graduated colour thresholded (greater than) by
+ feature Score</em></td>
+ <td><img src="fcsgtthan.gif" /></td>
+ </tr>
+ <tr>
+ <td><em>Colour by Feature Label (may also be thresholded)</em></td>
+ <td><img src="fcsntlabel.gif" /></td>
+ </tr>
+ <tr>
+ <td align="center" colspan="2"><em> <strong>The
+ current threshold and attribute is given in the icon's tooltip.</strong>
+ </em></td>
+ </tr>
+ </table>
+ </div>
+ </p>
+ <em>Graduated feature colours were introduced in Jalview 2.5.
+ Attribute based colouring and filters were added in Jalview 2.11.</em>
</body>
</html>
<p>
<strong>Sequence Feature Settings Dialog Box</strong>
</p>
+ <p>
+ Select <strong>View→Feature Settings...</strong> in an alignment
+ window to open the feature settings dialog box, which allows
+ precise control the visibility and appearance of sequence features for
+ an alignment view.
+ </p>
+ <div align="center">
+ <img src="featureSettings.png" width="400"> <br/>
+ Sequence Feature Settings for the Jalview Application (version 2.11)
+ </div>
+ <p>The top section of the dialog box lists all the sequence feature
+ groups, along with a tickbox for each that controls whether its
+ features are displayed. When many groups are present, their names may
+ be truncated, but the full name be shown in a tooltip when the mouse
+ hovers over their checkbox.</p>
+ <p><em>Feature colour schemes and filters</em>
+ <p>
+ The table in the middle lists all the feature types in the currently
+ selected groups, along with their display style, any configured
+ filters, and a tickbox indicating whether the type is enabled for
+ display.</p><p>Features may be highlighted with either a single colour or a <a
+ href="featureschemes.html">feature colourscheme</a> based on
+ either the scores associated with that feature or from the feature's
+ description (e.g. to distinguish different names associated with a
+ DOMAIN feature).The colour used for a feature can
+ be changed by clicking on its <strong><em>colour box</em></strong>. To configure the shading
+ style or filter for a feature, click its <strong><em>configuration</em></strong> box.
+ </p>
+ <p>
+ <em>Feature settings pop-up menu</em><br> <strong>Right-click</strong>
+ on a feature to open a pop-up menu that allows you to
+ <ul>
+ <li>Hide, show and select columns containing that feature</li>
+ <li>Sort the alignment or current selection according to count or score for that feature
+ type (see below)</li>
+ </ul>
+
+ <p>
+ <strong>Transparency and Feature Ordering</strong>
+ </p>
+ <p>Sequence features represent a variety of different types of
+ positional annotation, and often overlap. For example, a metal binding
+ site feature may be attached to one position along a stretch of
+ sequence marked with a secondary structure feature.</p>
+ <p>
+ The ordering of the sequence features in the dialog box list is the
+ order used by Jalview for rendering sequence features. A feature at
+ the bottom of the list is rendered <em>below</em> a feature higher
+ up in the list.<br> <em><strong>You can change
+ the order of a feature by dragging it up and down the list with
+ the mouse.</strong></em>
+ </p>
+ <p>
+ Use the <strong><em>Optimise order</em></strong> button to adjust the
+ feature render ordering to place features that on average cover shorter regions
+ of sequence above features annotating longer regions.
+ </p>
+ <p><a name="transparency"></a>
+ The <strong><em>transparency slider</em></strong> controls
+ the visibility of features rendered below other features. Reducing
+ the transparency will mean that features at the top of the list can
+ obscure features lower down, and increasing it allows the user to
+ 'see through' the upper layers of a set of features.
+ </p>
<p>
- Select <strong>View→Feature Settings...</strong> menu entry in
- an alignment window to open the feature settings dialog box, which
- allows you to precisely control the presence and appearance of
- sequence features for the current alignment.
+ <strong><em>You can save all features, with their
+ current colours and visibility in a Jalview format file. </em></strong>
</p>
- <center>
- <img src="featureSettings.gif" width="400" height="452"> <br>
- Sequence Feature Settings for the Jalview Application</img>
- </center>
<p>
- The top section of the dialog box lists all the sequence feature
- groups, along with a tickbox for each that controls whether its
- features are displayed. The table in the middle lists all the
- features in the currently selected groups, along with their display
- style and whether they are currently being displayed (only the
- ticked features and groups are displayed). <strong><em>You
- can change the colour or shading style used for a feature in the
- associated alignment by clicking on its colour box.</em></strong>
+ <a name="selectbyfeature"><strong>Selecting alignment
+ columns by feature</strong></a>
</p>
<p>
- <a name="selectbyfeature"><strong><em>Selecting
- alignment columns by feature</em></strong></a><br> <strong>Double-clicking
- a feature type</strong> in the <strong>Feature Settings</strong> dialog
- allows you to select columns in the alignment that contain (or do
- not contain) features of that type. If a region of the alignment is
- currently selected, then only features in the current selection will
- be searched. The following keys affect the way in which selections
- are made:
+ Double-clicking a <strong>feature type</strong> in the <strong>Feature
+ Settings</strong> dialog allows you to select columns in the alignment that
+ contain (or do not contain) features of that type that are currently visible (e.g. not filtered out or excluded due to an applied colour scheme threshold). If a region of the
+ alignment is currently selected, then only features in the current
+ selection will be searched. The following keys affect the way in which
+ selections are made:
+
<ul>
<li>Hold down <strong>Alt</strong> to select columns not
containing features of a particular type.
<em>Select columns by feature was added in Jalview 2.8.1</em>
</p>
<p>
- <strong><em>Feature settings pop-up menu</em></strong><br> <strong>Right-click</strong>
- on a feature to open a pop-up menu that allows you to
- <ul>
- <li>Hide, show and select columns containing that feature</li>
- <li>Sort the alignment or current selection using that feature
- type (see below)</li>
- <li>Toggle the type of colouring used for the feature</li>
- </ul>
- <p>
- Features may be highlighted with either a single colour or a <a
- href="featureschemes.html">feature colourscheme</a> based on
- either the scores associated with that feature or from the feature's
- description (e.g. to distinguish different names associated with a
- DOMAIN feature).
- </p>
- <p>
<strong><a name="sortbyfeature">Ordering alignment by
- features</a></strong><br> The 'Seq Sort by Score' and 'Seq Sort by
+ features</a></strong></p><p>The 'Seq Sort by Score' and 'Seq Sort by
Density' buttons will sort the alignment based on the average score
or total number of currently active features and groups on each
sequence. To order the alignment using a specific feature type, use
introduced in Jalview 2.5</em>
</p>
- <p>
- <strong>Transparency and Feature Ordering</strong>
- </p>
- <p>It is important to realise that sequence features are often not
- distinct and often overlap (for example, a metal binding site
- feature may be attached to one position along a stretch of sequence
- marked with a secondary structure feature).</p>
- <p>
- The ordering of the sequence features in the dialog box list is the
- order used by Jalview for rendering sequence features. A feature at
- the bottom of the list is rendered <em>below</em> a feature higher
- up in the list.<br> <em><strong>You can change
- the order of a feature by dragging it up and down the list with
- the mouse (not applet)</strong></em>.
- </p>
- <p>
- The <strong><em>Optimise order</em></strong> button (currently only
- available in the application) will re-order the feature render
- ordering based on the average length of each feature type.
- </p>
- <p><a name="transparency"></a>
- The <strong><em>transparency slider setting</em></strong> controls
- the visibility of features rendered below other features. Reducing
- the transparency will mean that features at the top of the list can
- obscure features lower down, and increasing it allows the user to
- 'see through' the upper layers of a set of features.
- </p>
- <p>
- <strong><em>You can save all features, with their
- current colours and visibility in a Jalview format file. </em></strong>
- </p>
</body>
</html>
git://source.jalview.org / jalview.git / commitdiff
