Project

General

Profile

Point » History » Version 19

Maarten Plieger, 03/17/2017 11:05 AM

1 3 Ernst de Vreede
h1. Point(pointstyle,fillcolor,linecolor,textcolor,textformat,fontfile,fontsize,discradius,textradius,dot,anglestart,anglestop,plotstationid)
2 1 Ernst de Vreede
3 1 Ernst de Vreede
h2. Configuration of rendering point data
4 3 Ernst de Vreede
5 14 Ernst de Vreede
The Point element is defines the rendering of point data. A Layer with point data can contain one or more NetCDF variables (identified by Variable elements in the configuration file). If there are exactly two Variable elements the layer is assumed to contain wind speed and direction (see [[Vector]]). 
6 5 Ernst de Vreede
There are many rendering possibilities for point data. 
7 3 Ernst de Vreede
8 3 Ernst de Vreede
The *pointstyle* attribute defines the style of point rendering and can have one of the values "point", "disc", "volume" or "symbol".
9 3 Ernst de Vreede
Point data can be rendered:
10 3 Ernst de Vreede
* as a text on the map on or around the station's location (single and multiple Variables) "point"
11 3 Ernst de Vreede
* as text on a coloured disc (one Variable): "disc"
12 3 Ernst de Vreede
* as a kind of fuzzy cloud: "volume"
13 3 Ernst de Vreede
* as a symbol determined by the point value and a set of SymbolInterval definitions: "symbol"
14 3 Ernst de Vreede
15 14 Ernst de Vreede
The *plotstationid* attribute (true/false) defines if the stationid is plotted together with the data.
16 3 Ernst de Vreede
17 19 Maarten Plieger
Appearance of a text is determined by the *textcolor*, *fontfile* and *fontsize* attributes. The numeric value is formatted into a text by the printf-style format string of the *textformat* attribute. Tip, no text is rendered when textformat is set to " ".
18 1 Ernst de Vreede
19 5 Ernst de Vreede
h3. Pointstyle point
20 3 Ernst de Vreede
21 1 Ernst de Vreede
<pre>
22 14 Ernst de Vreede
    <Point fillcolor="" linecolor="" textcolor="" fontfile="" fontsize="" discradius="5" textradius="" textformat="%f" dot="false" anglestart="" anglestep="" plotstationid="true" pointstyle="point"></Point>
23 1 Ernst de Vreede
    <RenderMethod>point</RenderMethod>
24 3 Ernst de Vreede
</pre>
25 14 Ernst de Vreede
This pointstyle draws a circle at the station location, coloured according to the value of the first variable of the layer and the Legend. If *discradius* is defined to be larger than 0 a circle is drawn at the station's location in a color determined by the data value and the Style's Legend.If *discradius* is 0 then the data's value is plotted centered at the station's location.
26 14 Ernst de Vreede
The attribute *linecolor* specifies a color for the edge of the circle. Making the *linecolor* transparent (linecolor="0x00000000") draws no line around the circle.
27 14 Ernst de Vreede
The value can be plotted next to the point. When 2 or more Variables are defined in a layer, the values get plotted in a circle around the station's location. The values are plotted starting at the angle defined by the *anglestart* attribute and are *anglestep* degrees apart. The distance of the text from the station's location is defined by the *textradius* attribute.
28 14 Ernst de Vreede
If a *fillcolor* attribute is specified the circle is drawn in the specified fixed color. A circle will be drawn around the disc in the *linecolor*.
29 15 Ernst de Vreede
The attribute *dot* plots a dot at the station's location; this can be useful during testing of the configuration of a point data style.
30 8 Ernst de Vreede
31 7 Ernst de Vreede
Single variable layer example: !https://dev.knmi.nl/attachments/682/point1.png!
32 6 Ernst de Vreede
33 1 Ernst de Vreede
Multiple variable layer example: !https://dev.knmi.nl/attachments/683/point3.png!
34 3 Ernst de Vreede
35 14 Ernst de Vreede
Example:
36 15 Ernst de Vreede
37 3 Ernst de Vreede
38 3 Ernst de Vreede
h3. Pointstyle disc
39 3 Ernst de Vreede
40 7 Ernst de Vreede
Pointstyle disc can only handle 1 variable in a layer or 2 in case of wind data (direction/speed).
41 3 Ernst de Vreede
The attribute *discradius* defines the size of the disc on which the value text is drawn, *fillcolor* defines the color of the disc (this color can contain transparency). 
42 1 Ernst de Vreede
43 1 Ernst de Vreede
The attributes *anglestart*, *anglestep*, *linecolor*, *plotstationid* and *textradius* have no meaning here.
44 8 Ernst de Vreede
45 7 Ernst de Vreede
Example with temperature data:
46 10 Ernst de Vreede
!/attachments/687/disc.png!
47 7 Ernst de Vreede
48 4 Ernst de Vreede
49 4 Ernst de Vreede
h3. Pointstyle volume
50 4 Ernst de Vreede
51 4 Ernst de Vreede
Pointstyle volume shows a fuzzy disc at the station's location. This style is most useful for events that can occur often and overlap (because the rendered discs are translucent).
52 4 Ernst de Vreede
The base color of the disc is defined by the *fillcolor* attribute. 
53 4 Ernst de Vreede
A station id is plotted if the *plotstationid* attribute has the value true.
54 4 Ernst de Vreede
55 4 Ernst de Vreede
The attributes *anglestart*, *anglestep*, *linecolor* and *textradius* have no meaning here.
56 8 Ernst de Vreede
57 17 Maarten Plieger
Example:
58 17 Maarten Plieger
!/attachments/688/volume.png!
59 17 Maarten Plieger
60 16 Maarten Plieger
h3. Pointstyle symbol
61 11 Ernst de Vreede
62 18 Maarten Plieger
When set to "symbol", it enables the [[SymbolInterval]] to draw Symbols/Icons on the map