earliest

earliest — gives the earliest value in a history.

Syntax

(earliest history)
    

Parameters

history

The name of a history defined by the history command.

Returns

The value and the system time in the following format:

(earliest history data seconds)

if successful, where data and seconds are real values. Otherwise

(error "No data for point history")
(error "History history does not exist")

Description

This command returns the value for the first data item in the history. This item may be either in a file or in memory.

This command corresponds to the Cogent C API function HI_Earliest and the hist_earliest dynamic library function.

Example

[sh]$ lsend Hist
Hist> (earliest p1)
(earliest p1 135.4 973631436.467178)
Hist>