updating user manual

Documentation/User Manual/1-user-interface/A_index.md

@@ -6,9 +6,9 @@ When VECTO starts the [Main Form](#main-form) is loaded. Closing this form will
 -	[Main Form](#main-form)
 -   [Settings](#settings)
 -	[Job Editor](#job-editor)
--   [Aux Dialog](#auxiliary-dialog)
--   [Advanced Auxiliary Dialog](#advanced-auxiliary-dialog)
 -	[Vehicle Editor](#vehicle-editor)
+-   [Aux Dialog](#auxiliary-dialog)
+-   [BusAux Dialog](#busauxiliary-dialog)
 -	[Engine Editor](#engine-editor)
 -	[Gearbox Editor](#gearbox-editor)
 -	[Graph Window](#graph-window)

Documentation/User Manual/1-user-interface/D1_VECTO-Job-Editor.md

@@ -42,46 +42,64 @@ Filepath to the Engine File (.veng)
 Filepath ot the Gearbox File(.vgbx)
 :	Files can be created and edited using the [Gearbox Editor](#gearbox-editor).
 
+### Auxiliaries Tab
+
+![](pics/VECTO_JobEditor_Aux.png)
+
 <div class="declaration">
 Auxiliaries
-:	This group contains input elements to define the vehicle's load from the auxiliaries.
-In Declaration Mode only the pre-defined auxiliaries are available and their power-demand is also pre-defined, depending on the vehicle category and driving cycle. This means the Auxiliary Type is set to 'Classic: Vecto Auxiliary' and no 'Constant Aux Load' can be specified.
-The following list contains the pre-defined auxiliaries where the concrete technology for each auxiliary can be configured using the [Auxiliary Dialog](#auxiliary-dialog). 
-**Double-click** entries to edit with the [Auxiliary Dialog](#auxiliary-dialog).
+:   This group contains input elements to define the engine's load from the auxiliaries.
+In Declaration Mode only the pre-defined auxiliaries are available and their power-demand is also pre-defined, depending on the vehicle category and driving cycle. 
+The list contains the pre-defined auxiliaries where the concrete technology for each auxiliary can be configured using the [Auxiliary Dialog](#auxiliary-dialog). 
+**Double-click** entries to edit with the [Auxiliary Dialog](#auxiliary-dialog). No other types of auxiliaries can be used in declaration mode.
 </div>
 
 <div class="engineering">
 Auxiliaries
-:	In Engineering Mode the set of auxiliaries can be freely defined.
-First, the Auxiliary Type can be selected. If the Bus Auxiliaries are selected a configuration file for the Advanced Auxiliaries has to be specified. When using the Bus Auxiliaries, the standard auxiliaries can  be added as well in the list below to take into account the steering pump, etc.
-The 'Constant Aux Load' can be used to define a constant power demand from the auxiliaries (similar to P_add in the driving cycle, but constant over the whole cycle).
-The following list can be used to define the auxiliary load in more detail via a separate input file. The auxiliaries are configured using the [Auxiliary Dialog](#auxiliary-dialog). 
- For each auxiliary an [Auxiliary Input File (.vaux)](#auxiliary-input-file-.vaux) must be provided and the [driving cycle](#driving-cycles-.vdri) must include the corresponding supply power.
-**Double-click** entries to edit with the [Auxiliary Dialog](#auxiliary-dialog).
-: ![addaux](pics/plus-circle-icon.png) Add new Auxiliary
-: ![remaux](pics/minus-circle-icon.png) Remove the selected Auxiliary from the list
+:   In Engineering Mode the auxiliary power demand can be defined in three ways. 
+
+The first option is to define the power demand directly in the driving cycle in the column "Padd" (see [Driving Cycles](#driving-cycles-.vdri). This allows to vary the auxiliary load over distance (or time, for time-based driving cycles).
+
+The second option is to define a constant power demand over the whole cycle. The auxiliary power demand can be specified depending on whether the combustion engine is on or off and the vehicle is driving. The auxiliary power demand during engine-off phase is corrected in the [post-processing](#engine-fuel-consumption-correction).
+
+The third option is to use the bus-auxiliaries model. For details see the [Bus Auxiliaries model](#bus-auxiliaries).
 </div>
 
+
 See [Auxiliaries](#auxiliaries) for details.
 
+
+### Cycles Tab
+
+![](pics/VECTO_JobEditor_Cycles.png)
+
 Cycles
 :   List of cycles used for calculation. The .vdri format is described [here](#driving-cycles-.vdri).
+
+<div class="declaration">
+In Declaration Mode, the cycles to be simulated depend on the vehicle group. The cycles are listed in this window for reference.
+</div>
+
+<div class="engineering">
+In Engineering Mode the cycles can be freely selected. All declaration cycles are provided in the Folder "Mission Profiles" and can be used or a custom cycle can be created and used.
+</div>
+
 **Double-click** an entry to open the file (see [File Open Command](#settings)).
-**Click** selected items to edit file paths.
 
+**Click** selected items to edit file paths.
 : ![addcycle](pics/plus-circle-icon.png) Add cycle (.vdri)
 : ![remcycle](pics/minus-circle-icon.png) Remove the selected cycle from the list
 
 
 ### Driver Assist Tab
 
-![](pics/VECTO-Editor-DriverAssist.png)
+![](pics/JobForm_DriverModel.png)
 
 
-In this tab the driver assistance functions are enabled and parameterised.
+In this tab the driver assistance functions are enabled and parameterised. The parameters for overspeed, look-ahead coasting and driver acceleration can only be modified in Engineering Mode.
 
 Overspeed
-:	See [Overspeed](#overspeed) for details.
+:   See [Overspeed](#driver-overspeed) for details.
 
 Look-Ahead Coasting
 :   See [Look-Ahead Coasting](#driver-look-ahead-coasting) for details.
@@ -90,6 +108,15 @@ Acceleration Limiting
 :   See [Acceleration Limiting](#driver-acceleration-limiting) for details.
 
 
+### ADAS Parameters
+
+![](pics/JobForm_ADASParams.png)
+
+In this tab certain general parameters for the advanced driver assistant system model can be set. Which ADAS feature is available can be selected in the vehicle itself, in Engineering Mode parameters like minimum activation speed, activation delay, or allowed overspeed can be adjusted. In Declaration Mode all parameters are fixed.
+
+For details on the individual parameters see the corresponding section [Engine Stop/Start](#advanced-driver-assistant-systems-engine-stopstart), [Eco-Roll](#advanced-driver-assistant-systems-eco-roll), [Predictive Cruise Control](#advanced-driver-assistant-systems-predictive-cruise-control)
+
+
 ### Chart Area
 
 If a valid [Vehicle File](#vehicle-editor), [Engine File](#engine-file-.veng) and [Gearbox File](#gearbox-file-.vgbx) is loaded into the Editor the main vehicle parameters like HDV group and axle configuration are shown here. The plot shows the full load curve(s) and sampling points of the fuel consumption map. 

Documentation/User Manual/1-user-interface/E_VECTO-Editor_Aux.md

@@ -46,3 +46,72 @@ Input File
 ![ok](pics/OK.png) ***Save and close***
 
 ![cancel](pics/Cancel.png) ***Close without saving***
+
+
+
+## BusAuxiliary Dialog
+
+<div class="engineering">
+
+![](pics/BusAux_Engineering.png)
+
+In Engineering Mode the electrical and mechanical power demand for the electric system, the pneumatic system and the HVAC can be provided.
+
+#### Electric System
+
+Current Demand Engine On
+:   Demand of the electric system when the ICE is on. The current is multiplied with the nominal voltage of 28.3V.
+
+Current Demand Engine Off Driving
+:   Demand of the electric system when the ICE is off and the vehicle is driving. The current is multiplied with the nominal voltage of 28.3V.
+
+Current Demand Engine Off Standstill
+:   Demand of the electric system when the ICE is off and the vehicle is at standstill. The current is multiplied with the nominal voltage of 28.3V.
+
+Alternator Efficiency
+:   The electric power demand is divided by the alternator efficiency to get the mechanical power demand at the crank shaft
+
+Alternator Technology
+:   The "conventional alternator" generated exactly the electric power as demanded by the auxiliaries. The "smart alternator" may generate more electric power than needed during braking phases. The exessive electric power is stored in a battery. In case "no alternator" is selected (only available for xEV vehicles) the electric system is supplied from the high voltage REESS via a DC/DC converter.
+
+Max Recuperation Power
+:   In case of a smart alternator, defines the maximum electric power the alternator can generate during braking phases.
+
+Useable Electric Storage Capacity
+:   In case of a smart alternator, defines the storage capacity of the battery. In case the battery is not empty, the electric auxiliaries are supplied from the battery. Excessive electric energy from the smart alternator during braking phases is stored in the battery.
+
+Electric Storage Efficiency
+:   This efficiency is applied when storing electric energy from the alternator in the battery.
+
+ESS supply from HEV REESS
+:   If selected, the low-voltage electric auxiliaries can be supplied from the high voltage REESS via the DC/DC converter. Needs to be selected in case "no alternator" is chosen as alternator technology. In case of a smart alternator, the low-voltage battery is used first and if empty the energy is drawn from the high voltage system.
+
+#### Pneumatic System
+
+Compressor Map
+:   [Compressor map file](#advanced-compressor-map-.acmp) defining the mechanical power demand and the air flow depending on the compressor speed.
+
+Average Air Demand
+:    Defines the average demand of copressed air througout the cycle.
+
+Compressor Ratio
+:    Defines the ratio between the air compressor and combustio engine
+
+Smart Air Compressor
+:    If enabled, the air compressor may generate excessive air during braking events. The air consumed and generated are [corrected in post processing](#engine-fuel-consumption-correction).
+
+#### HVAC System
+
+Mechanical Power Demand
+:   Power demand of the HVAC system directly applied at the crank shaft
+
+Electric Power Demand
+:   Electric power demand of the HVAC system. This is added to the current demand of the electric system
+
+Aux Heater Power
+:   Maximum power of the auxiliary heater
+
+Average Heating Demand
+:   Heating demand for the passenger compartment. This demand is primary satisfied from the combustion engines waste heat. In case the heating demand is higher, the auxiliary heater may provide additional heating power. The fuel consumption of the aux heater is [corrected in post processing](#engine-fuel-consumption-correction).
+
+</div>	

Documentation/User Manual/1-user-interface/F_VEH-Editor.md

@@ -75,6 +75,9 @@ Depending on the chosen mode either a [Speed Dependent Cross Wind Correction Inp
 
 In [Engineering Mode](#engineering-mode) this defines the effective (dynamic) wheel radius (in [mm]) used to calculate engine speed. In [Declaration Mode](#declaration-mode) the radius calculated automatically using tyres of the powered axle.
 
+### Vehicle Idling Speed
+
+The idling speed of the combustion engine can be increased in the vehicle settings. This may be necessary due to certain auxiliaries or for other technical reasons. This value is only considered if it is higher than the idling speed defined in the combustion engine.
 
 ### Axles/Wheels
 
@@ -97,19 +100,48 @@ For missions with a trailer predefined wheels and load-shares are added by Vecto
 Doubleclick entries to edit existing axle configurations.
 
 
+### Controls
+
+
+![](pics/blue-document-icon.png) New file
+: Create a new empty .vveh file
+
+![](pics/Open-icon.png) Open existing file
+: Open an existing .vveh file
+
+![](pics/Actions-document-save-icon.png) ***Save current file***
+
+![](pics/Actions-document-save-as-icon.png) ***Save file as...***
+
+![](pics/export-icon.png) Send current file to the [VECTO Editor](#job-editor)
+: **Note:** If the current file was opened via the [VECTO Editor](#job-editor) the file will be sent automatically when saved.
+
+![](pics/OK.png) Save and close file
+: If necessary the file path in the [VECTO Editor](#job-editor) will be updated.
+
+![](pics/Cancel.png) ***Cancel without saving***
+
+
+
+## Vehicle Editor -- Powertrain Tab
+
+![](pics/VehicleForm_Powertrain.png)
+
+
 ### Retarder Losses
 
 If a separate retarder is used in the vehicle a **Retarder Torque Loss Map** can be defined here to consider idling losses caused by the retarder.
 
-Four options are available:
+The following options are available:
 : -   No retarder
 -	Included in Transmission Loss Maps: Use this if the [Transmission Loss Maps](#transmission-loss-map-.vtlm) already include retarder losses.
--   Primary Retarder (before gearbox): The rpm ratio is relative to the engine speed
--   Secondary Retarder (after gearbox): The rpm ratio is relative to the cardan shaft speed
-
-Both, primary and secondary retarders, require an [Retarder Torque Loss Input File (.vrlm)](#retarder-loss-torque-input-file-.vrlm).
+-   Primary Retarder (before gearbox, transmission input retarder): The rpm ratio is relative to the engine speed.
+-   Secondary Retarder (after gearbox, transmission output retarder): The rpm ratio is relative to the cardan shaft speed.
+-   Engine Retarder: Used this if the engine already includes the retarder losses.
+-   Axlegear Input Retarder (after axlegear): The rpm ratio is relative to the axlegear input shaft speed. Only available for battery electric vehicles with E3 motor, serial hybrid with S3 motor, S-IEPC, and E-IEPC.
 
-The Retarder Ratio defines the ratio between the engine speed/cardan shaft speed and the retarder.
+Primary, secondary and axlegear input retarder require an [Retarder Torque Loss Input File (.vrlm)](#retarder-loss-torque-input-file-.vrlm).
+The retarder ratio defines the ratio between the engine speed/cardan shaft speed and the retarder.
 
 ### Angledrive
 
@@ -121,6 +153,42 @@ Three options are available:
 - Included in transmission: Use this if the gearbox already includes the transmission losses for the angledrive in the respective transmission loss maps.
 
 
+## Vehicle Editor -- Torque Limits Tab
+
+![](pics/VehicleForm_TorqueLimits.png)
+
+On this tab different torque limits can be applied at the vehicle level. For details which limits are applicable and who the limits are applied in the simulation [see here](#torque-and-speed-limitations).
+
+First, the maximum torque of the ICE may be limited for certain gears (see [Engine Torque Limitations](#torque-and-speed-limitations)).
+In case that the gearbox' maximum torque is lower than the engine's maximum torque or to model certain features like Top-Torque (where in the highest gear more torque is available) it is possible to limit the engine's maximum torque depending on the engaged gear. 
+
+
+## Vehicle Editor -- ADAS Tab
+
+![](pics/VehicleForm_ADAS.png)
+
+On the ADAS tab, the advanced driver assistant systems present in the vehicle can be selected.  See [ADAS - Engine Stop/Start](#advanced-driver-assistant-systems-engine-stopstart), [ADAS - EcoRoll](#advanced-driver-assistant-systems-eco-roll), and [ADAS - Predictive Cruise Control](#advanced-driver-assistant-systems-predictive-cruise-control)
+
+The following table describes which ADAS technology can be used and is supported for different powertrain architectures (X: supported, O: optional, -: not supported):
+
+| ADAS Technology \ Powertrain Architecture  | Conventional   | HEV   | PEV   |
+| ------------------------------------------ | -------------- | ----- | ----- |
+| Engine Stop/Start                          | X              | X     | -     |
+| EcoRoll Without Engine Stop                | X              | -     | -     |
+| EcoRoll with Engine Stop                   | X              | -     | -     |
+| Predictive Cruise Control                  | X              | X     | X     |
+| APT Gearbox EcoRoll Release Lockup Clutch  | O              | -     | -     |
+
+* Engine Stop/Start not allowed for PEV
+* EcoRoll for HEV always with ICE off
+* For PEV no clutch for disconnecting the EM present, thus no EcoRoll foreseen (very low drag of EM in any case)
+* Inputs for EcoRoll possible in GUI, but no effect in simulation
+
+
+## Vehicle Editor -- PTO Tab
+
+![](pics/Vehicleform_PTO.png)
+
 ### PTO Transmission
 
 If the vehicle has an PTO consumer, a pto transmission and consumer can be defined here. (Only in [Engineering Mode](#engineering-mode))
@@ -131,31 +199,17 @@ Three settings can be set:
 - PTO Consumer Loss Map (.vptol): Here the [PTO Idle Loss Map](#pto-idle-consumption-map-.vptoi) of the pto consumer can be defined (adds power demand when the pto cycle is not active).
 - PTO Cycle (.vptoc): Defines the [PTO Cycle](#pto-cycle-.vptoc) which is used when the pto-cycle is activated (when the PTO-Flag in the driving cycle is set).
 
-<div class="declaration">
-
-### ADAS
-
-On the ADAS tab, the options for advanced driver assistant systems can be selected. This is only supported in declaration mode. Depending on the mission cycle, vehicle group, and payload a certain benefit is applied to the calcualated fuel consumption. See [ADAS: Overspeed](#driver-overspeed) and [ADAS Technologies](#vehicle-adas-technologies)
-
-</div>
-
-### Controls
+<div class="engineering">
+In engineering mode additional PTO activations are available to simulate different types of municipal vehicles. It is possible to add a certain PTO load during driving while the engine speed and gear is fixed (to simulate for example roadsweepers), or to add PTO activation while driving (to simulate side loader refuse trucks for example). In both cases the PTO activation is indicated in the [driving cycle](#driving-cycles-.vdri) (column "PTO").
 
 
-![](pics/blue-document-icon.png) New file
-: Create a new empty .vveh file
+### Roadsweeper operation
 
-![](pics/Open-icon.png) Open existing file
-: Open an existing .vveh file
+PTO activation mode 2 simulates PTO activation while driving at a fixed engine speed and gear. The minimum engine speed and working gear is entered in the PTO tab. For details see [PTO](#pto).
 
-![](pics/Actions-document-save-icon.png) ***Save current file***
 
-![](pics/Actions-document-save-as-icon.png) ***Save file as...***
+### Sideloader operation
 
-![](pics/export-icon.png) Send current file to the [VECTO Editor](#job-editor)
-: **Note:** If the current file was opened via the [VECTO Editor](#job-editor) the file will be sent automatically when saved.
+PTO activation mode 3 simulates a time-based PTO activation while driving. Therefore, a separate PTO cycle ([.vptor]()) containing the PTO power over time has to be provided. The start of PTO activation is indicated with a '3' in the 'PTO' column of the [driving cycle](#driving-cycles-.vdri). For details see [PTO](#pto).
 
-![](pics/OK.png) Save and close file
-: If necessary the file path in the [VECTO Editor](#job-editor) will be updated.
+</div>
\ No newline at end of file
-
-![](pics/Cancel.png) ***Cancel without saving***

Documentation/User Manual/3-simulation-models/Auxiliaries.md

@@ -5,47 +5,12 @@ In Declaration mode the auxiliaries are pre-defined and the power demand is defi
 </div>
 
 <div class="engineering">
-In Engineering mode VECTO uses a generic map-based approach to consider all types of auxiliaries. The supply power demand for each single auxiliary is defined in the driving cycle. Hence a time/distance-dependent power demand can be defined. Based on the supply power and a pre-defined efficiency map the auxiliary input power is calculated. A constant efficiency determines the losses between auxiliary and engine.
+In Engineering mode the auxiliary power demand for the following states of the vehicle can be defined:
 
-For each auxiliary the power demand is calculated using the following steps:
+   - ICE On
+   - Vehicle driving, ICE off
+   - Vehicle standstill, ICE off
 
-![](pics/AuxModel.svg)
-
-1.  Auxiliary speed: **n~aux~ = n~Eng~ \* TransRatio**
-
-2.  Auxiliary output power: **P~auxOut~ = P~supply~/EffToSply**
-
-3.  Auxiliary input power: **P~auxIn~ = EffMap(n~Aux~, P~AuxOut~)**
-
-4.  Auxiliary power consumption: **P~aux~ = P~auxIn~/EffToEng**
-
-5.  **P~aux~ is added to the engine's power demand**
-
-6.  **P~supply~ is defined in the driving cycle
-
-
-|            |                                                                                                       |                                 |  
-| ---------- | ----------------------------------------------------------------------------------------------------- | --------------------------------|  
-| n~Eng~     | Calculated engine speed.                                                                            | \[1/min\]                       |  
-| TransRatio | Speed ratio between auxiliary and engine. [Defined in the Auxiliary File](#auxiliary-input-file-.vaux). | \[-\]                           |  
-| n~aux~     | Auxiliary speed                                                                                     | \[1/min\]                       |  
-| P~supply~  | Effective supply power demand. [Defined in the driving cycle](#driving-cycles-.vdri).             | \[kW\]                          |  
-| EffToSply  | Consumer efficiency. [Defined in the Auxiliary File](#auxiliary-input-file-.vaux).                      | \[-\]                           |  
-| P~auxOut~  | Auxiliary output power                                                                              | \[kW\]                          |  
-| EffMap     | Auxiliary efficiency map. [Defined in the Auxiliary File](#auxiliary-input-file-.vaux).                 | \[kW\] = f( \[1/min\], \[kW\] ) |  
-| P~auxIn~   | Auxiliary input power                                                                               | \[kW\]                          |  
-| EffToEng   | Efficiency of auxiliary (belt/gear) drive. [Defined in the Auxiliary File](#auxiliary-input-file-.vaux).| \[-\]                           |  
-| P~aux~     | Mechanical auxiliary power demand at the crank shaft                                                | \[kW\]                          |  
-
-
-
-
-
-Each auxiliary must be defined in the [Job File](#job-file) and each [driving cycle](#driving-cycles-.vdri) used with this vehicle/auxiliary must include supply power for each auxiliary. To link the supply power in the driving cycle to the correct auxiliary in the Job File an ID is used. The corresponding supply power is then named *"&lt;Aux\_ID&gt;"*.
-
-
-***Example:*** *The Auxiliary with the ID "ALT" (in the Job File) is linked to the supply power in the column "&lt;Aux\_ALT&gt;" in the driving cylce.*
-
-In addition to the generic map-based auxiliaries approach it is also possible to specify a constant load applied to the engine during the whole mission.
+If the ICE is on, the auxiliary power demand is directly applied to the combustion engine. In case the ICE is off, the according power demand is balanced in the modal data and the fuel consumption is [corrected in post processing](#engine-fuel-consumption-correction).
 
 </div>
\ No newline at end of file

Documentation/User Manual/3-simulation-models/BusAuxiliaries.md

+## Bus Auxiliaries
+
+<div class="engineering">
+
+![](pics/BusAux_Engineering.png)
+
+In Engineering Mode the electrical and mechanical power demand for the electric system, the pneumatic system and the HVAC can be provided.
+
+#### Electric System
+
+Current Demand Engine On
+:   Demand of the electric system when the ICE is on. The current is multiplied with the nominal voltage of 28.3V.
+
+Current Demand Engine Off Driving
+:   Demand of the electric system when the ICE is off and the vehicle is driving. The current is multiplied with the nominal voltage of 28.3V.
+
+Current Demand Engine Off Standstill
+:   Demand of the electric system when the ICE is off and the vehicle is at standstill. The current is multiplied with the nominal voltage of 28.3V.
+
+Alternator Efficiency
+:   The electric power demand is divided by the alternator efficiency to get the mechanical power demand at the crank shaft
+
+Alternator Technology
+:   The "conventional alternator" generated exactly the electric power as demanded by the auxiliaries. The "smart alternator" may generate more electric power than needed during braking phases. The exessive electric power is stored in a battery. In case "no alternator" is selected (only available for xEV vehicles) the electric system is supplied from the high voltage REESS via a DC/DC converter.
+
+Max Recuperation Power
+:   In case of a smart alternator, defines the maximum electric power the alternator can generate during braking phases.
+
+Useable Electric Storage Capacity
+:   In case of a smart alternator, defines the storage capacity of the battery. In case the battery is not empty, the electric auxiliaries are supplied from the battery. Excessive electric energy from the smart alternator during braking phases is stored in the battery.
+
+Electric Storage Efficiency
+:   This efficiency is applied when storing electric energy from the alternator in the battery.
+
+ESS supply from HEV REESS
+:   If selected, the low-voltage electric auxiliaries can be supplied from the high voltage REESS via the DC/DC converter. Needs to be selected in case "no alternator" is chosen as alternator technology. In case of a smart alternator, the low-voltage battery is used first and if empty the energy is drawn from the high voltage system.
+
+#### Pneumatic System
+
+Compressor Map
+:   [Compressor map file](#advanced-compressor-map-.acmp) defining the mechanical power demand and the air flow depending on the compressor speed.
+
+Average Air Demand
+:    Defines the average demand of copressed air througout the cycle.
+
+Compressor Ratio
+:    Defines the ratio between the air compressor and combustio engine
+
+Smart Air Compressor
+:    If enabled, the air compressor may generate excessive air during braking events. The air consumed and generated are [corrected in post processing](#engine-fuel-consumption-correction).
+
+#### HVAC System
+
+Mechanical Power Demand
+:   Power demand of the HVAC system directly applied at the crank shaft
+
+Electric Power Demand
+:   Electric power demand of the HVAC system. This is added to the current demand of the electric system
+
+Aux Heater Power
+:   Maximum power of the auxiliary heater
+
+Average Heating Demand
+:   Heating demand for the passenger compartment. This demand is primary satisfied from the combustion engines waste heat. In case the heating demand is higher, the auxiliary heater may provide additional heating power. The fuel consumption of the aux heater is [corrected in post processing](#engine-fuel-consumption-correction).
+
+</div>
\ No newline at end of file

Documentation/User Manual/3-simulation-models/Engine_Speed_Torque_limitations.md

 
-## Engine Torque and Engine Speed Limitations
+## Torque and Speed Limitations
 
 The engine's maximum speed and maximum torque may be limited by either the gearbox (due to mechanical constraints) or the vehicle control.
 Engine torque limitations are modeled by limiting the engine full-load curve to the defined maximum torque, i.e., the original engine full-load curve is cropped at the defined maximum torque for a certain gear. Limits regarding the gearbox' maximum input speed are modeled by intersecting (and limiting) the upshift line with the max. input speed. In the last gear, where no upshifts are possible, the engine speed is limited to the gearbox' maximum input speed.

Documentation/User Manual/3-simulation-models/simulation-models.md

@@ -13,7 +13,7 @@ In this chapter the used component models for the simulation are described.
 * [Engine: Transient Full Load](#engine-transient-full-load)
 * [Engine: WHTC Correction Factors](#engine-correction-factors)
 * [Fuel properties](#fuel-properties)
-* [Engine Torque and Engine Speed Limitations](#engine-torque-and-engine-speed-limitations)
+* [Torque and Speed Limitations](#torque-and-speed-limitations)
 * [Gearbox: Gear Shift Model](#gearbox-gear-shift-model)
 * [Gearbox: MT and AMT Gearshift Rules](#gearbox-mt-and-amt-gearshift-rules)
 * [Gearbox: AT Gearshift Rules](#gearbox-at-gearshift-rules)

Documentation/User Manual/convert.bat

@@ -7,6 +7,7 @@ setlocal enabledelayedexpansion enableextensions
 set LIST=
 for /f %%f in (files.txt) do set LIST=!LIST! "%%f"
 
+:repeat
 
 REM -- pandoc 1.19 -- pandoc --verbose  -f markdown+raw_html %LIST% -s -S --toc --toc-depth=2 --self-contained --email-obfuscation=none --section-divs --mathjax=includes/mathjax.js -c includes/style.css -c includes/print.css -B includes/header.html -A includes/footer.html -o help.html  -H includes/jquery.js -H includes/jquery-ui.js -H includes/include.js
 
@@ -20,6 +21,12 @@ REM  -- pandoc 2.17 --
 REM pandoc %LIST% -s -S --toc --toc-depth=2 --self-contained --email-obfuscation=none --section-divs --webtex  -c includes/style.css -B includes/header.html -A includes/footer.html -o help.html  -H includes/jquery.js -H includes/jquery-ui.js -H includes/include.js
 REM pandoc %LIST% -s -S --toc --toc-depth=2 --self-contained --email-obfuscation=none --section-divs --webtex="https://latex.codecogs.com/svg.latex?\large "  -c includes/style.css -B includes/header.html -A includes/footer.html -o help.html  -H includes/jquery.js -H includes/jquery-ui.js -H includes/include.js
 
+if ERRORLEVEL 1 (
+	echo "Failed to create help %errorlevel%"
+	pause 
+	goto repeat
+)
+
 echo Generated outputfile: help.html
 
 REM pandoc -s -S --toc --toc-depth=2 -N %LIST% -o help.docx

Documentation/User Manual/files.txt

@@ -4,6 +4,7 @@
 1-user-interface/C_settings.md
 1-user-interface/D1_VECTO-Job-Editor.md
 1-user-interface/D2_VTP-Job-Editor.md
+1-user-interface/E_VECTO-Editor_Aux.md
 1-user-interface/F_VEH-Editor.md
 1-user-interface/G_ENG-Editor.md
 1-user-interface/H_GBX-Editor.md
@@ -38,6 +39,7 @@
 3-simulation-models/Gearshift_MT.md
 3-simulation-models/TC.md
 3-simulation-models/Auxiliaries.md
+3-simulation-models/BusAuxiliaries.md
 3-simulation-models/PwheelInput.md
 3-simulation-models/PTO.md
 5-input-and-output-files/input-output.md