MOOSE generated documentation [skip ci]

This commit is contained in:
Applevangelist
2022-10-29 08:17:27 +00:00
parent 0f55b75634
commit c2cbd9d497
77 changed files with 1913 additions and 1872 deletions
+17 -17
View File
@@ -1617,7 +1617,7 @@ Controls a network of short range air/missile defense groups.</p>
<li>Setup quickly an AIR defense system for a coalition.</li>
<li>Setup multiple defense zones to defend specific coordinates in your battlefield.</li>
<li>Setup (SEAD) Suppression of Air Defense squadrons, to gain control in the air of enemy grounds.</li>
<li>Setup (CAS) Controlled Air Support squadrons, to attack closeby enemy ground units near friendly installations.</li>
<li>Setup (CAS) Controlled Air Support squadrons, to attack close by enemy ground units near friendly installations.</li>
<li>Setup (BAI) Battleground Air Interdiction squadrons to attack remote enemy ground units and targets.</li>
<li>Define and use a detection network controlled by recce.</li>
<li>Define AIR defense squadrons at airbases, FARPs and carriers.</li>
@@ -1635,7 +1635,7 @@ Controls a network of short range air/missile defense groups.</p>
<h2>Missions:</h2>
<p><a href="https://github.com/FlightControl-Master/MOOSE_MISSIONS/tree/master/AID%20-%20AI%20Dispatching/AID-AIR%20-%20AI%20AIR%20Dispatching">AID-AIR - AI AIR Dispatching</a></p>
<p><a href="https://github.com/FlightControl-Master/MOOSE_MISSIONS/tree/master/AID%20-%20AI%20Dispatching">AID-AIR - AI AIR Dispatching</a></p>
<hr/>
@@ -1701,7 +1701,7 @@ to set the ROE for these recce to hold weapons, and make them invisible from the
<h2>4. How do the defenses decide <strong>when and where to engage</strong> on approaching enemy units?</h2>
<p>The AIR dispacher needs you to setup (various) defense coordinates, which are strategic positions in the battle field to be defended.
<p>The AIR dispatcher needs you to setup (various) defense coordinates, which are strategic positions in the battle field to be defended.
Any ground based enemy approaching within the proximity of such a defense point, may trigger for a defensive action by friendly air units.</p>
<p>There are 2 important parameters that play a role in the defensive decision making: defensiveness and reactivity.</p>
@@ -1721,7 +1721,7 @@ the higher the probability will be that a defense action will be launched!</p>
<h2>5. Are defense coordinates and defense reactivity the only parameters?</h2>
<p>No, depending on the target type, and the threat level of the target, the probability of defense will be higher.
In other words, when a SAM-10 radar emitter is detected, its probabilty for defense will be much higher than when a BMP-1 vehicle is
In other words, when a SAM-10 radar emitter is detected, its probability for defense will be much higher than when a BMP-1 vehicle is
detected, even when both enemies are at the same distance from a defense coordinate.
This will ensure optimal defenses, SEAD tasks will be launched much more quicker against engaging radar emitters, to ensure air superiority.
Approaching main battle tanks will be engaged much faster, than a group of approaching trucks.</p>
@@ -1730,12 +1730,12 @@ Approaching main battle tanks will be engaged much faster, than a group of appro
<h2>6. Which Squadrons will I create and which name will I give each Squadron?</h2>
<p>The AIR defense system works with <strong>Squadrons</strong>. Each Squadron must be given a unique name, that forms the <strong>key</strong> to the squadron.
Several options and activities can be set per Squadron. A free format name can be given, but always ensure that the name is meaningfull
Several options and activities can be set per Squadron. A free format name can be given, but always ensure that the name is meaningful
for your mission, and remember that squadron names are used for communication to the players of your mission.</p>
<p>There are mainly 3 types of defenses: <strong>SEAD</strong>, <strong>CAS</strong> and <strong>BAI</strong>.</p>
<p>Suppression of Air Defenses (SEAD) are effective agains radar emitters. Close Air Support (CAS) is launched when the enemy is close near friendly units.
<p>Suppression of Air Defenses (SEAD) are effective against radar emitters. Close Air Support (CAS) is launched when the enemy is close near friendly units.
Battleground Air Interdiction (BAI) tasks are launched when there are no friendlies around.</p>
<p>Depending on the defense type, different payloads will be needed. See further points on squadron definition.</p>
@@ -1795,7 +1795,7 @@ AIR defenses can come immediately into action.</p>
<h2>12. Are moving defense coordinates possible?</h2>
<p>Yes, different COORDINATE types are possible to be used.
The COORDINATE_UNIT will help you to specify a defense coodinate that is attached to a moving unit.</p>
The COORDINATE_UNIT will help you to specify a defense coordinate that is attached to a moving unit.</p>
<h2>13. How much defense coordinates do I need to create?</h2>
@@ -1835,7 +1835,7 @@ close or greater distance from the defense coordinate.</p>
<li>From a parking spot with cold engines</li>
</ul>
<p><strong>The default takeoff method is staight in the air.</strong>
<p><strong>The default takeoff method is straight in the air.</strong>
This takeoff method is the most useful if you want to avoid airplane clutter at airbases!
But it is the least realistic one!</p>
@@ -1859,10 +1859,10 @@ But it is the least realistic one!</p>
<p>For each Squadron, depending on the helicopter or airplane type (modern, old) and payload, which overhead is required to provide any defense?</p>
<p>In other words, if <strong>X</strong> enemy ground units are detected, how many <strong>Y</strong> defense helicpters or airplanes need to engage (per squadron)?
<p>In other words, if <strong>X</strong> enemy ground units are detected, how many <strong>Y</strong> defense helicopters or airplanes need to engage (per squadron)?
The <strong>Y</strong> is dependent on the type of airplane (era), payload, fuel levels, skills etc.
But the most important factor is the payload, which is the amount of AIR weapons the defense can carry to attack the enemy ground units.
For example, a Ka-50 can carry 16 vikrs, that means, that it potentially can destroy at least 8 ground units without a reload of ammunication.
For example, a Ka-50 can carry 16 vikrs, that means, that it potentially can destroy at least 8 ground units without a reload of ammunition.
That means, that one defender can destroy more enemy ground units.
Thus, the overhead is a <strong>factor</strong> that will calculate dynamically how many <strong>Y</strong> defenses will be required based on <strong>X</strong> attackers detected.</p>
@@ -1912,7 +1912,7 @@ The defense system work through the definition of defense coordinates, which are
Multiple defense coordinates can be setup. Defense coordinates can be strategic or tactical positions or references to strategic units or scenery.
The AIR dispatcher will evaluate every x seconds the tactical situation around each defense coordinate. When a defense coordinate
is under threat, it will communicate through the command center that defensive actions need to be taken and will launch groups of air units for defense.
The level of threat to the defense coordinate varyies upon the strength and types of the enemy units, the distance to the defense point, and the defensiveness parameters.
The level of threat to the defense coordinate varies upon the strength and types of the enemy units, the distance to the defense point, and the defensiveness parameters.
Defensive actions are taken through probability, but the closer and the more threat the enemy poses to the defense coordinate, the faster it will be attacked by friendly AIR units.</p>
<p>Please study carefully the underlying explanations how to setup and use this module, as it has many features.
@@ -1961,7 +1961,7 @@ when these groups are spawned in or destroyed during the ongoing battle.
By spawning in dynamically additional recce, you can ensure that there is sufficient reconnaissance coverage so the defense mechanism is continuously
alerted of new enemy ground targets.</p>
<p>The following example defens a new reconnaissance network using a <a href="Functional.Detection.html##(DETECTION_AREAS)">Functional.Detection#DETECTION_AREAS</a> object.</p>
<p>The following example defense a new reconnaissance network using a <a href="Functional.Detection.html##(DETECTION_AREAS)">Functional.Detection#DETECTION_AREAS</a> object.</p>
<pre><code> -- Define a SET_GROUP object that builds a collection of groups that define the recce network.
-- Here we build the network with all the groups that have a name starting with CCCP Recce.
@@ -2118,7 +2118,7 @@ while defining which helicopter or plane <strong>templates</strong> are being us
</ul>
<p>The method <a href="##(AI_AIR_DISPATCHER).SetSquadron">AI_AIR_DISPATCHER.SetSquadron</a>() defines for you a new squadron.
The provided parameters are the squadron name, airbase name and a list of template prefixe, and a number that indicates the amount of resources.</p>
The provided parameters are the squadron name, airbase name and a list of template prefixes, and a number that indicates the amount of resources.</p>
<p>For example, this defines 3 new squadrons:</p>
@@ -2282,7 +2282,7 @@ If this parameter is not specified, then the default altitude will be used for t
<p>Depending on the demand of requested takeoffs by the AIR dispatcher, an airfield can become overloaded. Too many aircraft need to be taken
off at the same time, which will result in clutter as described above. In order to better control this behaviour, a takeoff scheduler is implemented,
which can be used to control how many aircraft are ordered for takeoff between specific time intervals.
The takeff intervals can be specified per squadron, which make sense, as each squadron have a "home" airfield.</p>
The takeoff intervals can be specified per squadron, which make sense, as each squadron have a "home" airfield.</p>
<p>For this purpose, the method <a href="##(AI_AIR_DISPATCHER).SetSquadronTakeOffInterval">AI_AIR_DISPATCHER.SetSquadronTakeOffInterval</a>() can be used to specify the takeoff intervals of
aircraft groups per squadron to avoid cluttering of aircraft at airbases.
@@ -3519,7 +3519,7 @@ of the squadron will be destroyed. This to keep consistency of air operations no
<tr class="w3-border">
<td class="name w3-half w3-container" style="word-wrap: break-word"><p><a href="##(AI_AIR_DISPATCHER).AddProcess">AI_AIR_DISPATCHER:AddProcess(From, Event, Process, ReturnEvents)</a></p></td>
<td class="summary w3-half w3-container" style="word-wrap: break-word">
<p>Set the default <a href="Process.html">Process</a> template with key ProcessName providing the ProcessClass and the process object when it is assigned to a <a href="Wrapper.Controllable.html">Wrapper.Controllable</a> by the task.</p>
<p>Set the default <a href="##(FSM_PROCESS)">#FSM_PROCESS</a> template with key ProcessName providing the ProcessClass and the process object when it is assigned to a <a href="Wrapper.Controllable.html">Wrapper.Controllable</a> by the task.</p>
</td>
</tr>
<tr class="w3-border">
@@ -5885,7 +5885,7 @@ The Detection object is polymorphic, depending on the type of detection object c
<div class="w3-row w3-margin-left w3-border-bottom w3-border-l2">
<div class="w3-half">
<p>
<a href="Tasking.Task_AIR.html##(AI_AIR)">Tasking.Task_AIR#AI_AIR</a>
<a href="AI.AI_Air.html##(AI_AIR)">AI.AI_Air#AI_AIR</a>
<strong><strong>Task</strong></strong>
</p>
</div>
@@ -11378,7 +11378,7 @@ multiplied by the Overhead and rounded up to the smallest integer. </p>
<h2><a id="#(AI_AIR_DISPATCHER).AddProcess" ><strong>AI_AIR_DISPATCHER:AddProcess(From, Event, Process, ReturnEvents)</strong></a></h2>
</div>
<p>Set the default <a href="Process.html">Process</a> template with key ProcessName providing the ProcessClass and the process object when it is assigned to a <a href="Wrapper.Controllable.html">Wrapper.Controllable</a> by the task.</p>
<p>Set the default <a href="##(FSM_PROCESS)">#FSM_PROCESS</a> template with key ProcessName providing the ProcessClass and the process object when it is assigned to a <a href="Wrapper.Controllable.html">Wrapper.Controllable</a> by the task.</p>
<div id= "#Functions##AddProcess" class="w3-show w3-white">
<div class="w3-container w3-white" id="functiontype">