spatstat (version 1.31-3)

as.hyperframe: Convert Data to Hyperframe

Description

Converts data from any suitable format into a hyperframe.

Usage

as.hyperframe(x, ...)
## S3 method for class 'default':
as.hyperframe(x, \dots)
## S3 method for class 'data.frame':
as.hyperframe(x, \dots, stringsAsFactors=FALSE)
## S3 method for class 'hyperframe':
as.hyperframe(x, \dots)
## S3 method for class 'listof':
as.hyperframe(x, \dots)

Arguments

x

Data in some other format.

...

Optional arguments passed to hyperframe.

stringsAsFactors

Logical. If TRUE, any column of the data frame x that contains character strings will be converted to a factor. If FALSE, no such conversion will occur.

Value

• An object of class "hyperframe" created by hyperframe.

Conversion of Strings to Factors

Note that as.hyperframe.default will convert a character vector to a factor. It behaves like as.data.frame.

However as.hyperframe.data.frame does not convert strings to factors; it respects the structure of the data frame x.

The behaviour can be changed using the argument stringsAsFactors.

Details

A hyperframe is like a data frame, except that its entries can be objects of any kind.

The generic function as.hyperframe converts any suitable kind of data into a hyperframe.

There are methods for the classes data.frame and listof, and a default method, all of which convert data that is like a hyperframe into a hyperframe object. (The method for the class listof converts a list of objects, of arbitrary type, into a hyperframe with one column.) These methods do not discard any information.

There are also methods for other classes (see as.hyperframe.ppx) which extract the coordinates from a spatial dataset. These methods do discard some information.

See Also

hyperframe, as.hyperframe.ppx

Examples

df <- data.frame(x=runif(4),y=letters[1:4])
   as.hyperframe(df)

   sims <- list()
   for(i in 1:3) sims[[i]] <- rpoispp(42)
   as.hyperframe(as.listof(sims))