openSkies (version 1.0.0)

openSkiesStateVectorSet: An R6Class object representing an ensemble of aircraft state vectors

Description

R6Class object representing an ensemble of aircraft state vectors. Contains a list of objects of class openSkiesStateVector. The ensemble can either represent a time series of state vectors of a single aircraft, or represent state vectors corresponding to multiple different aircrafts. For details on the information stored in each state vector, see the documentation for the openSkiesStateVector class. New instances can be manually created by providing a list of openSkiesStateVector objects. Alternatively, getSingleTimeStateVectors and getAircraftStateVectorsSeries will return an openSkiesStateVectorSet object if multiple state vectors matching the query conditions are found.

Usage

openSkiesStateVectorSet

Fields

state_vectors

List of openSkiesStateVector objects

time_series

Logical indicating if the openSkiesStateVectorSet object represents a time series of state vectors of a single aircraft.

Methods

add_state_vector(state_vector)

This method adds a new state vector to the openSkiesAircraft object, which will be set as the new last_state_vector and will be added to state_vector_history. state_vector should be an openSkiesStateVector object

get_uniform_interpolation(n, fields, method="fmm")

This method obtains a data frame with an interpolation of the specified fields along the route represented by the state vector set across n evenly distributed points. fields should be a character vector with the name of the fields that will be interpolated. Only numeric fields are accepted. method represents the interpolation method. "linear" will result in linear interpolation, while "fmm", "periodic", or "natural" will result in different types of spline interpolation.

get_time_points_interpolation(fields, time_field, timestamps, method="fmm")

This method obtains a data frame with an interpolation of the specified fields along the route represented by the state vector set across the specified timestamps. fields should be a character vector with the name of the fields that will be interpolated. Only numeric fields are accepted. method represents the interpolation method. "linear" will result in linear interpolation, while "fmm", "periodic", or "natural" will result in different types of spline interpolation. time_field indicates the name of the field of the openSkiesStateVectorSet object from which the timestamps of the original state vectors will be retrieved. Possible values are c("requested_time", "last_position_update_time", "last_any_update_time"). The time points at which the interpolations should be calculated should be provided as a vector through the timestamps argument.

sort_by_field(field, decreasing=FALSE)

This method sorts the state vectors of the openSkiesStateVectorSet object by the values of the field provided through field. By default, decreasing=FALSE and the state vectors will be sorted by increasing order of field. If decreasing=TRUE, decreasing order will be used.

split_into_flights(timeOnLandThreshold=300, timeDiffThreshold=1800)

This method automatically detects different flights contained in the openSkiesStateVectorSet object and returns a list of objects of class openSkiesFlight. Separate flights are detected based on two conditions: either the aircraft staying on ground for a given amount of time, or the aircraft not sending any status update for a given period. The thresholds are controlled, respectively, through the timeOnLandThreshold and timeDiffThreshold arguments. In both cases, the value should be provided in seconds.

Examples

# NOT RUN {
# Obtain a time series of state vectors for the aircraft with ICAO 24-bit 
# address 403003 for the 8th of October, 2020 between 16:50 and 16:53 (London
# time), with a time resolution of 1 minute.

if(interactive()){
test_stateVectorSet <- getAircraftStateVectorsSeries("403003", startTime="2020-10-08 16:50:00", 
endTime="2020-10-08 16:52:00", timeZone="Europe/London", timeResolution=60)
test_stateVectorSet
}
# }