history export command

Syntax

history export <keyword ...>

Primary keywords:

begin    end    file    skip    table    vs

Write the contents of the list of histories to the screen, a file (with the file keyword) or a table (with the table keyword). If any history ID is negative, then the value of the history with corresponding positive ID is reversed (multiplied by -1). The information can be limited to a specified range of data using the following keywords:

s <reverse> ...

Adds a history by name s to the list of those being output. If the reversed keyword is given, the negative of that history value is output. Multiple histories can be added.

begin i

Values with a step number greater than or equal to i will be output.

end i

Values with a step number less than or equal to i will be output.

file s <truncate> <append>

The history information is sent to a text file. If no extension is specified, “.his” is used. truncate causes any previously existing file to be replaced. append causes data to be appended to the end of the file. append is the default option.

skip i

Only one set of values for every i sampled intervals will be output. For example, skip 10 means that every 10th recorded set of values (starting with the first) will be output.

table s

The contents of the history are added to the contents of table s. Note that only one history at a time may be output to a table.

vs keyword

Specifies the values to use for the \(x\)-axis of the history output. By default this value is the step number.

s <reverse>

Specify the \(x\)-axis of the history output is the history s at the same step. If the reverse keyword is given, then the negative values of history s at the same step are used.

step

Specify the \(x\)-axis of the history output is the step number (the default).