GeoRegionValuePlot

GeoRegionValuePlot[{reg1val1,reg2val2,}]

generates a plot in which the geographic regions regi are colored according to the values vali.

GeoRegionValuePlot[regionsvalues]

uses a collection of regions regi from regions with corresponding values vali from values.

GeoRegionValuePlot[regionprop]

generates a plot in which the geographic subdivisions in region are colored according to the values EntityValue[,prop].

GeoRegionValuePlot[data]

generates a plot using the data available in data.

Details and Options

  • GeoRegionValuePlot is also known as a chloropleth map, shaded map and a thematic map.
  • GeoRegionValuePlot uses color to associate numeric values with regions on a map.
  • By default, GeoRegionValuePlot outlines and shades the specified regions over an unlabeled street map.
  • The geographic regions regi can be given in the following forms:
  • GeoPosition[{lat,lon}]latitude and longitude
    Entity[]geographic entity
    Dated[ent,date]dated entity
    GeoGroup[{}]grouped set of entities
    Polygon,GeoDisk,geographic regions
  • Multiple regions regions can be given in the following forms:
  • {reg1,reg2,}list of individual regions
    GeoPosition[{pos1,pos2,}]array of geo positions
    EntityClass[]class of geo entities
  • The values vali can be given in the following forms:
  • valipositive number
    Quantity[vali,unit]magnitude with units
    RGBColor[],Hue[],specific color
  • Multiple values values can be given in the following forms:
  • {val1,val2,}list of individual regions
    QuantityArray[{val1,val2,},unit]array of quantities
  • The data datai for GeoRegionValuePlot can be given in the following forms:
  • {e1,e2,}list of elements with or without wrappers
    <|k1e1,k2e2,|>association of keys and values
    WeightedData[]positions with weights for values
    w[{e1,e2,},]wrapper applied to a whole dataset
    w[{data1,data1,},]wrapper applied to all datasets
  • In GeoRegionValuePlot[region"prop"], region can be given in the following forms:
  • Entity[]an entity containing further divisons of entities
    EntityClass[]a class of entities
    {ent1,ent2,}a list of entities
  • The following wrappers can be used for chart elements:
  • Annotation[e,label]provide an annotation
    Button[e,action]define an action to execute when the element is clicked
    EventHandler[e,]define a general event handler for the element
    Hyperlink[e,uri]make the element act as a hyperlink
    Labeled[e,]display the element with labeling
    Legended[e,]include features of the element in a chart legend
    PopupWindow[e,cont]attach a popup window to the element
    StatusArea[e,label]display in the status area when the element is moused over
    Style[e,opts]show the element using the specified styles
    Tooltip[e,label]attach an arbitrary tooltip to the element
  • Data not given in these forms is ignored in forming the plot.
  • GeoRegionValuePlot takes the same options as GeoGraphics, with the following additions and changes:
  • ClippingStyle Automatichow to color regi if vali are not in PlotRange
    ColorFunction Automatichow to translate numerical values into colors
    ColorFunctionBinning Nonewhether to bin values into discrete colors
    ColorFunctionScaling Truewhether to scale arguments to ColorFunction
    ColorRules Automaticspecify color rules for explicit values
    GeoLabels Nonewhether and how to add labels to the loci
    LabelingSizeAutomaticmaximum size of callouts and labels
    LabelStyle Automaticgraphics directives to determine style of labels
    MissingStyle Automatichow to display regi if vali are missing or invalid
    PlotLegends Automatichow the legend will appear
    PlotMarkers Automatichow to mark very small locations
    PlotRange Allthe range of values to display
    PlotStyle Automaticgraphics directives to determine style of the loci
    ScalingFunctionsNonehow to scale individual values
    TargetUnits Automaticspecify units to use in the legend
  • ColorFunctionBinningbin specifies how to bin the values into discrete groups for computing colors.
  • Possible settings for bin are:
  • Noneuse a continuous set of colors
    Automaticautomatically determine the bins
    nuse n color bins
    "KMeans"use the k-means clustering algorithm to find the bins
    "Quantile"use quantiles to compute the bins
    {d}use bins with width d
    {min,max,d}use bins from min to max with width d
    {{b1,b2,,bn}}use specific break points bi to separate the bins
    {"name",n}use a named specification with n bins
  • The following settings for GeoLabels can be used:
  • Automaticadd text labels to graphical output
    Noneadd no labels
    funcapply the function func
  • PlotMarkers can take the following forms:
  • Automaticautomatically chosen plot markers
    Polygonuse polygons
    Pointuse points
    GeoMarkeruse geo markers
    "OpenMarkers"open shapes
    gmarkers consisting of copies of expression g
    {g,s}expression g at size s
    {Automatic,spec}automatic marker with fallback spec
    {Polygon,spec}polygon with fallback spec
  • With PlotMarkers->Automatic, polygons are used to show entity regions. A point will be used instead if no polygon is available.
  • The arguments supplied to functions in GeoLabels are graphicsi, regi, EntityValue[regi,"Position"] and vali, where graphicsi is the Graphics or GeoGraphics object that marks regi, by default either a Point or a Polygon.
  • The following settings for PlotRange can be used:
  • Automaticrange includes all of the vali
    maxrange includes all of the vali less than max
    {min,max}range includes all of the vali from min to max

Examples

open allclose all

Basic Examples  (1)

A plot comparing some countries in Europe:

Scope  (41)

General Data  (4)

Use quantities with units as values:

Plot an association:

Use a derived list of entities in the left-hand side of a rule:

Color all the subentities of an EntityClass:

Special Data  (7)

Use GeoDisk as region:

Use Polygon as region:

Use geo primitives:

Use GeoGroup:

Use quantities with units as values:

Use QuantityArray for the values:

Mix cities and countries and use explicit colors:

Data Wrappers  (5)

Wrap a Tooltip on data:

Override the default tooltips:

Use any object in the tooltip:

Wrap Style, StatusArea and Button:

Nest wrappers:

Labeling and Legending  (3)

Automatically add the names of the specified locations as labels:

Add custom labels for regions:

Use tooltips to show multiple pieces of information:

Presentation  (22)

Color regions using an existing color scheme:

Use equally sized bins for coloring the map:

Use a clustering algorithm to compute the bins:

Mark locations with a special character:

Mark locations with a GeoMarker:

For default, all regions are shown:

Show points for small regions:

Show polygons of all regions with a Polygon property:

Show polygons for extended regions and GeoMarker for small regions or with no Polygon property:

Show Tiny "OpenMarkers" for small regions:

Use a Point for all regions and label regions with a Tooltip:

Specify that missing data should be colored green with a dashed outline:

Change the style of the automatically generated labels:

Use EdgeForm to change the outline of extended regions:

Color clipped regions lighter blue if the value is too low and darker blue if the value is too high:

Color clipped regions light gray:

Do not color clipped regions:

Color only clipped regions when the value is too high:

Do not show legends:

Change the location of the legend:

Use a continuous gradient coloring for the plot and the legend:

Draw a relief map background for the map:

Specify a specific location for the center of the map:

Specify the region to show:

Options  (41)

AspectRatio  (4)

By default, the ratio of the height to width for the plot is determined automatically:

Make the height the same as the width with AspectRatio1:

Use numerical value to specify the height to width ratio:

AspectRatioFull adjusts the height and width to tightly fit inside other constructs:

ClippingStyle  (4)

Color clipped regions lighter blue if the value is too low and darker blue if the value is too high:

Color clipped regions light gray:

Color only clipped regions when the value is too high:

ColorFunction  (1)

Color regions using an existing color scheme:

ColorFunctionBinning  (7)

Use None to use a continuous range of colors:

Use colors corresponding to equal-width bins:

Specify how large the bins should be:

Use the -means algorithm for find clusters of values:

Specify how many clusters to find:

Using "Quantile" will put approximately the same number of regions in each bin:

Some of the regions are small and may not be visible:

Color the regions according to what quartile they are in:

Specify the bin boundaries:

ColorFunctionScaling  (1)

Use unscaled coordinates with a custom color function:

ColorRules  (1)

Specify color rules for explicit values:

GeoBackground  (1)

Use the default background for map region and background:

Draw a relief map background for the map:

GeoCenter  (1)

Maps are automatically centered based on the data:

Specify a specific location for the center of the map:

GeoLabels  (3)

Automatically add the names of the specified locations as labels:

Use tooltips to show the names of locations:

Use tooltips to show multiple pieces of information:

GeoProjection  (1)

GeoRange  (1)

The geographic region to show is automatically determined:

Specify the region to show:

LabelStyle  (1)

Change the style of the automatically generated labels:

MissingStyle  (1)

Specify that missing data should be colored green with a dashed outline:

PlotLegends  (3)

Do not show legends:

Change the location of the legend:

Use a continuous gradient coloring for the plot and the legend:

PlotMarkers  (7)

Mark locations with a special character:

Mark locations with a GeoMarker:

By default, all regions are shown:

Show points for small regions:

Show polygons of all regions with a Polygon property:

Show polygons for extended regions and GeoMarker for small regions or with no Polygon property:

Show tiny "OpenMarkers" for small regions:

PlotRange  (1)

Use all the color contrast for the countries with fewer than 20,000,000 people:

Use all the color contrast for the countries between 11,000,000 and 20,000,000 people:

PlotStyle  (2)

Use different style directives:

Use EdgeForm to change the outline of extended regions:

TargetUnits  (1)

Change the units shown in the legend:

Properties & Relations  (9)

Use GeoBubbleChart to show values with scaled bubbles:

Use GeoHistogram to aggregate locations into bins:

Use GeoSmoothHistogram to generate smooth densities from locations:

Use GeoListPlot for individual locations:

Use GeoVectorPlot and GeoStreamPlot for vector fields:

Draw contours on a map with GeoContourPlot:

Smoothly shade a map using color with GeoDensityPlot:

Use GeoGraphValuePlot to show the values on geographic networks:

Plot relationships between geographic locations on a map:

Neat Examples  (3)

Color the countries of the world by their net migration:

Color some tall buildings by height, with rich tooltip information:

Show land elevations and water depths in the region of New York City with color and tooltips:

Wolfram Research (2014), GeoRegionValuePlot, Wolfram Language function, https://reference.wolfram.com/language/ref/GeoRegionValuePlot.html (updated 2020).

Text

Wolfram Research (2014), GeoRegionValuePlot, Wolfram Language function, https://reference.wolfram.com/language/ref/GeoRegionValuePlot.html (updated 2020).

CMS

Wolfram Language. 2014. "GeoRegionValuePlot." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2020. https://reference.wolfram.com/language/ref/GeoRegionValuePlot.html.

APA

Wolfram Language. (2014). GeoRegionValuePlot. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/GeoRegionValuePlot.html

BibTeX

@misc{reference.wolfram_2022_georegionvalueplot, author="Wolfram Research", title="{GeoRegionValuePlot}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/GeoRegionValuePlot.html}", note=[Accessed: 08-June-2023 ]}

BibLaTeX

@online{reference.wolfram_2022_georegionvalueplot, organization={Wolfram Research}, title={GeoRegionValuePlot}, year={2020}, url={https://reference.wolfram.com/language/ref/GeoRegionValuePlot.html}, note=[Accessed: 08-June-2023 ]}