as.hyperframe

0th

Percentile

Convert Data to Hyperframe

Converts data from any suitable format into a hyperframe.

Keywords
manip, spatial
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.

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.

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.

See Also

hyperframe, as.hyperframe.ppx

Aliases
  • as.hyperframe
  • as.hyperframe.default
  • as.hyperframe.data.frame
  • as.hyperframe.hyperframe
  • as.hyperframe.listof
  • as.hyperframe.anylist
Examples
# NOT RUN {
   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))
   as.hyperframe(as.solist(sims))
# }
Documentation reproduced from package spatstat, version 1.57-1, License: GPL (>= 2)

Community examples

Looks like there are no examples yet.