dsp¶

dsp = ems¶

Models the Energy Management System.

**ems’ data**¶
`accelerations`	Acceleration [m/s2].
`after_treatment_cooling_duration`	After treatment cooling duration [s].
`after_treatment_warm_up_duration`	After treatment warm up duration [s].
`after_treatment_warm_up_phases`	Phases when engine is affected by the after treatment warm up [-].
`auxiliaries_power_loss`	Constant power loss due to engine auxiliaries [kW].
`auxiliaries_torque_loss`	Constant torque loss due to engine auxiliaries [N*m].
`belt_mean_efficiency`	Belt mean efficiency [-].
`clutch_tc_mean_efficiency`	Clutch or torque converter mean efficiency [-].
`dcdc_converter_efficiency`	DC/DC converter efficiency [-].
`drive_battery_model`	Drive battery current model.
`drive_battery_state_of_charges`	State of charge of the drive battery [%].
`drive_line_efficiencies`	Drive line efficiencies vector.
`ecms_s`	Equivalent Consumption Minimization Strategy params.
`ems_data`	EMS decision data.
`ems_model`	Energy Management Strategy model.
`engine_coolant_temperatures`	Engine coolant temperature vector [°C].
`engine_moment_inertia`	Engine moment of inertia [kg*m2].
`engine_power_losses_function`	Engine power losses function.
`engine_powers_out`	Engine power vector [kW].
`engine_speeds_base`	Base engine speed (i.e., without clutch/TC effect) [RPM].
`engine_speeds_out`	Engine speed [RPM].
`engine_speeds_out_hot`	Engine speed at hot condition [RPM].
`engine_speeds_parallel`	Hypothetical engine speed in parallel mode [RPM].
`engine_thermostat_temperature`	Engine thermostat temperature [°C].
`final_drive_mean_efficiency`	Final drive mean efficiency [-].
`final_drive_speeds_in`	Final drive speed in [RPM].
`force_on_engine`	Phases when engine is on because parallel mode is forced [-].
`fuel_map`	Fuel consumption map [RPM, kW, g/s].
`fuel_map_model`	Fuel map model.
`full_load_curve`	Vehicle full load curve.
`gear_box_mean_efficiency`	Gear box mean efficiency [-].
`gear_box_mean_efficiency_guess`	Gear box mean efficiency guess [-].
`gear_box_speeds_in`	Gear box speed [RPM].
`has_motor_p2_planetary`	Has the vehicle a motor in planetary P2?
`hev_power_model`	Hybrid Electric Vehicle power balance model.
`hybrid_modes`	Hybrid mode status (0: EV, 1: Parallel, 2: Serial).
`idle_engine_speed`	Engine speed idle median and std [RPM].
`is_cycle_hot`	Is an hot cycle?
`is_serial`	Is the vehicle serial hybrid?
`min_time_engine_on_after_start`	Minimum time of engine on after a start [s].
`motive_powers`	Motive power [kW].
`motor_p0_efficiency`
`motor_p0_electric_powers`
`motor_p0_maximum_power`
`motor_p0_maximum_power_function`	Maximum power function of motor P0.
`motor_p0_speed_ratio`	Ratio between motor P0 speed and engine speed [-].
`motor_p1_efficiency`
`motor_p1_electric_powers`
`motor_p1_maximum_power`
`motor_p1_maximum_power_function`	Maximum power function of motor P1.
`motor_p1_speed_ratio`	Ratio between motor P1 speed and engine speed [-].
`motor_p2_efficiency`
`motor_p2_electric_powers`
`motor_p2_maximum_power`
`motor_p2_maximum_powers`	Maximum power vector of motor P2 [kW].
`motor_p2_planetary_efficiency`
`motor_p2_planetary_electric_powers`
`motor_p2_planetary_maximum_power`
`motor_p2_planetary_maximum_power_function`	Maximum power function of planetary motor P2.
`motor_p2_planetary_speed_ratio`	Ratio between planetary motor P2 speed and planetary speed [-].
`motor_p3_front_efficiency`
`motor_p3_front_electric_powers`
`motor_p3_front_maximum_power`
`motor_p3_front_maximum_powers`	Maximum power vector of motor P3 front [kW].
`motor_p3_rear_efficiency`
`motor_p3_rear_electric_powers`
`motor_p3_rear_maximum_power`
`motor_p3_rear_maximum_powers`	Maximum power vector of motor P3 rear [kW].
`motor_p4_front_efficiency`
`motor_p4_front_electric_powers`
`motor_p4_front_maximum_power`
`motor_p4_front_maximum_powers`	Maximum power vector of motor P4 front [kW].
`motor_p4_rear_efficiency`
`motor_p4_rear_electric_powers`
`motor_p4_rear_maximum_power`
`motor_p4_rear_maximum_powers`	Maximum power vector of motor P4 rear [kW].
`motors_efficiencies`	Electric motors efficiencies vector.
`motors_electric_powers`	Cumulative motors electric power [kW].
`motors_maximum_powers`
`motors_maximums_powers`	Maximum powers of electric motors [kW].
`on_engine`	If the engine is on [-].
`planetary_mean_efficiency`	Planetary mean efficiency [-].
`planetary_ratio`	Fundamental planetary speed ratio [-].
`serial_motor_maximum_power_function`	Serial motor maximum power function.
`sink`	Sink node of the dispatcher that collects all unused outputs.
`start`	Starting node that identifies initial inputs of the workflow.
`start_stop_activation_time`	Start-stop activation time threshold [s].
`start_stop_hybrid`	Start stop model for hybrid electric vehicles.
`start_stop_hybrid_params`	Params of start stop model for hybrid electric vehicles.
`starter_model`	Starter model.
`times`	Time vector [s].

**ems’ functions**¶
`calculate_ems_data`	Calculate EMS decision data.
`calculate_engine_speeds_parallel`	Calculate hypothetical engine speed in parallel mode [RPM].
`calculate_engine_speeds_parallel_v1`	Calculate hypothetical engine speed [RPM].
`calculate_hybrid_modes`	Calculate the hybrid mode status (0: EV, 1: Parallel, 2: Serial).
`calibrate_ems_model`	Calibrate Energy Management Strategy model.
`calibrate_start_stop_hybrid_params`	Calibrate start stop model for hybrid electric vehicles.
`default_start_stop_activation_time`	Returns the default start stop activation time threshold [s].
`define_drive_line_efficiencies`	Defines drive line efficiencies vector.
`define_ems_model`	Define Energy Management Strategy model.
`define_engine_power_losses_function`	Define engine power losses function.
`define_fuel_map_model`	Define the fuel map model.
`define_hev_power_model`	Define Hybrid Electric Vehicle power balance model.
`define_motors_efficiencies`	Returns the same arguments.
`define_motors_maximum_powers`	Returns the same arguments.
`define_motors_maximums_powers`	Defines maximum powers of electric motors [kW].
`define_serial_motor_maximum_power_function`	Define serial motor maximum power function.
`define_start_stop_hybrid`	Defines start stop model for hybrid electric vehicles.
`get_force_on_engine`	Returns the phases when engine is on because parallel mode is forced [-].
`identify_after_treatment_warm_up_phases`	Identifies after treatment warm up phase.
`identify_engine_speeds_base`	Identify the engine speed at hot condition [RPM].
`identify_engine_speeds_out_hot`	Predicts the engine speed at hot condition [RPM].
`identify_hybrid_modes`	Identify the hybrid mode status (0: EV, 1: Parallel, 2: Serial).
`identify_motors_electric_powers`	Identify motors electric power split [kW].
`identify_motors_electric_powers_v1`	Identify motors electric power split [kW].
`identify_on_engine`	Identifies if the engine is on [-].
`predict_engine_speeds_out_hot`	Predicts the engine speed at hot condition [RPM].
`predict_hybrid_modes`	Predicts the hybrid mode status (0: EV, 1: Parallel, 2: Serial).
`predict_motors_electric_powers`	Predicts motors electric power split [kW].