point_sample {biosurvey}R Documentation

Sample points from a 2D environmental space

Description

Sample one or more points from a two dimensional environmental space according to a selection rule and with the possibility of having distinct sets of points to be sampled independently.

Usage

point_sample(data, variable_1, variable_2, n = 1,
             select_point = "E_centroid", id_column = NULL)

Arguments

data

matrix or data.frame that contains at least four columns: "Longitude" and "Latitude" to represent geographic position, and two other columns to represent the variables of the 2D environmental space.

variable_1

(character or numeric) name or position of the first variable (x-axis).

variable_2

(character or numeric) name or position of the second variable (y-axis). Must be different from the first one.

n

(numeric) number of points to be selected. If id_column is defined this argument indicates the number of points per set. Default = 1.

select_point

(character) how or which point will be selected. Three options are available: "random", "E_centroid", and "G_centroid". E_ or G_ centroid indicate that the point(s) closest to the respective centroid will be selected. Default = "E_centroid".

id_column

(character or numeric) name or numeric index of the column in data containing identifiers of one or distinct sets of points. If, NULL, the default, only one set is assumed.

Value

A data.frame containing n rows corresponding to the point or points that were sampled.

Examples

# Data
data("m_matrix", package = "biosurvey")

# Sampling points
points_s <- point_sample(m_matrix$data_matrix,
                         variable_1 = "Max_temperature",
                         variable_2 = "Min_temperature", n = 1,
                         select_point = "E_centroid", id_column = NULL)

points_s

[Package biosurvey version 0.1.1 Index]