forked from mc12027/OpenLAP-Lap-Time-Simulator
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
108 lines (95 loc) · 5.42 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
_______ _____________________ ________ ________ _____
__ __ \______________________ /___ |__ __ \ ___ __ \__________________(_)____________ /_
_ / / /__ __ \ _ \_ __ \_ / __ /| |_ /_/ / __ /_/ /_ ___/ __ \____ /_ _ \ ___/ __/
/ /_/ /__ /_/ / __/ / / / /___ ___ | ____/ _ ____/_ / / /_/ /___ / / __/ /__ / /_
\____/ _ .___/\___//_/ /_//_____/_/ |_/_/ /_/ /_/ \____/___ / \___/\___/ \__/
/_/ /___/
===================================================================================================
OpenLAP Laptime Simulation Project.
More information can be found in the "OpenLAP Laptime Simulation Project" videos on YouTube.
This software is licensed under the GPL V3 Open Source License.
Open Source MATLAB project created by:
Michael Chalkiopoulos
Cranfield University MSc Advanced Motorsport Engineer
National Technical University of Athens MEng Mechanical Engineer
LinkedIn: https://www.linkedin.com/in/michael-chalkiopoulos/
email: [email protected]
MATLAB file exchange: https://uk.mathworks.com/matlabcentral/fileexchange/
GitHub: https://github.com/mc12027
April 2020.
===================================================================================================
General OpenLAP usage instructions:
1) Create a vehicle with OpenVEHICLE.
2) Create a track with OpenTRACK.
3) Run straight line simulations with OpenDRAG.
OpenDRAG needs an OpenVEHICLE vehicle file to run.
4) Run lap time simulations with OpenLAP.
OpenLAP needs both a vehicle file from OpenVEHICLE and a track file from OpenTRACK to run.
===================================================================================================
Instructions on how to use each module/script:
___________________________________________________________________________________________________
OpenVEHICLE:
Racing vehicle model file creation for use in OpenLAP and OpenDRAG.
Instructions:
1) Select a vehicle excel file containing the vehicles information by
assigning the full path to the variable "filename". Use the
"OpenVEHICLE tmp.xlsx" file to create a new vehicle excel file.
2) Run the script.
3) The results will appear on the command window and inside the folder
"OpenVEHICLE Vehicles".
___________________________________________________________________________________________________
OpenTRACK:
Track model file creation for use in OpenLAP.
Instructions:
1) Select a track excel file containing the track information by
assigning the full path to the variable "filename". To select the
input method, change the "mode" variable to 'shape data' or 'logged
data'.
a) In "shape data" mode use the "OpenTRACK Shape tmp.xlsx" file
to create a new track excel file.
b) In "logged data" mode, use the "OpenTRACK Logged Data tmp.csv"
file to create a new track excel file. Make sure the rows and
columns in the functions correspond to the correct channels.
Channels needed to generate a usable track are distance, speed and
lateral acceleration or yaw velocity. To select between lateral
acceleration and yaw velocity for the curvature calculation, set
the "log_mode" variable to 'speed & latacc' or 'speed & yaw'.
Elevation and banking can be set to 0 everywhere if no data is
available. The grip factor should be set to 1 everywhere, and
tweaked only increase correlation in specific parts of a track. To
filter the logged data, change the duration of the filter from the
"filter_dt" variable (a value of 0.5 [s] is recommended).
2) Set the meshing size to the desired value (a value of 1 to 5 [m] is
recommended).
3) Set the track map rotation angle to the desired value in [deg].
Zero corresponds to the start of the map pointing towards positive X.
4) Run the script.
5) The results will appear on the command window and inside the folder
"OpenTRACK Tracks".
___________________________________________________________________________________________________
OpenDRAG:
Straight line acceleration and braking simulation using a simple point
mass model for a racing vehicle.
Instructions:
1) Select a vehicle file created by OpenVEHICLE by assigning the full
path to the variable "vehiclefile".
2) Run the script.
3) The results will appear on the command window and inside the folder
"OpenDRAG Sims". You can choose to include the date and time of each
simulation in the result file name by changing the
"use_date_time_in_name" variable to true.
___________________________________________________________________________________________________
OpenLAP:
Lap time simulation using a simple point mass model for a racing vehicle.
Instructions:
1) Select a vehicle file created by OpenVEHICLE by assigning the full
path to the variable "vehiclefile".
2) Select a track file created by OpenTRACK by assigning the full path to
the variable "trackfile".
3) Select an export frequency in [Hz] by setting the variable "freq" to
the desired value.
4) Run the script.
5) The results will appear on the command window and inside the folder
"OpenLAP Sims". You can choose to include the date and time of each
simulation in the result file name by changing the
"use_date_time_in_name" variable to true.