dsp

dsp = Legislation

Models the legislation corrections.

Legislation’s data
accelerations Acceleration vector [m/s2].
after_treatment_warm_up_phases Phases when engine speed is affected by the after treatment warm up [-].
alternator_efficiency Alternator efficiency [-].
angle_slopes Angle slope vector [rad].
atct_family_correction_factor Family correction factor for representative regional temperatures [-].
batteries_phases_delta_energy Phases delta energy of the batteries [Wh].
co2_emission_EUDC CO2 emission on EUDC NEDC phase [CO2g/km].
co2_emission_UDC CO2 emission on UDC NEDC phase [CO2g/km].
co2_emission_extra_high CO2 emission on extra high WLTP phase [CO2g/km].
co2_emission_high CO2 emission on high WLTP phase [CO2g/km].
co2_emission_low CO2 emission on low WLTP phase [CO2g/km].
co2_emission_medium CO2 emission on medium WLTP phase [CO2g/km].
co2_emission_value CO2 emission value corrected for RCB [CO2g/km].
co2_emissions CO2 instantaneous emissions vector [CO2g/s].
co2_params_calibrated CO2 emission model parameters (a2, b2, a, b, c, l, l2, t, trg).
corrected_co2_emission_value Corrected CO2 emission value of the cycle [CO2g/km].
corrected_sustaining_co2_emission_value Corrected CO2 emission value of the cycle [CO2g/km].
cycle_type Cycle type (WLTP or NEDC).
declared_co2_emission_value  
declared_sustaining_co2_emission_value  
distances Cumulative distance vector [m].
drive_battery_capacity Drive battery capacity [Ah].
drive_battery_delta_state_of_charge Overall delta state of charge of the drive battery [%].
drive_battery_electric_powers Drive battery electric power [kW].
drive_battery_nominal_voltage Drive battery nominal voltage [V].
enable_phases_willans Enable the calculation of Willans coefficients for all phases?
enable_willans Enable the calculation of Willans coefficients for the cycle?
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_max_power Engine nominal power [kW].
engine_powers_out Engine power vector [kW].
engine_speeds_out Engine speed vector [RPM].
engine_stroke Engine stroke [mm].
engine_type Engine type (positive turbo, positive natural aspiration, compression).
fmep_model Engine FMEP model.
force_on_engine Phases when engine is on because parallel mode is forced [-].
fuel_carbon_content Fuel carbon content [CO2g/g].
fuel_carbon_content_percentage Fuel carbon content [%].
fuel_consumption_value Fuel consumption of the cycle [l/100km].
fuel_density Fuel density [g/l].
fuel_heating_value Fuel heating value [kWh/l].
fuel_type Fuel type (diesel, gasoline, LPG, NG, ethanol, methanol, biodiesel, propane).
has_periodically_regenerating_systems Does the vehicle has periodically regenerating systems? [-].
is_hybrid Is the vehicle hybrid?
is_plugin First arg.
kco2_nedc_correction_factor kco2 NEDC correction factor [CO2g/km/Ah].
kco2_wltp_correction_factor kco2 WLTP correction factor [CO2g/Wh].
ki_additive Additive correction for vehicles with periodically regenerating systems [CO2g/km].
ki_multiplicative Multiplicative correction for vehicles with periodically regenerating systems [-].
mean_piston_speeds Mean piston speed vector [m/s].
min_engine_on_speed Minimum engine speed to consider the engine to be on [RPM].
missing_powers Missing engine power [kW].
motive_powers Motive power [kW].
optimal_efficiency Optimal efficiency and the respective parameters:
phases_co2_emissions CO2 emission of cycle phases [CO2g/km].
phases_distances Cycle phases distances [km].
phases_fuel_consumptions Fuel consumption of cycle phases [l/100km].
phases_indices Indices of the cycle phases [-].
phases_integration_times Cycle phases integration times [s].
phases_times Cycle phases times [s].
phases_willans_factors Willans factors:
rcb_corrected_co2_emission_value CO2 emission value corrected for RCB [CO2g/km].
rcb_correction Apply RCB correction?
service_battery_electric_powers Service battery electric power [kW].
speed_distance_corrected_co2_emission_value CO2 emission value corrected for speed & distance [CO2g/km].
speed_distance_correction Apply speed distance correction?
theoretical_motive_powers Theoretical motive power [kW].
theoretical_phases_distances Theoretical cycle phases distances [km].
theoretical_velocities Theoretical velocity vector [km/h].
times Time vector.
velocities Velocity vector [km/h].
willans_factors Willans factors:
Legislation’s functions
bypass Returns the same arguments.
bypass Returns the same arguments.
calculate_batteries_phases_delta_energy Calculates the phases delta energy of the batteries [Wh].
calculate_co2_emission_value Calculates the CO2 emission of the cycle [CO2g/km].
calculate_corrected_co2_emission Calculates the corrected CO2 emission of the cycle [CO2g/km].
calculate_corrected_co2_emission Calculates the corrected CO2 emission of the cycle [CO2g/km].
calculate_corrected_co2_emission_for_conventional_nedc Calculates the corrected CO2 emission of the cycle [CO2g/km].
calculate_fuel_carbon_content Calculates the fuel carbon content as CO2g/g.
calculate_fuel_carbon_content_percentage Calculates the fuel carbon content as %.
calculate_fuel_consumption_value Calculates the fuel consumption of the cycle [l/100km].
calculate_fuel_heating_value Calculates the fuel heating value as kWh/l.
calculate_optimal_efficiency Calculates the optimal efficiency [-] and t.
calculate_phases_co2_emissions Calculates CO2 emission or cumulative CO2 of cycle phases [CO2g/km or CO2g].
calculate_phases_distances Calculates cycle phases distances [km].
calculate_phases_fuel_consumptions Calculates cycle phases fuel consumption [l/100km].
calculate_phases_times Calculates cycle phases times [s].
calculate_phases_willans_factors Calculates the Willans factors for each phase.
calculate_rcb_corrected_co2_emission_value Calculates the CO2 emission value corrected for RCB [CO2g/km].
calculate_rcb_corrected_co2_emission_value_v1 Calculates the CO2 emission value corrected for RCB [CO2g/km].
calculate_rcb_corrected_co2_emission_value_v2 Calculates the CO2 emission value corrected for RCB [CO2g/km].
calculate_speed_distance_corrected_co2_emission_value Calculates the CO2 emission value corrected for speed & distance [CO2g/km].
calculate_theoretical_phases_distances Calculates theoretical cycle phases distances [km].
calculate_willans_factors Calculates the Willans factors.
default_engine_fuel_lower_heating_value Returns the default fuel lower heating value [kJ/kg].
default_fuel_carbon_content Returns the default fuel carbon content [CO2g/g].
default_fuel_density Returns the default fuel density [g/l].
default_kco2_nedc_correction_factor Returns the kco2 NEDC correction factor [CO2g/km/Ah].
default_ki_multiplicative Returns the default ki multiplicative factor [-].
default_speed_distance_correction Returns if speed distance correction is to be applied.
identify_kco2_wltp_correction_factor Identifies the kco2 correction factor [g/Wh].
identify_phases_indices Identifies the indices of the cycle phases [-].
merge_wltp_phases_co2_emission Merges WLTP phases co2 emission.
merge_wltp_phases_co2_emission Merges WLTP phases co2 emission.