Example thumbnail image

Description

A line or scatter plot of either timeseries data or event properties. Either all points data or orbital statistics can be shown with optional trend lines.

Wiki

This widget has additional information in a wiki page.

Implementation

Browse source code here.

Configuration options

Name	Description	Quantisation	Default	Type
title	Force title for this graph	optional		string
title-fontsize	Font size for title. 0 to disable. Only 0 or 10 (not used) are accepted	required	0	int (pt)
filename	Force name of output file	optional		string
bar-width	barwidth floating value	required	5e-05	float
datapoint	Data points to be plotted	multiple		Name Description Quantisation Default Type field Timeseries data point to plot. Enter just fieldname if unique, otherwise table.fieldname optional string table Rowcount plot (stats only) optional table event Plot a numeric or duration property from an event class optional eventproperty axis Obsolete optional int y-axis Give name of y-axis to attach to required left string, select from: "left" "right" label Legend label optional string accumulate Keep a count of number of events found. Only for use with event plots with no property selected optional False boolean constraint Per-field filtering multiple Name Description Quantisation Default Type table Table containing the conditional clauses optional table clause Filter this data series by a condition (e.g. MHS_MODE=3) multiple string colour Line and shade colour and default marker colour optional colour edge-colour Edge colour if different to line edge colour optional colour marker Marker type for scatter plots required string marker-colour Marker colour if different to line colour optional colour marker-size Marker size for scatter plots required 1.0 float bar-width barwidth floating value required 5e-05 float trendline Show a trendline for this series required False boolean linestyle Line type for scatter plots required solid string linewidth Line width for scatter plots required 1 float
absolute-start-time	Set start time for plot to literal time or `launch`	optional		datetime
absolute-stop-time	Set stop time for plot to literal time or `now`	optional		string
relative-start-time	Obsolete	optional		duration
relative-stop-time	Obsolete	optional		duration
auto-axis-margin	Obsolete	optional	0.05	float
scid	For SCID-less reports, individual graphs can be plotted using data from selected satellites	optional		string
region	Stats region if stats table used (ORB, 30MIN, DAY, HOUR etc.)	optional		string
limits	to display red/yellow/onboard limits if configured	required	none	string, select from: "none" "ground" "onboard" "all"
sampling	Source table class for samples	required	auto	string, select from: "auto" (Select all-points if <1d 00:00:00.000 data, otherwise stats) "all-points" "stats" "orbital-stats" "daily-totals"
subsampling	Subsampling mode	required	auto	string, select from: "auto" (Subsample if more than 3 times as many points as pixels (not implemented) or if this is a coverage (ROWCOUNT) plot) "none" (No subsampling) "subsampled" (Subsample points to 1 row per pixel)
modulus	Subsampling factor	optional		int
width	Width of the normal non-zoomed image	required	680	int (pixels)
height	Height of the normal image. If height is omited but width is specified, an aspect ratio of 3/2 is used	optional		int (pixels)
thumbnail-width	Obsolete option. If is specified, becomes zoomed width	optional		int (pixels1)
thumbnail-height	Obsolete	optional		uint (pixels)
y-max	Obsolete	optional		float
y-min	Obsolete	optional		float
default-y-max	Obsolete	optional		float
default-y-min	Obsolete	optional		float
trendline	Obsolete	required	False	boolean
appearance	Appearance of graph	required	auto	string, select from: "auto" (Select "min-max-avg" normally for a single data point, otherwise "line". Coverage plot uses "bar") "line" (Line graph) "scatter" (Scatter plot) "line-dots" (Scatter plot with connecting line) "bar-over" (Overlayed Bar graph) "bar-istar" (ISTAR-MSG styled Bar graph) "bar-istar-gapless" (ISTAR-MSG styled Bar graph without gaps) "bar-side" (Side-by_side Bar graph) "bar" (Bar graph) "min-max-avg" (For single data point plot only, using statistics or subsampling only. Graph used separate lines to show the min, avg and max values.) "min-max" (For single-point subsampled or stats plots only, draw separate min and max lines) "dynrange" (For subsampled or stats plots only, show min/max ranges as filled polygons with an averages line) "pie" (Pie graph)
calibrated	Plot calibrated values	required	True	boolean
trim	Clip all x-axes to only include the time range containing non-null data	required	False	boolean
show-orbits	Show orbit numbers along top axis	required	auto	string, select from: "auto" (Show orbits if height > 300 pixels) "true" (Always show orbits) "false" (Never show orbits)
legend	None	required	auto	string, select from: "auto" (None for min-max-avg plot, otherwise outside-right) "none" (No legend) "embedded" (Embedded, auto position) "embedded-top-left" (Embedded, top left corner) "embedded-top-right" (Embedded, top right corner) "embedded-bottom-left" (Embedded, bottom left corner) "embedded-bottom-right" (Embedded, bottom right corner) "outside-right" (To the right of the graph) "below-desc" (HTML table underneath the graph, include field descriptions) "below-desc-stats" (HTML table underneath the graph, include field descriptions and statistics)
y-label	Obsolete	optional		string
annotation	Annotate the plot with additional text	multiple		Name Description Quantisation Default Type text None required string colour None required black colour size None required 10 int x None required 0.02 float y None required 0.92 float
radius	Obsolete	optional		int
marker-size	Default marker size for datapoints in a scatter plot	required	1.0	float
normalise	Shift lines vertically so they all begin at the same level	required	False	boolean
rowcount-threshold	For stats plots only, discard all points where the rowcount is less than THRESH (as a proportion of the nominal rowcount	required	0.7	float (proportion)
anomaly-response	Control how to handle anomalous data points	required	none	string, select from: "none" (No anomaly processing) "axis" (Exclude anomalies from automatic y-axis adjustment) "remove" (Remove anomalies) "remove_histogram" (Remove anomalies using a histogram-based approach)
anomaly-threshold	Adjustment for anomaly detection. Valid for stats or subsampled data only. Number of standard deviations from the mean of the standard deviations which is considered an anomaly	required	2.5	float
anomaly-bin-ratio	Adjustment for anomaly detection for response option "remove". Mean number of data points per bin. The lower the number, the more precise the anomaly detection at the expense of computation time.	required	50	int
anomaly-cutoff-percentage	Adjustment for anomaly detection for response option "remove". Maximum percentage of data points removed from each end of the value range. The higher the value, the more data points are removed.	required	2	int
dynrange-alpha	With dynrange appearance, vary the transparency of the vertical min-max line	required	0.5	float
oversampling	If is not in use, read a bit more data either side of nominal report duration to avoid appearance of data gaps	required	0.01	float
x-axis	Configure an x-axis	multiple		Name Description Quantisation Default Type position Location of axis. Can only have one bottom (time) and one top (orbit) x-axis required bottom string, select from: "top" "bottom" locator Method used to work how where to place major and minor tick-marks. Pass an integer for fixed number required chart string, select from: "chart" (Custom CHART method) "matplotlib" (Matplotlib default method) "hour" (Ticks based on count of hours) "day" (Ticks based on count of hours) locator-modulus For fixed interval locators (hour etc) specify number of units between major ticks required 1 int format None optional string absolute-start-time Adjust graph start time if different to report start time optional datetime absolute-stop-time Adjust graph stop time if different to report stop time optional string relative-start-time Adjust graph start time if different to report start time optional duration relative-stop-time Set the stop time of this graph to an offset from the report start time optional duration round-start-time Round down the start time to a nice value optional string, select from: "day" "week" "month" "year" fontsize Font size for tick marks and label required 8 int colour Use a named (matplotlib) colour, or #RRGGBB (hex values) optional black string label Override the default axis label optional string label-colour Specify label colour, if different to tick mark colour optional colour label-fontsize Font size for label if different to tick mark font size required 8 int
y-axis	Configure default or additional y-axes	multiple		Name Description Quantisation Default Type min Force axis start (min) point optional float default-min Suggested axis start, shifted if data needs it optional float max Force axis stop (max) point optional float default-max Suggested axis stop, shifted if data needs it optional float margin With automatic y-axis limits selection a small margin is added to the computed axis limits required 0.05 float fontsize Font size for tick marks and label required 8 int colour Colour for tick marks and default label colour optional string label Force axis label optional string label-colour Specify label colour, if different to tick mark colour optional colour label-fontsize Font size for label if different to tick mark font size required 8 int anomaly-threshold None optional float position None required left string, select from: "left" "right" minor-ticks Distance between minor tick marks optional float
zoom	Specify appearance of enlarged image, when zoomed in the web interface of for PDF rendering	optional		Name Description Quantisation Default Type width Width of zoomed image optional uint (pixels) height If omited, non-zoomed aspect ratio is used optional uint (pixels) x-axis None optional Name Description Quantisation Default Type format None optional string locator None optional string label-fontsize Font size for label if different to tick mark font size required 8 int

Example

	<graph>
    option 1
    option 2
    ...
</graph>
	

This shows an example of the basic declaration of the widget with no options. Options are added as: <name>value</name>