Description Usage Arguments Details Value Author(s) References See Also Examples

View source: R/KinhomEnvelope.R

Simulates point patterns according to the null hypothesis and returns the envelope of *Kinhom* according to the confidence level.

1 2 3 | ```
KinhomEnvelope(X, r = NULL, NumberOfSimulations = 100, Alpha = 0.05,
ReferenceType = "", lambda = NULL, SimulationType = "RandomPosition",
Global = FALSE)
``` |

`X` |
A point pattern ( |

`r` |
A vector of distances. If |

`NumberOfSimulations` |
The number of simulations to run. |

`Alpha` |
The risk level. |

`ReferenceType` |
One of the point types. Default is all point types. |

`lambda` |
An estimation of the point pattern density, obtained by the |

`SimulationType` |
A string describing the null hypothesis to simulate. The null hypothesis, may be
" |

`Global` |
Logical; if |

The random location null hypothesis is that of Duranton and Overman (2005). It is appropriate to test the univariate *Kinhom* function of a single point type, redistributing it over all point locations.

The random labeling hypothesis is appropriate for the bivariate *Kinhom* function.

The population independence hypothesis is that of Marcon and Puech (2010).

This envelope is local by default, that is to say it is computed separately at each distance. See Loosmore and Ford (2006) for a discussion.

The global envelope is calculated by iteration: the simulations reaching one of the upper or lower values at any distance are eliminated at each step. The process is repeated until *Alpha / Number of simulations* simulations are dropped. The remaining upper and lower bounds at all distances constitute the global envelope. Interpolation is used if the exact ratio cannot be reached.

An envelope object (`envelope`

). There are methods for print and plot for this class.

The `fv`

contains the observed value of the function, its average simulated value and the confidence envelope.

Eric Marcon <[email protected]>

Duranton, G. and Overman, H. G. (2005). Testing for Localisation Using Micro-Geographic Data. *Review of Economic Studies* 72(4): 1077-1106.

Kenkel, N. C. (1988). Pattern of Self-Thinning in Jack Pine: Testing the Random Mortality Hypothesis. *Ecology* 69(4): 1017-1024.

Loosmore, N. B. and Ford, E. D. (2006). Statistical inference using the G or K point pattern spatial statistics. *Ecology* 87(8): 1925-1931.

Marcon, E. and Puech, F. (2010). Measures of the Geographic Concentration of Industries: Improving Distance-Based Methods. *Journal of Economic Geography* 10(5): 745-762.

Marcon, E. and F. Puech (2017). A typology of distance-based measures of spatial concentration. *Regional Science and Urban Economics*. 62:56-67.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | ```
data(paracou16)
# Keep only 20% of points to run this example
X <- as.wmppp(rthin(paracou16, 0.2))
plot(X)
# Density of all trees
lambda <- density.ppp(X, bw.diggle(X))
plot(lambda)
V.americana <- X[X$marks$PointType=="V. Americana"]
plot(V.americana, add=TRUE)
# Calculate Kinhom according to the density of all trees
# and confidence envelope (should be 1000 simulations, reduced to 4 to save time)
r <- 0:30
NumberOfSimulations <- 4
Alpha <- .10
plot(KinhomEnvelope(X, r,NumberOfSimulations, Alpha, ,
SimulationType="RandomPosition", lambda=lambda), ./(pi*r^2) ~ r)
``` |

```
Loading required package: spatstat
Loading required package: nlme
Loading required package: rpart
spatstat 1.52-1 (nickname: 'Apophenia')
For an introduction to spatstat, type 'beginner'
Note: R version 3.4.1 (2017-06-30) is more than 9 months old; we strongly recommend upgrading to the latest version
Loading required package: Rcpp
Warning message:
Interpretation of arguments maxsize and markscale has changed (in spatstat version 1.37-0 and later). Size of a circle is now measured by its diameter.
Plotting the first column of marks
Generating 4 simulations by evaluating expression ...
1, 2, 3, 4.
Done.
Warning message:
Envelope may be invalid; argument 'lambda' appears to have been fixed.
```

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.