BayesX (version 0.3-1)

shp2bnd: convert a shape-file into a boundary object

Description

Converts the geographical information provided in a shape-file into a boundary object (see Ch. 5 of the Reference Manual)

Usage

shp2bnd(shpname, regionnames, check.is.in = TRUE)

Arguments

shpname

Base filename of the shape-file (including path)

regionnames

Either a vector of region names or the name of the variable in the dbf-file representing these names

check.is.in

Test whether some regions are surrounded by other regions (FALSE speeds up the execution time but may result in a corrupted bnd-file)

Value

Returns a boundary object, i.e. a list of polygons that form the map. See read.bnd for more information on the format.

References

BayesX Reference Manual. Available from http://www.bayesx.org

See Also

write.bnd,drawmap,read.bnd

Examples

# NOT RUN {
## read shapefile into bnd object
shpName <- sub(pattern="(.*)\\.dbf", replacement="\\1",
               x=system.file("examples/northamerica_adm0.dbf",
                             package="BayesX")) 
north <- shp2bnd(shpname=shpName, regionnames="COUNTRY")

## draw the map
drawmap(map=north)

## compare with shipped bnd file
shippedBnd <- read.bnd(system.file("examples/northamerica.bnd", package="BayesX"))
stopifnot(all.equal(north, shippedBnd))
# }