diff --git a/Documentation/User Manual/3-simulation-models/Engine_FC_Correction.md b/Documentation/User Manual/3-simulation-models/Engine_FC_Correction.md
index 3df34a0d8a08b9298b57715beb0ae010f2bdb980..164a32760db5a56f56ed39bf63440a28bedd6f63 100644
--- a/Documentation/User Manual/3-simulation-models/Engine_FC_Correction.md
+++ b/Documentation/User Manual/3-simulation-models/Engine_FC_Correction.md
@@ -4,8 +4,38 @@ The final fuel consumption is corrected in a post-processing to reflect systems
###Engine Stop/Start Correction
-As the energy demand of auxiliaries is modeled as an average power demand over the whole simulated cycle, the energy demand certain auxiliaries during engine-off periods needs to be compensated during engine-on periods. This is done using the [Vehicle-Line approach](##vehicle-line-approach). The energy demand of the auxiliaries that shall be active also during engine-off periods as well as the energy demand for starting the engine is accumulated (see [Engine Stop/Start](#advanced-driver-assistant-systems-engine-stopstart), [Eco-Roll with Engine Stop/Start](#advanced-driver-assistant-systems-eco-roll), and [PCC with Eco-Roll and Engine Stop/Start](#advanced-driver-assistant-systems-predictive-cruise-control)) during the simulation. The final fuel consumption is corrected for this "missing" energy
+As the energy demand of auxiliaries is modeled as an average power demand over the whole simulated cycle, the energy demand of certain auxiliaries during engine-off periods needs to be compensated during engine-on periods. This is done using the [Vehicle-Line approach](##vehicle-line-approach). The energy demand of the auxiliaries that shall be active also during engine-off periods as well as the energy demand for starting the engine is accumulated (see [Engine Stop/Start](#advanced-driver-assistant-systems-engine-stopstart), [Eco-Roll with Engine Stop/Start](#advanced-driver-assistant-systems-eco-roll), and [PCC with Eco-Roll and Engine Stop/Start](#advanced-driver-assistant-systems-predictive-cruise-control)) during the simulation. The final fuel consumption is corrected for this "missing" energy
+###Bus Auxiliaries Correction
+
+**Electric System**
+
+In case smart electrics are used the electric energy generated may be different from the electric energy consumed as the smart alternator may generate more electric power in drag situations. Moreover, the state of charge of a battery may be different at the end of the simulated cycle than at the beginning and thus the fuel consumption needs to be corrected.
+
+$\Delta E_\textrm{ES} = E_\textrm{ES,consumed} - E_\textrm{ES,generated} + (\textrm{SOC}_\textrm{start} - \textrm{SOC}_\textrm{end}) * \textrm{Capacity}_{\textrm{RESS}}$
+
+$E_\textrm{ES,mech,corr} = \Delta E_\textrm{ES} / \eta_\textrm{alternator} / \eta_\textrm{pulley}$
+
+**Pneumatic System**
+
+In case of smart pneumatics the total air generated may be different from the total air consumed by all pneumatic consumers as the smart compressor generates more compressed air in drag situations. The fuel energy difference is corrected according to the following equations:
+
+$\Delta \textrm{Air} = \textrm{Air}_\textrm{consumed,total} - \textrm{Air}_\textrm{generated,total}$
+
+$k_\textrm{Air} = (E_\textrm{PS,generated} - E_\textrm{PS,off}) / (\textrm{Air}_\textrm{generated,total} - 0)$
+
+$E_\textrm{PS,corr} = k_\textrm{Air} * \Delta \textrm{Air}$
+
+
+**Aux Heater**
+
+The power demand for an additional fuel-fired heater is calculated in the post-processing. The HVAC steaty state model calculates the heating demand (weighted sum of different climatic conditions) and based on the engine's average waste heat over the cycle the power demand for the aux heater is calculated.
+
+$E_\textrm{ice,waste heat} = \sum_\textrm{fuels} FC_\textrm{final,sum}(fuel) * NCV_\textrm{fuel}$
+
+$\overline{P}_\textrm{ice,waste heat} = E_\textrm{ice, waste heat} / t_\textrm{cycle}$
+
+$E_{auxHeater} = P_\textrm{HVACSSM,auxHtr}(P_\textrm{ice,waste heat}) * t_\textrm{cycle}$
###Vehicle-Line Approach
@@ -13,6 +43,10 @@ The total fuel consumption is corrected in a post-processing step according to t
-$\Delta FC = k * (E_{aux,ICE,off} + E_{ICE,start} - E_{WHR,corr}/\eta_{alternator})$
+$\Delta FC = k * (E_\textrm{aux,ICE,off} + E_\textrm{ICE,start} - E_\textrm{WHR,corr}/\eta_\textrm{alternator}) + k * (E_\textrm{ES,mech,corr} + E_\textrm{PS,corr})$
+
+The fuel consumption for the aux heater is only added for the main fuel:
+
+$\Delta FC_\textrm{auxHeater} = E_\textrm{auxHeater} * NCV_\textrm{main fuel}$
-$FC_{final} = FC_{final,mod} + \Delta FC$
+$FC_\textrm{final} = FC_\textrm{final,mod} + \Delta FC + \Delta FC_\textrm{auxHeater}$
diff --git a/Documentation/User Manual/5-input-and-output-files/VMOD.md b/Documentation/User Manual/5-input-and-output-files/VMOD.md
index 5fd5810d890fd3726d7ac54f4a5c192ef8cf955b..9a2a994d4f23684f8f3cf3dc98e3ddaac40d5174 100644
--- a/Documentation/User Manual/5-input-and-output-files/VMOD.md
+++ b/Documentation/User Manual/5-input-and-output-files/VMOD.md
@@ -16,86 +16,87 @@ $P_{avg} = \frac{1}{simulation interval} \int{P(t) dt}$.
**Note:** For dual-fuel vehicles the fuel consumption columns are present for each fuel (e.g., FC-Map_Diesel CI, FC-Map_NG CI).
-| **Name** | **Unit** | **Description** |
-| ----------------- | ---------------------- | -------------------------- |
-| time | [s] | Absolute time. Timestamp at the middle of the current simulation interval [time - dt/2, time + dt/2] |
-| dt | [s] | Length of the current simulation interval |
-| dist | [m] | Distance the vehicle traveled at the end of the current simulation interval |
-| v_act | [km/h] | Average vehicle speed in the current simulation interval |
-| v_targ | [km/h] | Target speed |
-| acc | [m/s^2] | Vehicle's acceleration, constant during the current simulation interval |
-| grad | [%] | Road gradient |
-| Gear | [-] | Gear. "0" = clutch opened / neutral |
-| TC locked | 0/1 | For AT-Gearboxes: if the torque converter is locked or not |
-| n_eng_avg | [1/min] | Average engine speed in the current simulation interval. Used for interpolation of the engine's fuel consumption |
-| T_eng_fcmap | [Nm] | Engine torque used for interpolation of the engine's fuel consumption. T_eng_fcmap is the sum of torque demand on the output shaft, torque demand of the auxiliaries, and engine's inertia torque |
-| Tq_full | [Nm] | Engine's transient maximum torque (see [transient full load](#engine-transient-full-load)) |
-| Tq_drag | [Nm] | Engine's drag torque, interpolated from the full-load curve |
-| P_eng_fcmap | [kW] | Total power the engine has to provide, computed from n_eng_avg and T_eng_fcmap |
-| P_eng_full | [kW] | Engine's transient maximum power (see [transient full load](#engine-transient-full-load)) |
-| P_eng_drag | [kW] | Engine's drag power |
-| P_eng_inertia | [kW] | Power loss/gain due to the engine's inertia |
-| P_eng_out | [kW] | Power provided at the engine's output shaft |
-| P_clutch_loss | [kW] | Power loss in the clutch due to slipping when driving off |
-| P_clutch_out | [kW] | Power at the clutch's out shaft. P_clutch_out = P_eng_out - P_clutch_loss |
-| P_TC_out | [kW] | Power at the torque converter's out shaft. P_TC_out = P_eng_out - P_TC_loss |
-| P_TC_loss | [kW] | Power loss in the torque converter |
-| P_aux | [kW] | Total power demand from the auxiliaries |
-| P_gbx_in | [kW] | Power at the gearbox' input shaft |
-| P_gbx_loss | [kW] | Power loss at the gearbox, interpolated from the loss-map + shift losses + inertia losses |
-| P_gbx_shift | [kW] | Power loss due to gearshifts (AT gearbox) |
-| P_gbx_inertia | [kW] | Power loss due to the gearbox' inertia |
-| P_ret_in | [kW] | Power at the retarder's input shaft. P_ret_in = P_gbx_in - P_gbx_loss - P_gbx_inertia |
-| P_ret_loss | [kW] | Power loss at the retarder, interpolated from the loss-map. |
-| P_angle_in | [kW] | Power at the anglegear's input shaft. Empty if no Anglegear is used. |
-| P_angle_loss | [kW] | Power loss at the anglegear, interpolated from the loss-map. Empty if no Anglegear is used. |
-| P_axle_in | [kW] | Power at the axle-gear input shaft. P_axle_in = P_ret_in - P_ret_loss ( - P_angle_loss if an Angulargear is used). |
-| P_axle_loss | [kW] | Power loss at the axle gear, interpolated from the loss-map. |
-| P_brake_in | [kW] | Power at the brake input shaft (definition: serially mounted into the drive train between wheels and axle). P_brake_in = P_axle_in - P_axle_loss |
-| P_brake_loss | [kW] | Power loss due to braking. |
-| P_wheel_in | [kW] | Power at the driven wheels. P_wheel_in = P_brake_in - P_brake_loss |
-| P_wheel_inertia | [kW] | Power loss due to the wheels' inertia |
-| P_trac | [kW] | Vehicle's traction power. P_trac = P_wheel_in - P_wheel_inertia |
-| P_slope | [kW] | Power loss/gain due to the road's slope |
-| P_air | [kW] | Power loss due to air drag. |
-| P_roll | [kW] | Rolling resistance power loss. |
-| P_veh_inertia | [kW] | Power loss due to the vehicle's inertia |
-| P_aux_<XXX> | [kW] | Power demand for every individual auxiliary. Only if the run has auxiliaries. |
-| P_WHR_el | [kW] | Power generated by an electric WHR system, interpolated from WHR map. |
-| P_WHR_el_corr | [kW] | Power generated by an electric WHR system after applying |
-| P_aux_ESS_mech | [kW] | Power demand of the auxiliaries considered during engine off periods, multiplied by the engine start/stop utility factor. The final fuel consumption (.vsum) is correctedd for this power demand in a [post-processing step](#engine-fuel-consumption-correction). This power demand has no influence on FC-Map. |
-| P_ice_start | [kW] | Power demand for starting the engine after an engine-off period multiplied by the engine start/stop utility factor. P_ice_start = [E_ice_start](#advanced-driver-assistant-systems-eco-roll-engine-stopstart) / dt. The final fuel consumption (.vmod) is corrected for this power demand in a [post-processing step](#engine-fuel-consumption-correction). This power demand has no influence on FC-Map. |
-| P_PTO_consum | [kW] | Power demand from the PTO consumer. Only if the vehicle has a PTO consumer. |
-| P_PTO_transmission| [kW] | Power demand from the PTO transmission. Only if the vehicle has a PTO consumer. |
-| AA_NonSmartAlternatorsEfficiency | [Fraction] | Non-Smart Alternators Efficiency, Advance Auxiliaries Module |
-| AA_SmartIdleCurrent_Amps | [Amps] | Smart Idle Current in Amps, Advance Auxiliaries Module |
-| AA_SmartIdleAlternatorsEfficiency | [Fraction] | Smart Idle Alternators Efficiency, Advance Auxiliaries Module |
-| AA_SmartTractionCurrent_Amps | [Amps] | Smart Traction Current in Amps, Advance Auxiliaries Module |
-| AA_SmartTractionAlternatorEfficiency | [Fraction] | Smart Traction Alternator Efficiency, Advance Auxiliaries Module |
-| AA_SmartOverrunCurrent_Amps | [Amps] | Smart Overrun Current in Amps, Advance Auxiliaries Module |
-| AA_SmartOverrunAlternatorEfficiency | [Fraction] | Smart Overrun Alternator Efficiency, Advance Auxiliaries Module |
-| AA_CompressorFlowRate_LitrePerSec | [Ni L/S] | Compressor Flow Rate in litres per second, Advance Auxiliaries Module |
-| AA_OverrunFlag | [Bool [0/1] | Overrun Flag (yes/no), Advance Auxiliaries Module |
-| AA_EngineIdleFlag | [Bool [0/1] | Engine Idle Flag (yes/no), Advance Auxiliaries Module |
-| AA_CompressorFlag | [Bool [0/1] | Compressor Flag (off/on), Advance Auxiliaries Module |
-| AA_TotalCycleFC_Grams | [Grams] | Total Cycle Fuel Consumption in grams, Advance Auxiliaries Module |
-| AA_TotalCycleFC_Litres | [Litres] | Total Cycle Fuel Consumption in litres, Advance Auxiliaries Module |
-| TCnu | [-] | Torque converter operating point: speed ratio |
-| TCmu | [-] | Torque converter operating point: torque ratio |
-| T_TC_out | [Nm] | Torque converter operating point: output torque |
-| n_TC_out | [rpm] | Torque converter operating point: output speed |
-| T_TC_in | [Nm] | Torque converter operating point: input torque |
-| n_TC_in | [rpm] | Torque converter operating point: input speed |
-| FC-Map<\_FuelName> | [g/h] | Fuel consumption interpolated from FC map. |
-| FC-NCVc<\_FuelName> | [g/h] | Fuel consumption corrected for different NCV values in VECTO and VECTO Engine (FC-NCVc = FC-Map * LowerHeatingValueVectoEngine(fuel) / LowerHeatingValueVecto(fuel) ) |
-| FC-WHTCc<\_FuelName> | [g/h] | Fuel consumption after [WHTC Correction](#engine-fuel-consumption-calculation) (FC-WHTCc = FC-NCVc * WHTCCorrectionFactor(cycle, fuel) ) |
-| FC-AAUX<\_FuelName> | [g/h] | Fuel consumption computed by the AAUX module considering smart auxiliaries. (FC-AAUX = FC-WHTCc if the AAUX model is not used, otherwise the fuel consumption as calculated by the AAUX model) |
-| FC-ESS<\_FuelName> | [g/h] | Fuel consumption considering engine stop/start not always activated. (FC-ESS = FC-AAUX if the engie is on, FC-ESS = FC(P_aux) * (1 - engine stop/start utility factor) if the combustion engine is off - see [Engine Stop/Start](#advanced-driver-assistant-systems-eco-roll-engine-stopstart) |
-| FC-Final_mod<\_FuelName> | [g/h] | Instantaneous final fuel consumption value after all applicable corrections. (FC-Final_mod = FC-ESS) |
-| EcoRollConditionsMet | | 0 if the conditions for switching to eco-roll are _not_ met, 1 if the conditions for eco-roll are met - eco roll is activated after the activation delay (2s in declaration mode) |
-| PCCSegment | | 1 if a PCC segment was identified in the pre-processing (gradient below threshold where vehicle accelerates on its own without engine power), 0 otherwise |
-| PCCState | | 0: not inside PCC segment, 1: inside PCC segment, 2: PCC use-case 1 active, 3: PCC use-case 2 active |
-| ICE On | | 0 if the combustion engine is switched off (either during stand-still or eco-roll), 1 otherwise |
+| **Name** | **Unit** | **Description** |
+| ----------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| time | [s] | Absolute time. Timestamp at the middle of the current simulation interval [time - dt/2, time + dt/2] |
+| dt | [s] | Length of the current simulation interval |
+| dist | [m] | Distance the vehicle traveled at the end of the current simulation interval |
+| v_act | [km/h] | Average vehicle speed in the current simulation interval |
+| v_targ | [km/h] | Target speed |
+| acc | [m/s^2] | Vehicle's acceleration, constant during the current simulation interval |
+| grad | [%] | Road gradient |
+| Gear | [-] | Gear. "0" = clutch opened / neutral |
+| TC locked | 0/1 | For AT-Gearboxes: if the torque converter is locked or not |
+| n_ice_avg | [1/min] | Average engine speed in the current simulation interval. Used for interpolation of the engine's fuel consumption |
+| T_ice_fcmap | [Nm] | Engine torque used for interpolation of the engine's fuel consumption. T_eng_fcmap is the sum of torque demand on the output shaft, torque demand of the auxiliaries , and engine's inertia torque |
+| Tq_full | [Nm] | Engine's transient maximum torque (see [transient full load](#engine-transient-full-load)) |
+| Tq_drag | [Nm] | Engine's drag torque, interpolated from the full-load curve |
+| P_ice_fcmap | [kW] | Total power the engine has to provide, computed from n_eng_avg and T_eng_fcmap |
+| P_ice_full | [kW] | Engine's transient maximum power (see [transient full load](#engine-transient-full-load)) |
+| P_ice_drag | [kW] | Engine's drag power |
+| P_ice_inertia | [kW] | Power loss/gain due to the engine's inertia |
+| P_ice_out | [kW] | Power provided at the engine's output shaft |
+| P_clutch_loss | [kW] | Power loss in the clutch due to slipping when driving off |
+| P_clutch_out | [kW] | Power at the clutch's out shaft. P_clutch_out = P_eng_out - P_clutch_loss |
+| P_TC_out | [kW] | Power at the torque converter's out shaft. P_TC_out = P_eng_out - P_TC_loss |
+| P_TC_loss | [kW] | Power loss in the torque converter |
+| P_aux | [kW] | Total power demand from the auxiliaries |
+| P_gbx_in | [kW] | Power at the gearbox' input shaft |
+| P_gbx_loss | [kW] | Power loss at the gearbox, interpolated from the loss-map + shift losses + inertia losses |
+| P_gbx_shift | [kW] | Power loss due to gearshifts (AT gearbox) |
+| P_gbx_inertia | [kW] | Power loss due to the gearbox' inertia |
+| P_ret_in | [kW] | Power at the retarder's input shaft. P_ret_in = P_gbx_in - P_gbx_loss - P_gbx_inertia |
+| P_ret_loss | [kW] | Power loss at the retarder, interpolated from the loss-map. |
+| P_angle_in | [kW] | Power at the anglegear's input shaft. Empty if no Anglegear is used. |
+| P_angle_loss | [kW] | Power loss at the anglegear, interpolated from the loss-map. Empty if no Anglegear is used. |
+| P_axle_in | [kW] | Power at the axle-gear input shaft. P_axle_in = P_ret_in - P_ret_loss ( - P_angle_loss if an Angulargear is used). |
+| P_axle_loss | [kW] | Power loss at the axle gear, interpolated from the loss-map. |
+| P_brake_in | [kW] | Power at the brake input shaft (definition: serially mounted into the drive train between wheels and axle). P_brake_in = P_axle_in - P_axle_loss |
+| P_brake_loss | [kW] | Power loss due to braking. |
+| P_wheel_in | [kW] | Power at the driven wheels. P_wheel_in = P_brake_in - P_brake_loss |
+| P_wheel_inertia | [kW] | Power loss due to the wheels' inertia |
+| P_trac | [kW] | Vehicle's traction power. P_trac = P_wheel_in - P_wheel_inertia |
+| P_slope | [kW] | Power loss/gain due to the road's slope |
+| P_air | [kW] | Power loss due to air drag. |
+| P_roll | [kW] | Rolling resistance power loss. |
+| P_veh_inertia | [kW] | Power loss due to the vehicle's inertia |
+| P_busAux_ES_HVAC | [kW] | (Average) electric power demand for the HVAC system (mainly ventilation power) *(only in .vmod file if bus auxiliaries are used)* |
+| P_busAux_ES_other | [kW] | (Average) electric power demand for all other electric consumers (lights, radio, kitchen, ...) *(only in .vmod file if bus auxiliaries are used)* |
+| P_busAux_ES_consumer_sum | [kW] | (Average) total electric power demand of all electric consumers *(only in .vmod file if bus auxiliaries are used)* |
+| P_busAux_ES_mech | [kW] | (Average) mechanical power demand of all electric consumers (considering alternator efficiency and pulley efficiency) *(only in .vmod file if bus auxiliaries are used)* |
+| P_busAux_ES_gen | [kW] | Generated electrical power. May be higher than the electric power demand in case of smart electrics or lower if engine stop/start is enabled. Fuel consumption is corrected in the [post-processing](#engine-fuel-consumption-correction). *(only in .vmod file if bus auxiliaries are used)* |
+| Battery SoC | [%] | State of Charge of the battery (only used in case smart electric system is enabled) *(only in .vmod file if bus auxiliaries are used)* |
+| P_busAux_HVACmech_consumer | [kW] | (Average) mechanical power demand for the HVAC system. *(only in .vmod file if bus auxiliaries are used)* |
+| P_busAux_HVACmech_gen | [kW] | Generated mechanical power for the HVAC system. May be 0 in case of engine stop/start. the total fuel consumption is corrected in the [post-processing](#engine-fuel-consumption-correction). *(only in .vmod file if bus auxiliaries are used)* |
+| Nl_busAux_consumer | [Nl] | (Average) air demand of all consumers (air suspension, kneeling, brakes, pneumatic doors, ...). *(only in .vmod file if bus auxiliaries are used)* |
+| Nl_busAux_gen | [Nl] | Generated air (assuming the compressor runs only a fraction of the simulation interval). *(only in .vmod file if bus auxiliaries are used)* |
+| Nl_busAux_gen_max | [Nl] | Maximum air that can be generated if the compressor runs the whole simulation interval. *(only in .vmod file if bus auxiliaries are used)* |
+| P_busAux_PS_gen | [kW] | Mechanical power demand for the air compressor to produce Nl_busAux_gen air. *(only in .vmod file if bus auxiliaries are used)* |
+| P_busAux_PS_gen_max | [kW] | Mechanical power demand for the air compressor to produce the maximum air volume. (Used for correcting the total fuel consumption in case of smart pneumatic system) *(only in .vmod file if bus auxiliaries are used)* |
+| P_busAux_PS_gen_drag | [kW] | Mechanical power demand for the air compressor if no air is produced (compressor is in drag only, used for correcting the total fuel consumption in case of smart pneumatic system) *(only in .vmod file if bus auxiliaries are used)* |
+| P_aux_<XXX> | [kW] | Power demand for every individual auxiliary. Only if the run has auxiliaries. |
+| P_WHR_el | [kW] | Power generated by an electric WHR system, interpolated from WHR map. |
+| P_WHR_el_corr | [kW] | Power generated by an electric WHR system after applying |
+| P_aux_ESS_mech | [kW] | Power demand of the auxiliaries considered during engine off periods, multiplied by the engine start/stop utility factor. The final fuel consumption (.vsum) is correctedd for this power demand in a [post-processing step](#engine-fuel-consumption-correction). This power demand has no influence on FC-Map. |
+| P_ice_start | [kW] | Power demand for starting the engine after an engine-off period multiplied by the engine start/stop utility factor. P_ice_start = [E_ice_start](#advanced-driver-assistant-systems-eco-roll-engine-stopstart) / dt. The final fuel consumption (.vmod) is corrected for this power demand in a [post-processing step](#engine-fuel-consumption-correction). This power demand has no influence on FC-Map. |
+| P_PTO_consum | [kW] | Power demand from the PTO consumer. Only if the vehicle has a PTO consumer. |
+| P_PTO_transmission | [kW] | Power demand from the PTO transmission. Only if the vehicle has a PTO consumer. |
+| TCnu | [-] | Torque converter operating point: speed ratio |
+| TCmu | [-] | Torque converter operating point: torque ratio |
+| T_TC_out | [Nm] | Torque converter operating point: output torque |
+| n_TC_out | [rpm] | Torque converter operating point: output speed |
+| T_TC_in | [Nm] | Torque converter operating point: input torque |
+| n_TC_in | [rpm] | Torque converter operating point: input speed |
+| FC-Map<\_FuelName> | [g/h] | Fuel consumption interpolated from FC map. |
+| FC-NCVc<\_FuelName> | [g/h] | Fuel consumption corrected for different NCV values in VECTO and VECTO Engine (FC-NCVc = FC-Map * LowerHeatingValueVectoEngine(fuel) / LowerHeatingValueVecto(fuel) ) |
+| FC-WHTCc<\_FuelName> | [g/h] | Fuel consumption after [WHTC Correction](#engine-fuel-consumption-calculation) (FC-WHTCc = FC-NCVc * WHTCCorrectionFactor(cycle, fuel) ) |
+| FC-AAUX<\_FuelName> | [g/h] | Fuel consumption computed by the AAUX module considering smart auxiliaries. (FC-AAUX = FC-WHTCc if the AAUX model is not used, otherwise the fuel consumption as calculated by the AAUX model) |
+| FC-ESS<\_FuelName> | [g/h] | Fuel consumption considering engine stop/start not always activated. (FC-ESS = FC-AAUX if the engie is on, FC-ESS = FC(P_aux) * (1 - engine stop/start utility factor) if the combustion engine is off - see [Engine Stop/Start](#advanced-driver-assistant-systems-eco-roll-engine-stopstart) |
+| FC-Final_mod<\_FuelName> | [g/h] | Instantaneous final fuel consumption value after all applicable corrections. (FC-Final_mod = FC-ESS) |
+| EcoRollConditionsMet | | 0 if the conditions for switching to eco-roll are _not_ met, 1 if the conditions for eco-roll are met - eco roll is activated after the activation delay (2s in declaration mode) |
+| PCCSegment | | 1 if a PCC segment was identified in the pre-processing (gradient below threshold where vehicle accelerates on its own without engine power) , 0 otherwise |
+| PCCState | | 0: not inside PCC segment, 1: inside PCC segment, 2: PCC use-case 1 active, 3: PCC use-case 2 active |
+| ICE On | | 0 if the combustion engine is switched off (either during stand-still or eco-roll), 1 otherwise |
**Note:** The fuel name is only added to the fuel-consumption signals in case of dual-fuel engines.
@@ -107,4 +108,3 @@ P_loss_total = P_clutch_loss + P_gbx_loss + P_ret_loss + P_gbx_inertia + P_angle
P_wheel_inertia + P_air + P_roll + P_grad + P_veh_inertia (+ P_PTOconsumer + P_PTO_transm)
P_trac = P_veh_inertia + P_roll + P_air + P_slope
-
diff --git a/Documentation/User Manual/5-input-and-output-files/VSUM.md b/Documentation/User Manual/5-input-and-output-files/VSUM.md
index e2f8d99f850153e4c1f42904c3690ec261c8789f..2115663d1164e336646e86295dea4e39583cbc1c 100644
--- a/Documentation/User Manual/5-input-and-output-files/VSUM.md
+++ b/Documentation/User Manual/5-input-and-output-files/VSUM.md
@@ -5,61 +5,75 @@ The .vsum file includes total / average results for each calculation run in one
**Note:** For dual-fuel vehicles the fuel consumption columns are present for each fuel (e.g., FC-Map_Diesel CI, FC-Map_NG CI).
-| Name | Unit | Description |
-|-----------------------|--------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| Job | [-] | Job number in the format "X-Y" (with X as filenumber, and Y as cycle number) |
-| Input File | [-] | Name of the input job file (.vecto) |
-| Cycle | [-] | Name of the cycle file (or cycle name in declaration mode) |
-| Status | [-] | The result status of the run (Success, Aborted) |
-| Mass | [kg] | Vehicle mass (**Corected Actual Curb Mass Vehicle** + **Curb Mass Extra Trailer/Body**, see [Vehicle Editor](#vehicle-editor)) |
-| Loading | [kg] | Vehicle loading (see [Vehicle Editor](#vehicle-editor)) |
-| Cargo Volume | [m^3] | Vehicle cargo volume (Declaration Mode only!) |
-| time | [s] | Total simulation time |
-| distance | [km] | Total traveled distance |
-| speed | [km/h] | Average vehicle speed |
-| altitudeDelta | [m] | Altitude difference between start and end of cycle |
-| FC-Map<\_FuelName> | [g/h], [g/km] | Average fuel consumption before all corrections, interpolated from [Fuel Map](#engine-fuel-consumption-calculation), based on torque and engine speed. |
-| FC-NCVc<\_FuelName> | [g/h], [g/km] | Average fuel consumption after correcting for the [net calorific value](#engine-correction-factors) (Based on FC-Map from .vmod) |
-| FC-WHTCc<\_FuelName> | [g/h], [g/km] | Average fuel consumption after [WHTC Correction](#engine-fuel-consumption-calculation) (Based on FC-NCVc from .vmod) |
-| FC-AAUX<\_FuelName> | [g/h], [g/km] | Average fuel consumption after Smart Auxiliary Correction (*still in development*) (Based on FC-WHTCc from .vmod) |
-| FC-ESS<\_FuelName> | [g/h], [g/km] | Average fuel consumption including fuel consumption during engine-off periods (Based on FC-ESS from .vmod) |
-| FC-WHR_Corr<\_FuelName> | [g/h], [g/km] | Average fuel consumption including fuel consumption deduction due to electric power generated by an electric WHR system (FC-WHR_Corr = FC-ESS - E_WHR_el / eta_alternator * k_vehline)
-| FC-ESS_Corr<\_FuelName> | [g/h], [g/km] | Average fuel consumption including fuel consumption during engine-off periods corrected for energy demand during engine-off periods not accounted (FC-ESS_Corr = FC-WHR_Corr + (E_aux_ess_mech + E_ice_start) * k_vehline) |
-| FC-Final<\_FuelName> | [g/h], [g/km], [l/100km], [l/100tkm], [l/100m^3km] | Final average fuel consumption after ALL corrections (FC-Final = FC-ESS_Corr). Fuel consumption for calculation of CO~2~ value. If Loading = 0[kg] the column [l/100tkm] is left empty. |
-| CO2 | [g/km], [g/tkm], [g/m^3km] | Average CO~2~ emissions (based on FC-Final value). Output for [l/100tkm] is empty when Loading = 0[kg]. |
-| P_wheel_in_pos | [kW] | Average positive power at the wheels |
-| P_fcmap_pos | [kW] | Average positive power at engine (all non-negative values averaged over the whole cycle duration) |
-| E_fcmap_pos | [kWh] | Total positive work provided by the combustion engine. |
-| E_fcmap_neg | [kWh] | Total energy |
-| E_powertrain_inertia | [kWh] | Total work of engine, torqueconverter, and gearbox inertia |
-| E_aux_xxx | [kWh] | Energy demand of auxiliary with ID xxx. See also [Aux Dialog](#auxiliary-dialog) and [Driving Cycle](#driving-cycles-.vdri). In Declaration Mode the following auxiliaries always exists: E_aux_FAN (Fan), E_aux_PS (Pneumatic System), E_aux_STP (Steering Pump), E_aux_ES (Electrical System), E_aux_AC (Air Condition) |
-| E_aux_sum | [kWh] | Total energy demand of all auxiliaries. This is the sum for all E_aux_xxx columns. |
-| E_clutch_loss | [kWh] | Total energy loss in the clutch |
-| E_tc_loss | [kWh] | Total torque converter energy loss |
-| E_gbx_loss | [kWh] | Total transmission energy losses at gearbox (includes loss-map, inertia, and gear-shifts). E_shift_loss is already included here. |
-| E_shift_loss | [kWh] | Total energy losses due to gearshifts |
-| E_ret_loss | [kWh] | Total retarder energy loss |
-| E_angle_loss | [kWh] | Total torque converter energy loss |
-| E_axl_loss | [kWh] | Total transmission energy losses at the axlegear |
-| E_brake | [kWh] | Total work dissipated in mechanical braking (sum of service brakes, retader and additional engine exhaust brakes) |
-| E_vehicle_inertia | [kWh] | Total work of wheels inertia and vehicle mass |
-| E_air | [kWh] | Total work of air resistance |
-| E_roll | [kWh] | Total work of rolling resistance |
-| E_grad | [kWh] | Total work of gradient resistance |
-| E_PTO_CONSUM | [kWh] | Total energy demand of the pto consumer (if a pto consumer was used). |
-| E_PTO_TRANSM | [kWh] | Total energy demand of the pto transmission (if a pto transmission was used). |
-| E_WHR_el | [kWh] | Total electric energy generated by an electrical WHR system |
-| E_aux_ess_mech | [kWh] | Total work of auxiliaries during engine stop and thus not considered in FC-Map and FC-AAUX. Considered in FC-ESS_Corr via [fuel consumption correction](#engine-fuel-consumption-correction) (Based on P_aux_ESS_mech in .vmod) |
-| E_ice_start | [kWh] | Total work for starting the combustion engine, not considered in FC-Map and FC-AAUX. Considered in FC-ESS_Corr via [fuel consumption correction](#engine-fuel-consumption-correction) (Based on P_ice_start in .vmod) |
-| ice_starts | [-] | Number of times the combustion engine is started |
-| k_vehline | [g/kWh] | Slope of the regression line used for the [fuel consumption correction](#engine-fuel-consumption-correction) |
-| a | [m/s^2^] | Average acceleration |
-| a_pos | [m/s^2^] | Average acceleration in acceleration phases (a~3s~ \> 0.125 \[m/s^2^\], a~3s~ = 3-seconds-averaged acceleration) |
-| a_neg | [m/s^2^] | Average deceleration in deceleration phases (a~3s~ \< 0.125 \[m/s^2^\], a~3s~ = 3-seconds-averaged acceleration) |
-| AccelerationTimeShare | [%] | Time share of acceleration phases (a~3s~ \> 0.125 \[m/s^2^\], a~3s~ = 3-seconds-averaged acceleration) |
-| DecelerationTimeShare | [%] | Time share of deceleration phases (a~3s~ \< 0.125 \[m/s^2^\], a~3s~ = 3-seconds-averaged acceleration) |
-| CruiseTimeShare | [%] | Time share of cruise phases (-0.125 ≤ a~3s~ ≤ 0.125 \[m/s^2^\]) |
-| StopTimeShare | [%] | Time share of stop phases (v \< 0.1 \[m/s\]) |
+| Name | Unit | Description |
+| ----------------------- | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Job | [-] | Job number in the format "X-Y" (with X as filenumber, and Y as cycle number) |
+| Input File | [-] | Name of the input job file (.vecto) |
+| Cycle | [-] | Name of the cycle file (or cycle name in declaration mode) |
+| Status | [-] | The result status of the run (Success, Aborted) |
+| Mass | [kg] | Vehicle mass (**Corected Actual Curb Mass Vehicle** + **Curb Mass Extra Trailer/Body**, see [Vehicle Editor](#vehicle-editor)) |
+| Loading | [kg] | Vehicle loading (see [Vehicle Editor](#vehicle-editor)) |
+| Cargo Volume | [m^3] | Vehicle cargo volume (Declaration Mode only!) |
+| time | [s] | Total simulation time |
+| distance | [km] | Total traveled distance |
+| speed | [km/h] | Average vehicle speed |
+| altitudeDelta | [m] | Altitude difference between start and end of cycle |
+| FC-Map<\_FuelName> | [g/h], [g/km] | Average fuel consumption before all corrections, interpolated from [Fuel Map](#engine-fuel-consumption-calculation), based on torque and engine speed. |
+| FC-NCVc<\_FuelName> | [g/h], [g/km] | Average fuel consumption after correcting for the [net calorific value](#engine-correction-factors) (Based on FC-Map from .vmod) |
+| FC-WHTCc<\_FuelName> | [g/h], [g/km] | Average fuel consumption after [WHTC Correction](#engine-fuel-consumption-calculation) (Based on FC-NCVc from .vmod) |
+| FC-ESS<\_FuelName> | [g/h], [g/km] | Average fuel consumption including fuel consumption during engine-off periods (Based on FC-ESS from .vmod) |
+| FC-ESS_Corr<\_FuelName> | [g/h], [g/km] | Average fuel consumption including fuel consumption during engine-off periods corrected for energy demand during engine-off periods not accounted (FC-ESS_Corr = FC-WHR_Corr + (E_aux_ess_mech + E_ice_start) * k_vehline) |
+| FC-BusAux_PS_Corr<\_FuelName> | [g/h], [g/km] | Average fuel consumption corrected for the excessive/missing energy for the smart pneumatic system |
+| FC-BusAux_ES_Corr<\_FuelName> | [g/h], [g/km] | Average fuel consumption corrected for the excessive/missing energy for the smart electric system |
+| FC-WHR_Corr<\_FuelName> | [g/h], [g/km] | Average fuel consumption including fuel consumption deduction due to electric power generated by an electric WHR system (FC-WHR_Corr = FC-ESS - E_WHR_el / eta_alternator * k_vehline) |
+| FC-BusAux\_AuxHeater<\_FuelName> | [g/h], [g/km] | Average fuel consumption of the additionalheater. In case of dual-fuel vehicles the aux heater is fueled with the primary fuel |
+| FC-BusAux\_AuxHeater\_Corr<\_FuelName> | [g/h], [g/km] | Average fuel consumptioncorrected for the aux heater fuel demand |
+| FC-Final<\_FuelName> | [g/h], [g/km], [l/100km], [l/100tkm], [l/100m^3km] | Final average fuel consumption after ALL corrections (FC-Final = FC-ESS_Corr). Fuel consumption for calculation of CO~2~ value. If Loading = 0[kg] the column [l/100tkm] is left empty. |
+| CO2 | [g/km], [g/tkm], [g/m^3km] | Average CO~2~ emissions (based on FC-Final value). Output for [l/100tkm] is empty when Loading = 0[kg]. |
+| P_wheel_in_pos | [kW] | Average positive power at the wheels |
+| P_fcmap_pos | [kW] | Average positive power at engine (all non-negative values averaged over the whole cycle duration) |
+| E_fcmap_pos | [kWh] | Total positive work provided by the combustion engine. |
+| E_fcmap_neg | [kWh] | Total energy |
+| E_powertrain_inertia | [kWh] | Total work of engine, torqueconverter, and gearbox inertia |
+| E_aux_xxx | [kWh] | Energy demand of auxiliary with ID xxx. See also [Aux Dialog](#auxiliary-dialog) and [Driving Cycle](#driving-cycles-.vdri). In Declaration Mode the following auxiliaries always exists: E_aux_FAN (Fan), E_aux_PS (Pneumatic System), E_aux_STP (Steering Pump), E_aux_ES (Electrical System), E_aux_AC (Air Condition) |
+| E_aux_sum | [kWh] | Total energy demand of all auxiliaries. This is the sum for all E_aux_xxx columns and the bus auxiliaires. |
+| E_clutch_loss | [kWh] | Total energy loss in the clutch |
+| E_tc_loss | [kWh] | Total torque converter energy loss |
+| E_gbx_loss | [kWh] | Total transmission energy losses at gearbox (includes loss-map, inertia, and gear-shifts). E_shift_loss is already included here. |
+| E_shift_loss | [kWh] | Total energy losses due to gearshifts |
+| E_ret_loss | [kWh] | Total retarder energy loss |
+| E_angle_loss | [kWh] | Total torque converter energy loss |
+| E_axl_loss | [kWh] | Total transmission energy losses at the axlegear |
+| E_brake | [kWh] | Total work dissipated in mechanical braking (sum of service brakes, retader and additional engine exhaust brakes) |
+| E_vehicle_inertia | [kWh] | Total work of wheels inertia and vehicle mass |
+| E_air | [kWh] | Total work of air resistance |
+| E_roll | [kWh] | Total work of rolling resistance |
+| E_grad | [kWh] | Total work of gradient resistance |
+| BusAux PS air consumed | [Nl] | Total air consumed by the pneumatic system. |
+| BusAux PS air generated | [Nl] | Total air generated by the pneumatic compressor. Difference to "BusAux PS air consumed" is corrected in the [post-processing](#engine-fuel-consumption-correction) |
+| E_PS_compressorOff | [kWh] | Total energy demand for the pneumatic compressor if no air would be generated (compressor always in drag) |
+| E_PS_compressorOn | [kWh] | Total mechanical work for the pneumatic compressor to generate "BusAux PS air generated" |
+| E_BusAux_ES_consumed | [kWh] | Total electric energy for all electric consumers |
+| E_BusAux_ES_generated | [kWh] | Total electric energy generated |
+| ΔE_BusAux_Bat | [kWh] | In case of smart electrics, the difference of energy stored in the RESS between the beginning and end of the driving cycle. This energy difference is corrected in the post-processing |
+| E_BusAux_PS_corr | [kWh] | Mechanical energy of the pneumatic system that needs to be considered in the post-processing to [correct the total fuel consumption](#engine-fuel-consumption-correction) |
+| E_BusAux_ES_mech_corr | [kWh] | Mechanical energy of the electric system that needs to be considered in the post-processing to [correct the total fuel consumption](#engine-fuel-consumption-correction) |
+| E_BusAux_AuxhHeater | [kWh] | Energy demand of an additional aux heater. |
+| E_PTO_CONSUM | [kWh] | Total energy demand of the pto consumer (if a pto consumer was used). |
+| E_PTO_TRANSM | [kWh] | Total energy demand of the pto transmission (if a pto transmission was used). |
+| E_WHR_el | [kWh] | Total electric energy generated by an electrical WHR system |
+| E_WHR_mech | [kWh] | Total electric energy generated by an electrical WHR system |
+| E_aux_ess_mech | [kWh] | Total work of auxiliaries during engine stop and thus not considered in FC-Map and FC-AAUX. Considered in FC-ESS_Corr via [fuel consumption correction](#engine-fuel-consumption-correction) (Based on P_aux_ESS_mech in .vmod) |
+| E_ice_start | [kWh] | Total work for starting the combustion engine, not considered in FC-Map and FC-AAUX. Considered in FC-ESS_Corr via [fuel consumption correction](#engine-fuel-consumption-correction) (Based on P_ice_start in .vmod) |
+| ice_starts | [-] | Number of times the combustion engine is started |
+| k_vehline | [g/kWh] | Slope of the regression line used for the [fuel consumption correction](#engine-fuel-consumption-correction) |
+| a | [m/s^2^] | Average acceleration |
+| a_pos | [m/s^2^] | Average acceleration in acceleration phases (a~3s~ \> 0.125 \[m/s^2^\], a~3s~ = 3-seconds-averaged acceleration) |
+| a_neg | [m/s^2^] | Average deceleration in deceleration phases (a~3s~ \< 0.125 \[m/s^2^\], a~3s~ = 3-seconds-averaged acceleration) |
+| AccelerationTimeShare | [%] | Time share of acceleration phases (a~3s~ \> 0.125 \[m/s^2^\], a~3s~ = 3-seconds-averaged acceleration) |
+| DecelerationTimeShare | [%] | Time share of deceleration phases (a~3s~ \< 0.125 \[m/s^2^\], a~3s~ = 3-seconds-averaged acceleration) |
+| CruiseTimeShare | [%] | Time share of cruise phases (-0.125 ≤ a~3s~ ≤ 0.125 \[m/s^2^\]) |
+| StopTimeShare | [%] | Time share of stop phases (v \< 0.1 \[m/s\]) |
**Note:** The fuel name is only added to the fuel consumption signals for vehicles with dual-fuel engines. In case single-fuel and dual-fuel vehicles are simulated in one simulation run, the fuel consumption for single-fuel vehicles is reported without the fuel name suffix while the fuel consumption of dual fuel vehicles contains the fuel name suffix!