NCL Home > Documentation > Graphics > Graphical Interfaces


Draws a legend on the given workstation.


load "$NCARG_ROOT/lib/ncarg/nclscripts/csm/gsn_code.ncl"  ; This library is automatically loaded
                                                          ; from NCL V6.2.0 onward.
                                                          ; No need for user to explicitly load.

	procedure gsn_legend_ndc (
		wks    [1] : graphic,  
		nitems [1] : integer,  
		labels [*] : integer,  
		x      [1] : numeric,  
		y      [1] : numeric,  
		res    [1] : logical   



A Workstation identifier. The identifier is one returned either from calling gsn_open_wks or calling create to create a Workstation object.


The number of legend items you want.


An array of strings containing the legend labels.


The X and Y coordinates of the upper left corner of the legend, which must be normalized device coordinates (NDC).


A variable containing an optional list of legend resources, attached as attributes. Set to True if you want the attached attributes to be applied, and False if you either don't have any resources to set, or you don't want the resources applied.


This procedure draws a legend on the given workstation, given the number of items and labels for each item.

This procedure is similar to the function gsn_create_legend, except it doesn't return the legend id. The legend id can be useful if you want to use gsn_add_annotation to attach the legend to a plot.

See Also

gsn_create_legend, gsn_labelbar_ndc, gsn_add_annotation, drawNDCGrid


For some application examples see:

Also, see the suite of legend examples.