scatterm

Project scatter plot on axesm-based map

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.

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

Project Scatter Plot on Map

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")

Specify Marker Size

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")

Input Arguments

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	Appearance
"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

abm — axesm-based map

map created using axesm, worldmap, or usamap

axesm-based map, specified as a map created using the axesm, worldmap, or usamap function.

Output Arguments

h — Scatter plot

Group object

Scatter plot, returned as a Group object.

Version History

Introduced before R2006a