spatstat.geom (version 2.1-0)

as.hyperframe: Convert Data to Hyperframe

Description

Converts data from any suitable format into a hyperframe.

Usage

as.hyperframe(x, …)
# S3 method for default
as.hyperframe(x, …)
# S3 method for data.frame
as.hyperframe(x, …, stringsAsFactors=FALSE)
# S3 method for hyperframe
as.hyperframe(x, …)
# S3 method for listof
as.hyperframe(x, …)
# S3 method for anylist
as.hyperframe(x, …)

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, listof, anylist and a default method, all of which convert data that is like a hyperframe into a hyperframe object. (The method for the class listof and anylist 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

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

   sims <- replicate(3, runifrect(10), simplify=FALSE)
   as.hyperframe(as.listof(sims))
   as.hyperframe(as.solist(sims))
# }