plots the points pti styled according to the values vali.


uses a collection of points pti from pts with corresponding values vali from val.


uses the visual encoding enc to represent the values vali in the plot.


plots the locations and values from data.

Details and Options

  • PointValuePlot is also known as a graduated symbol map and thematic map.
  • PointValuePlot uses various visual encodings enc such as color, size and shape to represent values at specific locations.
  • The coordinates {x,y} in point pti can be given in the following forms:
  • xia real-valued number
    Quantity[xi,unit]a quantity with a unit
    Around[xi,ei]value xi with uncertainty ei
    Interval[{xmin,xmax}]values between xmin and xmax
  • The ptsi can be geographic locations with the following forms:
  • GeoPosition[{lat,lon}]latitude and longitude
    Entity[]geographic entity
    Dated[]dated entity
  • Multiple points pts can be given in the following forms:
  • {pt1,pt2,}list of individual points
    QuantityArray[]array of quantities
    GeoPosition[]array of geodetic positions
  • The values vali can be any form, including:
  • nnumeric value
    Quantity[vali,unit]magnitude with units
    {vali1,vali2,}list of values
  • Multiple values values can be given in the following forms:
  • {val1,val2,}list of individual values
    QuantityArray[{val1,val2,},unit]array of quantities
    Dataset[]dataset of values
  • The data data for PointValuePlot can be given in the following forms:
  • {e1,e2,}list of elements with or without wrappers
    <|k1e1,k2e2,|>association of keys and values
    SpatialPointData[]spatial points and annotations
    WeightedData[]positions with weights for values
    w[{e1,e2,},]wrapper applied to a whole dataset
    w[{data1,data1,},]wrapper applied to all datasets
  • The following wrappers can be used for plot elements:
  • Annotation[e,label]provide an annotation
    Button[e,action]define an action to execute when the element is clicked
    Callout[e,label]label the data with a callout
    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.
  • By default, the encoding enc is automatically chosen based on the forms of the values vali.
  • Possible settings for the encoding enc can be:
  • "Size"vary the point sizes according to the values
    "Color"smoothly color the points according to the values
    "DiscreteColor"discretely color the points according to the values
    "Shape"vary the shape of the point according to the values
    "Label"label the points with the values
    funcapply func to the values to determine the point marker
    nencencode the n^(th) value for a point with the encoding enc
    m;;nencencode the m^(th) through n^(th) values with the encoding enc
    Allencencode all the values for a point with the encoding enc
    {enc1,enc2,}use different encodings for different values
  • PointValuePlot takes the same options as Graphics with the following additions and changes:
  • AspectRatio Automaticoverall ratio of width to height
    AxesAutomaticwhether to draw axes
    BubbleScale"Area"feature scale used for bubbles
    BubbleSizes Automaticsize range to use for bubbles
    ColorFunction Automatichow to determine the color of points
    ColorFunctionScaling Truewhether to scale arguments to ColorFunction
    Frame Automaticwhether to draw a frame around the plot
    GeoBackground Automaticstyle specifications for the background
    GeoCenterAutomaticcenter coordinates to use
    GeoGridLines Nonegeographic grid lines to draw
    GeoGridLinesStyle Automaticstyle specifications for geographic grid lines
    GeoGridRangeAllprojected coordinate range to include
    GeoGridRangePaddingAutomatichow much to pad the projected range
    GeoModelAutomaticmodel of the Earth (or other body) to use
    GeoProjection Automaticprojection to use
    GeoRange Automaticgeographic area range to include
    GeoRangePaddingAutomatichow much to pad the geographic range
    GeoResolutionAutomaticaverage distance between background pixels
    GeoScaleBar Nonescale bar to display
    GeoServerAutomaticspecification of a tile server
    GeoZoomLevelAutomaticzoom to use for geographic background
    LabelingFunctionAutomatichow to label points
    LabelingSize Automaticmaximum size of callouts and labels
    MetaInformation{}metainformation about the map
    MissingStyleAutomatichow to style points with missing values
    PerformanceGoal$PerformanceGoalaspects of performance to try to optimize
    PlotLegendsNonelegends to use for data
    PlotMarkersNonemarkers to use to indicate each point
    PlotRange Automaticrange of coordinates to include
    PlotStyle Automaticgraphics directives to determine styles of points
    PlotTheme Automaticoverall theme for the plot
    RasterSizeAutomaticraster dimensions for the background data
    ScalingFunctions Nonehow to scale individual coordinates
    TargetUnitsAutomaticunits to display in the plot


open allclose all

Basic Examples  (5)

Points are shown using different colors for numeric values:

Multiple numeric values are displayed as plots:

Use size to represent the values associated with the points:

Plot spatial point data:

Plot geospatial data:

Scope  (14)

Data  (8)

Use a list of location-value rules:

Use grouped locations and values:

The values can contain quantities:

Use a quantity array for grouped values:

The keys in an association are used as the locations:

Use locations taken from geographic entities:

Use general geographic locations:

SpatialPointData objects include both location and values:

Encodings  (6)

Different values are mapped to different visual encodings:

Use color to encode the second value and size for the third:

Use a continuous set of colors:

Create pie charts from part of the sets of values:

Create bar charts from part of the sets of values:

Images and other visual values can be displayed directly:

Options  (53)

AspectRatio  (3)

Generic data uses a square aspect ratio by default:

Specify a different aspect ratio for the plot:

The aspect ratio for geographic data is determined by the map projection and geo range:

BubbleSizes  (3)

Bubble sizes are determined automatically:

Use named sets of sizes:

Specify the scaled bubble sizes for the smallest and largest values:

ColorFunction  (3)

Colors are computed using scaled values:

Color with a named color scheme:

Color with an arbitrary function:

ColorFunctionScaling  (2)

By default, arguments to the color function are scaled to be between 0 and 1:

Use unscaled values instead:

Frame  (2)

Generic data uses a frame by default:

Use axes instead of a frame:

FrameLabel  (3)

Generic data uses a frame by default:

Turn off the frame:

Use axes instead of a frame:

FrameStyle  (2)

Generic data uses a frame by default:

Specify a color for the frame:

GeoBackground  (3)

Geographic locations are shown on a default map background:

Use a satellite map for the background:

Use a relief map based on elevation instead:

GeoGridLines  (3)

Maps do not include lines of latitude and longitude by default:

Automatically choose which lines of latitude and longitude to include:

Specify the distance between lines of latitude and longitude:

GeoGridLinesStyle  (2)

Latitude and longitude lines are styled automatically:

Specify a color for the grid lines:

GeoProjection  (3)

Map projections are chosen automatically:

Use the Mercator projection for the map:

Use the Albers projection for the map:

GeoRange  (3)

The map region is chosen automatically:

Show a map of the entire world:

Show a map of the contiguous United States:

GeoScaleBar  (2)

Include scale bars for the map:

Include only metric distances:

GridLines  (3)

Enable grid lines on the plot:

Use horizontal grid lines only:

Specify which grid lines to include:

GridLinesStyle  (1)

Specify the style used by grid lines:

LabelingSize  (2)

The size of objects is determined automatically:

Use LabelingSize to change the size:

Specify the size of images used as labels:

LabelStyle  (3)

Label styles are chosen automatically:

Change the color of all labels in a plot:

Change the font and font size of the labels:

PlotRange  (2)

The range of values is computed automatically:

Specify the range to use:

PlotStyle  (3)

Styles are computed automatically:

Specify the size of points to use:

Specify colors to use for different groups in an encoding:

PlotTheme  (3)

Specify a theme for the plot:

Combine themes:

Turn off the grid lines normally used by the theme:

ScalingFunctions  (2)

Specify scaling functions to use on each axis:

Use a custom scale on the axis:

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


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


Wolfram Language. 2020. "PointValuePlot." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/PointValuePlot.html.


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


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


@online{reference.wolfram_2022_pointvalueplot, organization={Wolfram Research}, title={PointValuePlot}, year={2020}, url={https://reference.wolfram.com/language/ref/PointValuePlot.html}, note=[Accessed: 29-May-2023 ]}