X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=help%2Fhtml%2Ffeatures%2FannotationsFormat.html;h=38d17e289eb58895554f973c3220fcc12cb86ed3;hb=74e0948bc8efef9a573f037e8c037c46fade0c6f;hp=b5a52f5583bceb77d9a22ed79476e3a904fe1abe;hpb=811f68c1dc1e4c409751b785203ed0a7289529b3;p=jalview.git diff --git a/help/html/features/annotationsFormat.html b/help/html/features/annotationsFormat.html index b5a52f5..38d17e2 100755 --- a/help/html/features/annotationsFormat.html +++ b/help/html/features/annotationsFormat.html @@ -1,5 +1,21 @@ - +
Color strings can be embedded in a value field by enclosing an RGB triplet in square brackets to colour that position in an annotation row.
You can associate an annotation with a sequence by preceding its
-definition with the line: SEQUENCE_REF seq_name [startIndex]
+definition with the line:
+
SEQUENCE_REF seq_name [startIndex]All Annotations defined after a SEQUENCE_REF command will then be associated with that sequence, and the first field in the Value field list will (optionally) be placed at the startIndex'th column. +
Sequence associations are turned off for subsequent annotation
-definitions by: SEQUENCE_REF ALIGNMENT
SEQUENCE_REF ALIGNMENT+ +
Since version 2.5, Jalview allows annotation rows to be associated with a group defined on the alignment, by preceding the annotation row with the line: +
GROUP_REF group_name+Group association is turned off for subsequent annotation rows by +
GROUP_REF ALIGNMENT+Annotations may be associated with both a sequence and a group, however - group annotations are still experimental and unexpected behaviour may be observed when editing alignments containing both group and sequence associated annotation rows.
LINE_GRAPH type annotations can be given a colour
(specified as 24 bit RGB triplet in hexadecimal or comma separated
values), combined onto the same vertical axis, and have ordinate lines
(horizontal lines at a particular vertical axis value) using the
-following commands (respectively): COLOUR graph_name colour
+following commands (respectively):
+
+GRAPHLINE graph_name value label colour
+
+COLOUR graph_name colour
COMBINE graph_1_name graph_2_name
-GRAPHLINE graph_name value label colour
The visual display properties for a set of annotation rows can be modified using the following tab-delimited line:
+ROWPROPERTIES Row label centrelabs=true( or false) showalllabs=true(default is false) scaletofit=true (default is false)+
This sets the visual display properties according to the given values for all the annotation rows with labels matching Row label. The properties mostly affect the display of multi-character column labels, and are as follows: +
Groups of sequences can be defined using the tab delimited line
+SEQUENCE_GROUP Group_Name Group_Start Group_End Sequences+
The sequences can be defined by alignment index and a range of sequences can + be defined in a comma delimited field such as
+2-5,8-15,20,22
+Enter * to select all groups.
+If the alignment indices are not known, enter -1 then a tab delimited list + of sequence ids.
+If the SEQUENCE_REF has been defined, the group_start and group_end will be + relative to the sequence residue numbering, otherwise the group_start and group_end + will be the alignment column indices.
+The group can (optionally) be assigned various visualisation properties via + another tab delimited line thus:
+PROPERTIES Group_name tab_delimited_key_value_pairs ++
The key_value_pairs allow you to define a description and to colour the group + in various ways. All, none or some of the following values could be used for + a group:
+description=Text
+ colour=Helix Propensity
+ pidThreshold=0
+ consThreshold=0
+ outlineColour=red
+ displayBoxes=true
+ displayText=false
+ colourText=false
+ textCol1=black
+ textCol2=black
+ textColThreshold=0
+ idColour=ff3322
+
+ showunconserved=false
An example Annotation file is given below:
#Comment lines follow the hash symbol JALVIEW_ANNOTATION @@ -76,6 +165,13 @@ COLOUR Green Values green COLOUR Purple Letters 151,52,228 COMBINE Green Values Red Values GRAPHLINE Red Values 2.6 threshold black + +SEQUENCE_GROUP Group_A 30 50 * +SEQUENCE_GROUP Group_B 1 351 2-5 +SEQUENCE_GROUP Group_C 12 14 -1 seq1 seq2 seq3 +PROPERTIES Group_A description=This is the description colour=Helix Propensity pidThreshold=0 outlineColour=red displayBoxes=true displayText=false colourText=false textCol1=black textCol2=black textColThreshold=0 +PROPERTIES Group_B outlineColour=red +PROPERTIES Group_C colour=Clustal