calc_vsp: Calculate VSP
In jack-davison/jdavisonmisc: Generic Functions To Support VERS Analysis

Description Usage Arguments Value

View source: R/calc_vsp.R

This function simply calculates VSP using the methods outlined in the Davison 2020 STOTEN paper. This is useful for remote sensing datasets in conjuction with, for example, dplyr::mutate().

calc_vsp(
  mass = 1750,
  speed,
  accel,
  grad = 0,
  R0 = 157,
  R1 = 0.95,
  CdA = 0.66,
  aux = 2500,
  mass_unit = "kg",
  speed_unit = "ms",
  accel_unit = "mss",
  grad_unit = "rr",
  vehicle_specific = T
)

`mass`	Vehicle mass in kg or tonnes
`speed`	Vehicle speed in m/s, mph or km/h.
`accel`	Vehicle acceleration in m/s/s, mph/s or km/h/s.
`R0`	Rolling coefficient. Defaults to generic diesel car value 157.
`R1`	Rolling coefficient. Defaults to generic diesel car value 0.95.
`CdA`	Air resistance coefficient. Defaults to generic diesel car value 0.660.
`aux`	Auxiliary power demand in W. Defaults to 2500.
`mass_unit`	The unit of the vehicle mass provided. Can be "kg" or "t". Defaults to "kg".
`speed_unit`	The unit of the vehicle speed provided. Can be "ms", "mph" or "kmh". Defaults to "ms".
`accel_unit`	The unit of the vehicle acceleration provided. Can be "mss", "mphs" or "kmhs". Defaults to "mss".
`grad_unit`	The unit of the road gradient provided. Can be "rr" (rise over run), "perc" or "deg". Defaults to "rr".
`vehicle_specific`	Logical. If true (default), returns vehicle specific power in kW/t. If false, returns vehicle power in W.