Spark Lines


Simple spark lines of recent observations.

Query Index:


Sparklines of observations as Scalable Vector Graphic (SVG)

Sparklines of observations.

Caution: these spark line plots should be used with caution and some understanding of the underlying data. FITS data is often unevenly sampled. The data range may not be accurately represented at the resolution of these plots. No down sampling of any kind is attempted for plotting. There is potential for signal to be obscured or visual artifacts created. If you think you have seen something interesting then please use the raw CSV observations and more sophisticated analysis techniques to confirm your observations.


Spark lines can be used in an html img tag e.g., <img src="http://fits.geonet.org.nz/spark?siteID=GISB&typeID=e&days=365"/> or as an object or inline depending on your needs.

The labels on the sparkline (and so the width of the image) can be controlled using the label parameter.

label
none
latest
all (default)

The type of plot can be controlled using the type parameter.

type
line (default)
scatter

The range of x axis of plot can be controlled using the days parameter to set the data to include the number of days before now.

days
100
365
3650 Data is not aggregated. Consider the plot resolution.

The range of the y axis of plot can be controlled using the yrange parameter.

yrange
Not set - auto range on the data.
50 Single value - fixed range centered on the data
-15,50 Pair of values - fixes the y axis range
-5,5 For a set y axis data out of range changes the background.

The standard deviation and mean can be shown on a plot using the stddev parameter.

stddev
pop

Method: GET
URI
/spark?typeID=(typeID)&siteID=(siteID)&[yrange=float64]&[type=(line|scatter)]
Accept

Query Parameters

Required:
siteID
Site identifier e.g., WI000.
typeID
A type identifier for observations e.g., e.
Optional:
days
The number of days of data to display before now e.g., 250. Sets the range of the x-axis which may not be the same as the data. Maximum value is 365000.
label
all (default) none latest
stddev
Show standard deviation for the time window selected for the plot. Allowable value is pop for population standard deviation.
type
Plot type. Default line. Either line or scatter.
yrange
Defines the y-axis range as a fixed or dynamic range. A comma separated pair of values fix the min and max e.g., -15,50. A single value sets the positive and negative range about the mid point of the minimum and maximum data values. For example if the minimum and maximum y values in the data selection are 10 and 30 and the yrange is 40 then the y-axis range will be -20 to 60. yrange must be > 0 for single value dynamic range. If there are data in the time range that would be out of range on the plot then the background colour of the plot is changed.

Response Properties

SVG
This query returns an SVG image.