Main Content

clegendm

Add legend labels to map contour display

Description

clegendm(C,h) adds a legend specifying the contour line heights, C, to the current map contour plot, h.

clegendm(C,h,loc) places the legend in a specified location.

example

clegendm(___,unitstr) appends a string unitstr to each entry in the legend.

clegendm(___,labels) uses the text specified in labels to label the legend.

hl = clegendm(___) returns the handle to the legend object created.

Examples

collapse all

Load elevation raster data and a geographic cells reference object. Create a map axes object for the world. Display a contour plot using the raster data. Then, create a legend in the lower-right corner of the map. Specify the contour elevations as meters.

load topo60c
worldmap('world')
[c,h] = contourm(topo60c,topo60cR,-6000:1500:6000);
clegendm(c,h,4,'m')

Input Arguments

collapse all

Contour matrix, specified as a matrix with two rows. The first row represents longitude data and the second row represents latitude data. You can create a contour matrix by using contourm, contour3m, or contourfm.

Handle to the contour patches drawn onto the current axes, returned as an hggroup. You can get a handle to contour patches by usingcontourm, contour3m, or contourfm.

Location to place legend, specified as one of the following integers.

ValuePlacement
0

Automatic placement (default)

1

Upper right corner

2

Upper left corner

3

Lower left corner

4

Lower right corner

-1

To the right of the plot

Text to append to each entry in the legend, specified as a character vector or string scalar.

Labels in the legend, specified as a string array or cell array of character vectors. labels must have the same number of entries as the line children of h.

Output Arguments

collapse all

Handle to legend object created by the clegendm function, returned as a handle.

Introduced before R2006a