Users Manual
Categories
Annotations can be assigned to categories, corresponding to different groups of configuration settings. For example, annotations in different categories can be displayed in different colors. Additionally, categories are used in the Javascript API.

Categorizing configuration parameters is a two step process. First, annotations in the RSS file need to be assigned categories. <dc:subject> can be used in RSS 1.0, 2.0, and Atom. Be sure to include the xmlns:dc="http://purl.org/dc/elements/1.1/" declaration in the root node. Alternatively, <category> can be used in RSS 2.0.

Here's a sample RSS 2.0 item, categorized with <dc:subject>.

<item>
 <title>An example annotation</title>
 <link>http://example.com/geo</link>
 <description>Just an example</description>
 <georss:point>26.58 -97.83</georss:point>
 <dc:subject>category1</dc:subject>
</item>
Then, configuration options need to be categorized. Add subtags to configuration parameters, with the node name as the Category and the node value as the associated configuration value.

For example, the following assigns different plotshape's depending on category. Any annotation not assigned to "category1" or "category2" will receive the default value, here "square".

<plotshape>square
 <category1>circle</category1>
 <category2>triangle</category2>
 </plotshape>
The following configuration options are categorizable:
<icon>, <initialplotcolor>, <plotshape>, <plotsize>, <restingplotcolor>, <activatecolor>, <window>, <linecolor>, <linealpha>, <linethickness>, <fillalpha>, <zoomto>, <visible>.
Multiple Categories
It is possible to assign an annotation to multiple categories, to independently control multiple configuration options. For example, in a plot of recent earthquake activity, the size could vary according to the mangitude of the earthquake, and the color could vary according to how recently it occurred.
<item>
 <title>San Francisco Earthquake</title>
 <link>http://example.com/quake</link>
 <georss:point>26.58 -97.83</georss:point>
 <dc:subject>5</dc:subject>
 <dc:subject>week</dc:subject>
</item>
<plotsize>3
 <4>4</4>
 <5>5</5>
 <6>6</6>
 <7>7</7>
 <8>8</8>
</plotsize>

<initialplotcolor>0xFFFFFF</initialplotcolor>
 <day>0xFF0000</day>
 <week>0xFFFF00</week>
 <month>0x0000FF</month>
</initialplotcolor>
Categories and Tracks
The concept of categorized <track> display works slightly different. If the config option <trackcats> is set to "true" (as well as <track>) then lines are drawn between successive points belonging to the same category.

For example, say there are three successive points listed in RSS. The first and third are assigned "category1", and the second "category2". Without <trackcats>, the track line is drawn to connect all three; with <trackcats>, the track line is drawn between only the first and third.

Also note, <trackcats> ignores multiple categories; only the first, primary category is considered.