solist: List of Two-Dimensional Spatial Objects

Description

Make a list of two-dimensional spatial objects.

Usage

solist(..., check = TRUE, promote = TRUE)

Arguments

...

Any number of objects, each representing a two-dimensional spatial dataset.

check

Logical value. If TRUE, check that each of the objects is a 2D spatial object.

promote

Logical value. If TRUE, test whether all objects belong to the same class, and if so, promote the list of objects to the appropriate class of list.

Value

A list, usually belonging to the class "solist".

Details

This command creates an object of class "solist" (spatial object list) which represents a list of two-dimensional spatial datasets. The datasets do not necessarily belong to the same class.

Typically the intention is that the datasets in the list should be treated in the same way, for example, they should be plotted side-by-side. The spatstat package provides a plotting function, plot.solist, and many other functions for this class. In the spatstat package, various functions produce an object of class "solist". For example, when a point pattern is split into several point patterns by split.ppp, or an image is split into several images by split.im, the result is of class "solist".

If check=TRUE then the code will check whether all objects belong to one of the classes of two-dimensional spatial objects defined in the spatstat package. If this is not true then the result will belong to the more general class "anylist" instead of "solist". Set check=FALSE for efficiency, but only if you are sure that all the objects are valid.

If promote=TRUE then the code will check whether all the objects ... belong to the same class. If they are all point patterns (class "ppp"), the result will also belong to the class "ppplist". If they are all pixel images (class "im"), the result will also belong to the class "imlist".

Use as.solist to convert a list to a "solist".

Examples

Run this code

solist(cells, density(cells))
  solist(cells, japanesepines, redwood)