Figure.contour(x=None, y=None, z=None, data=None, **kwargs)

Contour table data by direct triangulation.

Takes a matrix, (x,y,z) pairs, or a file name as input and plots lines, polygons, or symbols at those locations on a map.

Must provide either data or x, y, and z.

[TODO: Insert more documentation]

Full option list at


  • B = frame

  • C = levels

  • G = label_placement

  • J = projection

  • L = triangular_mesh_pen

  • R = region

  • S = skip

  • W = pen

  • i = columns

  • x/y/z (1d arrays) – Arrays of x and y coordinates and values z of the data points.

  • data (str or 2d array) – Either a data file name or a 2d numpy array with the tabular data.

  • projection (str) – Required if this is the first plot command. Select map projection.

  • region (str or list) – Required if this is the first plot command. 'xmin/xmax/ymin/ymax[+r][+uunit]'. Specify the region of interest.

  • A (bool or str) – '[m|p|x|y]' By default, geographic line segments are drawn as great circle arcs. To draw them as straight lines, use A.

  • frame (str or list) – Set map boundary frame and axes attributes.

  • levels (str) – Contour file or level(s)

  • D (str) – Dump contour coordinates

  • E (str) – Network information

  • label_placement (str) – Placement of labels

  • I (bool) – Color the triangles using CPT

  • triangular_mesh_pen (str) – Pen to draw the underlying triangulation (default none)

  • N (bool) – Do not clip contours

  • Q (float or str) – Do not draw contours with less than cut number of points. '[cut[unit]][+z]'

  • skip (bool or str) – Skip input points outside region '[p|t]'

  • pen (str) – Set pen attributes for lines or the outline of symbols.