grtslin {psurvey.design}R Documentation

Select GRTS Sample of a Linear Resource

Description

This function select a GRTS sample of a linear resource. This function uses hierarchical randomization to ensure that the sample will include no more than one point per cell and then picks a point in selected cells using a center-peaked distribution. The function can impose a probability distribution on permutation selection in the hierarchical randomization.

Usage

grtslin(src.frame="shapefile", shapefilename=NULL, xy.frame=NULL, linframe,
   samplesize=100, SiteBegin=1, shift.grid=TRUE, startlev=NULL, maxlev=12,
   prm.prb=rep(1, 24))

Arguments

src.frame source of the frame, which equals "shapefile" if frame is to be read from a shapefile and otherwise is equal to NULL. The default is "shapefile".
shapefilename name of the input shapefile. If src.frame equal "shapefile" and shapefilename equals NULL, then the shapefile or shapefiles in the currrent directory are used. The default is NULL.
xy.frame name of the data structure containing xy-coordinates for elements in the frame, where format depends on type.frame. If src.frame equals "shapefile", then equal to NULL.
linframe a data frame containing id, mdcaty and mdm.
samplesize number of points to select in the sample. The default is 100.
SiteBegin number to use for first site in the design. The default is 1.
shift.grid option to randomly shift the hierarchical grid, where TRUE means shift the grid and FALSE means do not shift the grid, which is useful if one desires strict spatial stratification by hierarchical grid cells. The default is TRUE.
startlev initial number of hierarchical levels to use for the GRTS grid, which must be less than or equal to maxlev (if maxlev is specified) and cannot be greater than 12. The default is NULL.
maxlev maximum number of hierarchical levels to use for the GRTS grid, which cannot be greater than 12. The default is 12.
prm.prb specifies the permutation distribution. The default is an equiprobable distribution.

Value

A data frame of GRTS sample points containing: SiteID, id, x, y, mdcaty, and weight.

Author(s)

Tony Olsen Olsen.Tony@epa.gov
Tom Kincaid Kincaid.Tom@epa.gov

References

Stevens, D.L., Jr., and A.R. Olsen. (2004). Spatially-balanced sampling of natural resources. Journal of the American Statistical Association 99: 262-278.

See Also

grts plot.lindsgn


[Package psurvey.design version 2.2.1 Index]