GeoHistogram
GeoHistogram[locs]
plots a density histogram of the geographic locations locs.
GeoHistogram[locs,bspec]
plots a density histogram with bins specified by bspec.
GeoHistogram[locs,bspec,hspec]
plots a density histogram with bin densities computed according to the specification hspec.
Details and Options
- GeoHistogram[locs] by default plots a histogram with hexagonal bins having equal visual size.
- The location locs has the following forms and interpretations:
-
GeoPosition[…] array of geodetic positions {loc1,loc2,…} list of locations <loc1w1,… > locations with weights WeightedData[…] locations with weights EntityClass[…] entities with locations according to the property "Position" EntityClass[…]prop entities with locations according to the property prop - The locations loci have the following forms:
-
GeoPosition[…] latitude and longitude Entity[…] an entity with a location according to the property "Position" Entity[…]prop an entity with a location according to the property prop - The following bin specifications bspec can be given:
-
Automatic automatically chosen bins n approximately n bins wide Quantity[diam,unit] bins with approximate diameter diam {Quantity[w,unit],Quantity[h,unit]} bins with approximate width w and height h Quantity[area,unit] bins with approximate area area "Hexagon","Rectangle","Triangle" automatic bins with a given tile shape {reg1,reg2,…} geographic regions enttype GeoIdentify entity type {tile,spec} tile shapes with specification spec fb apply fb to get an explicit bin specification - The bin specification {tile,spec} can use any of the named tile shapes combined with the following specifications spec:
-
n n tiles wide {m,n} m tiles wide by n tiles high {"Total",n} approximately n tiles in total Quantity[diam,unit] diameter of the tile is approximately diam {Quantity[w,unit],Quantity[h,unit]} tiles are approximately w wide and h tall Quantity[area,unit] area of the tile is approximately area - The regi can be Entity objects such as countries corresponding to extended geographic regions or geometric constructs with GeoPosition coordinates.
- The function fb in GeoHistogram[locs,fb] is applied to a list of all {lati,loni} and should return an explicit list of bins {reg1,reg2,…}.
- Different forms of density histogram can be obtained by giving different bin density specifications hspec in GeoHistogram[locs,bspec,hspec]. The following forms can be used:
-
"Count" number of elements in each bin "Probability" fraction of values lying in each bin "Intensity" counts divided by bin area "PDF" probability density function fh heights obtained by applying fh to bins and counts - The function fh in GeoHistogram[data,bspec,fh] is applied to two arguments: a list of bins {reg1,reg2,…} and the corresponding list of counts {c1,c2,…}. The function should return a list of densities to be used for each of the cij.
- Density specifications that divide by the area of the bin use GeoArea and not the area of the projected regions.
- GeoHistogram has the same options as GeoGraphics with the following additions and changes: [List of all options]
-
ColorFunction Automatic how to color the plot ColorFunctionScaling True whether to scale the argument to ColorFunction LabelingFunction Automatic how to label bins LabelStyle Automatic graphics directives to determine style of labels PerformanceGoal $PerformanceGoal aspects of performance to try to optimize PlotLegends None how the legend will appear PlotRangeClipping True whether to clip at the plot range PlotStyle Automatic graphics directives to determine style of the plot PlotTheme $PlotTheme overall theme for the plot - ColorFunction is supplied with a single argument, given by default by the scaled density values.
-
AlignmentPoint Center the default point in the graphic to align with AspectRatio Automatic ratio of height to width Axes False whether to draw axes AxesLabel None axes labels AxesOrigin Automatic where axes should cross AxesStyle {} style specifications for the axes Background None background color for the plot BaselinePosition Automatic how to align with a surrounding text baseline BaseStyle {} base style specifications for the graphic ColorFunction Automatic how to color the plot ColorFunctionScaling True whether to scale the argument to ColorFunction ContentSelectable Automatic whether to allow contents to be selected CoordinatesToolOptions Automatic detailed behavior of the coordinates tool Epilog {} primitives rendered after the main plot FormatType TraditionalForm the default format type for text Frame False whether to put a frame around the plot FrameLabel None frame labels FrameStyle {} style specifications for the frame FrameTicks Automatic frame ticks FrameTicksStyle {} style specifications for frame ticks GeoBackground Automatic style specifications for the background GeoCenter Automatic center coordinates to use GeoGridLines None geographic grid lines to draw GeoGridLinesStyle Automatic style specifications for geographic grid lines GeoGridRange All projected coordinate range to include GeoGridRangePadding Automatic how much to pad the projected range GeoModel Automatic model of the Earth (or other body) to use GeoProjection Automatic projection to use GeoRange Automatic geographic area range to include GeoRangePadding Automatic how much to pad the geographic range GeoResolution Automatic average distance between background pixels GeoScaleBar None scale bar to display GeoServer Automatic specification of a tile server GeoZoomLevel Automatic zoom to use for geographic background GridLines None grid lines to draw GridLinesStyle {} style specifications for grid lines ImageMargins 0. the margins to leave around the graphic ImagePadding All what extra padding to allow for labels etc. ImageSize Automatic the absolute size at which to render the graphic LabelingFunction Automatic how to label bins LabelStyle Automatic graphics directives to determine style of labels MetaInformation {} meta-information about the map Method Automatic details of graphics methods to use PerformanceGoal $PerformanceGoal aspects of performance to try to optimize PlotLabel None an overall label for the plot PlotLegends None how the legend will appear PlotRange All range of values to include PlotRangeClipping True whether to clip at the plot range PlotRangePadding Automatic how much to pad the range of values PlotRegion Automatic the final display region to be filled PlotStyle Automatic graphics directives to determine style of the plot PlotTheme $PlotTheme overall theme for the plot PreserveImageOptions Automatic whether to preserve image options when displaying new versions of the same graphic Prolog {} primitives rendered before the main plot RasterSize Automatic raster dimensions for the background data RotateLabel True whether to rotate y labels on the frame Ticks Automatic axes ticks TicksStyle {} style specifications for axes ticks
List of all options
Examples
open allclose allBasic Examples (3)
Scope (26)
Data (6)
Use a GeoPosition representing a list of locations:
Use a list of GeoPosition locations:
Use entities to represent locations:
Create a histogram from the EntityClass containing skyscrapers around the world:
Use an Association with locations for keys and values for counts:
Use WeightedData:
Bins and Counts (14)
The number of bins is calculated automatically:
Specify the number of bins to use in the direction:
Specify the total number of bins to use:
Use rectangular and triangular bins:
Use 8 rectangular bins in the x axis:
Use different automatic binning methods:
Specify the diameter of each tile:
A list of entities with polygons can be used as bin tiling:
Use GeoIdentify entity types as bins:
Use a function to get an explicit bin specification:
Coloring bins by "Count" or "Probability" only uses the number of points in each bin:
"Intensity" and "PDF" show variation due to the bins having different areas on the globe:
Presentation (6)
Change the shape of the bin tiles:
Specify the color function used to indicate the density of values:
Use GeoProjection to change the map projection:
Use GeoCenter to center the map on a specific location:
Use a theme with a simple background map:
Use a theme with a high contrast color scheme and bright colors:
Options (22)
ColorFunction (4)
By default, regions with a higher density of points are colored darker:
Specify the color function from a coloring scheme:
Specify a specific color function:
Use ColorFunctionScaling->False to get unscaled height values:
ColorFunctionScaling (1)
Use ColorFunctionScaling->False to get unscaled height values:
GeoBackground (3)
GeoProjection (1)
Use GeoProjection to change the map projection:
GeoRange (4)
GeoScaleBars (1)
LabelingFunction (2)
PlotLegends (3)
PlotStyle (2)
Applications (5)
Plot the frequency of earthquakes around the world over 10 years:
Show the distribution of breweries in the United States:
Generate a density histogram of notable buildings in New York City:
Properties & Relations (9)
Use GeoSmoothHistogram to generate smooth densities from locations:
Use GeoListPlot for individual locations:
Use GeoHistogram to aggregate locations into bins:
Use GeoBubbleChart to show values with scaled bubbles:
Use GeoRegionValuePlot to show values with colored regions:
Use GeoVectorPlot and GeoStreamPlot for vector fields:
Draw contours on a map with GeoContourPlot:
Smoothly shade a map using color with GeoDensityPlot:
Text
Wolfram Research (2016), GeoHistogram, Wolfram Language function, https://reference.wolfram.com/language/ref/GeoHistogram.html.
CMS
Wolfram Language. 2016. "GeoHistogram." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/GeoHistogram.html.
APA
Wolfram Language. (2016). GeoHistogram. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/GeoHistogram.html