FITS API - Plot

Plot

Simple plots of observations.

Query Index:

Single Site - Plot observations for a single site as Scalable Vector Graphic (SVG)

Multiple Sites - Plot observations for multiple sites as Scalable Vector Graphic (SVG)

Plot observations for a single site as Scalable Vector Graphic (SVG)

Caution: these plots should be used with caution and some understanding of the underlying data. FITS data is often unevenly sampled. The requested 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.

Plots show data with errors. The minimum, maximum, and latest values are labeled. The plot can be used in an html img tag e.g., <img src="http://fits.geonet.org.nz/plot?siteID=GISB&typeID=e"/> or as an object or inline depending on your needs.

The number of days displayed can be changed with the days query parameter. If start is not specifed then the number of days before now is displayed. <img src="http://fits.geonet.org.nz/plot?siteID=GISB&typeID=e&days=300"/>

A fixed time range for the plot can be specified by setting start and days. <img src="http://fits.geonet.org.nz/plot?siteID=GISB&typeID=e&start=2010-01-01T00:00:00Z&days=200"/>

The range of the y-axis can be set with the yrange query parameter. A single value sets a fixed range centered on the data. <img src="http://fits.geonet.org.nz/plot?siteID=GISB&typeID=e&days=300&yrange=50"/>

The range of the y-axis can be set with the yrange query parameter. A pair of values fixes the y axis range. <img src="http://fits.geonet.org.nz/plot?siteID=GISB&typeID=e&days=300&yrange=-15,50"/>

Not all observations have an associated error estimate. <img src="http://fits.geonet.org.nz/plot?siteID=GISB&typeID=e_rf&days=300"/>

Scatter plots may be more appropriate for some observations. The population standard deviation can also be shown on a plot. <img src="http://fits.geonet.org.nz/plot?siteID=WI000&typeID=SO2-flux-a&type=scatter&stddev=pop"/>

The method used for an observation type can also be indicated on a scatter plot.

<img
        src="http://fits.geonet.org.nz/plot?siteID=WI000&typeID=SO2-flux-a&type=scatter&showMethod=true"/>

The scheme=projector parameter makes scatter/line plots with higher saturate colours so they'll be clearer for projectors. <img src="http://fits.geonet.org.nz/plot?siteID=WI000&typeID=SO2-flux-a&type=scatter&showMethod=true&scheme=projector"/>

If yrange is set and data values would be out of range the background colour of the plot changes. This happens with line and scatter plots. <img src="http://fits.geonet.org.nz/plot?siteID=WI000&typeID=SO2-flux-a&type=scatter&yrange=400"/>

Method: GET

URI: /plot?typeID=(typeID)&siteID=(siteID)&[days=int]&[yrange=float64]&[type=(line|scatter)&[showMethod=true]&[stddev=pop]&[scheme=web]]
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 e.g., 250. If start is not specified then the number of days before now is displayed. If start is specified then the number of days after start is displayed. Maximum value is 365000.
showMethod: If the plot type is scatter setting showMethod true will colour the data markers based on methodID.
start: the date time in ISO8601 format for the start of the time window for the request e.g., 2014-01-08T12:00:00Z.
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.
scheme: Change colour scheme for drawing scatter plots. Currently available schemes are: web and projector. The default value is web.

Response Properties

SVG: This query returns an SVG image.

Plot

Query Index:

Single Site

Query Parameters

Required:

Optional:

Response Properties

Multiple Sites

Query Parameters

Required:

Optional:

Response Properties