R: Generate N Uniform Random Points On Line Segments

runifpointOnLines {spatstat} | R Documentation

## Generate N Uniform Random Points On Line Segments

### Description

Given a line segment pattern, generate a random point pattern consisting of `n` points uniformly distributed on the line segments.

### Usage

    runifpointOnLines(n, L, nsim=1, drop=TRUE)

### Arguments

`n` | Number of points to generate.
`L` | Line segment pattern (object of class `"psp"`) on which the points should lie.
`nsim` | Number of simulated realisations to be generated.
`drop` | Logical. If `nsim=1` and `drop=TRUE` (the default), the result will be a point pattern, rather than a list containing a point pattern.

### Details

This command generates a point pattern consisting of `n` independent random points, each point uniformly distributed on the line segment pattern. This means that, for each random point,

- the probability of falling on a particular segment is proportional to the length of the segment; and

- given that the point falls on a particular segment, it has uniform probability density along that segment.

If `n` is a single integer, the result is an unmarked point pattern containing `n` points. If `n` is a vector of integers, the result is a marked point pattern, with `m` different types of points, where `m = length(n)`, in which there are `n[j]` points of type `j`.

### Value

If `nsim = 1`, a point pattern (object of class `"ppp"`) with the same window as `L`. If `nsim > 1`, a list of point patterns.

### Author(s)

Adrian Baddeley Adrian.Baddeley@curtin.edu.au and Rolf Turner r.turner@auckland.ac.nz

### See Also

`psp`, `ppp`, `pointsOnLines`, `runifpoint`

### Examples

      X <- psp(runif(10), runif(10), runif(10), runif(10),  window=owin())
      Y <- runifpointOnLines(20, X)
      plot(X, main="")
      plot(Y, add=TRUE)
      Z <- runifpointOnLines(c(5,5), X)

[Package spatstat version 1.63-3 Index]