dsp = Engine

Models the vehicle engine.

Engine’s data
accelerations Acceleration vector [m/s2].
active_cylinder_ratios Possible active cylinder ratios [-].
after_treatment_temperature_threshold Engine coolant temperature threshold when the after treatment system is warm [°C].
alternator_powers Alternator power [kW].
auxiliaries_power_loss Constant power loss due to engine auxiliaries [kW].
auxiliaries_power_losses Engine power losses due to engine auxiliaries [kW].
auxiliaries_torque_loss Constant torque loss due to engine auxiliaries [N*m].
auxiliaries_torque_loss_factors Constant torque loss factors due to engine auxiliaries [N/m2, N*m].
auxiliaries_torque_losses Engine torque losses due to engine auxiliaries [N*m].
belt_efficiency Belt efficiency [-].
clutch_tc_powers Clutch or torque converter power [kW].
co2_emissions CO2 instantaneous emissions vector [CO2g/s].
co2_emissions_model CO2 emissions model (co2_emissions = models(params)).
co2_normalization_references CO2 normalization references (e.g., engine loads) [-].
co2_params CO2 emission model parameters (a2, b2, a, b, c, l, l2, t, trg).
co2_params_calibrated CO2 emission model parameters (a2, b2, a, b, c, l, l2, t, trg).
co2_params_initial_guess Initial guess of co2 emission model params.
engine_capacity Engine capacity [cm3].
engine_coolant_temperatures Engine coolant temperature vector [°C].
engine_fuel_lower_heating_value Fuel lower heating value [kJ/kg].
engine_has_cylinder_deactivation Does the engine have cylinder deactivation technology?
engine_has_variable_valve_actuation Does the engine feature variable valve actuation? [-].
engine_heat_capacity Engine heat capacity [kg*J/K].
engine_idle_fuel_consumption Fuel consumption at hot idle engine speed [g/s].
engine_inertia_powers_losses Engine power losses due to inertia [kW].
engine_is_turbo If the engine is equipped with any kind of charging.
engine_mass Engine mass [kg].
engine_max_power Engine nominal power [kW].
engine_max_speed Maximum allowed engine speed [RPM].
engine_max_torque Engine nominal torque [N*m].
engine_moment_inertia Engine moment of inertia [kg*m2].
engine_n_cylinders Number of engine cylinders [-].
engine_powers_out Engine power vector [kW].
engine_speed_at_max_power Engine speed at engine nominal power [RPM].
engine_speeds_out Engine speed [RPM].
engine_speeds_out_hot Engine speed at hot condition [RPM].
engine_stroke Engine stroke [mm].
engine_temperature_derivatives Derivative of the engine temperature [°C/s].
engine_temperature_regression_model Engine temperature regression engine_temperature_regression_model.
engine_thermostat_temperature Engine thermostat temperature [°C].
engine_thermostat_temperature_window Thermostat engine temperature limits [°C].
engine_type Engine type (positive turbo, positive natural aspiration, compression).
extended_phases_co2_emissions Extended CO2 emission of cycle phases [CO2g/km].
extended_phases_integration_times Extended cycle phases integration times [s].
fmep_model Engine FMEP model.
fuel_carbon_content Fuel carbon content [CO2g/g].
fuel_consumptions The instantaneous fuel consumption vector [g/s].
fuel_map Fuel consumption map [RPM, kW, g/s].
fuel_type Fuel type (diesel, gasoline, LPG, NG, ethanol, methanol, biodiesel, propane).
full_bmep_curve Vehicle full bmep curve.
full_load_curve Vehicle full load curve.
full_load_powers T1 map power vector [kW].
full_load_speeds T1 map speed vector [RPM].
full_load_torques T1 map torque vector [N*m].
gear_box_powers_out Gear box power out vector [kW].
gear_box_type Gear box type (manual or automatic or cvt).
gross_engine_powers_out Gross engine power (pre-losses) [kW].
has_exhausted_gas_recirculation Does the engine have exhaust gas recirculation technology?
has_lean_burn Does the engine have lean burn technology?
has_selective_catalytic_reduction Does the engine have selective catalytic reduction technology?
has_sufficient_power The cycle’s percentage in which the vehicle has sufficient power [%].
identified_co2_emissions CO2 instantaneous emissions vector [CO2g/s].
idle_engine_speed Idle engine speed and its standard deviation [RPM].
idle_engine_speed_median Idle engine speed [RPM].
idle_engine_speed_std Standard deviation of idle engine speed [RPM].
ignition_type Engine ignition type (positive or compression).
initial_engine_temperature Initial engine temperature [°C].
initial_friction_params Engine initial friction params l & l2 [-].
is_cycle_hot Is an hot cycle?
max_available_engine_powers_out Maximum available engine power [kW].
max_engine_coolant_temperature Maximum engine coolant temperature [°C].
mean_piston_speeds Mean piston speed vector [m/s].
min_available_engine_powers_out Minimum available engine power [kW].
min_engine_on_speed Minimum engine speed to consider the engine to be on [RPM].
missing_powers Missing powers [kW].
motor_p0_powers Power at motor P0 [kW].
motor_p1_powers Power at motor P1 [kW].
motor_p2_planetary_powers Power at planetary motor P2 [kW].
obd_fuel_type_code OBD fuel type of the vehicle [-].
on_engine If the engine is on [-].
on_idle If the engine is on idle [-].
phases_co2_emissions CO2 emission of cycle phases [CO2g/km].
phases_distances Cycle phases distances [km].
phases_integration_times Cycle phases integration times [s].
stop_velocity Maximum velocity to consider the vehicle stopped [km/h].
times Time vector [s].
velocities Velocity vector [km/h].
Engine’s functions
bypass Returns the same arguments.
calculate_auxiliaries_power_losses Calculates engine power losses due to engine auxiliaries [kW].
calculate_auxiliaries_torque_loss Calculates engine torque losses due to engine auxiliaries [N*m].
calculate_auxiliaries_torque_losses Calculates engine torque losses due to engine auxiliaries [N*m].
calculate_engine_heat_capacity Calculates the engine heat capacity [kg*J/K].
calculate_engine_inertia_powers_losses Calculates the engine power losses due to inertia [kW].
calculate_engine_mass Calculates the engine mass [kg].
calculate_engine_max_power Calculates engine nominal power [kW].
calculate_engine_max_power_v1 Calculates engine nominal power [kW].
calculate_engine_max_torque Calculates engine nominal torque [N*m].
calculate_engine_moment_inertia Calculates engine moment of inertia [kg*m2].
calculate_engine_speeds_out Calculates the engine speed [RPM].
calculate_engine_type Calculates the engine type (gasoline turbo, gasoline natural aspiration, diesel).
calculate_full_load_powers Calculates T1 map power vector [kW].
calculate_full_load_speeds Calculates T1 map speed vector [RPM].
calculate_gross_engine_powers_out Calculates the gross engine power (pre-losses) [kW].
calculate_max_available_engine_powers_out Calculates the maximum available engine power [kW].
calculate_mean_piston_speeds Calculates mean piston speed [m/sec].
calculate_min_available_engine_powers_out Calculates the minimum available engine power (i.e., engine motoring curve).
check_vehicle_has_sufficient_power Checks if the vehicle has sufficient power.
correct_engine_powers_out Corrects the engine powers out according to the available powers and returns the missing and brake power [kW].
default_engine_max_speed Returns the default maximum allowed engine speed [RPM].
default_full_load_speeds_and_powers Returns the defaults full load speeds and powers [RPM, kW].
default_ignition_type Returns the default ignition type according to the fuel type.
default_ignition_type_v1 Returns the default ignition type according to the fuel type.
define_fuel_type_and_is_hybrid Defines engine fuel type and if the vehicle is hybrid.
define_full_bmep_curve Defines the vehicle full bmep curve.
define_full_load_curve Calculates the full load curve.
identify_engine_max_speed Identifies the maximum allowed engine speed [RPM].
identify_engine_speed_at_max_power Identifies engine nominal speed at engine nominal power [RPM].
Engine’s dispatchers
calculate_idle_engine_speed Identify idle engine speed median and std.
fc_model Calculates fuel consumptions.
thermal Models the engine thermal behaviour.