linebreak

Line break chart

Syntax

linebreak(Data)

h = linebreak(ax,Data)

Description

linebreak(Data) plots the asset data, in a line break chart.

h = linebreak(ax,Data) adds an optional argument for ax.

Examples

Generate a Line Break Chart for a Data Series for a Stock

Load the file SimulatedStock.mat, which provides a timetable (TMW) for financial data for TMW stock. This Linebreak chart is for closing prices of the stock TMW for the most recent 21 days. Note that the variable name of asset price is be renamed to 'Price' (case insensitive).

load SimulatedStock.mat
TMW.Properties.VariableNames{'Close'} = 'Price';
linebreak(TMW(end-20:end,:))
title('Line Break Chart for TMW')

Input Arguments

Data — Data for a series of prices

matrix | table | timetable

Data for a series of prices, specified as a matrix, table, or timetable. Timetables and tables with M rows must contain a variable named 'Price' (case insensitive).

Data Types: double | table | timetable

ax — Valid axis object

current axes (ax = gca) (default) | axes object

(Optional) Valid axis object, specified as an axes object. The linebreak plot is created in the axes specified by ax instead of in the current axes (ax = gca). The option ax can precede any of the input argument combinations.

Data Types: object

Output Arguments

h — Graphic handle of the figure

handle object

Graphic handle of the figure, returned as a handle object.

More About

Line Break Chart

A line break chart is a type of financial chart used to represent price movements of an asset over time, focusing on price action rather than time intervals.

The line break chart is particularly useful for identifying trends and reversals in price movements without the noise of time-based charts, such as candlestick or bar charts. Line break charts help traders and analysts make decisions based on significant price changes. A line break chart contains a series of vertical lines that represent price movements. Each line is drawn based on a specific price threshold rather than a fixed time interval. The chart consists of a series of "lines" that change direction based on price movements. A new line is drawn when the price moves a certain amount beyond the previous line.

Version History

Introduced in R2008a

R2022b: Support for negative price data

The Data input accepts negative prices.

R2018a: Support for matrix, time, or timetable input for data

linebreak accepts Data input as a matrix, timetable, or table.

The syntax for linebreak has changed. Previously, when using table input, the first column of dates could be serial date numbers, date character vectors, or datetime arrays, and you were required to have specific number of columns.

When using table input, the new syntax for linebreak supports:

• No need for time information. If you want to pass in date information, use timetable input.

• No requirement of specific number of columns. However, you must provide valid column names. linebreak must contain a column named ‘price’ (case insensitive).