CGView - Circular Genome Viewer
CGView XML - featureRange element
What is CGView? | Gallery | Creating a Map | CGView Application | CGView API | CGView Server
XML - featureRange element
The featureRange element is used to assign features, which are described using the feature element, to specific bases of the DNA sequence. The featureRange element is a child of the feature element. Most of the settings in the parent feature element can be overridden using the attributes in the featureRange element.

The following sample CGView document shows how featureRange and feature elements can be used to describe sequence features:

<?xml version="1.0" encoding="ISO-8859-1"?> <cgview backboneRadius="160" sequenceLength="1000" height="600" width="600" featureThickness="small"> <featureSlot strand="direct"> <feature color="red" decoration="clockwise-arrow"> <featureRange start="50" stop="180" proportionOfThickness="0.1" radiusAdjustment="0.5" /> <featureRange start="50" stop="100" decoration="arc" label="feature A1" /> <featureRange start="120" stop="150" decoration="arc" label="feature B1" /> <featureRange start="160" stop="190" label="feature C1" /> </feature> </featureSlot> <featureSlot strand="direct"> <feature color="blue" decoration="arc"> <featureRange start="50" stop="180" proportionOfThickness="0.1" radiusAdjustment="0.5" /> </feature> <feature color="blue" decoration="arc" label="feature A2"> <featureRange start="50" stop="100" /> </feature> <feature color="blue" decoration="arc" label="feature B2"> <featureRange start="120" stop="150" /> </feature> <feature color="blue" decoration="clockwise-arrow" label="feature C2"> <featureRange start="160" stop="190" /> </feature> </featureSlot> </cgview>

This is the map generated by the above document:

output of above document

Required featureRange attributes
Attribute Description Values
start The first base in this featureRange. integer between 1 and the length of the sequence being mapped. Note that the start attribute is smaller than the stop, regardless of which strand contains the feature. The only exception is when the feature spans the start/end junction of the sequence.
stop The last base in this featureRange. integer between 1 and the length of the sequence being mapped. Note that the start attribute is smaller than the stop, regardless of which strand contains the feature. The only exception is when the feature spans the start/end junction of the sequence.
Optional feature attributes
Attribute Description Values Default value
color Sets the color of this featureRange. This setting overrides the color value of the parent feature element. color Inherited from the color value of the parent feature element.
decoration Specifies how this feature should be drawn. This setting overrides the decoration value of the parent feature element. arc - draw this featureRange as an arc.
hidden - do not draw this featureRange (it will still be labelled).
counterclockwise-arrow - draw this featureRange as an arrow pointing in the counterclockwise direction.
clockwise-arrow - draw this featureRange as an arrow pointing in the clockwise direction. 		Inherited from the decoration value of the parent feature element.
font Sets the font used for this featureRanges's label. This setting overrides the font value of the parent feature element. font Inherited from the font value of the parent feature element.
hyperlink A hyperlink for this featureRange's label. This setting overrides the hyperlink value of the parent feature element. Be sure to escape any special XML characters that appear in the URL. See the XML Overview. URL Inherited from the hyperlink value of the parent feature element.
label A label for this featureRange. This setting overrides the label value of the parent feature element. text Inherited from the label value of the parent feature element.
mouseover A mouseover for this featureRange's label. This setting overrides the mouseover value of the parent feature element. Be sure to escape any special XML characters that appear in the mouseover text. See the XML Overview. text Inherited from the mouseover value of the parent feature element.
opacity Sets the opacity of this featureRange. This setting overrides the opacity value of the parent feature element. real between 0.0 and 1.0, with 0.0 being completely transparent. Inherited from the opacity value of the parent feature element.
proportionOfThickness Sets the proportion of the featureSlot thickness used when this featureRange is drawn. This setting overrides the opacity value of the parent feature element. real between 0.0 and 1.0, with 1.0 being the thickest. Inherited from the proportionOfThickness value of the parent feature element.
radiusAdjustment Specifies where this featureRange should be placed relative to the featureSlot (it adjusts the radius of the arc used to draw the featureRange). This attribute only has an effect when the proportionOfThickness attribute is set to a value less than 1.0. This setting overrides the radiusAdjustment value of the parent feature element. real between 0.0 and 1.0, with 0.0 being at the edge of the featureSlot closest to the center of the backbone circle. Inherited from the radiusAdjustment value of the parent feature element.
showLabel Specifies whether or not this featureRange's label should be drawn. This setting overrides the showLabel value of the parent feature element. The parent cgview element can override this value using its globalLabel attribute. true - the labels should be drawn.
false - the labels should not be drawn. 		true
showShading Specifies whether or not this featureRange should be drawn with shading. This setting overrides the showShading value of the parent feature element. true - shading should be used.
false - shading should not be used. 		Inherited from the showShading value of the parent feature element.

color = the color name (black for example), or the RGB values for the color (rgb(0,255,0) for example). The following color names are supported: aqua, black, blue, fuchsia, gray (and grey), green, lime, maroon, navy, olive, orange, purple, red, silver, teal, white, and yellow.

font = the name of the font, followed by the style, and then the size. An example font is Monospaced, bold, 50. Valid font names are: Default, Dialog, DialogInput, Monospaced, Serif, and SansSerif. Valid styles are: plain, bold, italic, and bold-italic.

integer = a whole number between -2,147,483,648 and +2,147,483,647.

real = a real number between 1.4e-45 and 3.4e+38.

Citing CGView:
CGView was written by Paul Stothard. Contact: stothard@ualberta.ca