trackvisits: Visits from a Track with Locations

In henningte/herdersTA: Extracting Movement Characteristics from GPS Trajectories of Nomadic Households

Description

trackvisits is the constructor function of objects of class trackvisits. Object of class trackvisits are data.frame objects that contain a row for each visit at a specific location and several variables for this visit:

location

A numeric value representing the id of the location.

group

A numeric value representing the id of the group the visit is assigned to.

start

A numeric value representing a row index giving the start of the visit.

end

A numeric value representing a row index giving the end of the visit.

nextvisitduration

A numeric value representing the duration between the end of the current visit and the start of the following visit in row numbers.

nextvisitsamelocationduration

A numeric value representing the duration between the end of the current visit and the start of the next following visit at the same location in row numbers.

nextvisitsamelocation

A logical value indicating if the following visit is at the same location (TRUE) or not (FALSE).

campsite

A logical value indicating of the current visit is classified as campsite (TRUE) or not (FALSE).

campsiteinbetween

A logical value indicating if there is a campsite visit at a different location between the end of the current visit and the start of the next following visit at the same location.

mergewithnext

A logical value indicating if the current visit should be merged with the next visit (TRUE) or not (FALSE).

Object of class trackvisits can be used in order to manipulate tracks based on visits and locations.

Usage

trackvisits(
  location,
  group = NA,
  start,
  end,
  starttime,
  endtime,
  longitude,
  latitude,
  altitude,
  currentvisitduration,
  nextvisitduration = NA,
  nextvisitsamelocationindex = NA,
  nextvisitsamelocationduration = NA,
  nextvisitsamelocation = FALSE,
  campsite = FALSE,
  campsiteinbetween = FALSE,
  mergewithnext = FALSE,
  norepeatedcampsitevisits = NA
)

Arguments

location	A numeric value representing the id of the locations.
group	A numeric value representing the id of the group the visits are assigned to.
start	A numeric value representing a row index giving the start of the visits.
end	A numeric value representing a row index giving the end of the visits.
starttime	A POSIXct value representing the time of the start of the visit.
endtime	A POSIXct value representing the time of the end of the visit.
longitude	A numeric value representing the longitude of the location of the visit.
latitude	A numeric value representing the latitude of the location of the visit.
altitude	A numeric value representing the altitude of the location of the visit.
currentvisitduration	A numeric value representing the duration between the end of the current visit and the start of the current visit in row numbers.
nextvisitduration	A numeric value representing the duration between the end of the current visit and the start of the following visit in row numbers. The last value must be NA.
nextvisitsamelocationindex	A numeric value representing the index of the visit that is at the same location as the current visit. The last value must be NA.
nextvisitsamelocationduration	A numeric value representing the duration between the end of the current visit and the start of the next following visit at the same location in row numbers. The last value must be NA.
nextvisitsamelocation	A logical value indicating of the current visit is classified as campsite (TRUE) or not (FALSE).
campsite	A logical value indicating of the current visit is classified as campsite (TRUE) or not (FALSE).
campsiteinbetween	A logical value indicating if there is a campsite visit at a different location between the end of the current visit and the start of the next following visit at the same location.
mergewithnext	A logical value indicating if the current visit should be merged with the next visit (TRUE) or not (FALSE). If set to NULL, NA will be inserted.
norepeatedcampsitevisits	A numeric value representing the number of repeated campsite visits at the same location until this visit.

Value

An object of class trackvisits. Object of class trackvisits are data.frame objects that contain a row for each visit at a specific location and several variables:

location

A numeric value representing the id of the location.

group

A numeric value representing the id of the group the visit is assigned to.

start

A numeric value representing a row index giving the start of the visit.

end

A numeric value representing a row index giving the end of the visit.

starttime

A POSIXct value representing the time of the start of the visit.

endtime

A POSIXct value representing the time of the end of the visit.

longitude

A numeric value representing the longitude of the location of the visit.

latitude

A numeric value representing the latitude of the location of the visit.

altitude

A numeric value representing the altitude of the location of the visit.

currentvisitduration

A numeric value representing the duration between the end of the current visit and the start of the current visit in row numbers.

nextvisitduration

A numeric value representing the duration between the end of the current visit and the start of the following visit in row numbers.

nextvisitsamelocationindex

A numeric value representing the index of the visit that is at the same location as the current visit.

nextvisitsamelocationduration

A numeric value representing the duration between the end of the current visit and the start of the next following visit at the same location in row numbers.

nextvisitsamelocation

A logical value indicating if the following visit is at the same location (TRUE) or not (FALSE).

campsite

A logical value indicating of the current visit is classified as campsite (TRUE) or not (FALSE).

campsiteinbetween

A logical value indicating if there is a campsite visit at a different location between the end of the current visit and the start of the next following visit at the same location.

mergewithnext

A logical value indicating if the current visit should be merged with the next visit (TRUE) or not (FALSE).

norepeatedcampsitevisits

A numeric value representing the number of repeated campsite visits at the same location until this visit.

See Also

plot.trackvisits, trackvisitsFromTrack, trackvisitsGetGroups, trackvisitsMergeGroups, trackvisitsSetNextvisitsamelocationindex, trackvisitsSetNorepeatedcampsitevisits.

Examples

#

henningte/herdersTA documentation built on Jan. 22, 2020, 5:16 a.m.