integrading advanced auxiliaries documentation into markdown documentation

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

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

Documentation/User Manual/1-user-interface/K0_VECTO-AdvancedAux.md

+##Advanced Auxiliary Dialog
+
+<div class="engineering">
+
+
+![](pics/VECTO-Editor_AAUX.png)
+
+###Description
+
+In the VECTO Job Editor dialog you need to select "BusAuxiliaries" in the drop down list on the left to configure the advanced auxiliaries.
+
+The Advance Auxiliaries Editor File (.aaux) defines all the auxiliary related parameters and input files like Alternator and Compressor Maps and HVAC steady state model outputs.
+
+The Advance Auxiliaries Editor contains four tabs/sub-modules where the different advanced auxiliary types can be configured:
+
+-   General
+    : Currently empty – reserved for potential future expansion.
+
+-   [Electrics](#electrical-auxiliaries-editor)
+    : The "Electrics" tab defines various parameters for electric auxiliaries used on the vehicle.
+
+-   [Pneumatics](#pneumatic-auxiliaries-editor)
+    : The "Pneumatic" tab defines various pneumatic auxiliaries data and pneumatic variables
+
+-   [HVAC](#hvac-auxiliaries-editor)
+    : The "HVAC" tab defines the steady state output values, which can also be loaded via the Steady State Model File (.AHSM)
+
+
+###Important notes
+
+Note that the cycle file name used should ideally respect the following syntax to be correctly associated with the pneumatic actuations map (.apac), otherwise the number of actuations will be set at 0 by default:
+
+-   "AnyOtherText _X_Bus.vdri", with "X" = "Urban", "Heavy urban", “Suburban", or "Interurban"
+-   "AnyOtherText_Coach.vdri"
+ 
+Some flexibility in syntax is allowable (the model looks for 'Bus', 'Coach', 'Urban', etc. in the file name), meaning that the standard default cycles are fully/correctly supported. However, for newly created cycles (i.e. for use in Engineering Mode) it is recommended to follow the above convention to guarantee correct functionality.
+
+###File Format
+
+The file uses the VECTO JSON format.
+
+The new file types have also defined to support the new Advanced Auxiliaries module in VECTO include:
+ 
+| File EXT NAME | Storage Type | Description |
+|---------------|--------------|-------------|
+|  .AAUX        |    JSON      | Overall configuration information for Electrical, Pneumatic and HVAC. Top of the tree for Advanced Auxiliaries |
+|  .AALT        |    CSV       | Advanced Combined Alternators: Contains combined map plus source maps. |
+|  .ACMP        |    CSV       | Advanced Compressor Map. |
+|  .APAC        |    CSV       | Pneumatic Actuations Map: Stores number of actuations per cycle |
+|  .AHSM        |    JSON      | Stores Steady State Model results, and also the configuration which resulted in the final result. UI to calculate various heat/cool/ventilate properties resulting in Electrical and Mechanical Power as well as cooling based on environmental conditions. |
+|  .ABDB        |    CSV       | Bus Parameter Database: Contains a list of the default parameters for different buses. |
+|  .AENV        |    CSV       | Stores a number of environmental conditions to be used by HVAC model when in batch-mode. |
+
+</div>
\ No newline at end of file

Documentation/User Manual/1-user-interface/K1_VECTO-AdvancedAux_EL.md

+##Electrical Auxiliaries Editor
+ 
+![](pics/AA_Electrics.jpg)
+ 
+###Description
+
+The "Electrics" tab defines various parameters for electric auxiliaries used on the vehicle:
+
+-   Powernet Voltage [locked field/fixed value]
+-   Alternator Map, including filepath to the new Combined Alternator Map (.AALT) file
+    : Files can be imported (blank field)/the [Combined Alternator Map editor](#combined-alternator-map-file-.aalt) opened (file present) by clicking on the ‘browse’ button adjacent to the “Alternator Map” text box.
+-   Alternator Pulley Efficiency [locked field/fixed value]
+-   Door Actuation Time(S) [locked field/fixed value]
+-   Stored Energy Efficiency [locked field/fixed value]
+-   Smart Electrics [On/Off]
+    : Smart electrics are enabled by checking the "Smart Electrics" box
+-   Electrical Consumables
+    : The "Electrical Consumables" table contains a list electrical equipment that place demand on the engine. Check boxes enable the user to select whether the energy demanded by each consumable is included in the calculation of the base vehicle. The user can modify only the number of consumables of each type installed on the vehicle*.  The Nominal Consumption (amps) for each consumer, and the percentage of time each consumer is active during the cycle are locked default values as agreed with the project steering group.
+
+* Note: for certain fields the allowable values are also controlled/prescribed according to the requirements of the project steering group.
+
+###Results Cards
+
+Upon activation of Smart Electrics using the check box, the user may enter Result Card values according to the methodology proposed by the steering group.  Until the certification procedure to determine the correct values is agreed, it is recommended to use the following default values:
+
+Example Default Results Card values
+
+| Amps | SmartAmps   |
+|------|-------------|
+| 40   | 0           |
+| 50   | 0           |
+| 60   | 54          |
+| 70   | 64          |
+| 80   | 30          | 
+
+  : Result Card: Idle
+
+
+| Amps  | SmartAmps       |
+|-------|-----------------|
+| 40    | 0               |
+| 50    | 0               |
+| 60    | 83              |
+| 70    | 94              |
+| 80    | 45              |
+
+  : Result Card: TractionON
+
+
+| Amps  |  SmartAmps   |
+|-------|--------------|
+| 40    | 0            |
+| 50    | 0            |
+| 60    | 172          |
+| 70    | 182          |
+| 80    | 90           |    
+
+  : Result Card: Overrun
+
+###Default Values
+
+The following table provides a summary of the default values that are populated whenever a new advanced auxiliaries (.AAUX) file is created from scratch (nominal consumption and % active are always fixed defaults, so are not shown).  The table also indicates the editable/default status of the relevant parameters in the VECTO UI in Engineering mode, and the recommended status in Declaration mode (not currently implemented).  The default values / parameter status has been agreed with the project steering group.
+
+*Default parameter values and editable status for the Electrical module*
+
+*General Inputs*
+ 
+| Category                     | Name                         | Default value    | Engineering    | Declaration    |
+|------------------------------|------------------------------|------------------|----------------|----------------|
+| Powernet Voltage             | Powernet Voltage             |             28.3 | Locked default | Locked default |
+| Alternator Map               | Alternator Map               |            blank | Open/editable  | Open/OEM data  |
+| Alternator Pulley Efficiency | Alternator Pulley Efficiency |             0.92 | Locked default | Locked default |
+| Door Actuation Time (s)      | Door Actuation Time (s)      |              4.0 | Locked default | Locked default |
+| Smart Electrics              | Smart Electrics              |        No (/Yes) | Open/editable  | Open/OEM data  |
+
+
+*List of Electrical Consumables*
+ 
+
+
+| Category                     | Name                | No. in Vehicle, Default Value    | Engineering    | Declaration    |
+|------------------------------|-----------------------------------------------------------|------------------|----------------|----------------|
+| Doors                        | Doors per vehicle                                         |                3 | Open/editable  | Open/OEM data  |
+| Veh Electronics &Engine      | Controllers, Valves, etc                                  |                1 | Locked default | Locked default |
+| Vehicle basic equipment      | Radio City                                                |                1 | Open/editable  | Open/OEM data  |
+| Vehicle basic equipment      | Radio Intercity                                           |                0 | Open/editable  | Open/OEM data  |
+| Vehicle basic equipment      | Radio/Audio Tourism                                       |                0 | Open/editable  | Open/OEM data  |
+| Vehicle basic equipment      | Fridge                                                    |                0 | Open/editable  | Open/OEM data  |
+| Vehicle basic equipment      | Kitchen Standard                                          |                0 | Open/editable  | Open/OEM data  |
+| Vehicle basic equipment      | Interior lights City/ Intercity + Doorlights [1/m]        |               12 | Open/editable  | Locked default |
+| Vehicle basic equipment      | LED Interior lights ceiling city/ontercity + door [1/m]   |                0 | Open/editable  | Locked default |
+| Vehicle basic equipment      | Interior lights Tourism + reading [1/m]                   |                0 | Open/editable  | Locked default |
+| Vehicle basic equipment      | LED Interior lights ceiling Tourism + LED reading [1/m]   |                0 | Open/editable  | Locked default |
+| Customer Specific Equipment  | External Displays Font/Side/Rear                          |                4 | Open/editable  | Open/OEM data  |
+| Customer Specific Equipment  | Internal display per unit ( front side rear)              |                1 | Open/editable  | Open/OEM data  |
+| Customer Specific Equipment  | CityBus Ref EBSF Table4 Devices ITS No Displays           |                1 | Open/editable  | Open/OEM data  |
+| Lights                       | Exterior Lights BULB                                      |                1 | Locked default | Locked default |
+| Lights                       | Day running lights LED bonus                              |                1 | Open/editable  | Open/OEM data  |
+| Lights                       | Antifog rear lights LED bonus                             |                1 | Open/editable  | Open/OEM data  |
+| Lights                       | Position lights LED bonus                                 |                1 | Open/editable  | Open/OEM data  |
+| Lights                       | Direction lights LED bonus                                |                1 | Open/editable  | Open/OEM data  |
+| Lights                       | Brake Lights LED bonus                                    |                1 | Open/editable  | Open/OEM data  |
+

Documentation/User Manual/1-user-interface/K2_VECTO-AdvancedAux_EL-ALT.md

+##Combined Alternator Map File (.aalt)
+
+The Combined Alternator Map (.AALT) file contains data relating to the efficiency of the alternator at various engine speeds and current demand. The .AALT file is a CSV file containing three fields: “Amp”, “RPM” (engine speed), and “Efficiency”. It can be created via the select file button, or an existing map directly imported into VECTO via the File Browser.
+
+
+![](pics/AA_Open-Create AALT.jpg)
+
+A new combined alternator map can be created or an existing one edited using the Combined Alternators editor module (see below).  This module enables the creation of a combined average alternator efficiency map by the advanced auxiliaries module, using input data for one or more alternators (Pully Ratio, Efficiency at different RPM/AMP combinations):
+
+![](pics/AA_Electrics_RC.jpg)
+
+Alternators may be added/deleted from the list. Data for existing alternators can be loaded into the form by double-clicking on the relevant alternator, and the data may then be updated and saved back down.
+
+The 'Diagnostics' tab provides a summary of the input data that is fed into combined alternator map calculations:
+
+![](pics/AALT-Editor_Diagnostics.png)
+
+The methodology for calculating the combined efficiency map is summarised below (and also included in the full schematics file included with the User Manual). Note: A simplified calculation is performed using the average of the user input efficiency values in the model pre-run only, to keep total run-time to a minimum (with negligible impact on the final result).  :
+
+![](pics/CombAltSchem.png)
+
+
+###File Format
+
+The file uses the VECTO CSV format.
+
+Several example default alternator maps are provided for use until a finalised certification procedure is in place for OEM-specific data.
+
+*Example Default Alternator Configuration for Advanced Alternator Map*
+
+---------------------
+Pulley Ratio:  3.6 
+---------------------
+
+
+|         |      |            |      |            |      |          | 
+|---------|------|------------|------|------------|------|----------|
+| *RPM*     | *2000*      | *2000*  | *4000*      | *4000*  | *6000*      | *6000*  |
+|         | **Amps** | **Efficiency** | **Amps** | **Efficiency** | **Amps** | **Efficiency**  |
+|         | **10.00** | 62.00 | **10.00** | 64.00 | **10.00** | 53.00 | 
+| I_max/2 | 27.00     | 70.00 | 63.00     | 74.00 | 68.00     | 70.00 | 
+| I_max   | 53.00     | 30.00 | 125.00    | 68.00 | 136.00    | 62.00 |
+
+Notes: Bold values are locked/fixed values; I_max = the maximum current in Amps.
+

Documentation/User Manual/1-user-interface/K3_VECTO-AdvancedAux_PNEU.md

+##Pneumatic Auxiliaries Editor
+ 
+
+![](pics/AA_Pneumatics.jpg)
+ 
+###Description
+
+The "Pneumatics" tab defines various parameters for pneumatic auxiliaries used on the vehicle:
+
+-   Pneumatic Auxiliaries Data/Variables
+    : Data for various pneumatic auxiliaries and the relevant pneumatic variables can be edited in the adjacent text boxes.
+-   Filepath to the Compressor Map (.ACMP) file
+    : Files can be imported by clicking the browse button adjacent to the “Compressor Map” text box.
+-   Filepath to the Actuations Map (.APAC) file
+    : Files can be imported by clicking the browse button adjacent to the “Actuations Map” text box.
+-   The “Retarder Brake”, “Smart Pneumatics” and “Smart Regeneration” and enable via check boxes.
+
+
+###Default Values
+
+The following table provides a summary of the default values that are populated whenever a new advanced auxiliaries (.AAUX) file is created from scratch.  The table also indicates the editable/default status of the relevant parameters in the VECTO UI in Engineering mode, and the recommended status in Declaration mode (not currently implemented).  The default values / parameter status has been agreed with the project steering group.
+
+**Default parameter values and editable status for the Pneumatic module**
+
+*Pneumatic Auxiliaries Data*
+
+| Category | Default value | Engineering | Declaration | Comments | 
+|----------|---------------|-------------|-------------|----------|
+| AdBlue NI per minute | 21.25 | Open/editable | Locked default | Only relevant for Pneumatic AdBlue Dosing, also needs drive cycle duration | 
+| Air Controlled Suspension NI/Minute | 15 | Open/editable | Locked default | Only relevant for Pneumatic Air Suspension Control, also needs drive cycle duration | 
+| Breaking No Retarder NI/KG | 0.00081 | Open/editable | Locked default | also needs vehicle weight | 
+| Braking with Retarder NI/KG | 0.0006 | Open/editable | Locked default | Also needs vehicle weight | 
+| Air demand per Kneeling NI/Kg mm | 0.000066 | Open/editable | Locked default | Also needs vehicle weight and kneeling height | 
+| Dead Vol Blowouts/L/Hour | 24 | Open/editable | Locked default |   | 
+| Dead Volume Litres | 30 | Open/editable | Locked default |   | 
+| Non Smart Regen Fraction Total Air Demand | 0.26 | Open/editable | Locked default |   | 
+| Overrun Utilisation for Compression Fraction | 0.97 | Open/editable | Locked default | Taken directly from White Book | 
+| Per Door Opening NI | 12.7 | Open/editable | Locked default | Only relevant for Pneumatic Door Operation, also needs number of door openings | 
+| Per Stop Brake Actuation NI/KG | 0.00064 | Open/editable | Locked default | Also needs vehicle weight | 
+| Smart Regen Fraction Total Air Demand | 0.12 | Open/editable | Locked default  |
+
+ 
+ 
+*Pneumatic Variables*
+
+| Category | Default value |   Engineering | Declaration | Comments |
+|----------|---------------|-------------|-------------|----------|
+| Compressor Map | <blank> | Open/editable | Locked default | A number of pre-set defaults will be provided; later value from test procedure. | 
+| Compressor Gear Ratio | 1.00 | Open/editable | Open/OEM data | Related compressor shaft speed to engine shaft speed |
+| Compressor Gear Efficiency | 0.97 | Open/editable | Locked default |   | 
+| AdBlue Dosing | Pneumatic | Open/editable | Open/OEM data | Pneumatic (/Electric) | 
+| Air Suspension Control | Mechanically | Open/editable | Open/OEM data | Mechanically (/Electrically) | 
+| Door Operation | Pneumatic | Open/editable | Open/OEM data | Pneumatic (/Electric) | 
+| Kneeling height millimeters | 70 | Open/editable | Open/OEM data | Used with air demand per kneeling | 
+| Actuations Map | testPneumatic | ActuationsMap | Open/editable | Locked default | Determined by passenger stops | 
+| Retarder brake | Yes | Open/editable | Open/OEM data | Yes (/No) | 
+| Smart Pneumatics | No | Open/editable | Open/OEM data | No (/Yes) | 
+| Smart Regeneration | No | Open/editable | Open/OEM data | No (/Yes)  |
+

Documentation/User Manual/1-user-interface/K4_VECTO-AdvancedAux_HVAC.md

+##HVAC Auxiliaries Editor
+ 
+![](pics/AA_HVAC.jpg)
+
+###Description
+
+The "HVAC" tab defines various parameters for heating, ventilation and air conditioning (HVAC) auxiliaries used on the vehicle, calculated from the HVAC Steady State Model (HVAC SSM):
+-   Disable HVAC Module [tickbox]
+-   Filepath to the Steady State Model File (.AHSM)
+    : Files can be imported by clicking the browse button adjacent to the HVAC "Steady State Model File (.AHSM)" text box.
+-   Filepath to the Bus Parameter Database (.ABDB)
+    " Files can be imported by clicking the browse button adjacent to the HVAC SSM bus parameters database file (.ABDB) text box.  The bus parameter database contains a list of default parameters for a number of pre-existing/defined buses that can be quickly switched between within the HVAC SSM Editor module.
+
+Outputs from the HVAC SSM include:
+-   Electrical Load Power Watts
+-   Mechanical Load Power Watts
+-   Fuelling Litres Per Hour
+
+
+###HVAC Steady-State Model Editor
+
+The HVAC Steady-State Model (HVAC SSM) Editor defines various data and parameters for calculation of HVAC auxiliary demands (electrical, mechanical and fuelling) from the vehicle, replicating the key inputs/functionality from the HVAC CO2SIM model developed for ACEA:
+
+-   Bus Parameters
+-   Boundary Conditions
+-   Other
+-   Tech List Input
+-   Diagnostics
+
+At the top of the window, two sets of outputs are presented for electrical, mechanical and fuelling demand:
+
+-   'Base' values: These are the calculated resulting demands from the inputs on the 'Bus Parameters', 'Boundary Conditions' and 'Other' tabs.
+-   'Adjusted' values: these are the final values output from the model, which additionally factor in the HVAC technologies included in the 'Tech List Input' tab.
+
+###Bus Parameters
+
+![](pics/HVAC_BusParameters.jpg)
+
+Input bus parameters can be edited directly or imported/calculated from the Bus Parameter Database (.abdb) file via the '\<Select\>' drop-down box at the top of the page. Parameters in the accompanying database file (.abdb) include:
+
+-   Bus Model Name (free text)
+-   Registered passengers
+-   Type (i.e. 'raised floor' = Class III, 'semi low floor' = Class II, or 'low floor' = Class I)
+-   Is Double Decker [tick box]
+-   Length in m,
+-   Wide in m,
+-   Height in m,
+-   \[Engine Type (only 'diesel' is currently supported), only when creating a 'New' entry\]
+-   Other fields, that are greyed out, are locked and not editable, containing fixed default values or calculations.
+ 
+
+###Boundary Conditions
+
+![](pics/HVAC_BoundaryConditions.jpg)
+
+On this tab the various boundary conditions for the HVAC SSM calculations can be set. Certain fields (greyed out) are locked and not editable, containing fixed default values or calculations.
+
+###Other
+
+![](pics/HVAC_Other.jpg)
+
+On this tab a number of other parameters for the HVAC SSM calculations can be set:
+-    Environmental conditions: when in 'Batch Mode' a climatic conditions dataset (.aenv) file must be used containing a series of environmental conditions. Otherwise single values for temperature and solar load may be input (these fields are locked/not used when in batch mode).
+-   AC System specifications/type: the AC-Compressor Type selection determines the COP value used, according to the specification of the project steering group.
+-   Ventilation settings
+-   Auxiliary Heater parameters: the power of the fuel fired heater may be included, other fields are provided for information only and are locked. The 'Engine Waste Heat' values are calculated during the actual model runs, which are determined via a pre-run of the model over the selected drive-cycle.
+
+###TechList Input
+
+![](pics/HVAC_TechList.jpg)
+
+To determine energy consumption of a certain bus-HVAC system combination, a customisable list of technologies may be added/edited on this tab to allow to take special features into account which have a reducing or increasing influence. Because several technologies are only available for certain bus types, the list has to be bus type-specific. The technologies list and the default values has been populated according to the steering group recommendations, however these may be deleted, edited or added to as required on this tab in Engineering mode.
+
+**Diagnostics**
+
+The final 'Diagnostics' tab provides a summary of the resulting outputs from the HVAC Tech List tab.
+
+
+###Default Values
+
+The following table provides a summary of the default values that are populated whenever a new advanced auxiliaries (.AAUX) file is created from scratch.  The table also indicates the editable/default status of the relevant parameters in the VECTO UI in Engineering mode, and the recommended status in Declaration mode (not currently implemented).  The default values / parameter status has been agreed with the project steering group.
+
+**Default parameter values and editable status for the HVAC module**
+
+**INP - BusParameters tab**
+
+*Bus Parameterisation*
+
+| Category/Input | Default value | Engineering | Declaration | 
+|----------------|---------------|-------------|-------------| 
+| Select | \<Select\> |   |   | 
+| Bus Model | <ABDB or input> | Open/editable | Locked default |
+| Number of Passengers | \<ABDB or input\> | Open/editable | Locked default | 
+| Bus Type | <ABDB or input> | Open/editable | Locked default | 
+| Double Decker? | No | Open/editable | Open/OEM data | 
+| Bus Length (m) | \<ABDB or input\> | Open/editable | Locked default | 
+| Bus Width (m) | \<ABDB or input\> | Open/editable | Locked default | 
+| Bus Height (m) | \<ABDB or input\> | Open/editable | Locked Calc | 
+| Bus Floor Surface Area (m^2) | Calculation | Locked Calc | Locked Calc | 
+| Bus Window Surface (m^2) | Calculation | Locked Calc | Locked Calc | 
+| Bus Surface Area (m^2) | Calculation | Locked Calc | Locked Calc | 
+| Bus Volume (m^3) | Calculation | Locked Calc | Locked Calc | 
+
+**INP - Boundary Conditions tab**
+
+*Boundary Conditions*
+
+| Category/Input | Default value | Engineering | Declaration | 
+|----------------|---------------|-------------|-------------| 
+| G-Factor ** | 0.95 | Open/editable | Open/editable | 
+| Solar Clouding | 0.8 | Locked Calc | Locked Calc | 
+| Heat per Passenger into Cabin (W) | 80 | Locked Calc | Locked Calc | 
+| Passenger Boundary Temperature (oC) | 12 | Open/editable | Locked default | 
+| Passenger Density: Low Floor (Pass/m^2) | 3 | Locked Calc | Locked default | 
+| Passenger Density: Semi Low Floor (Pass/m^2) | 2.2 | Locked Calc | Locked default |
+| Passenger Density: Raised Floor (Pass/m^2) | 1.4 | Locked Calc | Locked default |
+| Calculated Passenger Number | Calculation | Locked Calc | Locked Calc | 
+| U-Values W/(K\*m^3) | Calculation | Locked Calc | Locked Calc | 
+| Heating Boundary Temperature (oC) | 18 | Open/editable | Locked default | 
+| Cooling Boundary Temperature (oC) | 23 | Open/editable | Locked default | 
+| Temperature at which cooling turns OFF | 17 | Locked default |   | 
+| High Ventilation (l/h) | 20 | Open/editable | Locked default | 
+| How Ventilation (l/h) | 7 | Open/editable | Locked default | 
+| High (m^3/h) | Calculation | Locked Calc | Locked Calc | 
+| low (m^3/h) | Calculation | Locked Calc | Locked Calc | 
+| High Vent Power (W) | Calculation | Locked Calc | Locked Calc | 
+| Low Vent Power (W) | Calculation | Locked Calc | Locked Calc | 
+| Specific Ventilation Power (Wh/m3) | 0.56 | Open/editable | Locked default | 
+| Aux. Heater Efficiency | 0.84 | Open/editable | Locked default | 
+| GCV (Diesel / Heating oil) (kwh/kg) | 11.8 | Open/editable | Locked default | 
+| Window Area per Unit Bus Length (m^2/m) | Calculation | Locked Calc | Locked Calc |
+| Front + Rear Window Area (m^2) | Calculation | Locked Calc | Locked Calc | 
+| Max Temperature Delta for low Floor Busses (K) | 3 | Open/editable | Locked default | 
+| Max Possible Benefit from Technology List (Fraction) | 0.5 | Open/editable | Locked default |
+
+**INP - Other**
+
+*Enviromental Conditions*
+
+| Category/Input | Default value | Engineering | Declaration | 
+|----------------|---------------|-------------|-------------| 
+| Enviromental Temperature (oC) | 25 | Open/editable | Locked default | 
+| Solar (W/m²) | 400 | Open/editable | Locked default | 
+| Batch-mode | ON | Open/editable | Locked default | 
+| Environmental Conditions Database | TBC Default | Open/editable | Locked default | 
+
+*AC-system*
+
+| Category/Input | Default value | Engineering | Declaration | 
+|----------------|---------------|-------------|-------------| 
+| AC-compressor type | 2-stage (0/100) | Open/editable | Open/OEM data | 
+| AC-compressor type (Mechanical / Electrical) | Calculation | Locked Calc | Locked Calc | 
+| AC-compressor capacity (kW) | 18 | Open/editable | Locked default | 
+| COPCool | 3.50 | Locked Calc | Locked Calc | 
+
+*Ventilation*
+
+| Category/Input | Default value | Engineering | Declaration | 
+|----------------|---------------|-------------|-------------| 
+| Ventilation during heating | Yes | Open/editable | Locked default | 
+| Ventilation when both Heating and  AC are inactive | Yes | Open/editable | Locked default | 
+| Ventilation during AC | Yes | Open/editable | Locked default | 
+| Ventilation flow setting when both Heating and  AC are inactive | High | Open/editable | Locked default*** | 
+| Ventilation during Heating | High | Open/editable | Locked default*** | 
+| Ventilation during Cooling | High | Open/editable | Locked default*** | 
+
+*Aux. Heater*
+
+| Category/Input | Default value | Engineering | Declaration | 
+|----------------|---------------|-------------|-------------| 
+| Fuel Fired Heater (kW) | 30 | Open/editable | Open/OEM data | 
+
+*TechList Input**
+
+*Insulation*
+
+| Category/Input | Default value | Engineering | Declaration | 
+|----------------|---------------|-------------|-------------| 
+| Double-glazing | TF5 table* | Open/editable | Tick box only | 
+| Tinted windows | TF5 table* | Open/editable | Tick box only | 
+
+*Ventilation* 
+
+| Category/Input | Default value | Engineering | Declaration | 
+|----------------|---------------|-------------|-------------| 
+| Fan controll strategy | TF5 table* | Open/editable | Tick box only | 
+
+*Heating*
+
+| Category/Input | Default value | Engineering | Declaration | 
+|----------------|---------------|-------------|-------------| 
+| Heat pump systems | TF5 table* | Open/editable | Tick box only | 
+| Adjustable coolant thermostat | TF5 table* | Open/editable | Tick box only | 
+| Adjustable auxiliary heater | TF5 table* | Open/editable | Tick box only | 
+| Engine waste-gas heat exchanger | TF5 table* | Open/editable | Tick box only | 
+
+*Cooling*
+
+| Category/Input | Default value | Engineering | Declaration | 
+|----------------|---------------|-------------|-------------| 
+| Separate air distribution ducts | TF5 table* | Open/editable | Tick box only | 
+
+**Notes: **
+
+* Default parameter values for Technology List from ACEA TF5 proposal
+
+** Tinted Window: G-Factor/g-value (= "solar factor" = "total solar energy transmittance")   according ISO 9050. ISO 9050 defines wind speed at the outside surface of 14 km/h.
+
+Definition of bins for transmission rates according to ACEA TF5 recommendation:
+
+| g-value | bonus |
+|---------|-------|
+| < 0,1 | To be simulated with g = 0,05 |
+| 0,11 – 0,20 | To be simulated with g = 0,15 |
+| 0,21 – 0,30 | To be simulated with g = 0,25 |
+| 0,31 – 0,40 | To be simulated with g = 0,35 |
+| 0,41 – 0,50 | To be simulated with g = 0,45 |
+| 0,51 – 0,60 | To be simulated with g = 0,55 |
+| 0,61 – 0,70 | To be simulated with g = 0,65 |
+| 0,71 – 0,80 | To be simulated with g = 0,75 |
+| 0,81 – 0,90 | To be simulated with g = 0,85 |
+| 0,91 - 1    | To be simulated with g = 0,95 | 
+
+*** Air Flow Rate: recommended for future implementation in Declaration mode by ACEA TF5:
+
+| Phase | With thermal comfort roof mounted system | Without thermal comfort roof mounted system |
+|-------|------------------------------------------|---------------------------------------------|
+| **Cooling** | High (20x internal volume / h) | Low (7x internal volume / h) | 
+| **Ventilation** | High (20x internal volume / h) | Low (7x internal volume / h) | 
+| **Heating** | High (10x internal volume / h) | Low (7x internal volume / h) 
+
+###File Format
+
+The HVAC SSM (.ahsm) and Bus Parameter Database (.abdb) files use the VECTO CSV format.
+

Documentation/User Manual/convert.bat

@@ -8,7 +8,7 @@ set LIST=
 for /f %%f in (files.txt) do set LIST=!LIST! "%%f"
 
 
-pandoc  -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-1.11.3.min.js -H includes/jquery-ui-1.11.4.min.js -H includes/include.js
+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-1.11.3.min.js -H includes/jquery-ui-1.11.4.min.js -H includes/include.js
 
 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-1.11.3.min.js -H includes/jquery-ui-1.11.4.min.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-1.11.3.min.js -H includes/jquery-ui-1.11.4.min.js -H includes/include.js

Documentation/User Manual/files.txt

@@ -4,6 +4,11 @@
 1-user-interface/C_settings.md
 1-user-interface/D_VECTO-Job-Editor.md
 1-user-interface/E_VECTO-Editor_Aux.md
+1-user-interface/K0_VECTO-AdvancedAux.md
+1-user-interface/K1_VECTO-AdvancedAux_EL.md
+1-user-interface/K2_VECTO-AdvancedAux_EL-ALT.md
+1-user-interface/K3_VECTO-AdvancedAux_PNEU.md
+1-user-interface/K4_VECTO-AdvancedAux_HVAC.md
 1-user-interface/F_VEH-Editor.md
 1-user-interface/G_ENG-Editor.md
 1-user-interface/H_GBX-Editor.md

Documentation/User Manual/includes/include.js

@@ -32,5 +32,14 @@ $(function(){
     });
 
 
+/* hide some items from TOC */
+
+$("#TOC li a[href='#electrical-auxiliaries-editor']").parent().hide()
+$("#TOC li a[href='#combined-alternator-map-file-.aalt']").parent().hide()
+$("#TOC li a[href='#pneumatic-auxiliaries-editor']").parent().hide()
+$("#TOC li a[href='#hvac-auxiliaries-editor']").parent().hide()
+/*-------------------------*/
+
+    $("td[align=left").filter(function() {return $(this).text().indexOf("Locked default")===0 || $(this).text().indexOf("Locked Calc") === 0; }).addClass("aaux_locked")
 });
 </script>
\ No newline at end of file

Documentation/User Manual/includes/style.css

@@ -129,3 +129,9 @@ pre {
   padding: 2px;
   border: 1px solid #EEEEEE;
 }
+
+
+.aaux_locked { 
+  background: gray;
+  color: white;
+ }
\ No newline at end of file