PyNGL Home > Functions > Graphics routines

Ngl.polygon_ndc

Draws a filled polygon on the viewport.

Prototype

Ngl.polygon_ndc(wks, x, y, res=None)

Arguments

wks

The identifier returned from calling Ngl.open_wks.

x, y

One-dimensional (masked) NumPy arrays or Python lists containing the x, y NDC coordinates of the polygon.

res=None

An (optional) instance of the Resources class having GraphicStyle resources as attributes.

Return value

   None

Description

This procedure draws a filled polygon on the viewport of the requested workstation. x and y are 1-dimensional arrays (these can be Python lists or tuples, or NumPy arrays) defining the coordinates of the polygon in NDC space, and resources can optionally contain an unlimited number of GraphicStyle attributes that are resource names and their values.

The frame is not advanced when you call this procedure, so you need to call Ngl.frame yourself if you want to advance the frame.

As of version 1.3.0, there is automatic handling of missing data if one or both of the input arrays are masked arrays. Missing data will not be plotted.

See Also

Ngl.polymarker_ndc, Ngl.polyline_ndc, Ngl.add_polygon, Ngl.polygon, Ngl.draw_ndc_grid

Examples

See the example color4.py and its output and the example traj1.py and its output.