pygmt.Figure.histogram

Figure.histogram(table, **kwargs)

Plots a histogram, and can read data from a file or list, array, or dataframe.

Full option list at https://docs.generic-mapping-tools.org/latest/histogram.html

Aliases:

  • A = horizontal

  • B = frame

  • C = cmap

  • G = fill

  • J = projection

  • R = region

  • T = series

  • W = pen

  • c = panel

  • l = label

  • p = perspective

Parameters
  • table (str, list, or 1d array) – A data file name, list, or 1d numpy array. This is a required argument.

  • projection (str) – Required if this is the first plot command. projcode[projparams/]width. 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.

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

  • cmap (str) – File name of a CPT file or a series of comma-separated colors (e.g., color1,color2,color3) to build a linear continuous CPT from those colors automatically.

  • color (str) – Select color or pattern for filling of symbols or polygons. Default is no fill.

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

  • panel (bool or int or list) – [row,col|index]. Selects a specific subplot panel. Only allowed when in subplot mode. Use panel=True to advance to the next panel in the selected order. Instead of row,col you may also give a scalar value index which depends on the order you set via autolabel when the subplot was defined. Note: row, col, and index all start at 0.

  • label (str) – Add a legend entry for the symbol or line being plotted.

  • perspective (list or str) – [x|y|z]azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0]. Select perspective view and set the azimuth and elevation angle of the viewpoint. Default is [180, 90]. Full documentation is at https://docs.generic-mapping-tools.org/latest/gmt.html#perspective-full.

  • horizontal (bool) – Plot the histogram using horizonal bars instead of the default vertical bars.

  • series (int or str or list) – [min/max/]inc[+n] Set the interval for the width of each bar in the histogram.