From a39f58c3f476b060cbea33c354065f159d26548a Mon Sep 17 00:00:00 2001
From: Markus Quaritsch <markus.quaritsch@tugraz.at>
Date: Fri, 14 Jul 2017 09:21:13 +0200
Subject: [PATCH] update user manual
---
.../Torque Converter Simulation.docx | Bin 0 -> 16045 bytes
.../3-simulation-models/ADAS_EcoRoll.md | 3 +-
.../3-simulation-models/Driver_AccLimit.md | 2 +-
.../3-simulation-models/Driver_LAC.md | 2 +-
.../3-simulation-models/Engine_FC.md | 2 +-
.../Engine_Speed_Torque_limitations.md | 36 +++++++++++++++++-
.../3-simulation-models/GearShift.md | 11 +-----
.../3-simulation-models/GearShift_AMT.md | 22 +++++++++--
.../3-simulation-models/GearShift_AT.md | 20 +++++++---
.../3-simulation-models/Gearbox_AT.md | 2 +-
.../Transmission_Losses.md | 2 +-
.../Vehicle_CrossWindCorrection.md | 2 +-
.../3-simulation-models/Vehicle_RRC.md | 2 +-
.../3-simulation-models/simulation-models.md | 20 +++++-----
.../XML_DeclarationReport.md | 18 +++++++++
.../XML_Job-File_DeclarationMode.md | 10 +++++
.../5-input-and-output-files/input-output.md | 4 +-
Documentation/User Manual/files.txt | 4 +-
.../pics/at_gearbox_shiftlines.PNG | Bin 0 -> 10982 bytes
19 files changed, 121 insertions(+), 41 deletions(-)
create mode 100644 Documentation/Torque Converter Simulation.docx
create mode 100644 Documentation/User Manual/5-input-and-output-files/XML_DeclarationReport.md
create mode 100644 Documentation/User Manual/5-input-and-output-files/XML_Job-File_DeclarationMode.md
create mode 100644 Documentation/User Manual/pics/at_gearbox_shiftlines.PNG
diff --git a/Documentation/Torque Converter Simulation.docx b/Documentation/Torque Converter Simulation.docx
new file mode 100644
index 0000000000000000000000000000000000000000..b5aa0c02a551fd0f235601ea4af6743129c49ae7
GIT binary patch
literal 16045
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
QfPepiypPaip5N~NALrox;s5{u
literal 0
HcmV?d00001
diff --git a/Documentation/User Manual/3-simulation-models/ADAS_EcoRoll.md b/Documentation/User Manual/3-simulation-models/ADAS_EcoRoll.md
index 6b36b03ea6..21c3d25c02 100644
--- a/Documentation/User Manual/3-simulation-models/ADAS_EcoRoll.md
+++ b/Documentation/User Manual/3-simulation-models/ADAS_EcoRoll.md
@@ -1,5 +1,4 @@
-##Overspeed
-
+##Driver: Overspeed
Both functions control the vehicle's behaviour on uneven road sections (slope ≠0) and can be configured in the [Job File](#job-file)'s Driver Assist Tab. Overspeed is designed to model an average driver's behaviour without the aid of driver assistance systems. Eco-Roll represents an optional driver assistance feature. For this reason vehicles without Eco-Roll should always have the Overspeed function enabled.
diff --git a/Documentation/User Manual/3-simulation-models/Driver_AccLimit.md b/Documentation/User Manual/3-simulation-models/Driver_AccLimit.md
index dfa17c4eb9..c8b482e500 100644
--- a/Documentation/User Manual/3-simulation-models/Driver_AccLimit.md
+++ b/Documentation/User Manual/3-simulation-models/Driver_AccLimit.md
@@ -1,4 +1,4 @@
-##Acceleration Limiting
+##Driver: Acceleration Limiting
VECTO limits the vehicle acceleration and deceleration depending on current vehicle speed, to model a realistic driver behavior. These limits are defined in the [Acceleration Limiting Input File (.vacc)](#acceleration-limiting-input-file-.vacc), which can be set in the [Job File](#job-file). In Declaration mode this is already predefined.
diff --git a/Documentation/User Manual/3-simulation-models/Driver_LAC.md b/Documentation/User Manual/3-simulation-models/Driver_LAC.md
index d4963592e5..554a9e2f81 100644
--- a/Documentation/User Manual/3-simulation-models/Driver_LAC.md
+++ b/Documentation/User Manual/3-simulation-models/Driver_LAC.md
@@ -1,4 +1,4 @@
-##Look-Ahead Coasting
+##Driver: Look-Ahead Coasting
Look-Ahead Coasting is a function that aims on modelling real driver behaviour. It is a forward-looking function that detects forthcoming reductions in target speed in the mission profile (e.g. speed limit, etc.) and induces an early deceleration using engine braking before applying mechanical brakes according to the [deceleration limit](#acceleration-limiting).
diff --git a/Documentation/User Manual/3-simulation-models/Engine_FC.md b/Documentation/User Manual/3-simulation-models/Engine_FC.md
index c19ae43713..3343b67f65 100644
--- a/Documentation/User Manual/3-simulation-models/Engine_FC.md
+++ b/Documentation/User Manual/3-simulation-models/Engine_FC.md
@@ -1,4 +1,4 @@
-##Fuel Consumption Calculation
+##Engine: Fuel Consumption Calculation
The base FC value is interpolated from the stationary [FC map](#fuel-consumption-map-.vmap). If necessary the base value is corrected to compensate for unconsidered auxiliary energy consumption for vehicles with Start/Stop. In Declaration Mode additionally the WHTC correction is applied, see below.
diff --git a/Documentation/User Manual/3-simulation-models/Engine_Speed_Torque_limitations.md b/Documentation/User Manual/3-simulation-models/Engine_Speed_Torque_limitations.md
index ff90f19217..a41f6d2779 100644
--- a/Documentation/User Manual/3-simulation-models/Engine_Speed_Torque_limitations.md
+++ b/Documentation/User Manual/3-simulation-models/Engine_Speed_Torque_limitations.md
@@ -1,3 +1,37 @@
-###Engine Torque and Engine Speed Limitations
+##Engine Torque and Engine Speed Limitations
+
+The engine's maximum speed and maximum torque may be limited by either the gearbox (due to mechanical constraints) or the vehicle configuration.
+Engine torque limitations are modeled by limiting the engine full-load curve to the defined maximum torque, i.e., the orignial 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.
+
+
+<div class="engineering">
+In Engineering Mode, speed and torque limits can be defined and will be effective for every gear.
+</div>
+
+<div class="declaration">
+In Declaration Mode, the following rules restrict the limitations of engine torque:
+
+###Transmission Input-Speed Limitations
+
+* Applicable for every gear
+
+###Transmission Torque Limitations
+
+* For higher 50% of gears (i.e., gears 7 to 12 for a 12-gear transmission):
+ - Transmissions max torque > 90% of engine max torque: max. torque limitation *not* applicable (VECTO extrapolates loss-maps)
+ - Transmissions max torque <= 90% of engine max torque: max. torque limitation applicable
+* For lower 50% of gears (i.e., gears 1 to 6 for a 12-gear transmission):
+ - Transmission torque limit is always applicable
+
+###Vehicle defined Torque Limitations
+
+* For higher 50% of gears (i.e., gears 7 to 12 for a 12-gear transmission):
+ - Torque limit > 95% of engine max torque: max. torque limitation *not* applicable (VECTO extrapolates loss-maps)
+ - Torque limit <= 90% of engine max torque: max. torque limitation applicable
+* For lower 50% of gears (i.e., gears 1 to 6 for a 12-gear transmission):
+ - Torque limit is *not* applicable
+
+</div>
+
diff --git a/Documentation/User Manual/3-simulation-models/GearShift.md b/Documentation/User Manual/3-simulation-models/GearShift.md
index e1ec38aed0..cb7a98fcb9 100644
--- a/Documentation/User Manual/3-simulation-models/GearShift.md
+++ b/Documentation/User Manual/3-simulation-models/GearShift.md
@@ -1,4 +1,4 @@
-##Gear Shift Model
+##Gearbox: Gear Shift Model
The Gear Shift Model is based on shift curves that define the engine speed for up- and down- shifting as a function of engine torque. As soon as the engine operation point passes one of the shift curves a gear change is initiated.
@@ -45,13 +45,4 @@ Early Upshift (allow upshifts inside the shift polygons) is enabled for AMT only
-###Generic shift conditions
-- Only allow upshifts if the vehicle is not decelerating **and** the estimated acceleration in the next gear is higher than a certain threshold (default: 0.1 m/s²)
-- Do not allow downshifts with less time than a certain amount after an upshift (default 10 s)
-- Do not allow upshifts with less time than a certain amount after an downshift (default 10 s)
-
-Parameters in [Gearbox File](#gearbox-file):
-: - **DownshiftAferUpshiftDelay**
-- **UpshiftAfterDownshiftDelay**
-- **UpshiftMinAcceleration**
diff --git a/Documentation/User Manual/3-simulation-models/GearShift_AMT.md b/Documentation/User Manual/3-simulation-models/GearShift_AMT.md
index ddc1ff320d..6701c43dd8 100644
--- a/Documentation/User Manual/3-simulation-models/GearShift_AMT.md
+++ b/Documentation/User Manual/3-simulation-models/GearShift_AMT.md
@@ -1,6 +1,8 @@
-##Gear Shift Rules for AMT Gearbox
+##Gearbox: MT and AMT Gearshift Rules
-###Computation of Shift Polygons in Declaration Mode (According to ACEA Whitebook 2016)
+This section describes the gearshift rules for manual and automatic manual transmission models. When a gearshift is triggered, gears may be skipped for both MT and AMT gearboxes (see [Gearbox: Gear Shift Model](#gearbox-gear-shift-model)). Early Upshift (see [Gearbox: Gear Shift Model](#gearbox-gear-shift-model)) is only enabled for AMT gearboxes.
+
+###Shift Polygons in Declaration Mode (According to ACEA Whitebook 2016)
####1. Computation of Characteristic Points
@@ -26,12 +28,22 @@ and limited to the gear's maximum input speed.
* If the engine speed is higher than the gearbox maximum input speed or engine n_{95h} speed (whichever is lower)
* If all of the following conditions are met:
- - The vehicle is not decelerating
+ - The vehicle is not decelerating AND
- Engine operation point (speed and torque) is above (right of) the upshift line AND
- The acceleration in the next gear is above a certain threshold if the driver is accelerating, i.e., acceleration_nextGear > min(Min. acceleration threshold, Driver acceleration) AND
- The last gearshift was longer than a certain threshold (Declaration Mode: 2s) ago AND
- The last downshift was longer than a certain threshold (Declaration Mode: 10s) ago
+###Upshift rules for Early Upshift (AMT only)
+
+* If the engine speed is higher than the gearbox maximum input speed or engine n_{95h} speed (whichever is lower)
+* If all of the following conditions are met:
+ - The vehicle is not decelerating AND
+ - The engine's operating point (speed and torque) is above the downshift line with a certain margin to the max. torque (torque reserve) AND
+ - The acceleration in the next gear is above a certain threshold if the driver is accelerating, i.e., acceleration_nextGear > min(Min. acceleration threshold, Driver acceleration) AND
+ - The last gearshift was longer than a certain threshold (Declaration Mode: 2s) ago AND
+ - The last downshift was longer than a certain threshold (Declaration Mode: 10s) ago
+
###Downshift
@@ -53,3 +65,7 @@ and limited to the gear's maximum input speed.
- Min. time for downshift after an upshift
- Min. acceleration in next gear
+For Skip Gears and Early Upshift the following additional parameters are required:
+
+- Torque reserve
+
diff --git a/Documentation/User Manual/3-simulation-models/GearShift_AT.md b/Documentation/User Manual/3-simulation-models/GearShift_AT.md
index a916f4d470..6326a0c538 100644
--- a/Documentation/User Manual/3-simulation-models/GearShift_AT.md
+++ b/Documentation/User Manual/3-simulation-models/GearShift_AT.md
@@ -1,15 +1,20 @@
-##Gear Shift Rules for AT Gearbox
+##Gearbox: AT Gearshift Rules
-The gear shift rules for automatic gearboxes differ from AMT and MT.
-
-Gears are shifted sequentially:
+For AT gearboxes neither Skip Gears nor Early upshift (see [Gearbox: Gear Shift Model](#gearbox-gear-shift-model)) are enabled. Moreover, the gears are shifted strictly sequentially:
- 1C -> 1L -> 2L -> ... (torque converter only in 1st gear)
- 1C -> 2C -> 2L -> ... (torque converter in 1st and 2nd gear)
+###Shift Polygons in Declaration Mode
+
+* Downshift line: 700 rpm (torque independent, vertical line)
+* Upshift line: 900 rpm for torque <= 0; 1150 rpm @ Engine's maximum torque
+
+
+
###Upshift rules
-+ If engine speed and engine torque in the next gear (see shift sequence) is above the upshift line AND
++ If engine speed and engine torque in the *next gear* (see shift sequence) is above the upshift line AND
+ the acceleration in the next gear is above a certain threshold if the driver is accelerating, i.e., acceleration_nextGear > min(Min. acceleration threshold, Driver acceleration)
The user interface allows to enter two acceleration thresholds, one for locked gear to locked gear shifts and another vor converter to locked gear shifts. For converter to converter shifts the latter threshold applies.
@@ -27,4 +32,7 @@ The user interface allows to enter two acceleration thresholds, one for locked g
- Min. time between two consecutive gearshifts.
- Min. acceleration after gearshift for L to L gear shifts
-- Min. acceleration after gearhsift for C to L (and C to C) gear shifts
+- Min. acceleration after gearhsift for C to L gear shifts
+- Min. acceleration after gearshift for C to C geear shifts
+
+
diff --git a/Documentation/User Manual/3-simulation-models/Gearbox_AT.md b/Documentation/User Manual/3-simulation-models/Gearbox_AT.md
index befb1b8baf..0f3ee4f3f9 100644
--- a/Documentation/User Manual/3-simulation-models/Gearbox_AT.md
+++ b/Documentation/User Manual/3-simulation-models/Gearbox_AT.md
@@ -1,4 +1,4 @@
-##AT Gearbox Model
+##Gearbox: AT Gearbox Model
Vecto supports both, AT gearboxes with serial torque converter and AT gearboxes with power split. Internally, both gearbox types are simulated using a power train architecture with the torque converter in series.
diff --git a/Documentation/User Manual/3-simulation-models/Transmission_Losses.md b/Documentation/User Manual/3-simulation-models/Transmission_Losses.md
index d40af35e08..105f3f8247 100644
--- a/Documentation/User Manual/3-simulation-models/Transmission_Losses.md
+++ b/Documentation/User Manual/3-simulation-models/Transmission_Losses.md
@@ -1,6 +1,6 @@
##Transmission Losses
-Every transmission component uses the following formula for calculating the torques at input and output side of the component:
+Every transmission component (gearbox, angledrive, axlegear, ...) uses the following formula for calculating the torques at input and output side of the component:
$T_{output} = (T_{input} - T_{loss}) * r_{gear}$
diff --git a/Documentation/User Manual/3-simulation-models/Vehicle_CrossWindCorrection.md b/Documentation/User Manual/3-simulation-models/Vehicle_CrossWindCorrection.md
index aeaef604e5..3a9df433c9 100644
--- a/Documentation/User Manual/3-simulation-models/Vehicle_CrossWindCorrection.md
+++ b/Documentation/User Manual/3-simulation-models/Vehicle_CrossWindCorrection.md
@@ -1,4 +1,4 @@
-##Cross Wind Correction
+##Vehicle: Cross Wind Correction
VECTO offers three different modes to consider cross wind influence on the drag coefficient. It is configured in the [Vehicle File](#vehicle-file).
diff --git a/Documentation/User Manual/3-simulation-models/Vehicle_RRC.md b/Documentation/User Manual/3-simulation-models/Vehicle_RRC.md
index 4125921f87..0f7fedb35d 100644
--- a/Documentation/User Manual/3-simulation-models/Vehicle_RRC.md
+++ b/Documentation/User Manual/3-simulation-models/Vehicle_RRC.md
@@ -1,4 +1,4 @@
-##Rolling Resistance Coefficient
+##Vehicle: Rolling Resistance Coefficient
The rolling resistance is calculated using a speed-independent rolling resistance coefficient (RRC).
diff --git a/Documentation/User Manual/3-simulation-models/simulation-models.md b/Documentation/User Manual/3-simulation-models/simulation-models.md
index 4bf3dedcfe..942da84c07 100644
--- a/Documentation/User Manual/3-simulation-models/simulation-models.md
+++ b/Documentation/User Manual/3-simulation-models/simulation-models.md
@@ -3,17 +3,19 @@
In this chapter the used component models for the simulation are described.
* [Powertrain and Components Structure](#powertrain-and-components-structure)
-* [Driver: Acceleration Limiting](#acceleration-limiting)
-* [Driver: Look-Ahead Coasting](#look-ahead-coasting)
-* [ADAS: Overspeed](#overspeed)
-* [Vehicle: Cross Wind Correction](#cross-wind-correction)
-* [Vehicle: Rolling Resistance Coefficient](#rolling-resistance-coefficient)
+* [Driver: Acceleration Limiting](#driver-acceleration-limiting)
+* [Driver: Look-Ahead Coasting](#driver-look-ahead-coasting)
+* [ADAS: Overspeed](#driver-overspeed)
+* [Vehicle: Cross Wind Correction](#vehicle-cross-wind-correction)
+* [Vehicle: Rolling Resistance Coefficient](#vehicle-rolling-resistance-coefficient)
* [Engine Start/Stop](#engine-startstop)
-* [Engine: Fuel Consumption Calculation](#fuel-consumption-calculation)
-* [Engine: Transient Full Load](#transient-full-load)
-* [Engine: WHTC Correction](#transient-full-load)
+* [Engine: Fuel Consumption Calculation](#engine-fuel-consumption-calculation)
+* [Engine: Transient Full Load](#engine-transient-full-load)
+* [Engine: WHTC Correction](#engine-wthc-correction)
* [Engine Torque and Engine Speed Limitations](#engine-torque-and-engine-speed-limitations)
-* [Gear Shift Model](#gear-shift-model)
+* [Gearbox: Gear Shift Model](#gearbox-gear-shift-model)
+* [Gearbox: MT and AMT Gearshift Rules](#gearbox-mt-and-amt-gear-shift-rules)
+* [Gearbox: AT Gearshift Rules](#gearbox-at-gear-shift-rules)
* [Torque Converter Model](#torque-converter-model)
* [Auxiliaries](#auxiliaries)
* [Engine Only Mode](#engine-only-mode)
diff --git a/Documentation/User Manual/5-input-and-output-files/XML_DeclarationReport.md b/Documentation/User Manual/5-input-and-output-files/XML_DeclarationReport.md
new file mode 100644
index 0000000000..25c85a8d5a
--- /dev/null
+++ b/Documentation/User Manual/5-input-and-output-files/XML_DeclarationReport.md
@@ -0,0 +1,18 @@
+##XML Declaration Report
+
+<div class="declaration">
+In Declaration Mode VECTO generates two reports according to the Technical Annex for vehicle certification:
+
+* Manufacturer Report
+* Customer Information Report
+
+Both reports are in XML format and contain a description of the simulated vehicle and the simulation results. The format is described in the following resources:
+
+* [Manufacturer Report XML schema](../XML/XSD/VectoOutputManufacturer.xsd)
+* [Manufacturer Report XML schema diagram](VectoOutputDeclaration.pdf)
+* [Customer Report XML schema](../XML/XSD/VectoOutputCustomer.xsd)
+* [Customer Report XML schema diagram](VectoOutputDeclarationCustomer.pdf)
+
+Sample reports are distributed with the generic vehicles.
+
+</div>
diff --git a/Documentation/User Manual/5-input-and-output-files/XML_Job-File_DeclarationMode.md b/Documentation/User Manual/5-input-and-output-files/XML_Job-File_DeclarationMode.md
new file mode 100644
index 0000000000..c468c83d97
--- /dev/null
+++ b/Documentation/User Manual/5-input-and-output-files/XML_Job-File_DeclarationMode.md
@@ -0,0 +1,10 @@
+##XML Job-File (Declaration Mode)
+
+<div class="declaration">
+For vehicle certification the input data (vehicle data) has to be provided in XML format. Please see the following resources for more information:
+
+* [XML schema description](VectoInputDeclaration.1.0.pdf)
+* [XML schema diagram](../XML/XSD/VectoInput.xsd)
+* [Example of an XML Job-File](../XML/Examples/vecto_vehicle-sample.xml)
+
+</div>
\ No newline at end of file
diff --git a/Documentation/User Manual/5-input-and-output-files/input-output.md b/Documentation/User Manual/5-input-and-output-files/input-output.md
index b724875d44..c4593e1c93 100644
--- a/Documentation/User Manual/5-input-and-output-files/input-output.md
+++ b/Documentation/User Manual/5-input-and-output-files/input-output.md
@@ -7,10 +7,10 @@ Vecto uses data files for input and output of data. These are stored in differen
- [JSON](#json)
- [Vecto CSV](#csv)
-
+- [XML](#xml-job-file-declaration-mode)
**Output:**
- [JSON](#json)
- [Vecto CSV](#csv)
-- PDF (for Declaration Report)
+- [XML Declaration Report](#xml-declaration-report)
diff --git a/Documentation/User Manual/files.txt b/Documentation/User Manual/files.txt
index 4f710ca1d2..9957ec50e1 100644
--- a/Documentation/User Manual/files.txt
+++ b/Documentation/User Manual/files.txt
@@ -28,17 +28,19 @@
3-simulation-models/Engine_FC.md
3-simulation-models/Engine_DynamicFullLoad.md
3-simulation-models/Engine_WHTC.md
+3-simulation-models/Engine_Speed_Torque_limitations.md
3-simulation-models/Transmission_Losses.md
3-simulation-models/Gearbox_AT.md
3-simulation-models/GearShift.md
3-simulation-models/Gearshift_AMT.md
3-simulation-models/Gearshift_AT.md
-3-simulation-models/Engine_Speed_Torque_limitations.md
3-simulation-models/TC.md
3-simulation-models/Auxiliaries.md
3-simulation-models/PwheelInput.md
3-simulation-models/PTO.md
5-input-and-output-files/input-output.md
+5-input-and-output-files/XML_Job-File_DeclarationMode.md
+5-input-and-output-files/XML_DeclarationReport.md
5-input-and-output-files/CSV.md
5-input-and-output-files/JSON.md
5-input-and-output-files/VECTO.md
diff --git a/Documentation/User Manual/pics/at_gearbox_shiftlines.PNG b/Documentation/User Manual/pics/at_gearbox_shiftlines.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..434adab6d3364abd8a3ed96d143acb72d736392a
GIT binary patch
literal 10982
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
H{N?`wuul3X
literal 0
HcmV?d00001
--
GitLab