DADiSP Worksheet Functions > Function Categories > Data Type Conversion > XYDT

 

XYDT

Purpose:

Creates an XY plot from Date, Time and Y series.

Syntax:

XYDT(date, time, y, gap)

date

-

A series of date values.

time

-

A series of time values.

y

-

A series, the Y values.

gap

-

Optional. A real specifying the duration in days of a time gap to plot as a blank line. Defaults to 0.0 (no gaps).

Returns:

An XY series.

Example:

W1: {julstr("1-1-99"), julstr("1-10-99"), julstr("4-2-99")};setvunits("daily")

W2: {todstr("12:00"), todstr("14:00"), todstr("9:35")};setvunits("time")

W3: {1, 2, .5};setvunits("V")

W4: xydt(w1, w2, w3)

 

The series in W4 consists of the values:

 

1-01-99 12:00, 1.0 

1-10-99 14:00, 2.0 

4-02-99 09:35, 0.5 

Example:

W5: xydt(w1, w2, w3, 20)

 

Same as above except a gap appears between the 2nd and 3rd values.

Remarks:

To configure the x-axis to display both date and time values, use:

 

SETCONFIG("dt_scales_format", 1).

 

If gap > 0, nan values are inserted where the time between successive samples exceeds the gap. This results in a blank line separating time sections.

See Also:

DECDATE

DECTIME

DTXY

JULSTR

JULYMD

UNIXDT

XY

XYDTTAB