Baseline Properties

Baseline appearance and behavior

Baseline objects are created as part of bar charts, area charts, and stem charts. Baseline properties control the appearance and behavior of a Baseline object. By changing property values, you can modify certain aspects of the baseline. Use dot notation to refer to a particular object and property:

b = bar(1:10);
bl = b.BaseLine;
c = bl.Color;
bl.Color = 'red';

Appearance

expand all

Line color, specified as 'none', an RGB triplet, hexadecimal color code, a color name, or a short name. If you specify the color as 'none', then the baseline is invisible.

RGB triplets and hexadecimal color codes are useful for specifying custom colors.

  • An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1]; for example, [0.4 0.6 0.7].

  • A hexadecimal color code is a character vector or a string scalar that starts with a hash symbol (#) followed by three or six hexadecimal digits, which can range from 0 to F. The values are not case sensitive. Thus, the color codes '#FF8800', '#ff8800', '#F80', and '#f80' are equivalent.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.

Color NameShort NameRGB TripletHexadecimal Color CodeAppearance
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB® uses in many types of plots.

RGB TripletHexadecimal Color CodeAppearance
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

Example: 'blue'

Example: [0 0 1]

Example: '#0000FF'

Line style, specified as one of the line styles listed in this table.

Line StyleDescriptionResulting Line
'-'Solid line

'--'Dashed line

':'Dotted line

'-.'Dash-dotted line

'none'No lineNo line

Line width, specified as a positive value in point units.

Example: 0.75

Location and Visibility

expand all

Value of the baseline, specified as a scalar.

Typically, baselines are associated with bar series, stem series, or area objects. The BaseValue property for the associated object and the BaseValue property for the baseline object always have the same value. Setting one property also sets the other property. The BaseLine property for the associated object contains the baseline object.

Example: 0.75

Visibility, specified as one of these values:

  • 'on' — Display the baseline.

  • 'off' — Hide the baseline without deleting it. You can access the properties of an invisible baseline.

Typically, baselines are associated with bar series, stem series, or area objects. The ShowBaseline property for the associated object and the Visible property for the baseline object always have the same value. Setting one property also sets the other property. The BaseLine property for the associated object contains the baseline object.

Parent/Child

expand all

Parent, returned as an Axes object. However, Baseline objects are not listed as children of the axes.

The baseline has no children. You cannot set this property.

Introduced in R2014b