The various data types that are used when defining Multigraph objects in Mugl files.
A color is expressed as either a 6-digit hexadecimal code or one of the following strings: "black"
, "red"
, "green"
, "blue"
, "yellow"
, "magenta"
, "cyan"
, or "white"
.
Data values in Multigraph come in two types: number
and datetime
. A data value of type number
may be specified in either integer or decimal format. The datetime
type is a combination of a date and time of day.
A datetime value may be specified in the 17-character format YYYYMMDDHHmmssqqq (see the table below).
4-digit year
2-digit month (01-12)
2-digit day of month (01-31)
2-digit hour of day (00-23)
2-digit minutes (00-59)
2-digit seconds (00-59), or decimal seconds with millisecond precision
3-digit milliseconds (000-999; should only be present if ss does not contain a decimal)
Any number of these components may be omitted from the right-hand end of the string (except the year YYYY, which is always required), in which case the missing components are assumed to be zero (except MM or DD, which default to 01). Any non-number characters, such as punctuation or spaces, may be inserted anywhere in the datetime string to make it easier for humans to read. Multigraph simply ignores any non-numeric characters in the string (with the exception of the optional decimal symbol in the ss value).
The following are all examples of valid datetime strings:
A DataMeasure is a Data Value (either number or datetime) that specifies the width of an area relative to the data type of its axis.
A datetime DataMeasure may be specified in the format (brackets not included): [NUMBER][CHARACTER-CODE]
. NUMBER
is any number and CHARACTER-CODE
corresponds to a period of time and is one of the following:
Years
Months
Weeks
Days
Hours
Minutes
Seconds
Milliseconds
For example, "1Y2M3D"
would translate into a time period that is exactly 1 Year, 2 Months & 3 Days long, agnostic of any starting position for the data. "3Y"
would be 3 years, "10M2D5H"
would be 10 months, 2 days & 5 hours, etc.