plot.stpp: Plot for spatio-temporal point objects

View source: R/plot.stpp.R

plot.stppR Documentation

Plot for spatio-temporal point objects

Description

This function plot either xy-locations and cumulative distribution of the times, or a space-time 3D scatter, or the time-mark and space-mark of the spatio-temporal point pattern, through arguments style and type.

It can also plot xy-locations with time treated as a quantitative mark attached to each location, as in the previous version of the function, through argument mark (see stpp version < 2.0.0).

Usage

## S3 method for class 'stpp'
plot(x, s.region=NULL, t.region=NULL, style="generic", type="projection",
mark=NULL , mark.cexmin=0.4, mark.cexmax=1.2, mark.col=1, ...)

Arguments

x

Any object of class stpp in spatio-temporal point format.

s.region

Two-column matrix specifying polygonal region containing all data locations. If s.region is missing, the default limits are considered.

t.region

Vector containing the minimum and maximum values of the time interval. If t.region is missing, the default limits are considered.

type

Specify the kind of graphical representation. If type="projection" (default) the function plot the xy-locations and cumulative distribution of the times. If type="mark" the function plot the time-mark and space-mark. If type="scatter" the function plot space-time 3D scatter.

style

Two different classes of graphic styles can be chosen. If style="generic" (default) the graphics are plot by default function plot in R and if style="elegant" the graphics are plot based on the R packages ggplot2 and plot3D.

mark

Logical. If NULL (default), xy-locations and cumulative distribution of the times are plotted. If TRUE, the time is treated as a quantitative mark attached to each location, and the locations are plotted with the size and/or colour of the plotting symbol determined by the value of the mark.

mark.cexmin, mark.cexmax

Range of the size of the plotting symbol when mark=TRUE.

mark.col

Colour of the plotting symbol when mark=TRUE. If mark.col=0, all locations have the same colour specified by the usual col argument. Otherwise, can be 1 or "black" (default), 2 or "red", 3 or "green", 4 or "blue", in which cases symbols colour is faded, and the darker corresponds to the most recent time.

...

Further arguments to be passed to the functions plot and scatter3D. Typical arguments are pch, theta and phi.

Value

None

Author(s)

Edith Gabriel <edith.gabriel@inrae.fr> and Francisco J. Rodriguez-Cortes.

References

Gabriel E., Rowlingson B., Diggle P. (2013). stpp: an R package for plotting, simulating and analyzing Spatio-Temporal Point Patterns. Journal of Statistical Software, 53(2), 1–29.

Stoyan, D., Rodriguez-Cortes, F. J., Mateu, J., and Gille, W. (2017). Mark variograms for spatio-temporal point processes. Spatial Statistics. 20, 125-147.

See Also

as.3dpoints for creating data in spatio-temporal point format.


stpp-GitHub-community/stpp documentation built on April 19, 2024, 3:14 a.m.