as.linfun: Convert Data to a Function on a Linear Network

In spatstat/spatstat.linnet: Linear Networks Functionality of the 'spatstat' Family

Convert Data to a Function on a Linear Network

Description

Convert some kind of data to an object of class "linfun" representing a function on a linear network.

Usage

  as.linfun(X, ...)

  ## S3 method for class 'linim'
as.linfun(X, ...)

  ## S3 method for class 'linnet'
as.linfun(X, ..., values=marks(X))

  ## S3 method for class 'lintess'
as.linfun(X, ..., values=marks(X), navalue=NA)

Arguments

X	Some kind of data to be converted.
...	Other arguments passed to methods.
values	Optional. Vector of function values, one entry associated with each tile of the tessellation.
navalue	Optional. Function value associated with locations that do not belong to a tile of the tessellation.

Details

An object of class "linfun" represents a function defined on a linear network.

The function as.linfun is generic. The method as.linfun.linim converts objects of class "linim" (pixel images on a linear network) to functions on the network.

The method as.linfun.linnet converts a linear network (object of class "linnet") to a function on the network. The function values are specified by the argument values. It should be a vector with one entry for each segment of the network; any point lying on segment number i will return the value values[i]. If values is missing or NULL, the function values are taken to be the marks attached to the segments (values=marks(X)); if there are no marks attached to the segments, the function value is the integer index of the segment (values=seq_len(nsegments(X))).

The method as.linfun.lintess converts a tessellation on a linear network into a function with a different value on each tile of the tessellation. The function values are specified by the argument values. It should be a vector with one entry for each tile of the tessellation; any point lying in tile number i will return the value values[i]. If values is missing, the marks of the tessellation are taken as the function values. If values is missing and the tessellation has no marks, or if values is given as NULL, then the function returns factor values identifying which tile contains each given point.

Value

Object of class "linfun".

Author(s)

\spatstatAuthors

.

See Also

linfun

Examples

   X <- runiflpp(2, simplenet)
   Y <- runiflpp(5, simplenet)

   # image on network
   D <- density(Y, 0.1)

   f <- as.linfun(D)
   f
   f(X)

   h <- as.linfun(simplenet)

   # tessellation on network
   Z <- lineardirichlet(Y)
   g <- as.linfun(Z)
   g(X)
   h <- as.linfun(Z, values = runif(5))
   h(X)

spatstat/spatstat.linnet documentation built on June 1, 2025, 6:17 p.m.