highlow (fts)

Time series High-Low plot

highlow (fts) is not recommended. Use highlow instead.

Syntax

highlow(tsobj)
highlow(tsobj,color)
highlow(tsobj,color,dateform)
highlow(tsobj,color,dateform,'ParameterName',ParameterValue, ...)
hll = highlow(tsobj,color,dateform,'ParameterName',ParameterValue, ...)

Arguments

tsobj

Financial time series object.

color

(Optional) A three-element row vector representing RGB or a color identifier. (See plot.)

dateform

(Optional) Date format used as the x-axis tick labels. (See datetick.) You can specify a dateform only when tsobj does not contain time-of-day data. If tsobj contains time-of-day data, dateform is restricted to 'dd-mmm-yyyy HH:MM'.

'ParameterName'

'ParameterName' can be:

  • HighName: high prices series name

  • LowName: low prices series name

  • OpenName: open prices series name

  • CloseName: closing prices series name

ParameterValue

The parameter value is a character vector that represents the valid parameter name.

Description

highlow(tsobj) generates a High-Low plot of the data in the financial time series object tsobj. tsobj must contain at least four data series representing the high, low, open, and closing prices. These series must have the names High, Low, Open, and Close (case-insensitive).

highlow(tsobj,color) additionally specifies the color of the plot.

highlow(tsobj,color,dateform) additionally specifies the date format used as the x-axis tick labels. See datestr for a list of date formats.

highlow(tsobj,color,dateform,'ParameterName',ParameterValue, ...) indicates the actual names of the required data series if the data series do not have the default names.

You can specify open prices as optional by providing the parameter name 'OpenName' and the parameter value ''.

highlow(tsobj, color, dateform, 'OpenName', '')

hhll = highlow(tsobj,color,dateform,'ParameterName',ParameterValue, ...) returns the handle to the line object that makes up the High-Low plot.

Examples

collapse all

This example shows how to generate a High-Low plot for Disney stock for the dates May 28 to June 18, 1998.

load disney.mat
Warning: FINTS is not recommended. Use TIMETABLE instead. For more information, see <a href="matlab:web(fullfile(docroot, 'finance/convert-from-fints-to-timetables.html'))">Convert Financial Time Series Objects (fints) to Timetables</a>.
highlow(dis('28-May-1998::18-Jun-1998'))
Warning: FINTS is not recommended. Use TIMETABLE instead. For more information, see <a href="matlab:web(fullfile(docroot, 'finance/convert-from-fints-to-timetables.html'))">Convert Financial Time Series Objects (fints) to Timetables</a>.
title('High-Low Plot for Disney')

See Also

Introduced before R2006a