Skip to content

Latest commit

 

History

History
368 lines (283 loc) · 17.2 KB

README.md

File metadata and controls

368 lines (283 loc) · 17.2 KB

CDM plugin V2.2

CDM is an Euroscope plugin based on the real life CDM tool that allows us to improve the departure flows at airports. CDM includes the following times:

  • EOBT: Estimated off block time.
  • TOBT: Target off block time.
  • TSAT: Target Start-Up Approval Time.
  • TTOT: Target Take Off Time.
  • TSAC: Target Start-Up Approval Communicated.
  • ASAT: Actual Start-Up Approval Time.
  • ASRT: Actual Start-Up Request Time.
  • CTOT: Calculated Take Off Time.

How to use:

  • Load up the plugin.

  • If there is no master controller, you should use the command .cdm master {airport} of the airport you want to become the master. You can have as many airport as you want, but there can ony be 1 MASTER at the same time (The MASTER should be DELIVERY or the lowest ATC position to have access to all CDM actions).

  • Add The following items to the departure list with their actions:

  • EOBT

    • image

      or

    • image

  • E

    • image
  • TOBT

    • image

      or

    • image

  • TSAT

    • image
  • TTOT

    • image
  • TSAC

    • image

      or

    • image

  • ASAT

    • image
  • ASRT

    • image
  • CTOT

    • image

      or

    • image

  • Ready Start-up

    • image
  • Extra (All CDM Option in one Menu)

    • image

MASTER AND SLAVE:

  • Master: The master is the "admin" of the CDM and is the only controller who calculates the times (TSAT, TTOT and ASRT)
    • Use .cdm master {airport} command (TO LET THE CDM DO IT'S JOB, ONLY 1 CONTROLLER CAN BE THE MASTER AT THE SAME TIME).
  • Slave: The Slave Monitors the CDM and has some limited actions.
    • Default type, so, you don't need to change anything unless you are now a master, where you can use .cdm slave {airport} command.

HOW TO DO A CONTROLLER CHANGE CORRECTLY:

  1. Check to have the same CDMconfig.xml and taxizones.txt configuration, otherwise it won't work correctly.
  2. The Old controller changes to Slave with command .cdm slave.
  3. Once there are no master controllers, the new controlles gets the master "rol" with the command .cdm master {airport}.
  4. That's it!

Define configurations

Colors.txt

  • color1 = DARK GREEN
  • color2 = LIGHT GREEN
  • color3 = GREY
  • color4 = ORANGE
  • color5 = YELLOW
  • color6 = DARKYELLOW
  • color7 = RED
  • color8 = EOBT STATIC COLOR
  • color9 = TTOT STATIC COLOR
  • color10 = ASRT STATIC COLOR
  • color11 = CTOT STATIC COLOR
  • color12 = CHANGES TOBT, TSAT and ASAT to the defined color WHEN S/U STATUS IS SET

CDMconfig.xml

  • Normal Visibility Operations Rate/hour (ex. rate ops="40").
  • Low Visibility Operations Rate/hour (ex. rateLvo ops="10").
  • Expired CTOT time, it selects the time before expire the CTOT if the pilot is not connected (ex. expiredCtot time="15").
  • Real Mode to calculate times automatically from the sent EOBT (DISABLED: realMode mode="false" and ENABLED: realMode mode="true").
  • Invalidate flight at tsat will invalidate flights at TSAT+6 (ex. invalidateAtTsat mode=true).
  • ReaMsg (ex. minutes="0"). - It sets the time to add for the "Send Rea Message" function.
  • [OPTIONAL] Rates URL (ex. Rates url="https://........"), if no URL needed, just leave it blank (ex. Rates url="") and the file will be used.
  • [OPTIONAL] Taxizones URL (ex. Taxizones url="https://........"), if no URL needed, just leave it blank (ex. Taxizones url="") and the file will be used.
  • Default Taxi time in minutes if taxi time not found in the taxizones.txt file (ex. DefaultTaxiTime minutes="15").
  • Refresh Time in seconds (ex. RefreshTime seconds="20").
  • Debug mode activated (true) or desactivated (false) (ex. Debug mode="false" or Debug mode="true").
  • [OPTIONAL] Event CTOTs URL to the TXT file - Format is defined below (ex. Ctot url:"https://...."), if no URL needed, just leave it blank (ex. Ctot url="").
  • VDGS file type: 1-TXT, 2-JSON, 3-TXT&JSON (ex. vdgsFileType type="3").
  • [OPTIONAL] FTP host to push CDM Data (ex. ftpHost host:"ftp.aaaaaa.com") - leave it blank if not in use "".
  • [OPTIONAL] FTP user to push CDM Data (ex. ftpUser user:"username") - leave it blank if not in use "".
  • [OPTIONAL] FTP password to push CDM Data (ex. ftpPassword password:"&&&&&&") - leave it blank if not in use "".
  • SU_WAIT sets a remark in FlightStrip for external use when ready TOBT is pressed (ex. Su_Wait mode="false" or Su_Wait mode="true").

taxizones.txt

  • You can define a zone with an specific taxiTime with the following specifications AIRPORT:RUNWAY:BOTTOM_LEFT_LAT:BOTTOM_LEFT_LON:TOP_LEFT_LAT:TOP_LEFT_LON:TOP_RIGHT_LAT:TOP_RIGHT_LON:BOTTOM_RIGHT_LAT:BOTTOM_RIGHT_LON:TAXITIME, ex:LEBL:25L:41.286876:2.067318:41.290236:2.065955:41.295688:2.082523:41.292662:2.084613:10, if no taxizone defined, the default taxi time is set to 15 min.

rate.txt

Format: AIRPORT:A:ArrRwyList:NotArrRwyList:D:DepRwyList:NotDepRwyList:DependentRwyList:Rate_RateLvo

- ArrRwyList -> Comma-separated list of runways (If more than 1, it will use if one, other or all selected). Enter * to disregard.

- NotArrRwyList -> Comma-separated list of runways. Enter * to disregard.

- DepRwyList -> Comma-separated list of runways (If more than 1, it will use if one, other or all selected). Enter * to disregard.

- NotDepRwyList -> Comma-separated list of runways. Enter * to disregard.

- DependentRwyList -> Comma-separated list of runways (it will use the same sequence order for runways selected here). Enter * to disregard.

- Rate_RateLvo -> Normal Rate and LVO Rate. If more than one departure runways, you can define more than one rate separated by comma.

Examples:

- `LEPA:A:24L:*:D:24R,24L:*:24L,24R:30_12` (1 arr runway, 1 dep runway, 24R/L as dependant. 1 rate defined for all departures).

- `LEPA:A:24L:24R:D:24R,24L:*:*:30_12,20_7` (1 arr runway, 1 non-arrival runway, 2 dep runway, dep runways as independant, different rates defined for both dep runways).

- `LEPA:A:*:*:D:*:*:*:30_12` (All departures would have the same rate, doesn't matter the selected runways).

Internal Checks:

A line will be "activated" based on:

  • Runway assigned to the plane. (This runway should be in the DepRwyList list of the line. Which must comply with the below point).

  • Runways selected in Euroscope's Runway selector dialog (if the selected runways are in the line. If more runways in the line than selected in ES, but the selected are as DepRwyList in the line, it will be activated too).


Important points

  • Order of the configurations/rates is important (first line more important than last).
  • AIRPORTS NOT DEFINED, WILL NOT BE CONSIDERED A CDM AIRPORT.
  • Examples can be found in the givenfiles.

Examples can be found in the givenfiles.

Event CTOTs

How does it work?

Used for the EVCTOT column with the following format: ,

Example:

ETH2504,0800
JST3,0802
HFO184,0804
ASY121,0806
DTK454,0808
QTR119,0820
SVA247,0822
MS47,0824
DTK379,0828
DHL204,0836
QTR454,0840
CFG1MA,0842
UAL422,0844

FTP files and format

Files

Every airport will have a different txt file (ex. LEBL airport: CDM_data_LEBL.txt)

TXT Format

CALLSIGN,TOBT,TSAT,TTOT,CTOT,FlowRestrictionMessage,

BAW224,183600,183600,184400,ctot,flowRestriction,
RYR22GV,183600,183700,184600,ctot,flowRestriction,
MON562,183600,183700,184800,ctot,flowRestriction,
IBE73RT,183600,184000,185000,ctot,flowRestriction,
IBE51D,183600,184200,185200,ctot,flowRestriction,
IBE3540,183600,184400,185400,ctot,flowRestriction,
EXS15G,183600,184900,185600,ctot,flowRestriction,
EXS12,183600,184700,185800,1922,London Event,
MON837,183600,185200,190000,ctot,flowRestriction,
RYR33P,183600,185200,190200,ctot,flowRestriction,
MON235N,183600,185300,190400,ctot,flowRestriction,
EZY12JM,183600,185600,190600,ctot,flowRestriction,
RYR42TQ,183600,185700,190800,ctot,flowRestriction,
BEE154A,183600,190000,191000,1924,London Event,

JSON Format

{
   "version":1,
   "flights":[
      {
         "lat":41.2923,
         "lon":2.09795,
         "icao_type":"A320",
         "callsign":"CFG7521",
         "flight":"CFG7521",
         "tobt":"1910",
         "tsat":"1910",
         "runway":"24L",
         "sid":"MOPAS5Q"
      },
      {
         "lat":41.2915,
         "lon":2.07371,
         "icao_type":"A320",
         "callsign":"BAW483B",
         "flight":"BAW483B",
         "tobt":"1913",
         "tsat":"1913",
         "runway":"24L",
         "sid":"MOPAS5Q"
      }
   ]
}

CAD - Capacity Availability Document

On this Document (https://raw.githubusercontent.com/rpuig2001/Capacity-Availability-Document-CDM/main/CAD.txt) there are the capacities for the arrival airports. The CDM will separate aircrafts with the same destination by the rate specified in the CAD creating a CTOT with the Flow Message (FM) of "ARR CAP" (If the arrival rate is less than the departure airport and NO Flow Measures are in force)). The data from the CAD will be refreshed every 5 minutes (Same as the Flow Measures).

For more information, check the CAD GitHub Repository. https://github.com/rpuig2001/Capacity-Availability-Document-CDM

Commands

  • .cdm reload - Reloads all CDM plugin configs and taxizones file.
  • .cdm refresh - Force the refresh phase to do it now.
  • .cdm save - Saves data to savedData.txt.
  • .cdm load - Loads savedData.txt.
  • .cdm master {airport} - Become the master of the selected airport.
  • .cdm slave {airport} - Turn back to slave of the selected airport.
  • .cdm refreshtime {seconds} - It changes the refresh rate time in seconds (Default 30, MAX 99 Seconds).
  • .cdm delay {minutes} - Adds delay minutes to all traffics that have a TSAT greater then now. (it doesn't apply if TSAT has already passed) - WAIT SOME SECONDS TO UPDATE AFTER APPLIED.
  • .cdm customdelay {airport}/{runway} {time_start} - Moves all TSATs for selected airport and runway from the starting at the time_start (time_start can be a 4 digits time (2114 - 21:14 time) or 1/2 digits minutes (5 - 5min or 10 - 10 min) - WAIT SOME SECONDS TO UPDATE AFTER APPLIED. (Ex1. .cdm customdelay LEBL/24L 1100 -> All TSATs from LEBL rwy 24L will start at 1100 // Ex2. .cdm customdelay LEBL/24L 10 -> All TSATs will start at now+10 min). To remove the "restriction" use -> ".cdm customdelay LEBL/24L 9999" (using 9999 as time).
  • .cdm lvo - Toggle lvo ON or OFF.
  • .cdm realmode - Toggle realmode ON or OFF.
  • .cdm remarks - Toggle set TSAT to Euroscope scratchpad ON or OFF.
  • .cdm rates - Updates rates values from rate.txt.
  • .cdm flow - Reloads the flow data (Otherwise it's automatically reloaded every 5 min).
  • .cdm help - Sends a message with the available commands.

Functions and colors:

  • Column EOBT: It gets the EOBT set by the pilot in the flightplan.

    • NOTES:
      • If RealMode is enabled, when the pilot send a new EOBT, then it will show with color4 (Default ORANGE) when EOBT is different than TOBT.
    • Functions
      • Edit EOBT -> Sets EOBT to the specified time (4 digits).
    • Colors:
      • color8 -> Default.
  • Column TOBT: If realMode is disabled, TOBT will calculate TSAT and TTOT from the TOBT time. To delete it simple edit the time and press enter deleting the content.

    • NOTES:
      • If there is no ASRT or "Ready Start-up GREEN", at TOBT+5, TSAT and other times will be invalidated.
      • To add a TOBT while realMode is DISABLED, use the Ready TOBT Function to set the actual time as a TOBT or the Edit TOBT to set a 4 digits time.
      • If realMode is enable it will ONLY set the EOBT as TOBT when the first flightplan is recived, if the EOBT is changed the TOBT will not change automatically and you can use other functions such as the EOBT to TOBT Function to move it through. (EOBT will have a different color to say you that there's a new time sent by the pilot).
    • Functions:
      • Ready TOBT -> Sets TOBT to the actual time.
      • Edit TOBT -> Sets TOBT to the specified time (4 digits).
    • Colors:
      • #8fd894 LIGHT GREEN ->
      • #00c000 DARK GREEN -> After EOBT-5.
  • Column E: It shows a letter depending on the plane timmings:

    • Functions:
      • NO FUNCTIONS.
    • Colors:
      • #00c000 DARK GREEN -> Default.
    • TEXT SHOWING:
      • P: EOBT is farther than the Actual Time - 35min. TSAT, TTOT and TOBT will be showing the following character "~~" (To order them to the end of the list).
      • C: EOBT is less than 35min and TOBT hasn't expired (TOBT+6) or TSAT hasn't expired (TSAT+6).
      • I: TSAT has expired.
  • Column TSAT: It is the TTOT - the taxi time defined in the taxizones.txt, otherwise it sets 15min.

    • Functions:
      • NO FUNCTIONS.
    • Colors:
      • #8fd894 LIGHT GREEN -> From EOBT-35 to TSAT-5 and after TSAT+6 if not expired.
      • #00c000 DARK GREEN -> From TSAT-5 to TSAT+5.
      • #f5ef0d YELLOW -> From TSAT+5 to TSAT+6.
  • Column TTOT: The plugin calculates a TSAT based on this column, the TTOT, you can't have planes with same TTOT, the time between departures is calculated from the rate/hour. So if you need 40 departures/hour, the plugin will calculate it for you with no equal TTOTs.

    • Functions:
      • Edit/Set custom CDT -> Sets CDT as desired if CDT is available (for example, if a CDT is already used by another pilot TTOT, it would not be set as it's already in use).
    • Colors:
      • color9 -> Default.
  • Column TSAC: With the left click you can directly set the tsat and with the right click you can remove it or set the time you want. If this field is +/- 5min that the TSAT, the color change to orange to indicate that his TSAT has changed more than 5min.

    • Functions:
      • NO FUNCTIONS.
    • Colors:
      • #00c000 DARK GREEN -> If between +/- 5min of TSAT.
      • #ed852e ORANGE -> If +/- 5min of TSAT.
  • Column ASAT: It sets the time when ST-UP, TAXI or DEPA state is set on the first time.

    • Functions:
      • NO FUNCTIONS.
    • Colors:
      • #00c000 DARK GREEN -> If actual time < ASAT - 5min.
      • #f5ef0d YELLOW -> From ASAT+5 to always.
  • Column ASRT: It shows the requested StartUp time, It can be added to the list with the toggle function or sending a REA Msg.

    • Functions:
      • Toggle ASRT -> Sets RSTUP/ASRT or removes it if already set.
    • Colors:
      • color10 -> Default.
  • Column Ready Start-up: It shows if the plane is Ready for Start-up or not together with the ASRT. (ASRT and Ready Start-up do the same, but this column is a way to represent the real "ready start-up" state from IRL because Euroscope doesn't have this state).

    • Functions:
      • Toggle Ready Start-up function -> Sets RSTUP/ASRT or removes it if already set.
    • Colors:
      • #00c000 GREEN -> RSTUP is set.
      • #BE0000 RED -> RSUP is NOT set.
  • Column CTOT: It shows aircraft's CTOT which can be added, modified, removed or reloaded.

    • Functions:
      • Send REA Msg -> It will be contarntly looking for a better CTOT every refreshtime when this is checked.
      • Remove from REA Msg -> It will keep ctot and will not look for a better CTOT anymore.
      • Set/Remove MANUAL CTOT -> It creates or removes a CTOT for the user (Only CTOTs where TSAT>now+5min are allowed).
    • Colors:
      • color11 -> Default.
      • #f5ef0d YELLOW -> REA Msg is sent.
      • #ed852e ORANGE -> MANUAL/EVENT CTOT.
      • #BE0000 RED -> MANUAL/EVENT CTOT and Flow/CAD CTOT.
  • Column EvCTOT: It show ctots provided by ctot file (ctot.txt).

    • Functions:
      • Add Event CTOT as MAN CTOT -> Set the CTOT of the tfc as a Manual CTOT (For events such as CTL or CTP) - (CTOT will only be set when CTOTs where TSAT>now+5min).
    • Colors:
      • #00c000 GREEN -> Default.