dsp

dsp = Vehicle free body diagram

Calculates forces and power acting on the vehicle.

Vehicle free body diagram’s data

accelerations	Acceleration vector [m/s2].
aerodynamic_drag_coefficient	Aerodynamic drag coefficient [-].
aerodynamic_resistances	Aerodynamic resistance vector [N].
air_density	Air density [kg/m3].
air_temperature	Air temperature [°C].
angle_slope	Angle slope [rad].
angle_slopes	Angle slope vector [rad].
atmospheric_pressure	Atmospheric pressure [kPa].
cargo_mass	Cargo mass [kg].
climbing_force	Vehicle climbing resistance [N].
correct_f0	A different preconditioning cycle was used for WLTP and NEDC?
curb_mass	Curb mass [kg].
cycle_type	Cycle type (WLTP or NEDC).
distances	Cumulative distance vector [m].
elevations	Elevation vector [m].
f0	Rolling resistance force [N] when angle_slope == 0.
f0_uncorrected	Uncorrected rolling resistance force [N] when angle_slope == 0.
f1	Defined by dyno procedure [N/(km/h)].
f2	As used in the dyno and defined by respective guidelines [N/(km/h)^2].
frontal_area	Frontal area of the vehicle [m2].
fuel_mass	Fuel mass [kg].
has_roof_box	Has the vehicle a roof box? [-].
inertial_factor	Factor that considers the rotational inertia [%].
initial_velocity	Initial velocity [km/h].
motive_forces	Motive forces [N].
motive_powers	Motive power [kW].
n_dyno_axes	Number of dyno axes [-].
n_passengers	Number of passengers including driver [-].
n_wheel	Total number of wheels [-].
n_wheel_drive	Number of wheel drive [-].
obd_velocities	OBD velocity vector [km/h].
passenger_mass	Average passenger mass [kg].
passengers_mass	Passengers mass including the driver [kg].
path_distances	Cumulative distance vector [m].
path_elevations	Elevation vector [m].
raw_frontal_area	Raw frontal area of the vehicle [m2].
road_loads	Cycle road loads [N, N/(km/h), N/(km/h)^2].
road_state	Road state (i.e., dry, wet, rainfall, puddles, ice).
rolling_resistance	Rolling resistance force [N].
rolling_resistance_coeff	Rolling resistance coefficient [-].
rotational_inertia_forces	Rotational inertia forces [N].
slope_model	Angle slope model [rad].
static_friction	Static friction coefficient [-].
times	Time vector [s].
traction_acceleration_limit
traction_deceleration_limit
tyre_category	Tyre category (i.e., A, B, C, D, E, F, and G).
tyre_class	Tyre class (i.e., C1, C2, and C3).
tyre_state	Tyre state (i.e., new or worm).
unladen_mass	Unladen mass [kg].
vehicle_body	Vehicle body (i.e., cabriolet, sedan, hatchback, stationwagon, suv/crossover, mpv, coupé, bus, bestelwagen, pick-up).
vehicle_category	Vehicle category (i.e., A, B, C, D, E, F, S, M, and J).
vehicle_height	Vehicle height [m].
vehicle_mass	Vehicle mass [kg].
vehicle_width	Vehicle width [m].
velocities	Velocity vector [km/h].
velocity_resistances	Forces function of velocity [N].
wheel_drive_load_fraction	Repartition of the load on wheel drive axles [-].

Vehicle free body diagram’s functions

apply_f0_correction	Corrects the rolling resistance force [N] if a different preconditioning cycle was used for WLTP (WLTP precon) and NEDC (NEDC precon).
calculate_accelerations	Calculates the acceleration from velocity time series [m/s2].
calculate_accelerations_v1	Calculates the acceleration from motive forces [m/s2].
calculate_aerodynamic_drag_coefficient	Calculates the aerodynamic drag coefficient [-].
calculate_aerodynamic_drag_coefficient_v1	Calculates the aerodynamic drag coefficient [-].
calculate_aerodynamic_resistances	Calculates the aerodynamic resistances of the vehicle [N].
calculate_air_density	Calculates the air density [kg/m3].
calculate_angle_slopes	Returns the angle slope vector [rad].
calculate_climbing_force	Calculates the vehicle climbing resistance [N].
calculate_curb_mass	Calculate unladen mass [kg].
calculate_distances	Calculates the cumulative distance vector [m].
calculate_f0	Calculates rolling resistance [N].
calculate_f1	Calculates the f1 road load [N/(km/h)].
calculate_f2	Calculates the f2 coefficient [N/(km/h)^2].
calculate_frontal_area	Calculates the vehicle frontal area [m2].
calculate_motive_forces	Calculate motive forces [N].
calculate_motive_forces_v1	Calculate motive forces [N].
calculate_motive_powers	Calculates motive power [kW].
calculate_passengers_mass	Calculate passengers mass including driver [kg].
calculate_raw_frontal_area	Calculates raw frontal area of the vehicle [m2].
calculate_raw_frontal_area_v1	Calculates raw frontal area of the vehicle [m2].
calculate_rolling_resistance	Calculates rolling resistance [N].
calculate_rolling_resistance_coeff	Calculates the rolling resistance coefficient [-].
calculate_rotational_inertia_forces	Calculate rotational inertia forces [N].
calculate_traction_acceleration_limits	Calculates the traction acceleration limits [m/s2].
calculate_unladen_mass	Calculate unladen mass [kg].
calculate_unladen_mass_v1	Calculate unladen mass [kg].
calculate_vehicle_mass	Calculate vehicle_mass [kg].
calculate_velocities	Filters the obd velocities [km/h].
calculate_velocities_v1	Calculates the velocity from acceleration time series [km/h].
calculate_velocity_resistances	Calculates forces function of velocity [N].
calculate_wheel_drive_load_fraction	Calculate the repartition of the load on wheel drive axles [-].
default_n_wheel	Returns the default total number of wheels [-].
default_static_friction	Returns the default static friction coefficient [-].
define_slope_model	Returns the angle slope model [rad].
define_slope_model	Returns the angle slope model [rad].
define_slope_model_v1	Returns the angle slope model [rad].
grouping	Returns the same arguments.
select_default_n_dyno_axes	Selects the default number of dyno axes[-].
select_inertial_factor	Selects the inertia factor [%] according to the number of dyno axes.
splitting	Returns the same arguments.