Signature
Parameters
str, np.array, pd.Series, pd.Index (default None)
The name of the dataframe column, np.array, pd.Series, or pd.Index
to be plotted. If np.array, pd.Series, or pd.Index are used then it
must have same length as dataframe. Values are used to color the plot.
Ignored if
color is also set.The kind of plots to produce. The default is to create a map (“geo”).
Other supported kinds of plots from pandas:
- ‘line’ : line plot
- ‘bar’ : vertical bar plot
- ‘barh’ : horizontal bar plot
- ‘hist’ : histogram
- ‘box’ : BoxPlot
- ‘kde’ : Kernel Density Estimation plot
- ‘density’ : same as ‘kde’
- ‘area’ : area plot
- ‘pie’ : pie plot
- ‘scatter’ : scatter plot
- ‘hexbin’ : hexbin plot.
str (default None)
The name of a colormap recognized by matplotlib.
str, np.array, pd.Series (default None)
If specified, all objects will be colored uniformly.
matplotlib.pyplot.Artist (default None)
axes on which to draw the plot
matplotlib.pyplot Artist (default None)
axes on which to draw the legend in case of color map.
bool (default False)
If False, cmap will reflect numerical values of the
column being plotted. For non-numerical columns, this
will be set to True.
bool (default False)
Plot a legend. Ignored if no
column is given, or if color is given.str (default None)
Name of a choropleth classification scheme (requires mapclassify).
A mapclassify.MapClassifier object will be used
under the hood. Supported are all schemes provided by mapclassify (e.g.
‘BoxPlot’, ‘EqualInterval’, ‘FisherJenks’, ‘FisherJenksSampled’,
‘HeadTailBreaks’, ‘JenksCaspall’, ‘JenksCaspallForced’,
‘JenksCaspallSampled’, ‘MaxP’, ‘MaximumBreaks’,
‘NaturalBreaks’, ‘Quantiles’, ‘Percentiles’, ‘StdMean’,
‘UserDefined’). Arguments can be passed in classification_kwds.
int (default 5)
Number of classes (ignored if scheme is None)
None or float (default None)
Minimum value of cmap. If None, the minimum data value
in the column to be plotted is used.
None or float (default None)
Maximum value of cmap. If None, the maximum data value
in the column to be plotted is used.
str or float or sequence (default None)
Only applies to point geometries within a frame.
If a str, will use the values in the column of the frame specified
by markersize to set the size of markers. Otherwise can be a value
to apply to all points, or a sequence of the same length as the
number of points.
tuple of integers (default None)
Size of the resulting matplotlib.figure.Figure. If the argument
axes is given explicitly, figsize is ignored.
dict (default None)
Keyword arguments to pass to
matplotlib.pyplot.legend or
matplotlib.pyplot.colorbar.
Additional accepted keywords when scheme is specified:fmt : string
A formatting specification for the bin edges of the classes in the
legend. For example, to have no decimals: {"fmt": "{:.0f}"}.
labels : list-like
A list of legend labels to override the auto-generated labels.
Needs to have the same number of elements as the number of
classes (k).
interval : boolean (default False)
An option to control brackets from mapclassify legend.
If True, open/closed interval brackets are shown in the legend.list - like
Ordered list-like object of categories to be used for categorical plot.
dict (default None)
Keyword arguments to pass to mapclassify
dict (default None)
Keyword arguments specifying color options (as style_kwds)
to be passed on to geometries with missing values in addition to
or overwriting other style kwds. If None, geometries with missing
values are not plotted.
'auto', 'equal', None or float (default 'auto')
Set aspect of axis. If ‘auto’, the default aspect for map plots is ‘equal’; if
however data are not projected (coordinates are long/lat), the aspect is by
default set to 1/cos(df_y * pi/180) with df_y the y coordinate of the middle of
the GeoDataFrame (the mean of the y range of bounding box) so that a long/lat
square appears square in the middle of the plot. This implies an
Equirectangular projection. If None, the aspect of
ax won’t be changed. It can
also be set manually (float) as the ratio of y-unit to x-unit.bool (default True)
Update axes data limits to contain the new geometries.
dict
Style options to be passed on to the actual plot function, such
as
edgecolor, facecolor, linewidth, markersize,
alpha.Returns
matplotlib axes instance