lhs.exp.shp: Export a LoCoH-hullset to shapefile

Description Usage Arguments Note See Also

Description

Export hulls, hull parent points, and/or isopleths from a locoh-hullset object to ESRI's shapefile format

Usage

1
2
3
4
5
6
7
lhs.exp.shp(lhs, id = NULL, k = NULL, r = NULL, a = NULL,
  s = NULL, hs.names = NULL, hpp = FALSE, hulls = FALSE,
  iso = FALSE, iso.idx = NULL, iso.metric = NULL, ellipses = FALSE,
  dr = FALSE, dr.idx = NULL, allpts = FALSE, nn = FALSE,
  dir = ".", file.base = "", file.base.auto = TRUE,
  avl.file = NULL, status = TRUE, show.time = TRUE, hm = "all",
  anv = NULL, hsp = NULL, metadata = TRUE)

Arguments

lhs

A LoCoH-hullset object

id

The name(s) of individuals to export

k

The k value of hullsets to export

r

The r value of hullsets to export

a

The a value of hullsets to export

s

The s value of hullsets to export

hs.names

The name(s) of saved hullsets to export

hpp

Export hull parent points (as a point shapefile). T/F

hulls

Export hulls (as a polygon shapefile). T/F

iso

Export isopleths (as a polygon shapefile). T/F

iso.idx

Numeric vector of the indices of the isopleths that will be exported (acts a filter)

iso.metric

Hull sort metric(s) for the isopleths that will be exported (acts a filter). Character vector.

ellipses

Export ellipses (as a polygon shapefile). T/F

dr

Export directional routes. T/F

dr.idx

Numeric vector of the indices of the isopleths that will be exported (acts a filter)

allpts

Export all points (as a point shapefile). T/F

nn

Export nearest neighbors (as a multipoint shapefile). T/F

dir

The directory where the shapefiles will be placed (use "." for the working directory, and "~" for the user directory)

file.base

The base of the file name without any extension (the script will append to this)

file.base.auto

Whether to automatically generate the file name base from the id, s-value, and k-a-r value. Ignored if file.base is passed. T/F

avl.file

The name of an existing avl (ArcView legend) file

status

Show messages. T/F

show.time

Report time for script to complete. T/F

hm

The name of hull metric(s) that will be included in the attribute table. Default is 'all'. Applicable only to hulls and hull parent points. Character vector or comma separated string.

anv

The name of ancillary variables(s) of the parent point that will be included in the attribute table. Default is NULL. Applicable only to hulls and hull parent points. Character vector or comma separated string.

hsp

A list containing one hull scatterplot object with regions saved (i.e., object returned by lhs.plot.scatter), or the index of a hull scatter plot saved in the hullset (see lhs.hsp.add). If passed, a column for the region number will be included in the attribute table. Applies only to hulls and hull parent points.

metadata

Export field descriptions in a meta data file (not yet supported)

Note

Filenames for the resulting shapefiles are automatically generated, but you can specify the directory with the dir argument and the base of the file name with file.base. The constructed filenames will consist of a base followed by the name of the hullset and a suffix indicating the type of feature saved (e.g., '.hulls', '.pts', ".iso", etc. ). If a shapefile already exists with the same name, a unique filename will be constructed by appending a two-digit numeric extension.

Most of the time, exporting hull parent points (hpp=T) is the same as exporting all points (allpts=T), however in some cases not all points have enough neighbors to make a hull so they wouldn't be included in exported of hull parent points. Only hull parent points will have the corresponding hull metrics included in the attribute table.

avl.file, if passed, is the name of an ArcView 3.x legend file that contains symbology info. If a value is passed, the script will make a copy of avl.file with the same base name as the shapefile, so that symbology will automatically created in ArcMap. avl.file is presumed to be relative to the working folder.

See Also

lhs.exp.csv, hulls, isopleths


tlocoh documentation built on May 2, 2019, 5:27 p.m.