Alerax's LSO AI Script - ED Forums
 


Notices

Reply
 
Thread Tools Display Modes
Old 11-01-2018, 12:28 AM   #1
Alerax
Junior Member
 
Join Date: Sep 2017
Posts: 93
Default Alerax's LSO AI Script



--- PREFACE ------------------------------------------------------------------------

Hi All-

First off, I really appreciate everyone’s positive responses and feedbacks on the first release of the Alerax LSO AI Script (from here on shall be referenced as “LSO Script”). Especially would like to give my special thanks to randomtroubledmind, GYRO_N5EG, VFMA-42 HighwaymanEd, and the VFMA-42 SabreTooths squadron for your inputs, suggestions, and tirelessly pushing the LSO Script to its limits. The LSO Script was originally created so that my friends and I can enjoy the Hornet together during our weekly flights. As you can imagine, it was rather disruptive to have one us do LSO calls and not get the satisfaction (and challenge) of landing on the CV after a long successful mission.

That being said, the reason I decided to release the LSO Script to the public was very much to give the community and its members the same fun and enjoyment my friends and I have had in the past months. I purposely wrote the LSO Script to be a standalone, plug-and-play “module” that can be used with any mission (as far as I’m aware of) in both single-player and multi-player environment. What this means is that the LSO Script is itself self-contained, does not use any flags, triggers, or variables that will cause conflict with your existing mission designs.

Now, for some of you who are aware of and concern about the way the LSO Script was written, I have to ask for your patience. This is my first time releasing any script/code for the public, and programming is far from what I do professionally. I’m actively learning about open source licenses to understand the best path forward, but I can assure you that I will release the full LSO Script when I am no longer actively supporting it. Until then, I appreciate your understanding and suggest you check out the features and the value this LSO Script offers to the community.

Now that this is out the way- let’s jump into the exciting part!

Regards-
Alerax



--- FULL FEATURE LIST ( 04.07.2019 ) ------------------------------------------------------------------------

GENERAL
- Carrier Communication Information, with radio frequencies, TACAN, ILS, and CV airspace information
- Weather Status Report, with CV BRC, CV final bearing, CV velocity, and wind conditions
- Over 90 unique sound files
- Export grades to Saved Games folder
- Export flight track for review to Saved Games folder (ADDED v.2.5)
- Support for F/A-18C and F-14B
CASE I
- Request for Marshal, Enter Pattern, or Straight-in Approach
- Ability to request Marshal as a Single Flight or as a Section (up to 2 flights)
- Marshal stack logic with Angels designation and Charlie call to enter pattern
- Separate frequencies (one for Marshal and one for LSO) to simulate communication protocols
CASE II/III
- Since ED is “close” to releasing an official carrier mod, I’ll pause on this to not duplicate work. https://www.facebook.com/plugins/pos...61731277495341
LSO CALL EVALUATION
- Distance abeam to the CV
- Interval distance between each aircraft
- Handles for spin/holding pattern
- Long the groove calls
- Line up and altitude calls, with different levels of intensity for corrections
- On-speed and glide slope calls (ADDED v.2.5)
- Bolter and wave-off calls
- Wire trap and overall groove flying performance assessment
- Comprehensive grading report using common LSO shorthand notations


--- INSTALLATION ------------------------------------------------------------------------

I have simplified the installation significantly. There are largely two parts to the installation, the script and sound files.

Firstly, here are the steps to install the script file into your mission.
1 ) Open your mission or create a new one in the Mission Editor.
2 ) Go to the Trigger panel.
3 ) On the first column, select new Trigger (rename this to whatever you like), and change condition to “MISSION START”.
4 ) On the third column, select new Action “Do Script File”. Select open and locate the "Alerax_LSO_Script_Release_v2.5.lua" file.
5 ) Rename your CV to “Stennis_AI” (case sensitive)
6 ) Save the mission.
Secondly, the sound file installation no longer requires you to install each sound file one by one. However, you’ll need a “.zip” file program for this to work. Also, make sure that you close out of the Mission Editor before you do this step, else DCS Mission Editor may overwrite your mission file.
1 ) Locate and select your mission (.miz) file.
2 ) Press F2 to rename the mission file and change the “.miz” to “.zip”. This will allow you directly place the sound files into the mission.
3 ) Open the newly converted .zip file and place the "Alerax_LSO_AI_Script" folder into the root directory (same directory as the “l10n” folder).
4 ) Close out of the .zip file.
5 ) Press F2 and rename the mission back from “.zip” to “.miz”.
Done!



--- PREPARATION ------------------------------------------------------------------------

I recommend you to review the materials available from the following links to get familiar with the procedures and expectations of a Hornet pilot when inbounding to and landing on the CV. The LSO Script uses a lot of the requirements and procedures detailed in these sources.
Lex’s CV Ops Basic (VID 1 & VID 2)
https://youtu.be/LvGQS-3AzMc?list=PL...r6VBvAJ5cEYDEz

Naval Air Training Command CV Procedures
https://www.cnatra.navy.mil/local/do...pubs/P-816.pdf

VFA-113 Stingers’ LSO Training Course
https://youtu.be/BbMw4PcvMyY

NATOPS Landing Signal Office Manual
http://www.navyair.com/LSO_NATOPS_Manual.pdf
The LSO Script attempts to provide you with as authentic of an experience as possible based on the publicly available information. Feedback for authenticity improvements are welcome.



--- USAGE: CASE I ------------------------------------------------------------------------

There are three methods to engage the LSO when in a CASE I recovery condition. I will go through each, from the simplest to the most involved procedure.

STRAIGHT-IN APPROACH

This is the simplest procedure to engage the LSO, where you are essentially flying straight into the groove and land on the CV. There will be no abeam checks to the CV or Long in the Groove calls. Note that you can only select this approach if there are no other aircraft in BOTH the Pattern or the Marshal Stack.
1 ) Tune in to the CV Marshal Frequency. To check the frequency, go to (F10) -> Carrier Menu -> (F1) Carrier Comm Information. Look for “Marshal Freq”.
2 ) Request for Straight-In Approach: (F10) -> Carrier Menu -> Find yourself (F5-F8) -> (F4) Request Straight-In.
3 ) If you are cleared for the approach, you will hear “[tail number] Signal Charlie Straight-In, Check-in Button [#]”. Then tune into the designated Button (Channel #) to hear the LSO calls.
4 ) If you are not cleared for the approach, you will hear “[tail number] Signal Delta, Request for Marshal”.
ENTER PATTERN APPROACH

This is the middle of the road procedure to engage the LSO, where you execute the CV overhead break pattern and the 180 turn to enter the groove. Note that you can only select this approach if there are no other aircraft in the Marshal (but may have other aircraft in the Pattern, so be vigilant when entering). The selection process is similar to the Straight-In Approach.
1 ) Tune in to the CV Marshal Frequency. To check the frequency, go to (F10) -> Carrier Menu -> (F1) Carrier Comm Information. Look for “Marshal Freq”.
2 ) Request for Enter Pattern Approach: (F10) -> Carrier Menu -> Find yourself (F5-F8) -> (F3) Request Enter Pattern.
3 ) If you are cleared for the approach, you will hear “[tail number] Signal Charlie Pattern, Check-in Button [#]”. Then tune into the designated Button (Channel #) to hear the LSO calls.
4 ) As you fly over the CV, you will hear “Check-in Clear” which will indicate that you are clear to engage the overhead break.
5 ) If you are not cleared for the approach, you will hear “[tail number] Signal Delta, Request for Marshal”.
MARSHAL APPROACH

This is the most involved procedure, but also the most satisfying when you complete the full sequence. The procedure requires you to request marshal from the CV, fly within the tolerance of the 5NM Marshal stack at your designated Angel (and change Angel as the stack collapses), exit the 5NM Marshal, and enter the Pattern. This approach can be done either as a Single Flight or as a Section (up to 2 flights).
1 ) Tune in to the CV Marshal Frequency. To check the frequency, go to (F10) -> Carrier Menu -> (F1) Carrier Comm Information. Look for “Marshal Freq”.
2 ) For Single Flight request for Marshal Approach: (F10) -> Carrier Menu -> Find yourself (F5-F8) -> (F1) Request Marshal Single.
3 ) For Sectional request for Marshal Approach: (F10) -> Carrier Menu -> Find yourself (F5-F8) -> (F2) Request Marshal Section. Note that your wingman needs to fly within 200ft from you to be counted as a Section.
4 ) If you are cleared for the approach, you will hear “[tail number #1] [tail number #2] Freedom Marshal, Angels [X]”.
5 ) Fly your designated Angels and hold a steady 5NM Marshal pattern above the CV (see the resources noted above for a description of this pattern).
6 ) If you hear “[tail number #1] [tail number #2] Push to Angels [X]”, it means that the Marshal stack has collapsed, and you (and your flight) have to push down One Angels to get Signal Charlie. Note that the verbal call will only be for flights in Angels Two, however, all flights must collapse to the appropriate Angel when this call is heard.
7 ) Signal Charlie will be called for you (and your flight) when you (the lead only) are approximately in between Position 2 and 3 to the CV, flying level at Angel Two, and with the correct corresponding heading in the 5 NM Marshal Stack turn. If you are cleared to enter the pattern, you will hear “[tail number #1] [tail number #2] Signal Charlie Pattern, Check-in Button [#]”. Then tune into the designated Button (Channel #) to hear the LSO calls.
8 ) As you fly over the CV, you will hear “Check-in Clear” which will indicate that you are clear to engage the overhead break.
If you or your squadron is interested in going through the procedure, please send me a private message and I’m happy to walk you through in Multi-player.



--- LSO CALLS AND GRADES ------------------------------------------------------------------------

DESCRIPTION

As released in the last version, the LSO calls will give you feedback based on two axes (altitude and line up). The LSO Script attempts to mimic human behaviors in both the level of intensity (corresponding to the amount of correction needed), the timing of the calls, and drift corrections.

In addition, the LSO Script provides you with a comprehensive grading report of all your passes and summarizes your performance using the common shorthand LSO notation below

Overall Grade:
_OK_ = OK Underline, OK = OK Pass, (OK) = Fair Pass, -- = No Grade, C = Cut Pass
B = Bolter, TCA = Too Close Abeam, TWA = Too Wide Abeam, INT = Incorrect Interval, WO = Wave-Off, WOP = Wave-Off Pattern, OWO = Own Wave-Off
Positions:
X = At Start, IM = In the Middle, IC = In Close, AR = At the Ramp
Aircraft Flight:
LUL = Line up Left, DL = Drifted Left, LUR = Line up Right, DR = Drifted Right
H = High, LO = Low, / = Fly through Glideslope (up), \ = Fly through Glidesope (down)
Aircraft Speed:
F = Fast, S = Slow
Others:
NC = Nice Correction, () = Slightly off-course
For Example:
(OK) 4 (LUL)X (LO)IM LODRIC NCAR
Means fair pass, 4 wire, slightly lined up left at the start, slightly low in the middle, low and drifted right in close, nice correction at the ramp.


FLIGHT PATH REVIEW (ADDED v2.5)

The LSO Script exports your flight track starting between the 90° and 3/4 mile ball call to a “.csv” file for plotting with Excel (see below on how to enable this). The track file exports both your aircraft line up and altitude with references to the error margins. Note that each individual unique aircraft flight track will be exported to the same file. Steps to automatically plot your landing flight path.
1 ) Unzip and place the “_Track Graph.xlsm” file into your “YOURNAME/Saved Games/DCS(.openbeta)/Mods/Alerax_LSO_AI” folder.
2 ) Open the “_Track Graph.xlsm”.
3 ) Press the “Run Plotting Macro”. You may need to enable content to allow the macro to run.
4 ) Once the Message Box shows “----COMPLETE----“, all your track files are plotted.
5 ) Open the track file in your “YOURNAME/Saved Games/DCS(.openbeta)/Mods/Alerax_LSO_AI” folder and enjoy!


GRADING EXPORT - For Server/Single-Player Only

The LSO Script has an ability to export your grade as a “.doc” file to you DCS Saved Games folder (specifically “YOURNAME/Saved Games/DCS(.openbeta)/Mods/Alerax_LSO_AI”). To enable this feature, there are several things you need to do.
1 ) For people who use JSGME, put the attached folder into your “_Mods” folder and enable it. Done.
2 ) For all others, go to “DCS INSTALLATION FOLDER/Scripts”
3 ) Open the filename “MissionScripting.lua” using Notepad++
4 ) Comment out the following two lines by placing “—“ in front of the line
• “sanitizeModule('io')” --> “--sanitizeModule('io')”
• “sanitizeModule('lfs')” --> “--sanitizeModule('lfs')”
[/////WARNING/////]
I would like to be completely transparent with this feature. The reason these steps are needed is because DCS prevents “.lua” script from reading/writing files for security reason. By commenting these two lines, you are effectively allowing this LSO Script (and any other script that you may knowingly or not knowingly run) to read/write files to your computer. As such, you are enabling a program to read/write your files at your own risk, and YOU are responsible for any issues, loss, or damages that may occur.
[/////WARNING/////]


CLARIFICATION: You DO NOT need to enable Grade Export capabilities for the LSO Script to provide its basic functions. This step is only if you WANT to and CHOOSE to have your grades exported to a file.


--- CLOSING ------------------------------------------------------------------------

Once again, I would like to reiterate my humble appreciation to the community for your positive responses and feedback with this LSO Script. This LSO Script is an accumulation of a lot of hours in the past months conceptualizing, researching, executing, testing, and reworking to get to where we are today. If you feel that this is a valuable addition to your flight simulation experience, I would encourage you to continue supporting the development of this LSO Script though constructive feedbacks and/or donation to the page the below. It really means a lot to me seeing how much this LSO Script adds value to the community.

Donate Link (PayPal)

I will continue to fix bugs and tweak the LSO Script as feedbacks roll in. One goal of mine is to build the Case II/III recovery in the same level of detail and complexity as you experience with the Case I. Stay tuned for the next major update!

Sincerely,
Alerax



--- FAQ ------------------------------------------------------------------------

Q: I can't see any menu items for this script?
A: This script only works for F/A-18C Hornet flying within the Carrier Airspace (40NM from Carrier). Support for other aircraft are being considered.

Q: I don’t hear any Marshal or LSO calls?
A: Make sure you are tuned into the correct corresponding frequencies (To check the frequency, go to (F10) -> Carrier Menu -> (F1) Carrier Comm Information. Look for “Marshal Freq” or “LSO Freq”). If you are using Easy Communication, you will not be able to hear the Marshal calls (due to limitations of DCS), but you can still hear the LSO calls if you call into the Stennis using the normal [ATC Selection] inbound call to “tune” your Hornet to the correct frequency.

Q: I get “Wait for current radio transmission to complete” after select call, what does this mean?
A: It means that you have to wait for current radio transmission to complete. To prevent overlapping calls, I had to add this requirement in so that there are no interruptions with the communications.

Q: Vaicom won't allow me to check in with Marshal?
A: Due to the way the script creates the menus dynamically for the flights, this is not currently working but we're working on it for a future update.

Q: I would like to integrate this LSO Script to my missions, and I’m concerned it will cause conflicts with [insert concerns]. Will it cause any issue?
A: As far as I’m aware, this script will not cause any conflict since I wrote it to be self-contained and not reliant on other inputs. If you do find issues, please let me know and I’m happy to address them.

Q: Can I use a Carrier name other than "Stennis_AI"?
A: Yes, just change the name on Line 37 in the script to whatever name you use in the Mission Editor and it will work.

Q: What is the default Marshal/Airboss Frequency and can you change this? How? (-Painter-)
A: The default Marshal/Airboss frequency is 305.000Mhz (default button 1 for the Hornet). Yes, this can be changed by editing Line 38 to whatever frequency you want. For example, 305000000 = 305.000 Mhz, 254000000 = 254.000 Mhz. The number is in hertz so just do the math to get it into the Mhz format.

Q: Will this script work with any (or dynamic) Carrier heading? (FSKRipper)
A: Yes, this script will work with any Carrier heading you set in the Mission Editor. It also has the ability to handle dynamic Carrier heading changes as well.

Q: Can I use this LSO Script in my Multi-player server?
A: Yes the script was written for both the single-player and multi-player environments. However, if you do use this I ask that you credit me and people involved appropriately and that you are not using this LSO Script for commercial purposes. Also, thanks to the VMFA-42 SabreTooths squadron, we have tested this script in the multi-player environment and confirmed that it is stable.

Q: Can I use this LSO Script in my mission/campaign/module/add-ons that I’m selling to others?
A: No.

Q: Can I use this LSO Script in my mission/campaign/module/add-ons that I’m releasing for free to the community?
A: Yes (and you are an awesome person, thanks for adding value to the community).

Q: How should mission designers credit you and your support team? (NeilWillis)
A: I'd suggest keeping the header in the script and something simple like "Credit: LSO AI Script, Author: Alerax" is plenty enough.


.
Attached Files
File Type: rar Alerax_LSO_AI_Script.rar (2.63 MB, 230 views)
File Type: rar 01 - Enable Script Export.rar (599 Bytes, 129 views)
File Type: rar _Track Graph.rar (33.5 KB, 115 views)
File Type: lua Alerax_LSO_Script_Release_v2.5.1.lua (144.5 KB, 230 views)
File Type: miz Alerax_LSO_Mission_v2.5.1.miz (2.69 MB, 200 views)

Last edited by Alerax; 04-08-2019 at 10:18 AM.
Alerax is offline   Reply With Quote
Old 11-01-2018, 12:29 AM   #2
Alerax
Junior Member
 
Join Date: Sep 2017
Posts: 93
Default

[Reserved]
Alerax is offline   Reply With Quote
Old 11-01-2018, 12:35 AM   #3
Highwayman-Ed
Senior Member
 
Highwayman-Ed's Avatar
 
Join Date: Nov 2005
Location: Melbourne, Australia
Posts: 1,377
Send a message via AIM to Highwayman-Ed
Default

It's been a pleasure to help you on this journey and we look forward to getting stuck into the CASE III recoveries!
__________________

Intel i7-7700k @4.8GHz
MSI Z270 Gaming Carbon Pro
32GB G.Skill Trident DDR3200 RAM
MSI 11GB GTX1080ti Founders Edition
40" Panasonic TH-40DX600U @ 4K
Oculus Rift CV1
Gametrix JetSeat with SimShaker
Windows 10 64 Bit Home Edition


Highwayman-Ed is offline   Reply With Quote
Old 11-01-2018, 12:52 AM   #4
kjohncampbell
Junior Member
 
Join Date: Jul 2015
Posts: 2
Default

Great job <Salute!>

JayCee
Intel i7-7700k @4.8GHz
32GB G.Skill Trident DDR3200 RAM
11GB GTX1080ti
Oculus Rift CV1
Gametrix JetSeat with SimShaker
Windows 10 64 Bit Pro
kjohncampbell is offline   Reply With Quote
Old 11-01-2018, 01:26 AM   #5
Strut
Member
 
Strut's Avatar
 
Join Date: Jul 2011
Location: NW of YWLM
Posts: 899
Default

Alerax I really appreciate what you blokes have done ! I always look forward to using your LSO scripts ! Thanks again!
__________________
Regards






Spoiler:
Win10 64bit, Intel(R) Core(TM) i7-5820K CPU OC @ 4.50GHz x6, X99A GAMING PRO CARBON, MSI GTX1080TI GAMING X TRIO 11Gb, 32GB DDR4 RAM, SSD 960 EVO250GB, SSD 850 EVO 500GB, JetSeat, MFG Crosswind Pedals, VPC Mongoose T-50, TMWH, DSD ButtonBox, Rift, Pimax 5k XR/BE
Strut is offline   Reply With Quote
Old 11-01-2018, 02:38 PM   #6
Furia
Veteran
 
Furia's Avatar
 
Join Date: Oct 2010
Posts: 914
Default

Brilliant!!! Thanks a lot Alerax!!

Nex Sunday my Virtual squadron is starting a long cuise campaing with the Hornet and we will surely use your script!
I really like the addition of exporting the grades. Need to eplore the possibility of creating a Greenie Board with this one.

Just one question, would the script work if I rename the carrier to something else than Stennis_AI but I also add that new name to the script lua?

Thanks a lot!!!
__________________
http://menorca.infotelecom.es/~raulurbina/ESA/banner_furia.png
Furia is offline   Reply With Quote
Old 11-01-2018, 02:45 PM   #7
canned_fire
Junior Member
 
Join Date: Aug 2016
Posts: 55
Default

Hi, sorry if this is a stupid question, but would the scrip work with the upcoming Community A-4?
Thanks for the work.
canned_fire is offline   Reply With Quote
Old 11-01-2018, 05:33 PM   #8
Grimes
ED Testers Team
 
Grimes's Avatar
 
Join Date: Jan 2006
Location: Black Mesa
Posts: 7,852
Default

Quote:
Originally Posted by Alerax View Post
GRADING EXPORT

The LSO Script has an ability to export your grade as a “.doc” file to you DCS Saved Games folder (specifically “YOURNAME/Saved Games/DCS(.openbeta)/Mods/Alerax_LSO_AI”). To enable this feature, there are several things you need to do.
1 ) For people who use JSGME, put the attached folder into your “_Mods” folder and enable it. Done.
2 ) For all others, go to “DCS INSTALLATION FOLDER/Scripts”
3 ) Open the filename “MissionScripting.lua” using Notepad++
4 ) Comment out the following two lines by placing “—“ in front of the line
• “sanitizeModule('io')” --> “--sanitizeModule('io')”
• “sanitizeModule('lfs')” --> “--sanitizeModule('lfs')”
[/////WARNING/////]
I would like to be completely transparent with this feature. The reason these steps are needed is because DCS prevents “.lua” script from reading/writing files for security reason. By commenting these two lines, you are effectively allowing this LSO Script (and any other script that you may knowingly or not knowingly run) to read/write files to your computer. As such, you are enabling a program to read/write your files at your own risk, and YOU are responsible for any issues, loss, or damages that may occur.
[/////WARNING/////]
That is asking a lot for code that is obfuscated. Sure its on people to heed your suggestion, but its on you for denying people to be able to verify for themselves the script isn't doing anything not advertised.
__________________
You can only tie the world record for lowest flight.
Current Projects: Scripting Wiki, Something...
Useful Links: Mission Scripting Tools MIST-(GitHub) MIST-(Thread), SLMOD for DCS 1.5/2.0, IADScript, Mission Editing Wiki!, Mission Building Forum
Grimes is offline   Reply With Quote
Old 11-01-2018, 05:58 PM   #9
Alerax
Junior Member
 
Join Date: Sep 2017
Posts: 93
Default

Quote:
Originally Posted by Furia View Post
Brilliant!!! Thanks a lot Alerax!!

Nex Sunday my Virtual squadron is starting a long cuise campaing with the Hornet and we will surely use your script!
I really like the addition of exporting the grades. Need to eplore the possibility of creating a Greenie Board with this one.

Just one question, would the script work if I rename the carrier to something else than Stennis_AI but I also add that new name to the script lua?

Thanks a lot!!!
Hi Furia- Hope you and your squadron have fun script in your campaign.

Yes, you can use a different Carrier name. Just change the "Stennis_AI" on Line 37 to any name you selected in the Mission Editor and it will work.

I'll add this the Q/A.

Enjoy!
Alerax
Alerax is offline   Reply With Quote
Old 11-01-2018, 06:01 PM   #10
Alerax
Junior Member
 
Join Date: Sep 2017
Posts: 93
Default

Quote:
Originally Posted by canned_fire View Post
Hi, sorry if this is a stupid question, but would the scrip work with the upcoming Community A-4?
Thanks for the work.
Hi canned_fire - unfortunately, the script only works with the F/A-18 Hornet. When other airframes (Tomcat) that can benefit from this script are released I'll make sure to support them.

-Alerax
Alerax is offline   Reply With Quote
Reply

Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump

All times are GMT. The time now is 04:47 PM. vBulletin Skin by ForumMonkeys. Powered by vBulletin®.
Copyright ©2000 - 2019, Jelsoft Enterprises Ltd.