clegendm

Add legend labels to map contour display

Syntax

clegendm(C,h)

clegendm(C,h,loc)

clegendm(___,unitstr)

clegendm(___,labels)

hl = clegendm(___)

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.

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

Create Legend for Contour Display

Load elevation raster data and a geographic cells reference object. Display the data using a contour plot on a world map. 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

C — Contour matrix

numeric matrix

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.

h — Handle of contour patches

hggroup

Handle to the contour patches displayed on the current axes, returned as an hggroup. You can get a handle to contour patches by using contourm, contour3m, or contourfm.

loc — Location

0 (default) | 1 | 2 | 3 | 4 | -1

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

Value	Placement
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

unitstr — Text to append

character vector | string scalar

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

labels — Labels

cell array of character vectors | string array

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

hl — Handle to legend object

handle

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

Version History

Introduced before R2006a