calc_vsp: Calculate VSP

Description Usage Arguments Value

View source: R/calc_vsp.R

Description

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().

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
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
)

Arguments

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.

Value

A value of vehicle (specific) power.


jack-davison/jdavisonmisc documentation built on Jan. 1, 2021, 4:26 a.m.