scatterm

Project scatter plot on axesm-based map

collapse all in page

Syntax

scatterm(lat,lon)

scatterm(lat,lon,sz)

scatterm(lat,lon,sz,c)

scatterm(___,"filled")

scatterm(___,mkr)

scatterm(abm,___)

h = scatterm(___)

Description

scatterm(lat,lon) creates a scatter plot on the current axesm-based map with circular markers at the geographic locations specified by lat and lon.

To display scatter plots on geographic axes or map axes, use the geoscatter function instead.

scatterm(lat,lon,sz) specifies the circle sizes.

scatterm(lat,lon,sz,c) specifies the circle colors.

scatterm(___,"filled") fills in the circles, in addition to any of the input argument combinations in the previous syntaxes.

example

scatterm(___,mkr) specifies the marker type.

scatterm(abm,___) plots into the specified axesm-based map abm instead of into the current axesm-based map. The option abm must precede any of the input argument combinations in the previous syntaxes.

h = scatterm(___) returns the scatter plot.

Examples

collapse all

Project Scatter Plot on Map

Open Live Script

Create a map of Europe.

load coastlines
worldmap europe
geoshow(coastlat,coastlon,"DisplayType","polygon", ...
    "FaceColor",[0.7 0.9 0.5])

Project the locations of European capitals onto the map using filled, black markers.

[lat,lon] = readvars("european_capitals.txt");
scatterm(lat,lon,"filled","k")

Figure contains an axes object. The hidden axes object contains 14 objects of type scatter, patch, line, text.

Specify Marker Size

Open Live Script

Create a map for a region containing Southeast Asia.

load coastlines
worldmap([-25 35],[90 170])
geoshow(coastlat,coastlon,"DisplayType","polygon", ...
    "FaceColor",[0.9 1 0.9])

Project the locations of tsunami events onto the map using filled markers. Specify the marker sizes using the maximum heights of the tsunamis.

GT = readgeotable("tsunamis.shp","CoordinateSystemType","geographic");
lat = GT.Shape.Latitude;
lon = GT.Shape.Longitude;
h = GT.Max_Height;

scatterm(lat,lon,10*h,"filled")

Figure contains an axes object. The hidden axes object contains 12 objects of type scatter, patch, line, text.

Input Arguments

collapse all

`lat` — Latitude coordinates
scalar | vector

Latitude coordinates, specified as a scalar or vector. The size of lat must match the size of lon.

Data Types: single | double

`lon` — Longitude coordinates
scalar | vector

Longitude coordinates, specified as a scalar or vector. The size of lon must match the size of lat.

Data Types: single | double

`sz` — Marker size
`36` (default) | numeric scalar | numeric vector | `[]`

Marker size, specified as one of these options. The size controls the area of each marker in points squared.

A numeric scalar — Use a uniform marker size.
A numeric vector — Use a different marker size for each data point. The vector must be the same length as lat and lon.
Empty brackets ([]) — Use the default market size of 36 points squared. Use this option when you want to specify c and use the default marker size.

`c` — Marker color
RGB triplet | three-column matrix of RGB triplets | vector | `"r"` | `"g"` | `"b"` | ...

Marker color, specified as one of these options.

RGB triplet or color name — Plot all markers with the same color.
Three-column matrix of RGB triplets — Use different colors for each marker. Each row of the matrix specifies an RGB triplet color for the corresponding marker. The number of rows must equal the lengths of lat and lon.
Vector — Use different colors for each marker and linearly map values in c to the current colormap. The length of c must equal the length of lat and lon.

An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1]; for example, [0.4 0.6 0.7]. Alternatively, you can specify some common colors by name. This table lists the named color options and equivalent RGB triplets.

Color Name	Short Name	RGB Triplet
`"red"`	`"r"`	`[1 0 0]`
`"green"`	`"g"`	`[0 1 0]`
`"blue"`	`"b"`	`[0 0 1]`
`"cyan"`	`"c"`	`[0 1 1]`
`"magenta"`	`"m"`	`[1 0 1]`
`"yellow"`	`"y"`	`[1 1 0]`
`"black"`	`"k"`	`[0 0 0]`
`"white"`	`"w"`	`[1 1 1]`

`"filled"` — Option to fill interior of markers
`"filled"`

Option to fill the interior of the markers, specified as "filled". Use this option with markers that have a face, such as "o" or "square". When you use this option with markers that do not have a face, such as "+", "*", ".", and "x", the function does not display any markers.

`mkr` — Marker symbol
`"o"` (default) | `"+"` | `"*"` | `"."` | `"x"` | ...

Marker symbol, specified as one of the values listed in this table.

Marker	Description	Resulting Marker
`"o"`	Circle
`"+"`	Plus sign
`"*"`	Asterisk
`"."`	Point
`"x"`	Cross
`"_"`	Horizontal line
`"\|"`	Vertical line
`"square"`	Square
`"diamond"`	Diamond
`"^"`	Upward-pointing triangle
`"v"`	Downward-pointing triangle
`">"`	Right-pointing triangle
`"<"`	Left-pointing triangle
`"pentagram"`	Pentagram
`"hexagram"`	Hexagram