siriemashapes: siriemashapes

View source: R/siriemashapes.R

siriemashapesR Documentation

siriemashapes

Description

Creates complete dataframe/shapefile from Hotspots results obtained from Siriema software.

Usage

siriemashapes(line_path, events_path, hotspot_path, crs)

Arguments

line_path

Line used in Siriema - txt file path.

events_path

Events used in Siriema - txt file path.

hotspot_path

Hotspot results obtained from Siriema - txt or dat file path.

crs

Coordinate reference system. Strongly recommended the use of EPSG number.

Details

WARNING: For best (and accurate) results, it is strongly recommended that the Hotspot analysis is performed taking into account the number of divisions set to double of the radius.

The function offers a large list object containing two elements: a spatial data frame with improvements of Siriema's Hotspot Analysis results and a summary of the species found in each sample unit.

The spatial data frame is called shapefile and it is composed by the following attributes:

  • ID: ID of the sample unit.

  • length: Length of the sample unit. It is supposed to be very similar to the diameter (double of the radius) of the original Hotspot Analysis.

  • km_center: Central km mark of the sample unit.

  • km_ini: Initial km mark of the sample unit.

  • km_end: Final km mark of the sample unit.

  • HS: Aggregation intensity.

  • UCL: Upper confidence limit.

  • LCL: Lower confidence limit.

  • HS-UCL: Subtraction of aggregation intensity by the upper limit of confidence interval. This is the "real" value of aggregation intensity as it already takes into account what is above the confidence interval.

  • Hotspot: Information if the sample unit is a hotspot. Y means that HS-UCL > 0 and therefore it is already a hotspot.

  • NEvents: Number of events in the sample unit.

  • Rank: Rank of aggregation intensity based on HS-UCL.

  • FisherJenks3: Fisher-Jenks classification in three classes (text) based on HS-UCL. Calculation is performed only on rows that already are a hotspot.

  • FJ3num: Fisher-Jenks classification in three classes (numeric) based on HS-UCL. Calculation is performed only on rows that already are a hotspot.

  • FisherJenks5: Fisher-Jenks classification in five classes (text) based on HS-UCL. Calculation is performed only on rows that already are a hotspot.

  • FJ5num: Fisher-Jenks classification in five classes (numeric) based on HS-UCL. Calculation is performed only on rows that already are a hotspot.

The summary of the species found in each sample unit is called species_df and it is composed by the following attributes:

  • ID: ID of the sample unit.

  • Sp: Species name (as from the Events file)

  • NEvents: Number of events in the sample unit.

Author(s)

Rubem Dornas (rapdornas@gmail.com)


rdornas/siriemashapes documentation built on Feb. 2, 2024, 12:02 a.m.