spatstat.geom (version 2.1-0)

as.hyperframe: Convert Data to Hyperframe


Converts data from any suitable format into a hyperframe.


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, …)



Data in some other format.

Optional arguments passed to hyperframe.


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.


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

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

The behaviour can be changed using the argument stringsAsFactors.


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


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

   sims <- replicate(3, runifrect(10), simplify=FALSE)
# }