Home

eDEP User Guide eDEP - EUROCONTROL Experimental Centre

1. eDEP Reference GL eDEP USER 1 1 13 Keyword Data description Data type Mandatory amp comments CRUISE CAS Cruise speed in knots int y DATALINK STA Whether aircraft is b ol ati a TUS datalink equipped ASAS Capability ASAS capability n ADS B Equipment Au n status Whether aircraft is RVSM_STATUS RVSM equipped boolean n FAIL NUMBER 12 Pumberofths String y aircraft AIRLINE Airline name String n SID optional Sequence of ROUTE Flight route CONTROL _ POINT and y or ROUTE_SEGMENT STAR optional Page 45 of 63 eDEP Reference GL eDEP USER 1 1 13 6 2 2 Control Point Syntax The control point syntax is essentially the same as that for points currently defined in the GSDK trajectory The syntax starts with a compulsory name and can describe the point as an explicit latitude or longitude or can use the given fix name to retrieve a location It can also define optional level and speed values which will supersede any RFL or letters of agreement The following provide valid examples of control point syntax CONTROL_POINT FIX SPRAT CAS SPEED 400 SPRAT with speed CONTROL_POINT FIX REDFA FLIGHT LEVEL 290 REDFA with FL 290 CONTROL POINT FIX DCS MACH SPEED 0 9 FLIGHT_LEVEL 290 DCS with speed and altitude CONTROL POINT 53 855928 1 739048 FLIGHT LEVEL 310 Unnamed point CONTROL_POINT FIX DSL DSL There is no facility to implicitly create a new fix thro
2. lt contextName gt MTCD ENABLED True if MTCD is enabled in the client service with the given TRUE If the MTCD server is running then the probe may still be used lt contextName gt TRAJECTORY _TAG The tag of the trajectory subscribed to by the MTCD server Flight GROU with the given context name ND_TAG lt contextName gt CONFLICT CLASS The class of the Conflict generated by the MTCD server with atc mtcd entit the given context name y Conflict lt context name gt CONFLICT RISK_SETTER CLASS The name of the class used in the client with the given atc mtcd clien context name for calculating risk associated with conflicts t entity flight ConflictRiskS etterImpl lt lt contextName gt LOOKAHEAD_ TIME The look ahead time in seconds for which conflicts should be 1200 0 detected lt MTCD gt SEPARATION THRESHOLD The horizontal separation threshold in nautical miles 5 0 lt contextName The horizontal separation threshold in Nautical Miles beneath 15 0 gt CONTEXTUAL_SEPARATION_THRESHOLD which an aircraft is deemed Contextual for the subject aircraft lt contextName gt UPDATE_INTERVAL The update interval in seconds between MTCD calculations 5 0 lt MTCD gt RISK_UPPER_VERTICAL_SEPARATIO The number of levels 100 s of feet added to the standard 30 N_THRESHOLD vertical separation upper non RVSM airspace in order to detect aircraft that may potentially be a risk if the aircraft changes the CFL to the RFL or XFL
3. lt TP gt RATE_1 The angular rate at which the aircraft turns in degrees per 3 degrees sec second lt TP gt USE_RATE_1_CEILING States that rate 1 will only apply below the limiting altitude FALSE ceiling see RATE_1_CEILING lt TP gt RATE_1_CEILING The maximum altitude at which rate 1 applies Above this 10 000 0 ft level the radius increases according tp lt TP gt CLIMB_SPEEDS The default list of climb speeds to taper the speed in the initial climb below 10 000ft lt level gt lt knots gt lt TP gt DESCENT_SPEEDS The default list of descent speeds to taper the speed in the final descent below 10 000ft lt level gt lt knots gt component TP SERVER The name of the TP server that should be accessed by the TP local application s TrajectoryService TISB Component DEBUG_REPORT_CAT62 Sets debug report messages for CAT62 messages FALSE FILTER_ON_SERVICE_VOLUMES Defines whether service volume filtering is enabled FALSE SERVICE_VOLUMES List of Service Volumes to use UDP FORWARDING_CAT62_CONNECTIONS Defines the names of the external UDP channels to forward TISB Category 62 messages to Note These connections must be defined in the TISB EXTERNAL CONNECTIONS resource UDP FORWARDING_CAT62 Enables forwarding of ASTERIX Category 62 messages via FALSE UDP UDP FORWARDING_CAT62_DEBUG Sets forwarding debug output for Asterix Category 62 UDP FALSE forwarding EXTERNAL CONNECTIONS Defines UDP connections to external clients
4. ASP SCENARIO_READER Defines which parser framework is to be used to read in the scenario data The value is normally Page 19 of 63 eDEP Reference GL eDEP USER 1 1 13 gsdk scenario ScenarioReaderlmpl ASP MIDDLE_MARKER_POSITION The position relative to an ILS Ladder at which the dotted 8 Nm lockon box is drawn for example a value of 6 means the dotted lockon box is drawn on the 6 rung of the ladder counting away from the runway ASP OUTER_MARKER POSITION The length of the area Nm in which an aircraft can lockon 13Nm defines the dotted box at the start of an ILS Ladder ASP LOCKON_WIDTH The width of the area Nm in which an aircraft can lockon 1Nm defines the dotted box at the start of an ILS Ladder ASP LOCKON_HEIGHT The maximum height ft an aircraft can lockon at 3000ft ASP REDUCE_SPEED_DISTANCE The distance from the runway that the aircraft should reduce 4Nm speed in Nm ASP FINAL_APPROACH_SPEED Returns the final approach speed for a B744 in knots 150Knots ACR Performance Component ACR SCENARIO_READER Defines which parser framework is to be used to read in the aircraft performance data If the program is reading BADA data with online conversion this should be atc performance server BadaScenarioReaderImp otherwise gsdk scenario ScenarioReaderlmpl ACR SCENARIO Defin
5. GSDK SPEED_VECTOR_BUTTONS GSDK NUMBER_OF_ TRACK HISTORY BU TTONS GSDK TRACK HISTORY BUTTONS IMAGES LABEL DEBUG LOGICAL_COLOURS PHYSICAL_COLOURS TRANSPARENCY PVD NORMAL_COLOUR FILL_SOLID PVD RTB EXTENDED RADAR TOOLBOX Options are NONE and SINGLE_RECTANGLE Defines the maximum number of dirty redraw rectangles allowed before a full redraw is 16ctioned Defines if J2SE 1 4 support for Volatile Images may be used Defines if Volatile Images are to be used throughout the graphics display For use with non transparent displays only Defines the heading number format By default 3 digits are output for the heading value Defines the range number format By default 3 digits filled with spaces are output for the range value Defines the graduation step value used when calculating the heading value By default a value of 5 is used Setting the value to 1 prevents the rounding of the heading value allowing a number of decimal places to be specified in the HEADING_FORMAT_CHAR resource item Defines a sensitive margin in pixels around a menu It is used to trigger a menu destruction if the corresponding GSDK AWS MENU DESTROY_ON_EXIT resource If set true destroys menu when cursor is outside of bounding margin If true destroys menu on mouse button 3 press The frequency at which range rings are drawn Airlane width in Nautical Miles This is only used when running in non transparent mode N b 1Nm 1852 metres Time in millisecon
6. PVD STCA ALERT WINDOW FILTER C LASS PVD APW_ALERT_WINDOW_FILTER _CLASS PVD APW_AIRCRAFT_ALERT_FILT ER_CLASS PVD STCA AIRCRAFT ALERT FILTER _CLASS PVD LABEL DIRECT_MENU INCLUDE _ NEXT_WAYPOINT RADAR_TOOLBOX value PRESENT USE SPEED FILTER RADARTOOLBOX FILTERMENU CLASS ACLABEL HANDOVERMENU value PRES ENT lt cwp gt UNIT lt cwp gt ROLE lt cwp gt HYBRID lt cwp gt SIL lt CWP gt ALERT_WINDOW X Y PRESENT lt CWP gt MESSAGE IN X Y PRESENT lt CWP gt MESSAGE OUT X Y PRESENT lt CWP gt GENERAL_TOOLBOX X Y PRESENT lt CWP gt METEO_WINDOW X Y PRESENT Reference GL eDEP USER 1 1 13 Description The angle that the trajectory editor will choose a waypoint further down stream as a rejoin point because the turn angle to rejoin is deemed excessive Use the state colour of the aircraft rather than the fixed SYSTEM colour for the GROUND trajectory Use the new version of the FlightLeg temporary during transition True to show the time gained lost resulting from an Elastic Vector modification in addition to the heading bearing information normally shown Number of trail dots in the track history Length of the heading vector Class defining the STCA filter logic for the EATMP Alert Window The class must implement SubscriberFilter Class defining the APW filter logic for the EATMP Alert Window The class must implement SubscriberFilter Class defining the
7. or period By convention resource names can be grouped logically by using the period character to create more meaningful names Resources are initialised at start up by specifying the resource file name on the command line by using the r lt filename gt option Specific resource values may also be set directly via the command line using the p lt resource name gt lt resource value gt option 5 1 2 Resource Value Syntax 5 1 2 1 String Strings can be introduced as a single word if it can be read as a single token or terminated with double quotation marks to include white space or special characters 5 1 2 2 Boolean A Boolean value is introduced with the reserved name tokens TRUE true FALSE or false 5 1 2 3 Numeric Numeric values are read as double precision values but stored as integer values if the number has an equivalent value to an integer 5 1 2 4 Lists List elements are delimited commas or white space and terminated with round brackets and These lists may be homogeneous all items of the same type or heterogeneous a mixture of items including nested lists to an arbitrary depth 5 1 2 5 Comments Double slash comments are accepted in resource files 5 1 3 Combining Resource values From Existing Definitions Resource values defined in the file can be constructed by combining existing resource name values with new text items to form a new value The items are de referenced by p
8. Requires MTCD USE_EXTENDED RISK lt MTCD gt RISK_LOWER_VERTICAL SEPARATIO As previous entry but in lower or RVSM airspace 30 N_THRESHOLD lt MTCD gt USE_EXTENDED_RISK Determines whether the MTCD should generate Conflict False Risk in an extended vertical separation See previous two entries lt MTCD gt USE_CONTEXTUAL Determines whether the MTCD should detect Contextual false conflicts These are not real conflicts but flights that are present within an extended lateral separation and in a vertical zone containing the AFL CFL and XFL of the two aircraft plus vertical separation margins The contextual conflicts are often shown in the VAW as blue lines when displaying a subject aircraft s vertical trajectory See MTCD CONTEXTUAL_SEPARATION_THRESHOLD lt contextName gt INCLUDE_AIRSPACE_CONFLICT Flag indicating whether or not the MTCD component should False S report conflicts between aircraft and military sectors lt MTCD gt MANUALPROBE_DISPLAY_TIME The manual probe information display time in seconds 3 lt contextName gt MANUALPROBE_LOOKAHEAD_ The manual probe trajectory lookahead time in seconds for 1200 TIME detecting a loss of separation contextName gt CONFLICT_ID_DOWNTIME The period of time in seconds that must elapse once a 30 0 conflict has been destroyed before its ID can be assigned to a new conflict lt contextName gt FILTER UNIT_EXIT_MARGIN This is the period of time after an aircraft s expected exit 180 0 f
9. True False Null True NO_DECLARED _ ROLE NO_DECLARED _ UNIT FALSE 0 0 FALSE eDEP Resource Reference GL eDEP USER 1 1 13 Description Default PVD ELASTICVECTOR SHOW_TIME_DIFFER ENCE SIL MERGE_RANGE SIL NO_ENTRIES Specifies whether the elastic vector should show the time difference between the existing route and the heading Defines the range in metres used to merge the SILs that are close together when the SILs are defined automatically CWP default behaviour Maximum number of entries permitted in a SIL Conflict and Risk Display CRD Predicted Problem Display CRD PRESENT CONFLICT_DELEGATION_TIME CONFLICT_LOOKAHEAD_TIME PPD VERTICAL_AXIS_OFFSET PPD POTENTIAL_PROBLEM_ SYMBOL SIZE PPD AIRSPACE PROBLEM SYMBOL _ SIZE lt cwp gt CRD X and CRD Y lt cwp gt CRD WIDTH and CRD HEIGHT lt cwp gt CRD MIN_HORIZONTAL_AXIS lt cwp gt CRD MAX_HORIZONTAL_AXIS lt cwp gt CRD MAX_ HORIZONTAL MENU lt cwp gt CRD MIN_HORIZONTAL_MENU lt cwp gt CRD MAX_VERTICAL MENU lt cwp gt CRD MIN_VERTICAL MENU lt cwp gt CRD MIN_VERTICAL_AXIS lt cwp gt CRD MAX_TACTICAL VERTICAL _AX IS lt cwp gt CRD MIN_VERTICAL_AXIS lt cwp gt CRD MAX_PLANNING_VERTICAL_AX IS CWP SSR MODEA AFL DISPLAY lt cwp gt CRD DISPLAY REMINDER_LINE lt cwp gt CRD REMINDER_MINIMUM_TIME lt cwp gt CRD DISPLAY _DISTANCE_TENTHS lt cwp gt CRD AIRCRAFT_CONFLICT SYMBOL_AT_START CRD CONFLICT_SYMBOL_DISPLAYER
10. compressed file using the standard ZIP format The GSDK differentiates between the format of the stored data by checking the file extension name If the extension is zip then the file is opened as a ZIP compressed file and each entry in the ZIP archive will be opened and extracted as a plain text file If the extension ends with a z then the file is opened as a GZIP compressed file and extracted as a plain text file All other files are treated as plain text Note that there is no Java capability to open a ZIP file from within an Applet as the Java ZIP protocol requires file access which is forbidden under Java security rules 6 4 3 Supplied Map files The eDEP platform is supplied with the following map files located in gsdk dat e Ukcoast The UK coastline no elevation data in both zip and Z format e Europe Outline map no elevation data of Europe e All Europe _ Maps This ZIP file contains individual maps of all the countries in Europe The file must be manually decompressed before it can be used Page 50 of 63 eDEP Reference GL eDEP USER 1 1 13 7 RUNNING EDEP APPLICATIONS 7 1 INTRODUCTION EDEP applications consist of a number of elements e A generic main program there exist a number under atcapp e Resource files which tailor this main program usually defining the COMPONENTS resource variable e Other files scenario Java policy etc The eDEP platform is packaged with an atcapp directory package containin
11. 6 Page 3 of 63 eDEP 0 62 Reference GL eDEP USER 1 1 13 Release Date Release Description Modifications sections affected and relevant information Graffica Hargreaves Added resource descriptions for filtering Section 5 3 1 7 Graffica Vere 23 Apil 2007 Graffica 4 May 2007 Humphrey Graffica 29 May 2007 Stainton Graffica 07 Jul 2007 OWEN Graffica 07 August 2007 Hargreaves Graffica 10 August 2007 Kirkwood Graffica 13 August Thom 2007 Added resource for SIL committed PEL display Removed sections now contained in SCMP Section 5 3 1 7 Sections 3 and 4 2 Section 5 3 1 6 Section 5 3 1 4 Section 5 3 1 6 Added stca resource to select track sources Remove REC and CFMU resources which are now in the eDEP_EEC_DDD Added resource descriptions for height filter range Added IAS GENERATE DAP resource Version number change to common Graffica standard Graffica 14 Nov 2007 Added resource for PVD Section 5 3 1 7 OWEN Graffica Graffica 21 Dec 2007 Rawlings Graffica 24 Jan 2008 OWEN 10 Dec 2007 Changed resource name SHOW_LAND_WHEN_NU LL to SHOW FOR NULL COP Added resources named GSDK AWS LINK Section 5 3 1 7 Section 5 3 1 4 Updated CS coordination Sections 5 3 1 5 and 5 3 1 6 resources 1 10 1 11 1 12 1 13 Graffica OWEN Graffica 15 April 2008 VERE Graffica 25 June 2008 OWEN 29 Feb 2008 Graffica
12. CENTRE Nameot Me ATC conte sing y comprising this sector EN ROUTE APPROACH If the value is not one of CONTROL KIND Kind of control executed the previous the control y gt by this sector kind will be UNKNOWN This field is case sensitive VHF Frequency FREQUENCY allocated to this sector eat y COORDINATION Coordination point for Ser wani i _POINT this sector sii te A ORERE TOA S Page 39 of 63 eDEP Reference GL eDEP USER 1 1 13 We can define n coordination points per sector Page 40 of 63 eDEP 6 1 10 SID Syntax A SID is defined by identifying the name of the SID and then creating a route made up from the departure runway name and a sequence of SID points These points mark out the path of the SID through the TMA region together with a series of flight levels to be attained within the SID Reference GL eDEP USER 1 1 13 SID NCL_R6_1SP AIRPORT NCL RUNWAY NCL_R06 COMPRISING FIX NCLO1 FIX NCLO2 FIX NCLO3 FIX NCL11 END FLIGHT LEVEL 020 CAS SPEED 180 FLIGHT LEVEL 050 CAS SPEED 210 FLIGHT LEVEL 070 CAS SPEED 250 FLIGHT LEVEL 130 6 1 11 STAR Syntax A STAR is defined by identifying the name of the STAR and then creating a route made up from a sequence of STAR points and the arrival runway name These points mark out the path of the STAR through the TMA region together with a series of flight levels to be attained within
13. CLASS CRD CURSOR_DISPLAYER CLASS CRD SCOPE CLASS Determines whether the conflict and risk display should be shown The time before a conflict that it will be delegated to the TACTICAL controller The time in seconds before a conflict that it will be shown in the aircraft label of the PVD displays The distance in pixels by which the vertical axis on the PPD is offset to the left of the origin or more precisely to the left of the minimum value on the horizontal axis The size of the problem symbol used to show potential aircraft problems in the PPD and on flight legs The size is actually the width and height in pixels of the bounding square The size of the problem symbol used to show airspace problems in the PPD and on flight legs The size is actually the width and height in pixels of the bounding square Screen position of the CRD in pixels Width and height of the CRD in pixels The range and size of the horizontal and vertical axes String used to replace AFL in the aircraft label when the aircraft s transponder is operating in Mode A Determines whether a draggable line is drawn across the width of the PPD from the reminder triangle which is always displayed The time in seconds on the y axis beneath which the reminder triangle cannot be dragged Determines whether the distance to closest approach is displayed to the nearest nautical mile or the nearest tenth of a nautical mile Determines whether airc
14. TURN_RADIUS_ RATE 5000 4 radius in metres 0 65746 radius change in metres ft of altitude CAS_CRUISE 280 0 in knots CAS_CLIMB 280 0 in knots CAS CLIMB RATE 4026 0 in ft min CAS_CLIMB_ CEILING 42000 0 in ft CAS DESCENT 280 0 in knots CAS_DESCENT_RATE 1416 0 in ft min CAS DESCENT CEILING 47200 0 in ft MACH CRUISE 0 74 in Mach number MACH CLIMB 0 76 in Mach number MACH_CLIMB_ RATE 3702 0 in ft min MACH CLIMB CEILING 42000 0 in ft MACH_DESCENT 0 70 in Mach number MACH DESCENT RATE 334 0 in ft min MACH_DESCENT_ CEILING 4771 0 in ft CLONES B732 B734 B735 B73A B73B END END The following table summarises the fields Keyword Data description Data type Mandatory amp comments Aircraft type as seen in i AIRCRAFT TYPE IFPLs String y radius change in TORN RADIUS RATE metres ft of altitude NOMINAL TURN RADIUS Turn radius Radius in metres y CAS_CRUISE Taken directly from BADA knots y Page 47 of 63 eDEP Reference GL eDEP USER 1 1 13 CAS_CLIMB Taken directly from BADA knots y CAS CLIMB_RATE BADA ll cin y sea level CAS_CLIMB_ CEILING BADA ceiling plus 15 feet y CAS_DESCENT Taken directly from BADA knots y descent rate assumed same as CAS_DESCENT_RATE IB737 estimated from PTF data Feet min y descent ceiling assumed same as CASaDESCENT CEILING IB737 estimated from PTF
15. data teet y MACH CRUISE taken directly from BADA knots y MACH _CLIMB taken directly from BADA knots y estimated from BADA PTF climb MACH _CLIMB_RATE rate at CMTL and extrapolated feet min y back to ground level taken from BADA ceiling plus MACH _CLIMB_CEILING 15 feet y MACH DESCENT taken directly from BADA kiiots y descent rate assumed same as MACH _DESCENT_RATE __ B737 estimated from PTF data Feet min y descent ceiling assumed same as MACH DESCENT CEIRING IB737 estimated from PTF data re X CLONES Equivalent a c types String List n 6 3 3 BADA Files online conversion BADA files may be read and converted computationally on startup This approach is discouraged due to the inherent performance hit In order to specify this use the following lines ACR SCENARIO ACR SCENARIO_R bada resources data types dat atc performance server BadaScenarioReaderImpl ADER The second line here specifies that the data is not to be read in directly but loaded as BADA data and converted online This BADA data is a collection of over 250 files each one specifying a subset of the data about each of around 100 aircraft It is impractical to list each files in the resource hence the types dat file must be introduced and specified in ACR SCENARIO Within the BADA directory there are 3 subdirectories apf opf and ptf Each subdirectory has the same naming convention for each aircraft ICAO callsign e
16. determined in terms of the time it takes to fly the length of the base leg rather than a length in metres However the time is estimated by dividing the base leg flight distance by the nominal flight TAS speed derived from the nominal current CAS Page 36 of 63 eDEP Reference GL eDEP USER 1 1 13 6 1 5 LOA Syntax The Letter Of Agreement syntax comprises the name of the LOA and the COP fix that it is based on the entry and exit sectors plus some additional optional parameters The following provide typical examples of LOA syntax LOA PERNO COP PERNO ENTRY UR EXIT FS LOA MTZ _ 2 COP MTZ ENTRY KKKKK EXIT UR BI_DIRECTIONAL ACTIVATION DELAY 300 0 GREEN LEVELS 290 310 The parameters are as follows Keyword Data description Data type Mandatory LOA LOA name String y Name of COP Fix at which the POE LOA applies Siring y Name of entry sector Note the ENTRY special string can be String y used to denote any sector Name of exit sector Note the EXIT special string can be String y used to denote any sector If present LOA applies in both BI DIRECTIONAL directions i e with entry and Keyword only n exit sectors reversed Time before sector entry that ACTIVATION DELAY _ flights using this LOA should be float number of seconds n activated List of green flight levels at GREEN_LEVELS which coordinations are list of integers n automati
17. e atcapp resources common amp atcapp resources componenttests Page 32 of 63 eDEP 6 EDEP SCENARIO FILES 6 1 AIRSPACE FILE Reference GL eDEP USER 1 1 13 The airspace file read by the ASP component defines the static components of a simulation 6 1 1 Airport Syntax The airport syntax is illustrated below An airport entity shall comprise a unique name and a list of the runways at the airport AIRPORT KJFK 52 98 0 51 COMPRISING KJFK_R27 END Keyword Data description Data type Mandatory AIRPORT Airport name String y Latitude Longitude of reference point for this double double y airport List of runways COMPRISING y references 6 1 2 Agreement Syntax The agreement syntax is illustrated below AGREEMENT AGREEMENT 1 FIX KIPPA FIX FAMBO COMPRISING FILTER ORIGIN EHAM RULES lt 210 RESTRICTED FL 210 gt 210 RESTRICTED FL RFL END FILTER ORIGIN LHHR RULES gt 210 RESTRICTED FL 210 lt 210 RESTRICTED FL RFL END FILTER ORIGIN KJFK RULES 210 RESTRICTED FL 220 lt 210 RESTRICTED FL 180 gt 210 RESTRICTED FL REL END FILTER ORIGIN EGGW RULES lt 210 OR gt 240 RESTRICTED FL RFL gt 210 AND lt 240 RESTRICTED FL 220 END FILTER RULES RESTRICTED _FL 260 END END Page 33 of 63 of agreement element list eDEP Refere
18. file data letters of agreements file data navigation points file data runways_file data sectors_file data sids stars_file data start_time_file data static_display_file data The converter can be used either in offline or online mode In offline mode the data files are converted into eDEP format resource files via the eec maff converter MaffToEdep application The offline converter is shown in Figure 7 2 below The ACE Version drop down box allows the user to specify the version of the data being converted MAFF to EDEP converter 15 xi MAFF data file C GrafficaleDEP EEC src eecimafiidataface2004b1 Browse OUTPUT directory CiGrafficaleDEPIEECisrcieectresourcesicomponenttestsimaf Browse ACE Version ace2004b y lace2004h jace2005a Figure 7 2 Offline MAFF eDEP Converter Convert Quit In online mode the data is read directly into the platform on launch This is achieved in the resources by specifying that the MaffScenarioReader be used in place of the standard scenario reader and the location of the data files This has to be done for airspace and flightplans separately ASP SCENARIO lt Directory of data files gt IFPL SCENARIO lt Directory of data files gt ASP SCENARIO READER eec maff parser scenario MaffScenarioReader IFPL SCENARIO READER eec maff parser scenario MaffScenarioReader ACE VERSIONS ace2004b The ACE_VERSI
19. lt CALLSIGN gt CONNECTIONS Defines UDP connections to local cockpits identified by callsign UDP MESSAGE_TYPE The Java class defining the type of message always Asterix UDP READ_SIZE Maximum size of UDP message in bytes 4096 STORE_HISTORY The TISB reports are stored in the TISBHistory object if this FALSE is set otherwise only one report is stored GENERATE TRACK REPORTS DEBUG Debug output for Track Reports OFF BUFFER_INTERVAL Rate at which incoming UDP TISBMessages are distributed 1 second TS Component CLOCK STOPTIME The time at which the system shall shutdown If not specified the system runs indefinitely USE_EXTERNAL START_TIME Allows the service to pick up start time from an external FALSE source rather than the Time Server itself This is required for use with OASIS UCWP Component lt ucwp gt Whether the UCWP server should send automatic clearances TRUE unitName AUTO_GUIDANCE_ ENABLED or lt ucwp gt AUTO_GUIDANCE_ ENABLED for an unmanned ASSUMED Unit to the FM and also send the instruction to the AIR system Note both flavours may be specified the Unit specific version overrides the general version Compare with AUTOMATIC_SID_AND_STAR whereby the AIR system follows the SID and STAR automatically Page 25 of 63 eDEP 5 3 1 7 CWP Resources Reference GL eDEP USER 1 1 13 Resource Description Default lt cwp gt PVD X Y WIDTH HEIGHT Plan View Display dimensions lt cwp gt PVD SCALE LATITU
20. of the STCA grid lt STCA gt GENERATE_APW When set Area Proximity Warnings are generated and shown False in the CWP aircraft label and alert window An area proximity warning is generated when a flight enters a restricted area lt STCA gt APW_LOOKAHEAD_TIME The number of seconds ahead of a flight entering a military 90 sector that an Area Proximity Warning will be generated lt STCA gt TRACK_PAIR_FILTERS A list of classes that represent filters to be applied to pairs of The pair of tracks to determine whether or not they should be included in classes in the the STCA calculation example on the left are e g used as defaults STCA TRACK PAIR FILTERS atc stca server filters MilitaryPai rFilter atc stca server filters SameSourceFi lter These filters reject tracks that are both military or which are not derived from the same source lt STCA gt USE_TRACK_SOURCES A list of strings that reference the Track sources that are to be DEFAULT monitored by the STCA calculation Normally a Track created within the platform is has the source name DEFAULT MTCD Component MTCD ENABLED TRUE if the MTCD server is enabled for calculating conflicts TRUE Page 21 of 63 eDEP Reference GL eDEP USER 1 1 13 when the GROUND trajectory is updated and returning them to the clients If the server is present then the manual probe may still be used even if this is FALSE
21. the data flows is described in the following paragraphs identifying the data content of each terminator on the diagram The labels attached to each data flow indicate the nature of the information being between Edep and the terminator console time hange requests text based traffic definition time updates text based airspace definition inputs through graphical devices formatted mapping data graphics display output security policy named resource values serialised output data Figure 2 1 Edep Context Diagram 2 1 1 Resources Files The resources files provide a mechanism to load named resource values into a static resource database which can be accessed directly from any object running within a single Java Virtual Machine The values can be the simple types Boolean String Integer or Real or a complex list structure with arbitrary sequences of values arranged into lists The lists can be nested to an arbitrary depth and define an arbitrary structure The file is referenced from the command line parameter A single resource file may also load other files referenced from a designated file using a LOAD directive within the file These resource values are used to configure the source and level of diagnostic output the required set of components to run including the actual component class to use and the corresponding component names It also defines the fonts and logical and physic
22. 13 August 2008 VERE Graffica 15 August 2008 VERE Graffica 19 Aug 2008 OWE N Graffica 20 Oct 2008 OWEN Graffica 22 Oct 2008 OWEN CORE COORDINATION BUG FIXES CS and UCWP resources Added GSDK secure socket resources Section 5 3 1 6 Section 5 3 1 3 CORE_GSDK_AWSPATHDE Section 5 3 1 7 TAILS_IMPROVEMENT Modified resources for PVD TRAIL Added resources PVD HDG_VECTOR_WIDTH and HIGHLIGHTED_HDG_VEC TOR WIDTH Added a resource for single button re centre 5 3 1 4 5 3 1 3 Section 5 3 1 6 auto PACK when a flight is Section 5 3 1 9 deleted Added resources for MTCD Section 5 3 1 6 Added a resource to enable the middleware for remote network distribution ENABLE_REMOTE_DISCOV ERY Updated FM MTCD and CS resources Added a PWP resource for Graffica 14 Jan 2009 Added resources for PPD Section 5 3 1 7 OWEN Page 4 of 63 eDEP Reference GL eDEP USER 1 1 13 1 3 ABBREVIATIONS Abbreviation Meaning CWP Controller Working Position IDE Integrated Development Environment JRE Java Runtime Environment JVM Java Virtual Machine PPD Predicted Problem Display PWP Pilot Working Position SDK Software Development Kit AVT ADS B and TIS B Validation Testbed Page 5 of 63 eDEP Reference GL eDEP USER 1 1 13 2 PLATFORM OVERVIEW The following diagram shows the principal Edep component objects and their associations in the platform Each of
23. 9L 52 98 0 51 1500 263 OPEN 1500 263 OPEN ILS THRESHOI 1000 263 CLOSED THRESHOI LD IOM LD CLN ILS EQUIPPED 3 30 THRESHOLD IOM Outer Marker Distance Plan View l gt Middle Marker Distance glide angle _ 6 1 9 Sector Syntax va Elevation Sse i o The following example illustrates the definition of an ATC Sector Ladder Ladder divisio n leggth SECTOR NATS_ S11 REGION Page 38 of 63 eDEP Reference GL eDEP USER 1 1 13 ALTITUDE 0 45000 54 89 2 56 53 54 181 33 1 Le Ol 52 03 0 59 54 30 0 55 END ATC ATC_CENTRE NATS CONTROL KIND EN_ROUTE FREQUENCY 123 45 COORDINATION POINT SCORS COORDINATION POINT SILVA COORDINATION POINT DOGGA COORDINATION POINT KIPPA END The following example illustrates a multi volume sector definition SECTOR NATS_S12B REGION ALTITUDE 0 45000 53 27 8 23 11 9 52 03 0 55 END ATC ATC_CENTRE NATS CONTROL_KIND EN_ROUTE FREQUENCY 120 185 COORDINATION_POINT DOGGA COORDINATION_POINT SCORS COORDINATION POINT MONIL END The following table defines in more detail the data content Keyword Data description Data type Mandatory SECTOR Sector name String y Description of the volumes constituting this sector REGI N We can define the sector e as a sum of volume END using the AND keyword to group several REGION descriptions Type of zone ATC y ATC
24. APW filter logic for CWP Aircraftimpl The class must implement AircraftA lertFilter Class defining the STCA filter logic for CWP Aircraftimpl The class must implement AircraftA lertFilter Set to false if the DirectMenu should not include the next waypoint in the menu applies to EATMP only and for trajectories without an offset Where value is the name of a button in the atc eatmp toolbox RadarToolboxButtonPanel Set to False for the button to be omitted in the panel Determines whether or not the speed filter should be included in the radar toolbox Defines the class that will be used to create the filter menu for the radar toolbox If no class is provided there will be no accessible filter menu Where value is the name of a button in the atc graphics menus HandoverMenu Set to False for the button to be omitted in the menu Defines the CWP position s unit name and role type Defines if the CWP is a hybrid clearances are sent to both GRD and AIR subsystems Defines a list of SIL windows Each SIL window is defined by the following sublist name long _posn latitude posn COP1 COPn Where COP is the Coordination Point Fix These resources define the positions and presence of the PVD inner windows i e the EATMP alert window the message in out windows the general toolbox and the meteo window Page 27 of 63 Default 45 false false False true 60 0 Null Null Null Null True
25. ATE_ ENRICHMENT REPORT Enriches track data with ARTAS sourced data FALSE IAS ENRICH_EVERY_ REPORT Enrich every track with the additional ARTAS data FALSE ARTAS STATE VECTOR DEBUG Debug information for state vectors FALSE ARTAS MISSED_TRACK_STALEOUT The number of tracks to miss before a track is staled out 1 ARTAS UPDATE_RATE The speed that artas updates each track used to calculate stale out 5 time ASTERIX MESSAGES ASTERIX FIX_FSPEC_LENGTH If set Asterix message compound fields FSPEC fields are set false to a fixed maximum length See atc asterixmessages fields compound AbstractCompoundFiel d DL Datalink Component DL ACL_TIMEOUT The maximum time in seconds allowed for an ACL dialogue 15 before it is deemed to have timed out DL ACL_AUTOMATIC_RESPONSE_DELAY The delay before the Datalink server will auto respond to an 10 Clearance request when no PWP is present DL ACM_AUTOMATIC_RESPONSE_DELAY The delay before the Datalink server will auto respond to a 10 Page 20 of 63 eDEP Reference GL eDEP USER 1 1 13 Handover request when no PWP is present IFPL Component lt IFPL gt ACTIVATION_DELTA Defines the activation delta time in seconds Flight Plans will 0 0 be sent out this number of seconds before their official activation time lt IFPL gt FORCE_IMMEDIATE_ACTIVATION If set to TRUE then all IFPLs are activated immediately at FAL
26. DE PVD centre position and scale LONGITUDE lt cwp gt MAP lt map URL gt Defines the map file or files to be used If this resource is a list it will read each map defined as a lt owp gt MAP lt name gt lt map URL gt name URL pair in a sub list j lt cwp gt PVD DISPLAY_ALL_FIXES Defines whether all fixes are to be displayed or whether the fix definition controls their display in the PVD If this is not supplied all fixes will be displayed lt CWP gt CWP HEADING_SELECTION Defines the step interval for selecting headings NORMAL 5 degree interval NATS 1 degree interval PVD BEACON CLASS Defines dynamically the classes to be used for label PVD LABEL CLASS graphics and label behaviour PVD LABEL_BEHAVIOUR CLASS PVD SYMBOL CLASS Defines dynamically the classes to be used for PVD SYMBOL_BEHAVIOUR CLASS aircraft symbol graphics and label behaviour PVD TRACKSYMBOL CLASS Defines dynamically the classes to be used for Track PVD TRACKLABEL CLASS label and symbol If this resource is not set no symbol class is used PVD SIL CLASS Defines dynamically the classes to be used for SIL PVD SIL_ BEHAVIOUR CLASS graphics and behaviour PVD SIL SHOW_COMMITTED_PEL Change SIL display to show the committed PEL False value only not the currently negotiated value PVD MESSAGE_WINDOW_BEHAVIOUR Defines dynamically the classes to be used for CLASS Message Window graphics and behaviour PVD FLIGHTLEG LABEL CLASS Defines the label
27. NEW_VERSION Use the new version of the FlightLeg temporary false during transition QNH TRANSITION_LEVEL Determines the flight level under which a leading 40 PAC TEXT MESSAGES CLASSNAME PAC LEAD_TIME INFO PAC LEAD_TIME ALERT 0 should be added to the flight level displays in labels flight level menus extended labels etc The class used to define the PAC PreparedClearance messages in the CWp The time seconds before the activation time of a PreparedClearance that the ATC Controller should see the PAC message in Line 4 of the aircraft label The time seconds before the activation time of a PreparedClearance that the ATC Controller should see the PAC message in Line 0 of the aircraft label Page 29 of 63 Atc common clearances DefaultPreparedCleara nceMessages 120 60 eDEP Reference GL eDEP USER 1 1 13 Resource Description Default CWP USE UNDECORATED DIALOGS If false the PPD and VAW dialogs are each False decorated with a platform specific window If true the look and feel of these dialogs is similar to that of the AWS windows lt cwp gt CWP CONFLICT CLASS Class to use in conflict symbol factory to create Atcgraphics graphics c instances of the conflict symbol onflict ConflictSymbol lt cwp gt PVD PRESS AND HOLD DELAY lt cwp gt CWP ENABLE UNACHIEVABLE LEVE LS PVD TRAIL MAXIMUM_ SIZE PVD TRAIL MINIMUM_SIZE PVD HDG_VECTOR_WIDTH PVD HIGHLIGHTED_HDG_VECTOR_WIDTH The delay interval after which
28. NFORMANCE ALERT_TIME PILOT After the ATC controller issues a clearance an alert will be raised if 20 _ RESPONSE the pilot does not conform before this elapsed time TP Component lt TP gt CRUISE_TIMESTEP Time step for non manoeuvring aircraft 30 0 lt TP gt MANOEUVRE_TIMESTEP Time step for manoeuvring aircraft 10 0 lt TP gt USE_IMMEDIATE_TURN Specifies whether aircraft should turn immediately or gradually lt TP gt MODEL_SMOOTH_ACCELERATION Specifies whether aircraft should accelerate decelerate FALSE smoothly or instantaneously lt TP gt ACCELERATION The rate at which the aircraft changes speed This is only 1 0 applicable if smooth acceleration is modelled lt TP gt ACCELERATION_PROCESSOR CLASS The name of the class that models acceleration lt TP gt MODEL_TIME Specifies whether aircraft should model time constraints or TRUE leave the nominal performance timings lt TP gt SPEED MAXIMUM_INCREASE The maximum speed increase as a proportion of the nominal 0 15 speed appropriate for the aircraft type lt TP gt SPEED MAXIMUM_DECREASE The maximum speed decrease as a proportion of the nominal 0 10 speed appropriate for the aircraft type lt TP gt TIME_PROCESSOR CLASS The name of the class that models time constraint lt TP gt INSERT_TIME_CONSTRAINT_SPEEDS Sets whether speed constraints should be inserted into the FALSE trajectory to indicate the required speed changes To Be Agreed lt TP gt MODEL_SMOOTH_CLIMBS Specifies whether aircraft sh
29. ONS resource parameter indicates the MAFF version of the files to be input and the MAFF version hierarchy i e the ACE_ VERSIONS resource shall be set thus ACE VERSIONS lt lt MAFF version gt gt lt lt eldest version gt gt The MAFF Converter attempts to load the parser corresponding to the version specified i e the first MAFF version listed If no parser is found it searches for a parser supporting the next version This process continues until either a parser is found or the final version is reached The final version listed is always ACE2004A all parsers have been implemented for ACE4A thus a parser is always found An eDEP user wishing to use ACE2005A MAFF files would set the ACE_VERSIONS resource thus ACE VERSIONS ACE2005A ACE2004B Page 57 of 63 eDEP Reference GL eDEP USER 1 1 13 The ACE4B data does not support letters of agreement data To overcome this deficiency the MAFF converter accepts will accept ACESA letters of agreement data when converting ACE4B data The MAFF data conversion process is fully automated it is not necessary to create any files manually The following files are generated by the MAFF conversion process e maff gsdk e airspace gsdk e traffic gsdk The maff gsdk file contains the START_TIME and coordination projection centre data 7 7 2 Data Recording The REC component STORIA data recording is an eDEP component which e Builds eDEP airspace
30. S GSDK MIDDLEWARE ENABLE_REMOTE_DISCOVERY Page 14 of 63 Description Defines the time in seconds that the discovery service will wait before abandoning a lookup The hostname of the machine running the Edep discovery service contained within the simulation Engine The port used by the RMI registry found within the discovery service Thread Pool size for multi threaded event dispatching Determines if an event can be distributed to several clients in parallel If active then the use of RMI is suspended between objects within the same VM i e no serialization overhead If set then events are pre marshalled before being dispatched to clients This is an important 14ctioned14ion when the number of clients is large Provides a CORBA like oneway semantic for remote methods which have a void return type When set to true the discovery server is started as a separate process enabling distribution of a system on a network of machines When false the system runs standalone with discovery Default NONE 100 Default 1099 FALSE TRUE FALSE FALSE FALSE eDEP Reference GL eDEP USER 1 1 13 Resource Description Default as a thread inside the VM GSDK MIDDLEWARE RUN_DISCOVERY_SERVER Determines if the discovery server is TRUE to be started or not on this VM This is usually set to false when running internet demos GSDK MIDDLEWARE SSL DEPLOY_SECURITY Specifies whether the middleware FALSE should deploy the sec
31. SE start up This is useful for data preparation needs lt IFPL gt SCENARIO Defines the resource file containing the airspace definition The resource path is relative e g atcapp resources airspace 1 dat lt IFPL gt SCENARIO_READER Defines which parser framework is to be used to read in the scenario data The value is normally gsdk scenario ScenarioReaderlmpl IFPL START_TRAJECTORY_ID The trajectory ID is an incrementing field stored in the 1000 flightplan It is set in flightplan order starting from this value It is used for PMs generation ADSBReports STCA Component lt STCA gt COVERAGE_ZONE LATI Defines the lat long rectangle for which safety nets are lt STCA gt COVERAGE_ZONE LONGI required lt STCA gt COVERAGE ZONE LAT2 lt STCA gt COVERAGE_ZONE LONG2 lt STCA gt LOOKAHEAD_TIME The look ahead time in seconds 120 0 lt STCA gt SEPARATION_THRESHOLD The horizontal separation threshold in nautical miles 5 0 lt STCA gt UPDATE_INTERVAL The update interval in seconds 5 VERTICAL SEPARATION NON_LEVEL_SUPPLE 0 MENT lt STCA gt SMOOTHING DELAY The STCA smoothing delay in milliseconds The STCA 2000 calculation algorithm can be delayed before updating this helps to smooth out overall system loading lt STCA gt FILTER_ON_CFL Flag used to select filtering of STCA according to expected False CFL stop off level lt STCA gt MAX_POSSIBLE_SPEED The maximum possible aircraft speed in metres second This 350 0 value determines the size
32. SER 1 1 13 6 1 3 Fix Syntax The fix syntax starts with a compulsory name and must specify the points latitude and longitude co ordinates The fix syntax also comprises optional qualifying tokens The following provide valid examples of fix syntax FIX BEENO 53 211980 3 035031 FIX BLUFA 52 925274 3 153416 DISPLAY FALSE FIX BOLIN 53 543487 2 384787 WAYPOINT FIX DANDI 55 335161 4 980592 VOR FIX DENBY 53 518141 1 934622 NDB FIX DOGGA 53 385280 1 900694 TACAN FIX DONNA 55 463380 5 113971 VOR_TAC DISPLAY TRUE FIX ELDIN 53 153929 3 337044 VOR_DME DISPLAY FALSE FIX FAMBO 54 233450 0 142549 WAYPOINT DISPLAY FALSE Keyword Data description Data type Mandatory FIX Fix name String y Latitude Longitude of double double y this fix NDB TACAN VOR VOR_DME T Pome VOR_TAC ype ot poin WAYPOINT n Default value for FixType is NAVAID i e any of NDB TACAN VOR VOR_DME or VOR_ TAC TRUE 9 DISPLAY Display on CWP FALSE n 6 1 4 Hold Syntax The hold is defined in the airspace scenario file using the following syntax HOLD H1 Hold name FIX F1 Reference fix BASE_LEG_DISTANCE 30 0 Distance of the base leg of racetrack in nm NOMINAL SPEED 250 CAS Knots ORIENTATION 240 Heading direction of base leg DIRECTION RIGHT Turn direction when entering hold END These hold semantics are compatible with the IPAS definition of a hold see Ref 4 Note that the size of the hold may be
33. Specifically sets the number of columns in the right hand data entry panel for direct to order entry Determines whether the PWP has a supervisory role A supervisor PWP displays all aircraft Set to true to perforn a PACK in the FlightStrips when a flight is deleted Description 640 FALSE 4 5 10 10 FALSE FALSE Default EYE_TRACKER STATIC_FILE_PATH EYE_TRACKER DYNAMIC FILE PA TH lt CWP gt PANEL_UPDATE LISTENER CL ASS lt CWP gt VAW PANEL_ CHANGE LISTEN ER CLASS 5 3 1 11 Datalink Resources RESOURCE DOVE ACL_AUTOMATIC_ RESPONSE DELAY DOVE ACM_AUTOMATIC_RESPONSE_DELAY Path of the file to which static data are recorded Path of the file to which dynamic data are recorded The update listener which records the objects in the PVD The change listener which records the panel events resized moved shown DESCRIPTION Seconds The duration of delay the delay imposed before an unmanned PWP replies to a ACL controller request Seconds The duration of delay the delay imposed before an unmanned PWP replies to a controller ACM request Page 31 of 63 DEFAULT 10 COORD AUTOMATIC _ RESPONSE DELAY 2 eDEP Reference GL eDEP USER 1 1 13 PWP AUTOMATIC_WILCO Boolean If true a PWP shall false automatically acknowledge all controller clearances This parameter is only applicable to manned PWPs PM ACL_TIMEOUT Seconds The time after which a 15 controller pilot dialogue is deemed to have timed
34. YPE The Java class defining the type of message always Asterix UDP READ SIZE Maximum UDP message size in bytes 4096 STORE_HISTORY The ADSB reports are stored in the ADSBHistory object if FALSE this is set otherwise only one report is stored BUFFER_INTERVAL Rate at which incoming UDP ADSB messages are 1 second distributed Coordination Component COORDINATION ADVANCE_BOUNDARY_TIME Time in seconds from unit entry at which the ABI 1800 0 Advanced Boundary Information is signalled to the next unit also called a NOTIFY message COORDINATION ACTIVATION_TIME Time in seconds from unit entry at which inbound is 600 0 signalled to the next unit context COORDINATION AUTOMATIC_ACCEPTA Determines whether coordination requests should be FALSE NCE automatically accepted in a CWP of the given name context COORDINATION AUTOMATIC_HANDOV Defines if all handovers should be automatically initiated and FALSE ER accepted ideal for demonstration modes unitName COORDINATION AUTOMATIC_TRANSFE For the automatic handover the time in seconds after a flight 60 0 R_DELAY crosses the next Unit boundary that the handover will be triggered For automatic handover the time seconds after a flight has 60 0 unitName COORDINATION AUTOMATIC_ASSUME_ been transferred into the local Unit that the ASSUME will be DELAK triggered unitName COORDINATION AUTOMATIC_RESPO Time delay between a request and the response from an 20 0 NSE_DELAY unmann
35. a mouse click is interpreted as a press and hold followed by a release Use on exit waypoint for quick look trajectory leg display Allows any climb level to be input when set true When set false restricts inputs to achievable levels as defined by the aircraft performance Sets the maximum and minimum sizes of the trail dots The size will automatically taper from the maximum to the minimum size Set the width of the aircraft heading vector in the PVD and VAW Set the width of the highlighted aircraft heading vector in the PVD and VAW 500 milliseconds true 10 Pixels Maximum 5 Pixels Minimum 1 pixel 3 pixels For an exhaustive description of resources that affect the FlightLeg appearance edition graphical layers and functionality see Ref 6 5 3 1 8 PVT resources Resource Description Default lt PVT gt SHOW_UNIT_ CROSSING Shows unit crossings superimposed on FALSE trajectory data lt PVT gt PVD SCALE LATITUDE PVD centre position and scale LONGITUDE lt PVT gt PVD X Y WIDTH HEIGHT PVD graphical dimensions lt PVT gt VPT X Y WIDTH HEIGHT VPT graphical dimensions lt PVT gt AIRSPACE_ VISIBLE Determines whether the airspace is visible false lt PVT gt FLIGHT_TAG The trajectory to be displayed in the PVT either GROUND aircraft or ground 5 3 1 9 PWP resources Resource Description Default lt pwp gt FREQUENCY List of frequencies allocated to this PWP PWP DEFAULTS List of PWP positions designated as default p
36. acter encoding Under Windows use Word Pad and save as text only not MS DOS text nor Unicode text File atc nlp lt xml version 1 0 encoding utf 8 gt lt jnlp spec 1 0 codebase http pc speech13 webstart edep href atc jnlp gt lt information gt lt title gt GSDK Demonstrator lt title gt lt vendor gt Eurocontrol Experimental Centre lt vendor gt lt description gt ATC Application lt description gt lt icon href images GSDK gif gt lt offline allowed gt lt information gt lt resources gt lt j2se version 1 3 gt lt jar href lib applications jar gt lt jar href lib gsdk jar gt lt resources gt lt security gt lt all permissions gt lt security gt lt application desc main class atcapp ATCapplication gt lt argument gt r lt argument gt lt argument gt resources atcapp resources gsdk lt argument gt lt argument gt trans lt argument gt lt argument gt x lt argument gt lt application desc gt lt 3n1p gt Note If the application requires all security permission setting the java security policy property for the JVM is useless The behaviour of the application will be the same as if we use a java policy file like this grant permission java security AllPermission Page 60 of 63 eDEP Reference GL eDEP USER 1 1 13 8 3 JAVA OBFUSCATION The process of obfuscation causes Java byte code to be prot
37. al colours to use in the graphical components the specific class implementations to use for key component interfaces and the layout and configuration of graphical items The resources files are further detailed in section 5 2 1 2 Map Files The ATC application may need access to map information in particular coastline but also terrain and feature definitions The map file provides this information in a generic form allowing coastline contours area features linear features and point features to be defined The default map provided is Page 6 of 63 eDEP Reference GL eDEP USER 1 1 13 for the UK coastline only Further information can be found in the NIMA web site at http www nima mil The map files are explained in section 6 3 2 1 3 Airspace File This file provides a free formatted text description of the airspace and contains airspace feature definitions which include sectors units airspace fixes standard routes SIDs STARs airports runways and letters of agreement The airspace file syntax is explained in section 6 1 2 1 4 Traffic File The traffic file provides a free formatted text description of the set of flight plans required to run with the platform These plans define the initial flight plans IFPL for the flights associated with the named callsigns These plans use information defined in the airspace file to create the plans using either standard routes SIDs and STARs or using user defined routes defining pa
38. and traffic files from any STORIA XML files e Records significant data during simulation run in online or offline mode The data recorded are Radar tracks Conflicts Pilot Orders Assume Transfer actions and Time events Radar tracks are recorded either from the PM component normal mode or from the IAS component demo mode The resource file c resources componenttests rec ias as track event source gsdk shows how to set the resources when the platform in running in demo mode The resource file eec resources componenttests rec online gsdk shows how to set the specific resources for data recording If the REC FILEPATH resource is set the REC component will output the records in the specified XML file If the REC SERVER_NAME resource is set and REC ONLINE true the REC component will send the recorded elements to the STORIA API running on the specified server T The REC component holds a mechanism which enables CWPs to record any data This can be done asynchronously either by raising anonymously a DataRecordingRequestEvent or by calling the DataRecordingService recordCWPData method Page 58 of 63 eDEP Reference GL eDEP USER 1 1 13 8 JAVA WEB START This chapter provides a brief introduction to Java WebStart a technology which can be employed to easily place eDEP applications on an intranet or the Internet The following sections provide useful hints and ex
39. ation Graffica Vere 25 Aug 2005 0 51 Graffica Jan 2006 various Pl Graffica Vere 16 Jan 2006 Graffica 25 April various Graffica 5 July 2006 various Graffica 26 Oct 2006 various 27 Nov 2006 Humphrey Humphrey SN Graffica 28Feb2007 Owen 0 59 Graffica Owen Graffica Rawli SApr2007 ngs 0 0 0 0 0 0 0 0 28Feb2007 52 52 53 54 55 56 57 58 61 0 Graffica Kirkwood Added resource to allow STCA filtering on CFL Added various resources Improved ILS description Added additional flight plan attributes Section 5 3 1 6 Sections 5 3 1 4 5 3 1 6 5 3 1 7 5 3 1 9 Section 6 1 8 Section 6 2 1 Graffica 10th Jan 2006 Added SPD resources Sections 5 3 1 6 5 3 1 12 5 3 1 7 Owen Added new resources Sections 5 3 1 4 and 5 3 1 7 relating to changes for FASTI Various resources Section 5 3 1 6 5 3 1 7 5 3 1 9 7 7 1 added modified MAFF conversion added Various resources added Section 5 1 5 5 3 1 6 5 3 1 7 5 3 1 9 Various resources added Section 5 3 1 4 Added recording stream Section 5 3 1 2 reset resource Added LOA to airspace file Section 6 1 5 description Add TP resource for Section 5 3 1 6 multiple TP servers Sections 5 3 1 6 Added FM resource FM XFL_MODEL TOCBOD TOLERANCE Added CFMU eDEP converter resources Various graphics resources added Section 5 3 1 4 11 Apr 2007 Updated ARTAS resources Section 5 3 1
40. ayed True in the VPt Flight Path Monitor Deviation Related lt cwp gt LATERAL_THRESHOLD The maximum permissible lateral deviation in 1 5 Nautical Miles before a deviation is reported lt cwp gt LONGITUDINAL_THRESHOLD The maximum permissible longitudinal deviation 10 in seconds before a longitudinal deviation is reported lt cwp gt VERTICAL_THRESHOLD The maximum permissible vertical deviation in 300 feet before a vertical deviation is reported lt cwp gt The maximum permissible vertical deviation from 3 VERTICAL_CLEARANCE_ THRESHOLD the cleared flight level in flight levels before a vertical clearance deviation is reported lt cwp gt VERTICAL_CLEARANCE_LATENCY The time allowed in seconds for a flight to 30 0 respond to a new vertical clearance by climbing or descending before a vertical clearance deviation is reported CWP DEVIATION_TEXT_FORMATTER Class to define the text displayed in the deviation atcgraphics graphics CLASS button The class must implement the interface buttons atc fpm entity DeviationTextFormatter DeviationButton LabelTextFormatter lt cwp gt DELEGATION_TIME seconds 300 FLIGHTLEG EDITOR MAX_REJOIN_ANGLE The angle that the trajectory editor will choose a 45 waypoint further down stream as a rejoin point because the turn angle to rejoin is deemed excessive FLIGHTLEG USE_STATE_ COLOUR Use the state colour of the aircraft rather than the false fixed SYSTEM colour for the GROUND trajectory FLIGHTLEG USE_
41. cally accepted These are mutually exclusive at least one of the entry and exit sector names must be specified 6 1 6 Restricted Area Syntax Restricted areas are simply defined as 3 dimensional volumes as the following example illustrates RESTRICTED AREA MIL1 REGION ALTITUDE 0 45000 52 98 0 51 52 98 0 81 52 49 0 74 52 37 0 79 52 68 0 96 93323 0 31 038639 0 24 53 24 0432 9312 0 32 END WEZ Page 37 of 63 eDEP 6 1 7 Route Syntax The route syntax comprises an optional SID followed by an en route definition and completed with an optional STAR Reference GL eDEP USER 1 1 13 ROUTE ROUTE_2 COMPRISING FIX DENBY FIX UPTON FIX GOLES FIX KIPPA FIX KOMIK FIX BLUFA END 6 1 8 Runway Syntax The runway syntax is illustrated below A runway shall comprise a unique name that should identify the host airport and the runway name Without the airport name component runway names would not be unique it is quite possible that two airports would both have a runway R14L The runway shall also comprise the latitude longitudinal position the runway length in metres the heading in degrees The runway shall also specify the current status the threshold fix Finally the runway syntax allows the user to specify whether the runway is ILS equipped and if it is the glide angle and the lateral angle RUNWAY LHHR_R14 52 98 0 51 RUNWAY LHHR_R27 52 98 0 51 RUNWAY EHAM R1
42. cified routes after being ASSUMED in a particular unmanned ATC Unit See the CS section in the eDEP_GRD_DDD for details e g UCWP ASSUME CFLS FE 240 EDDW EDDH where IMMEDIATE means give the CFL order on being ASSUMED without waiting for the flight to leave the CONCERNED Unit IMMEDIATE None COORDINATION ROUTE_UNIT_AG REEMENTS A resource for specifying the COP flight level for flights on specified routes when entering a specified ATC Unit see the CS section in the eDEP_GRD_DDD for details E g COORDINATION ROUTE UNIT AGREEME HH EHAM EHRD 240 HH RFL NTS Here flights from EHAM and EHRD to any destination should enter Unit HH at FL240 If this rule does not apply then any flights entering HH should enter HH at their RFL None COORDINATION ROUTE NO GO UNITS A resource for specifying that a particular ATC Unit should not receive control of a flight that is on specified routes See the CS section of the eDEP_GRD_DDD for details E g COORDINATION ROUTE_NO_GO_UNITS CS EHAM DD Here flights going from any origin to EHAM should not ne handed over to Unit DD which should be skipped from the chain of control None AIRSPACE Component ASP SCENARIO Defines the resource file containing the airspace definition The resource path is relative e g atcapp resources airspace 1 dat
43. class for display on the Dynamic atc graphics pvd Fli Flight Leg Current choices are ghtLegLabel atc graphics pvd FlightLegLabel and atc graphics pvd SequencedFlightLegLabel PVD FLIGHTLEG WPT_MARKER CLASS The class of the marker on the FlightLeg gsdk aws AwsMark er in PVD or null in VAW PVD FLIGHTLEG WPT_MARKER HIGHL Highlight a marker on the trajectory when entering False IGHT_ON_ ENTRY PVD FLIGHT_FILTER CLASS PVD STCA LIMIT_TIME PVD STCA LINE_ PATTERN PVD STCA LINE_WIDTH ACLABEL EXIT WAYPOINT BUTTON NO E XIT_COP ACLABEL EXIT_WAYPOINT BUTTON SHOW_FOR_NULL_COP it with the mouse Defines the class that will be used as the filter object for this PVD The maximum length of the STCA conflict line in seconds from current location By default the complete line is drawn without limit STCA line dash pattern drawn to highlight a truncated STCA line STCA heading line width in pixels String value to go into the Exit Waypoint button when no exit cop is found only used when PVD LABEL EXIT_WAYPOINT_BUTTONSHO W_FOR_NULL_COP is set to true Show exit waypoint button when no exit COP is found Page 26 of 63 atcgraphics graphic s pvd FlightFilterlm pl 0 Solid line Land False eDEP Resource FLIGHTLEG EDITOR MAX REJOIN ANGLE FLIGHTLEG USE_STATE_COLOUR FLIGHTLEG USE_NEW_VERSION PVD ELASTICVECTOR SHOW_TIME_DI FF PVD FILTER_CONFLICTS PVD HISTORY_LENGTH PVD HEADING_LENGTH
44. deviates vertically from its trajectory ILS Component ILS AUTOMATIC_LOCKON Determines whether a flight should automatically attempt to lock on FALSE to an ILS Flight will start searching for an ILS immediately after it encounters the top of STAR IAS Component IAS RADAR_UPDATE_INTERVAL The radar update interval in seconds 6 0 IAS TRAJECTORY_TO_FLY Value of GROUND AIRCRAFT or LIVE Aircraft If set the AIRCRAFT then plots are derived from the AIR subsystem state vectors If set to GROUND then plots are derived from the GROUND trajectory If set to LIVE plots are derived from State Vectors provided by the ARTAS component IAS DAP_UPDATE_INTERVAL The frequency in seconds at which DAP data is sent by the IAS IAS RADAR_U PDATE_INTE RVAL IAS GENERATE DAP Determines whether IAS shall generate DAP data TRUE IAS EVENT_DISPATCH_ MECHANISM The event dispatch mechanism radar or datalink used to distribute RADAR data from the IAS This will affect the rate at which data is dispatched by the IAS and whether any delay is imposed upon the time taken to dispatch the data RECEIVED DAP DEBUG Debug output for DAP ON OFF or DEBUG OFF ADSB PROJECT_DEPENDENT_DAP Plugin DAP additional data IAS STATE_VECTOR_DEBUG Debug information for state vectors FALSE PM Component PM CONSTRAINT_MANAGER The constraint manager used in the PM PM MINIMUM_STATE_VECTOR_INTERVAL Interval in seconds between state vector updates 6 0 PM TCAS_RA DELAY Delay in seconds between immedia
45. ds PM HCWP_DELAY_ORDERS Whether or not orders generated from a HCWP should be delayed by FALSE the PM PM HCWP_ORDERS DELAY MEAN The average delay to be suffered in seconds 0 PM HCWP_ORDERS DELAY SPREAD The spread about the average delay i e min delay average 0 spread 2 and max delay average spread 2 in seconds DAP_PROCESSOR CLASS Plugin implementation of DAPAdditionalProcessor to process Additional DAP information DAP_GENERATOR CLASS Plugin implementation of DAPAdditionalGenerator to process Additional DAP information PM EXCLUDE_FIXES BEHIND Sets whether fixes which are behind a flights supposed direction of FALSE travel as determined from its assigned route rather than its actual direction of travel are regarded as invalid with respect to direct to and resume own navigation orders If they are invalid and this resource is set to TRUE these fixes will not appear in the order entry anel PM DAP PILOT_PREFERENCES Ta if a PilotPreferencesReport should be down linked via ADS B FALSE to the GROUND system For ADS B equipped aircraft FPM Component FPM CONFORMANCE_CHECKING TRUE if the FPM should do conformance checking between pilot False selected values and the associated ATC clearance FPM CONFORMANCE ALERT_TIME CONTROLL After the pilot enters a value that differs from the ATC clearance an 5 ER_RESPONSE alert will be raised after this elapsed time seconds unless the ATC controller modifies the clearance to be the same FPM CO
46. ds between each redraw check A list of report handler classes The report handler objects shall be generated from this list The name of the reporter log file to be used with the FileReportHandler object The time stamp to append to the log file The format of the time in the time stamp using the Java SimpleDateFormat class Zoom control using mouse wheel Map centre control using mouse centre button Overridden by USE_CENTRE_BUTTON_PAN resource described below Pan control using mouse centre button Pan scale factor Length of trail history Extended range and bearing tool showing range and bearing readout at both ends of the line Lower range value for speed filter Upper range value for speed filter Number of speed vector buttons in extended radar toolbox Speed vector button label values in the form of a list Number of track history buttons Track history button label values in the form of a list Directory where application images are kept Used by several graphical applications to display extra debug information in graphical labels Defines the list of logical colours Defines the list of physical colours Boolean flag determining if overlay transparencies are to be used Fills polygons with solid colour in non transparent mode Can be used to give impression of transparent colour Increased number of trail history buttons in radar tool box Page 16 of 63 1 i e unlimited TRUE FALSE 000 HHH 10 pixels a
47. e atc the set of reusable ATC components e atcapp the main program classes and scenario files e test the atc specific test software lt home gt GSDK Y The GSDK library module containing src and scripts subdirectories lt home gt ASMT Y The various client applications built upon the Edep lt home gt CORA2 platform lt home gt TCAS lt home gt EEC Y The EEC module containing EEC integration code e g connections to IPAS and STORIA 4 2 CONTINUUS STRUCTURE This sub section has been superseded by the eDEP Software Configuration Management Plan SCMP Ref 7 namely the EEC Onsite Activities section for the Synergy CM previously Continuus project organisation and the Development Environment section for how to work with these Page 9 of 63 eDEP Reference GL eDEP USER 1 1 13 5 EDEP RESOURCE FILES 5 1 INTRODUCTION 5 1 1 Overview The GSDK provides a central mechanism to provide named resource values to participating applications These resources are similar to Unix shell variables or Java properties The Resources class provides a set of static methods to access the required resource items These items can define the primitive values Boolean real integer or String In addition arbitrary lists of objects can be created and can be laid out in the file using free format text Resource names must start with an alphabetic character and may contain any alphanumeric or underscore _ or dollar
48. e s class g find atc atcapp gsdk name Stub sed e s class public g sed e s class g 8 3 2 4 Main methods Do not forget to retain methods main String args Simplest solution is to launch Retroguard script builder with java cp retroguard jar RGgui and to keep is proposal for main methods always click next Use the script generated to complete your own script 8 3 2 5 Resources The name of the package in which the resources are stored should not be changed by obfuscations For example if the configuration files are contained in the package resources we should add this line in the RetroGuard script class resources class graffica 8 3 3 Procedure 1 Compile project 2 Generate stubs 3 Make the jar jar cvf edep jar atc atcapp gsdk resources graffica Copy edep jar in RETROGUARD_ HOME ars 4 Make RetroGuard script Save the script as SRETROGUARD HOME script rgs 5 Run obfuscator cd SRETROGUARD HOME Java cp retroguard jar RetroGuard jars edep jar jars edep obf jar 6 Do not forget to test Page 63 of 63
49. e GL eDEP USER 1 1 13 The fixes is the list of fixes on which the agreement applies from 1 to n In this example the agreement applies on KIPPA and FAMBO The filter will determine if the flight should follow the associated rules For example FILTER ORIGIN EHAM means that all flight coming from EHAM airport satisfy the agreement Filter can be made on ORIGIN Any flight coming from this airport satisfies the agreement DESTINATION Any flight going to this airport satisfies the agreement SID Any flight using this SID satisfies the agreement STAR Any flight using this STAR satisfies the agreement FIX Any flight having this fix in 1ts IFPL satisfies the agreement ROUTE Any flight following a portion of this route according to its IFPL satisfies the agreement The keyword NOT can be used in the filter For example FILTER NOT ORIGIN EGGW means that all flights that do not come from EGGW satisfy the agreement It is exactly the same for all other entities used in the filter The rules should be interpreted as follow e One operator only OP1 threshold RESTRICTED FL value if RFL OP threshold then value e Two operators o OP threshold AND OP2 threshold2 RESTRICTED FL value if RFL OPI threshold amp amp RFL OP2 threshold2 then value o OPI threshold OR OP2 threshold2 RESTRICTED FL value if RFL OP threshold1 REL OP2 threshold2 then value Page 35 of 63 eDEP Reference GL eDEP U
50. eDEP Reference GL eDEP USER 1 1 13 Graffica eDEP User Guide eDEP Page 1 of 63 eDEP Reference GL eDEP USER 1 1 13 1 2 3 4 gt oo Table Of Contents O o PEE EE A E E sods Mase Aedes 3 1 1 RETELENCES 2 e E E anit Stes cates 3 1 2 Document Change Historia A deehese nied 3 1 3 Abbreviations ici 5 Platform O VEVE ica a E a obs e aa Rea E a aa or aae AEA R ash 6 Platform amp Tools Installation tii led 8 Delivery structures enni aae N e E ARN a a R NR 9 4 1 CVS Structures iiO 9 4 2 COntinuus SHrUC UES dad dd td dada 9 edep resource filesinin a a E e ea et ants ae aen ot vant tee ea cet dete 10 5 1 Introducir ira 10 5 2 Command Line Argument inrsin i nie E En E akik aa ennie 12 5 3 Resource A OTE 12 Sid Colours amp Fonts astra da id 32 50 COLOUR PALETTES 2 its latas 32 5 6 Typical Resource FIle Structure o ooonoonnonnnonncocnconncnoncnoncnnncnrconononnnonnncanncnn rc nn non nrcn rra nnnnnnos 32 Cd a ee a vanes aldo de e el ce tees 33 6 1 ATEO o da ed ade do 33 6 2 Trafic lena A a 42 6 3 AIRCRAFT PERFORMANCE FILE ccssssssscessceceeceeeeeecsessesessssescesesceeceeeeseeeesseeesneeas 47 6 4 A Meier ee et 49 Hunting e Dep applications ii A ito 51 7 1 INTO cui A A AA A eee N ne anes 51 7 2 PrEsREQUISILES ives dd 51 3 MONO VM EXAMPLES consustancial der Eba aeiio 53 74 distributed application EXAMPLE seesssesessesesssrseessessresesseesressrseessessreeessosseesosseeseessens
51. ected against malicious attempts at reverse engineering This is obviously of interest when placing eDEP applications on the Internet The eDEP project has made use of the RetroGuard product distributed under the LGPL license whereby no charge is made for commercial or non commercial use of the product It can be downloaded at http www retrologic com 8 3 1 RetroGuard scripts The format of RetroGuard scripts is very easy to understand They can be generated manually using scripts with find and sed Here are a few useful examples Action Script Retain the name of i l gsdk events HeapObject class class gsdk events HeapObject Retain all public fields and method name class atc cwp server CWPControllerImpl of class oblic atc cwp server CWPControllerImpl Retain the name of method method l StartSTC gsdk std STD p1 of class gsdk entity MobileEntityImpl StartSTD gsdk entity MobileEntityImpl Lgsdk std STD V Retain the name of the package resources class resources Page 61 of 63 eDEP Reference GL eDEP USER 1 1 13 8 3 2 Obfuscation constraints for EDEP The script for obfuscating EDEP correctly with RetroGuard is obtained by taking into account the three following constraints 8 3 2 1 Reflection As we use the reflection package in several classes we have to be careful when obsfucating We can distinguish 2 cases use of forName and use of getDeclaredMethod 8 3 2 1 1 fo
52. ection 0 for more information Note in the current release of the Edep platform these resource options are normally associated with CWP components Resource lt component gt RECORD_ MODE lt component gt RECORD_FILE Description Value is either RECORD REPLAY or NONE When RECORDing this value defines a filename into which all network messages are recorded For example edep src atcapp recording cwp1 log When REPLAYing this value a Java resource from which replay data is retrieved For example atcapp recording cwp1 log lt component gt ORDER_RECORD_FILE Only used in RECORDing mode Defines the file into which all significant scenario events e g controller orders are recorded For example ATC src atcapp recording cwp1_orders log REPLAY ORDER_RECORD_ INDEX Only used in REPLAY mode Defines a Java resource file which itself lists all of the individual order record files to load GSDK RECORDING STREAM_RESET_INTERVAL The number of events to write to the output stream between each call to reset to avoid memory leaking 5 3 1 3 Middleware Resources Resource GSDK MIDDLEWARE DISCOVERY DEFAULT TIMEOUT GSDK MIDDLEWARE DISCOVERY_ HOST GSDK MIDDLEWARE DISCOVERY_ PORT GSDK MIDDLEWARE EVENT_DISPATCHING_THREADPOOL SIZE GSDK MIDDLEWARE MULTITHREAD_EVENT_DISPATCHING GSDK MIDDLEWARE OPTIMISE_ COLLOCATION GSDK MIDDLEWARE OPTIMISE_ EVENT MARSHALLING GSDK MIDDLEWARE OPTIMISE ONEWAY_CALL
53. ed unit or automatically responding CWP Page 18 of 63 eDEP Reference GL eDEP USER 1 1 13 COORDINATION RELEASE REMINDER Whether the ATC Controller should be prompted to handover the flight when leaving the local ATC Unit TRUE COORDINATION RELEASE REMINDER DELAY If the previous resource is true the delay seconds before the prompt should appear 0 0 COORDINATION COORDINATION AUTO_SKIP E NABLED Whether the CS server may skip Units of a short traversal duration FALSE COORDINATION AUTO_SKIP THRESHOLD If the previous resource is TRUE the traversal duration seconds below which the ATC Unit will be skipped 120 COORDINATION RAP_ENABLED Whether non standard Unit boundary conditions should be negotiated with the downstream Unit when that Unit becomes ACTIVATED FALSE COORDINATION SERVER_AUTO_MESSAGES_D ISABLED Disable the CS server s automatic ACT and ABI messages and its Agreement TIMEOUT messages Used by the AEG gateway which needs simply to load the coordination state coming from the ESCAPE CS server which would conflict with any action performed by the eDEP server FALSE UCWP unitName AUTO_GUIDANCE_ENABLED or 2nd priority UCWP AUTO GUIDANCE ENABLED Whether the UCWP should perform automtic CFL orders in the stated unmanned Unit or generally in all unmanned Units TRUE UCWP ASSUME_ CFLS A definition of CFL orders to be given to flights on spe
54. eees 53 7 5 VALIDATION SCENARIO EXAMPLE 1 cccccescssececseseeceeeeseesesesseseseescsceaceeceseeeesseeesaeees 54 7 6 recording replay and the MOnitor ccccesccessceseceeceseessecessesseecseeeeseceecssseseecnseenseeneensees 54 TE BBC Applications sta At ee Soe Sei ee Re ee 56 Java Web Stat 0ccceu ited A eats Bead a We Ae Lia 59 8 1 installation yes Fes es ended Teac ia 59 D2 A EN NN 59 8 3 ER 61 Page 2 of 63 eDEP 1 INTRODUCTION Reference GL eDEP USER 1 1 13 The aim of this document is to assist eDEP users with the activities of platform installation configuration and launching For more information concerning the platform design the reader should address either the Architecture Design Document ADD or the Detailed Design Document DDD REFERENCES IPAS ACE Interface Specification 2004B External 4 Requirement eDEP Software 6 7 Management Plan 12 DOCUMENT CHANGE HISTORY 1 eDEP Architecture Design Doc GL eDEP ADD 1 V1 8 M Vere March 2003 2 eDEP GSDK Detailed Design 1 5 M Vere October 2002 eDEP ATC Detailed Design GL eDEP DDD 1 1 9 M Vere March 2003 eDEP SPD _ADD doc the Sector Package Demonstrator ADD Version Le Swen wl Ref Title Doc Reference Authors Date 1 3 eDEP FlightLeg doc GL eDEP FL 001 S Owen Configuration Gy jeDEP TN 1 1 0 M Humphrey May 2007 Release Release Date Release Description Modifications sections affected and relevant inform
55. es the file holding the aircraft performance data If the program is reading BADA data with online conversion this should be the types dat file at the root of the BADA directory otherwise this should be the Edep formatted aircrafttypes dat file ACR USE_OPERATIONAL_VALUES override the turn radius rate values to give constant turn rate FALSE for all altitudes ARTAS ARTAS lt StreamID gt DEBUG_REPORT_CAT62 Sets debug report messages for CAT62 messages FALSE ARTAS lt StreamID gt DEBUG_REPORT_CAT32 Sets debug report messages for CAT32 messages FALSE ARTAS lt StreamID gt DEBUG_REPORT_CAT21 Sets debug report messages for CAT21 messages FALSE UDP ENABLED Set to true if UDP connections are required including host FALSE channel name host name port ARTAS lt StreamID gt FILTER_ON_ARTAS_UNITS Defines whether ARTAS unit should be used to filter messages CONNECTIONS Defines the set of UDP connections required UDP READ_SIZE Maximum size of UDP message in bytes 4096 CWP RECEIVE_UNITS Units to receive data from Artas for UDP MESSAGE_TYPE The Java class defining the type of message always Asterix ARTAS lt StreamID gt DSID_SIC The default data source identifier ARTAS lt StreamID gt DSID_SAC The default data source area ARTAS lt StreamID gt USER_NUMBER The user number enrichment data 0 ARTAS lt StreamID gt CENTRE The track source centre enrichment data 0 ARTAS lt StreamID gt POSITION The track source position enrichment data 0 IAS GENER
56. g D228 there is a file inside the ptf directory called D228 _ ptf As such to locate these files all that is needed is a file listing each ICAO callsign currently used this is types dat This must lie in the base bada directory ie on the same level as ptf apf and opf and each token must be an existing ICAO type as described in each directory There is a performance issue related to online BADA conversion while it has no impact during runtime it may take a short time to calculate upon initialisation typically in the region of 10 seconds Page 48 of 63 eDEP Reference GL eDEP USER 1 1 13 6 3 4 BADA files offline conversion In order to circumvent the performance issue it is possible to convert the BADA files offline and them read them in as an eDEP file format the same format as used in section 6 3 2 To specify this use the resource parameters ACR SCENARIO atcapp resources common atc badatypes dat ACR SCENARIO READER gsdk scenario ScenarioReaderImpl The file listed reflects the data in BADA v3 5 which is the data currently included with the project As such you should witness the same results as if you had used BADA files online conversion This is the recommended approach 6 3 5 BADA offline converter If a more up to date version of BADA is available it is possible to convert the data creating a new badatypes dat file In order to do this run the file bada offline BadaOffLineCon
57. g a number of useful examples e Mono VM multi CWP example e Distributed multi machine example e Data recording replay example e Profile Validation tool example Equally the supplied Eclipse project file contains a number of launch configurations for the above examples 7 2 PRE REQUISITES 7 2 1 Colour Modes Before running Edep the user should check that their PC s colour mode is set to True Colour 24bit if it is not Edep transparencies and geographic maps may not be displayed To check and set the colour mode follow the menu sequence Start gt Settings gt Control Panel gt Display Settings The resulting menu is illustrated below The user should specify a value of True Color 24 bit for the colors option Display Properties 2 x Background Screen Saver Appearance Effects Web Seltings Display B1996NSL on Intel r 82815 Graphics Controller 4 12 01 2607 Screen area m Colors Less More True Color 24 bit 1280 by 1024 pixels le Extend my windows desktop onto this monitor Advanced Page 51 of 63 eDEP Reference GL eDEP USER 1 1 13 7 2 2 Launch configurations 7 2 2 1 Creating a new Launch configuration Select the menu option Run gt Run and then Java Application The following options need to be specified e Main class atcapp ATCapplication e Program arguments VM arguments The recognised command line argument
58. he monitor application will produce a frame with two panes the Tree pane and the graph pane The tree pane can be explored to examine various aspects of the components currently running The graph pane waits for the program to start running then starts printing bars representing which components are firing and how often You can query specific components to get information on each event coming from that component by locating them in the Tree pane under Servers and right clicking them then selecting Show this Revert back to the main summary window by performing the same action on Servers Page 55 of 63 eDEP Reference GL eDEP USER 1 1 13 CA cues Figure 7 1 Discovery Monitor HMI 7 7 EEC APPLICATIONS 7 7 1 Data conversions The EEC eDEP platform is complemented by the following applications e CFMU to eDEP converter Builds eDEP airspace and traffic files based on CFMU data e XML to eDEP Builds eDEP airspace and traffic files from the IPAS database e MAFF to eDEP converter Builds eDEP airspace and traffic files from MAFF format data ACE2004B bis and ACE2005A versions are supported LOA data is not available in ACE2004b bis version MAFF data Page 56 of 63 eDEP Reference GL eDEP USER 1 1 13 The MAFF to eDEP converter extracts Airspace and Flightplan data from the following MAFF data files Airports_file data airways_file data atc_constraints_file data flight _file data holds
59. is launched This is to ensure the Discovery Service is running As the number of CWP positions increases the following GSDK middleware optimisations should be considered GSDK MIDDLEWARE MULTITHREAD EVENT DISPATCHING TRUE GSDK MIDDLEWARE OPTIMISE_COLLOCATION TRUE GSDK MIDDLEWARE OPTIMISE EVENT MARSHALLING TRUE GSDK MIDDLEWARE OPTIMISE ONEWAY CALLS TRUE 7 5 VALIDATION SCENARIO EXAMPLE The eDEP platform is supplied with a multi position PWP and CWP example which may be run over several machines This validation scenario is found in atcapp resources acceptancetests validation2002 This can be run via the above mentioned ATC APP Launcher 7 6 RECORDING REPLAY AND THE MONITOR The eDEP platform is packaged with an example of recording and replay in action mono VM application Refer to the resource files in atcapp resources componenttests recording amp replay for more information 7 6 1 Recording The data recording occurs at the CWP component level Therefore the supplied demonstration will cause the following binary files to be generated e Cwpl log cwp2 log Recording of all inter component messages from the CWP viewpoint e Cwpl_ orders log Cwp2_orders log Recording of significant events occurring within each CWP 7 6 2 Replay In order to replay the above recordings the following should be followed e Refresh the Eclipse project within the package view click right on eDEP this ensures
60. loading Resources names can be complex build up from dot separated words For example 1 Eclipse will treat all non Java files as resources hence they will be copied JBuilder has to be to be configured via the properties option to copy certain file types Page 11 of 63 eDEP Reference GL eDEP USER 1 1 13 GSDK MIDDLEWARE OPTIMISE COLLOCATION FALSE CWP1 GSDK MIDDLEWARE OPTIMISE COLLOCATION TRUE The first element of the scoped resource is invariably the component name This is often used to provide a form of resource overloading That is when looking up a resource value x y the platform will first attempt to locate a resource named lt component gt x y followed by x y This obviously allows resource values to be set in a general fashion and then overloaded for a particular component 5 1 9 System Start up During application launch the Edep platform will automatically attempt to load a file atcapp resources defaults gsdk This file is intended to contain system wide defaults that apply to all applications The developer may also cause the platform to load a specific resource file This is done via the command line option r lt resource file name gt 5 2 COMMAND LINE ARGUMENTS The following command line arguments are recognised by Edep ARGUMENT PURPOSE r lt resource file gt Specifies the resource file to be loaded at start up p lt resource name gt lt resource value gt Allows
61. me of the classes for which stubs have been generated with this script cd CLASSES find atc atcapp gsdk name Stub sed e s Stub class g sed e s g For release d180202 the following classes are concerned atc airspace server ASPControlleriImpl atc console server ConsoleControllerImp atc coordination server CSControllerImp atc cwp server CWPControlleriImp atc fm server FMControlleriImpl atc fpm server FPMControlleriImp Page 62 of 63 eDEP Reference GL eDEP USER 1 1 13 atc ifpl server IFPLControlleriImp atc mtcd server MTCDControlleriImp atc tp server TPControlleriImp atc track server ATGControlleriImp atc ts server TSControlleriImp gsdk middleware discovery server DiscoveryImpl gsdk middleware events DelegateRemoteListener gsdk middleware events RemoteListenerAdapter gsdk middleware server ComponentControllerImpl For all these classes and the stubs we should retain their names and the names of all public methods and fields We do not need to tell RetroGuard to retain the name of methods declared in the interfaces implemented by theses classes the behaviour of RetroGuard is correct without adding specific lines in the script We can use these 2 shell scripts to generate the appropriate section for the RetroGuard script cd SCLASSES find atc atcapp gsdk name Stub sed e s Stub class public g sed
62. nce GL eDEP USER 1 1 13 Keyword Data description Data type Mandatory AGREEMENT Agreement Name String y Fix name FIX We can define n fixes for each String y agreement COMPRISING No data just indicate the start y of agreement element list No data just indicate the start PITER of agreement element filter y ORIGIN Origin airport name 0 1 String hi origin per filter Destination airport name 0 1 These tags DESTINATION destination per filter pine a can all be Fix name 0 to n fixes per preceeded PA filter pine E the tag Route name 0 to n routes per E NOT ROUTE filter String n SID SID name 0 1 sid per filter String n STAR name 0 1 star per i STAR filter String n No data just indicate the start RULES of rule list corresponding to y the filter gt lt First operator gt n lt First threshold only when E first operator is present Mo a Logical connector only if OR second operator is present AND gt lt Second operator only if first a a Operator is present as Second threshold only if second threshold is present eo i RESTRICTED FL Restriction to be applied R tievel y END No data just indicate the end y Each agreement is made of several 1 n agreement elements The agreement is structured as follows e Fixes fixes on which the agreement applies e List of Agreement elements composed of o Filter filter flights that should follow the rules o Rules Page 34 of 63 eDEP Referenc
63. nd 10 pixels False True S 18520 20 Empty list edep_log False hh mm ss_ddMMMyyyy TRUE TRUE TRUE 4 15 FALSE 0 100 5 None 5 None Atcapp resources images FALSE FALSE FALSE FALSE eDEP RADAR _TOOLBOX HEIGHT_FILTER LOW ER RADAR _TOOLBOX HEIGHT_FILTER UPPE R SCREENMANAGER PLUGIN CWP_SCREEN_MANAGER 5 3 1 5 General ATC resources Resource CPDLCACM STD CPDLCALC STD ATC LAST_ VALID LOWER FLIGHT LEVEL ATC RVSM CLOCK STARTTIME CLOCK STOPTIME CLOCK SYNCHRONIZED_TO_UTC PROJECTION CENTRE LATITUDE PROJECTION CENTRE LONGITUDE PROJECTOR CLASS CONSTRAINT CLASS TRAJECTORY CLASS WAYPOINT CLASS Reference GL eDEP USER 1 1 13 Lower range for the height filter 0 Upper range for the height filter 600 Defines the Screenmanager to be used this will be replaced by the PLUGIN CWP_SCREEN_MANAGER individual managers in future Defines the screenmanager Plugins components to be used PpdManagerlmpl These are defined in interface implementation pairs PvdManagerlmpl VawManagerlmpl EATMPFlightLegManag er amp AsasManagerlmpl Description Default Defines the datalink state machines Determines if RVSM separations are to be used Defines the clock start time within a quoted string The value can be of the form HH MM SS or dd MM yy HH mm ss Defines the time at which the platform should shutdown If no value is specified the platform will continue to run ad infinit
64. of the contour the item is placed in The items can also define an optional name field The perimeter of the AREA and LINEAR features is defined by a list of latitude longitude co ordinates terminated by a END keyword The POINT features are positioned with a single latitude longitude co ordinate The file has the following format BOUNDS 7 70 49 75 2 0 6120 COASTLINE 0 537056 51 517582 0 526694 51 516777 END CONTOUR HEIGHT 76 2 661771 52 332763 2 661827 52 322707 END RAILWAY LINEAR 2 6125 54 43211 2 612417 54 431946 END LAKE Page 49 of 63 eDEP Reference GL eDEP USER 1 1 13 5 627639 57 639027 5 630944 57 637833 END POPULATION 1 331889 52 848251 1 331306 52 845974 1 336417 52 836945 END As the map data is read from the file it is automatically converted from latitude longitude co ordinates to an appropriate projection to give Cartesian co ordinates By default the toolkit uses a Lambert projection but any projection algorithm satisfying the Projector interface from the geometry package can be used 6 4 2 File Storage Format Although GSDK map data is defined using a generic text format the files in which the mapping data 1s stored may be compressed in order to save disk space and loading time particularly across a network or over the Internet The GSDK supports three map file storage formats a plain text file b compressed file using the GNU GZIP format c
65. on Data type Mandatory amp comments FLIGHTPLAN Callsign String y ACTIVATION Flight activation time Time y ORIGIN Departure airport name String y DESTINATION Destination airport name String y RFL Requested flight level int y n int If data is not given the IFL Initial flight level To be added for flight is considered to milestone 2 Mike be stable at his CFL RFL int f E h CFL Cleared flight level To be added for a Zonet giyen tae milestone 2 Mike ight is considered to be stable at his RFL SSR CODE SSR code int 4 digits between 0 y and 7 A B C D S NO If a value is given and is not one of the previous Bor SSR MODE SSR mode the mode will be If no value is given we UNKNOWN assume SSR mode is A Thik held icas compliant with IPAS sensitive n ALLOCATED SS taa R CODE Allocated SSR Code and 7 ALLOCATED _ SSRCODE_NOT_SET value is given 1 ICAO ADDRESS ICAO 24 bit address String n String If l n h FLIGHT RULES Flight Rules INSTRUMENTED or no value 1s BIVen the VISUAL RULES_NOT_SET value is used 1 n If no value is given the String CIVIL or TYPE_NOT_ SET E e eli MILITARY value is used and the flight is considered to be CIVIL ETD Estimated departure time Time y MODEL Aircraft model String y LIGHT MEDIUM HEAVY If the value is not one of the previous the WAKE Wake turbulence 3 SDS S category UNKNOWN This field is case sensitive Page 44 of 63
66. ositions managing all unallocated frequencies lt pwp gt PWP_WIDTH PWP_HEIGHT The PWP Dimensions 1280 1024 lt pwp gt PVD X Y Plan View Display position lt pwp gt PWP_PVD WIDTH The width of the PVD and the top left column 500 The PVD expands vertically to fill all available vertical space above the Datalink Panel The width of the top right column containing the Aircraft Strips and Details Panels is the width of the PWP minus the PVD width lt pwp gt PWP_DATALINK HEIGHT The height of the PWP Datalink Panel The 100 Datalink Panel width is linked to the width of the PVD The PVD fills all remaining vertical space above the Datalink Panel lt pwp gt PWP_DETAILS HEIGHT The height of the PWP Details Panel The Details 150 Panel width is the width of the PWP minus the width of the PVD The PWP Aircraft Strips Panel fills all remaining vertical space above the Details Panel lt pwp gt PWP_BOTTOM HEIGHT The height of the Order Entry and Data Entry 300 Page 30 of 63 eDEP lt pwp gt PWP_ORDER_ENTRY WIDTH lt pwp gt PVD SCALE LATITUDE LONGITUDE lt pwp gt MAP PVD BEACON CLASS PVD LABEL CLASS PVD LABEL_BEHAVIOUR CLASS PVD SYMBOL CLASS PVD SYMBOL_BEHAVIOUR CLASS PWP AUTOMATIC_WILCO PWP HEADING_SELECTION PWP EXCLUDE UNACHIEVABLE TU RNS PWP ROWS PWP COLS PWP DIRECT_ DATA _ENTRY1 ROWS PWP DIRECT DATA_ENTRY1 COLUMNS PWP HEADING DATA ENTRY3 ROWS PWP HEADING DATA ENTRY3 COLUMN S lt pwp gt SUPERVISOR contex
67. ould accelerate decelerate FALSE smoothly or instantaneously lt TP gt CLIMB_SMOOTHING_PROCESSOR CLASS The processor class that models smooth changes in climb 1 0 rate lt TP gt SMOOTHING TIME_IN_CLIMB The time before TOC BOD during which flight is climbing or 15 0 descending Page 24 of 63 eDEP Reference GL eDEP USER 1 1 13 lt TP gt SMOOTHING TIME_ON_LEVEL The time away from TOC BOD where the flight should be 5 0 level lt TP gt SMOOTHING ACCELERATION Smoothing vertical acceleration rate in ms 2 2 0 lt TP gt SMOOTHING AIRCRAFT_ONLY Only generate the smoothed climb for the aircraft trajectory FALSE lt TP gt SMOOTHING DEBUG Produce debug output for all modified points in the profile FALSE lt TP gt SMOOTHING WITHIN_PROFILE Flag to restrict smoothjing changes to be within the existing TRUE vertical profile as produced by the TP lt TP gt SMOOTHING WAYPOINT_INTERVAL The interval between the generated waypoints for the 1 0 smoothed climb descent lt TP gt ACCELERATION_PROCESSOR CLASS The name of the class that models acceleration lt TP gt MODEL_WIND The flag indicating whether wind is modelled FALSE lt TP gt WIND_PROCESSOR CLASS The name of the class that models wind lt TP gt USE_RATE_1 Flag to indicate whether the aircraft should fly rate 1 turns or FALSE use the default TP turn model
68. out DATALINK ENABLED TRUE True if Datalink should be used in the False simulation DATALINK AUTO_UPLINK TRAJECTORY COO True if a coordinated trajectory should False RDINATED automatically be uplinked after being accepted 5 3 1 12 ASAS Resources ASAS has been implemented in the context of the SPD project and is subject to modification in the future See Ref 5 for the latest description of the ASAS resources 5 4 COLOURS amp FONTS The various colours and fonts which may be positioned via the resources are too numerous to mention The developer is invited to consult the Java code or consult the standard configuration files available in atcapp resources common Airspace Airport Font Airport Colour Airway GSDK REGION LANE AIRLANE_ WIDTH 5 5 COLOUR PALETTES The CWP employs two sets of colour mappings logical colours and physical colours The physical colours file maps a colour name onto an RGB value The set of logical colours map the colours of individual widgets onto physical colours Using this approach it is relatively simple to change the colour of a specific widget without affecting the colour of any other widgets 5 6 TYPICAL RESOURCE FILE STRUCTURE The eDEP delivery contains many examples of structured resource files The developer is invited to examine the following e atcapp resources acceptancetests validation2002 Examples containing multiple CWPs uCWPs PWPs running in either mono process or distributed modes
69. periences with Java WebStart and other related products e g code obfuscators The developer is encouraged to visit the Java WebStart web site for more information http ava sun com products javawebstart 8 1 INSTALLATION The Web Start download will detail the exact installation procedure 8 2 GENERAL 8 2 1 Development The Java Web Start environment enables ordinary Java applications 1 e not applets to be downloadable across the Internet There are however a number of minor programming restrictions which are summarised here e Use this getClass getClassLoader getResource path for loading resources Image file The method getSystemResource should not be used In static method it can be replaced by new Toto getClass getClassLoader getResource path where Toto is the name of the class where the static method is declared NOTE For some classes system classes the getClassLoader method returns null For example new Object getClass getClassLoader returns null e Use this getClass forName instead of Class forName Refer to the developer guide and FAQ for more information 8 2 2 Security policy A Java application under Web Start may be run either a within a sandbox as with applets b outside of a sandbox as with normal applications If b is the case then the application must be signed so that the end client may accept or not this security risk Please
70. rName If we want to be sure that all forName calls work after obfuscation we have to keep the name of all public classes that might be loaded by reflection To ease this work and be sure that the reflection will always work we decided to retain the name of ALL public classes This solution is satisfactory because e The generation of the script for RetroGuard can be automated e The obfuscated code remains very difficult to understand RetroGuard script generation to keep all public classes names cd SCLASSES find atc atcapp gsdk name class sed e s class g sed s class g grep v A gt amp all classes rgs 8 3 2 2 getDeclaredMethod If we want to be sure that all getDeclaredMethod calls work after obfuscation we have to retain the name of all methods public loaded like this We should not retain the name of all public methods of all classes because it makes the obfuscated code very easy to understand We should search for all uses of getDeclaredMethod in the project and add the appropriate line in the RetroGuard script For release 4180202 the following classes and methods are concerned Class Method atc aircraft Aircraft StartSTD gsdk entity MobileEntityImpl StartSTD Here is the corresponding lines in the RetroGuard script method atc aircraft Aircraft StartSTD Lgsdk std STD V method gsdk entity MobileEntityImpl StartSTD Lgsdk std STD V 8 3 2 3 RMI We can get the na
71. raft conflict symbols are displayed on the PPD graph at the start time of the conflict or at the time of closest approach The class used to manage the display of ConflictSymbols in the PPD CRD The class used to manage the display of cursors on the axes of the PPD CRD The class used to manage the display of scope shading in the PPD CRD Page 28 of 63 0 20 False 300 300 0 15 21 True True atcgraphics eatmp ppd conflictdisplayer Def aultConflictSymbolDi splayer atcgraphics eatmp ppd CUrsors DefaultCursorDisplay er null eDEP Reference GL eDEP USER 1 1 13 Resource Description Default lt cwp gt SPEED_MENU SHOW_TAS Specifies whether the TAS speed option is shown in True the speed menu CWP CFL_DISPLAY_THRESHOLD The number of flight levels by which CFL must 0 differ from AFL for CFL to displayed i e CFL displayed if and only if CFL AFL gt CFL_DISPLAY_THRESHOLD Vertical Assistance Window VAW or Vertical Profile Tool VPT VPT PRESENT lt cwp gt VPT X and VPT Y lt cwp gt VPT WIDTH and VPT HEIGHT lt cwp gt VPT SHOW_SECTORS Specifies whether the VPT shall display all the True sectors flown through the subject unit or simply to display the whole unit lt cwp gt VPT TIME_TO_UNIT_ENTRY Time interval displayed on the VAW before unit 3 minutes lt cwp gt VPT TIME_TO_UNIT_EXIT entry and after unit exit 3 minutes lt cwp gt SHOW_GROUND_FLIGHTLEG Specifies whether the ground trajectory is displ
72. refer to http developer java sun com developer onlineTraining Security for more information This part of the article is interesting if we want need to use a Java policy file When granting permissions you can base them on who signed the code where the code came from the codebase or grant them to everyone The java security Permission class serves as the base class of all 1 2 permission related classes What an actual grant statement looks like in the policy file follows This would allow write access to the local temporary directory and all subdirectories recursively for code signed by JavaJoe and downloaded from http www TrustedUserHome foo If an asterisks was used instead of a dash the permissions would be for only the specific directory not its subdirectories also grant signedBy JavaJoe codeBase http www TrustedUserHome foo permission java io FilePermission c temp Page 59 of 63 eDEP Reference GL eDEP USER 1 1 13 8 2 3 Debugging The following hints are given for application debugging e Activate Java console Launch Java Web Start go to Files gt Preferences in Advanced sub menu check Activate Java console e When you are debugging you may need to empty the cache of the navigator e Sometimes the application cache for Java Web Start is corrupted Launch Java Web Start to check 8 2 4 JNLP file example Please note that JNLP files are very sensitive to char
73. refixing the resource name with a character and combined using a amp character Thus the following item definitions HOME c users GSDK DAT dat SCENARIO HOME amp example test_scenario amp DAT Will produce the following resource value SCENARIO c users GSDK example test_scenario dat Page 10 of 63 eDEP Reference GL eDEP USER 1 1 13 5 1 4 Loading Nested Resource Files The Resources file can read nested files embedded in the file it is currently loading introduced by the LOAD directive This directive is followed by a file path name which can include existing resource strings LOAD applications data scenario dat 5 1 5 Manipulating Resource Files The user can manipulate existing list resources by using the special operators APPEND JOIN REMOVE and MERGE The operators respectively append a new item to a list the item itself can be a list join two lists together remove an item from a list merge an item into a list a simple pattern match is employed to match the contents of the remove merge property to the first matching element in the list Examples of their use are given below TEST ABC Result APPEND D JOIN EF MERGE G MERGE A REMOVE D gt Ppp Pb B B B B B B HuuuuTz Hb canana Qs aa r Note that any resource values can be overridden with new values simply by resetting
74. rom the subject unit for which new conflicts involving the aircraft are deemed to be of interest to the subject unit The time period is given in seconds lt contextName gt FILTER UNIT_ENTRY_MARGIN This is the period of time before an aircraft s expected entry 180 0 to the subject unit for which new conflicts involving the aircraft are deemed to be of interest to the subject unit The time period is given in seconds Applicable to the MTCD server with the given context name or all servers is omitted lt contextName gt USE_TIME HORIZON This flag indicates that the time interval between TOC BOD False manoeuvre completion and the loss of plan separation should be used in the evaluation of the risk status of a potential conflict See time horizon definition below lt contextName gt TIME HORIZON This is the minimum interval between the end of a climb 300 0 Page 22 of 63 eDEP Reference GL eDEP USER 1 1 13 manoeuvre TOC BOD and the start of a conflict the point of loss of separation beyond which a conflict is declared as CONTEXTUAL not CONFLICT or RISK FM Component EARLY_CLIMB_ACROSS_MULTIPLE_POINTS Causes climbs to be done as early as possible even before TRUE sector entry PAC DELAY INCLUDE MILITARY Determines whether the FM should generate trajectories for military FALSE flights Setting this resource facilitates the di
75. s are detailed in section 5 2 The following VM arguments should be specified Djava security policy scripts java policy Xms2m Xmx200m Then the launch configurations may be set up to build standard launch scripts Once this process is finished the new imported project should be displayed on screen 7 2 2 2 Reusing an existing launch configuration Select the menu option Run gt Run and then select the existing configuration Page 52 of 63 eDEP Reference GL eDEP USER 1 1 13 The Edep software should now run and the user should see at least one CWP 7 3 MONO VM EXAMPLES The eDEP project includes an Eclipse launch configuration called ATC APP Launcher which allows many mono VM component tests to be run The launch script specifies the following VM amp program arguments e VM arguments Djava security policy scripts java policy Xms2m Xmx200m e Program arguments None The VM arguments are useful specifying a pre supplied Java policy file not strictly necessary in a mono VM application if collocation optimisations are set and specifying a min and max size for the memory heap needed for running on big screens where large amounts of system memory are required Once this is launched the following HMI appears Apobcation louscher aini Daty KOMA v Aen PVT Varo Trafic Ran Test Defast vanna oun This HMI allows the following to be selected e The particular resource file many of which are componen
76. sages 8010 ACS_PORT_NOTIF The port on which to send to the ACS for NOTIF messages 8001 LOCAL_PORT The port on the local machine to listen to for ACS Ras 8011 messages The following resources are only required when CONNECTED FALSE SCENARIO_READER The Scenario Reader for TCAS Entities eg Atcx acsg server ACSGScenarioReaderImpl SCENARIO The TCAS Script DATALINK_UPDATE _INTERVAL The frequency in seconds at which TCAS advisories should 1 0 be reported in Datalink mode ADSB Component REPORT_CAT21 Sets debug report messages for CAT21 messages FALSE UDP FORWARDING_CAT21_CONNECTION Defines the external UDP channels to forward ADSB S Category 21 messages to UDP FORWARDING_CAT21 Enables forwarding of ASTERIX Category 21 messages via FALSE UDP UDP FORWARDING_CAT21_DEBUG Sets forwarding debug output for UDP forwarding of FALSE Category 21 Asterix Messages UDP FORWARDING_CAT244 CONNECTIO Defines the names of the external UDP channels to forward NS ADSB Category 244 messages to Note These channels must be defined in SMART UDP CONNECTIONS resource UDP FORWARDING_CAT244 Enables forwarding of ASTERIX Category 244 messages via FALSE UDP UDP FORWARDING_CAT244_DEBUG Sets forwarding debug output for UDP forwarding of FALSE Category 244 Asterix Messages SMART UDP CONNECTIONS The set of UDP connections from Edep ADSB to SMART Also connections to external clients SMART UDP ENABLED The SMART UDP connection is enabled FALSE UDP MESSAGE_T
77. specific resource values to be explicitly set via the command line 5 3 RESOURCE LIST This section lists the resources currently available to the developer for tailoring the Edep platform behaviour 5 3 1 1 General Resources Resource Description Default COMPONENTS The list of components to be instantiated within the VM This list contains elements of the form component class component name For example COMPONENTS atc ts TS TS lt c gt DEBUG_APP lt c gt Boolean flag indicating if Debug is active within the context of FALSE the given component s thread DEBUG_ UNKNOWN Boolean flag indicating if debug is active within the context of FALSE unknown threads e g RMI threads DEBUG Global flag for disabling debug everywhere when set to false FALSE WARNING Boolean flag defining if warning messages should be output TRUE MESSAGE Boolean flag defining if info messages should be output TRUE lt component gt SCENARIO The Entity scenario file used to populate the N a components database on startup lt component gt DYNAMIC_SCENARIO The monitored dynamic scenario directory Na lt component gt DYNAMIC_SCENARIO_UPDATE The default speed for polling of the 1000 monitored scenario directory in milliseconds Page 12 of 63 eDEP Reference GL eDEP USER 1 1 13 Page 13 of 63 eDEP 5 3 1 2 Recording and Replay resources Reference GL eDEP USER 1 1 13 The following resources are available for recording and replay Refer to s
78. splay of military flights in the PVT and allows the user to manipulate military flight plans XFL_MODEL Selects the method required to determine the initial value of the XFL TOCBOD value on a sector boundary prior to activation After activation the XFL may be negotiated between adjacent units The available methods are TOCBOD EDEP FM XFL_MODEL TOCBOD TOLERANCE The altitude tolerance to use for deciding ifan XFL should be set to 2500 the sector crossing altitude or the nearest TOD BOD TOC BOC when the preceding flag is set to TOCBOD Whether the LOA green levels should be used to determine the XFL TRUE FM XFL_MODEL USE_LOA_LEVELS in preference to any value calculated with the current XFL_MODEL FM COP_BORDER_THRESHOLD The threshold in nautical miles from a sector boundary within which 15nm a fix based LOA or a trajectory waypoint will be accepted as a COP for the crossing The generic name to be given to a COP at a sector boundary when no BDY FM COP_ANONYMOUS_NAME LOA or trajectory based COP is found FM DELETE_FLIGHT_ON_TRACK_DESTRUCTIO Determines whether the FM removes the corresponding flight from FALSE N its database when it receives a track destruction message from the IAS FM RECALC_ON_LONG_DEV Determines whether a flight s ground trajectory is recalculated when TRUE the flight deviates longitudinally from its trajectory FM RECALC _ON_VERTICAL DEV Determines whether a flight s ground trajectory is recalculated when FALSE the flight
79. t tests e Display options e NORMAL TRUE COLOUR PC resolution PC true colour e NORMAL PC resolution no true colour e BARCO i e 2k by 2k no true colour e Airin PVT e AWS graphics options Update Threshold Volatile Images Graphics update rate etc Some of these options are dependent on other options and may change automatically when selecting other options Once the options are set the user has the choice of either a visualising the traffic in the PVT or b running the scenario 7 4 DISTRIBUTED APPLICATION EXAMPLE For distributed applications the eDEP delivery is packaged with the following main files Page 53 of 63 eDEP e atcapp SimulationEngine Reference GL eDEP USER 1 1 13 useful for running the core FDPS amp Timer Console This main also runs up the central eDEP discovery server e atcapp SimulationEngineClient useful for running secondary components e g CWPs and ATC tools This main does not run up the central eDEP discovery server The Eclipse project is set up with launch configurations for the above mains These configurations will run the resource files found in atcapp resources componenttests distributed Since these files set the variable GSDK MIDDL EWAR E DISCOVERY HOST to localhost the client should be run on the same machine although in a separate VM as the server Note the SimulationEngine must be up and running before the SimulationEngineClient
80. tName FLIGHT_STRIP PACK_WHEN_FLIGHT_DE LETED 5 3 1 10 Eye Tracking Resources Resource Reference GL eDEP USER 1 1 13 panels The panels above use all of the remaining space in the PWP The width of the Order Entry panel The Data Entry panel expands to fill the remaining width of the PWP PVD centre position and scale Defines the map file to be used Defines dynamically the classes to be used for label graphics and label behaviour Defines dynamically the classes to be used for aircraft symbol graphics and label behaviour Determines whether the PWP will automatically wilco all incoming datalink messages all headings snapped to N degree intervals where N is specified in the resource Affects Direct to orders and resume own navigation data entry panels Beacons which would involve turns that are unachievable will be filtered from the list of available beacons The default number of rows cols to be displayed in the left hand data entry panel Modifying these parameters enables the user to increase the number of aircraft displayed in one page The user cannot reduce the number of aircraft below the default values Specifically sets the number of rows in the right hand data entry panel for direct to order entry Specifically sets the number of columns in the right hand data entry panel for direct to order entry Specifically sets the number of rows in the right hand data entry panel for own navigation heading entries
81. te TCAS messages and delayed 6 0 TCAS messages PM SQUAWK_IDENT_DURATION The length of time in seconds for which an aircraft will send an SSR 20 0 ident signal in response to a squawk ident order RESUME_ANGLE The maximum angle at which a flight will resume navigation Page 23 of 63 eDEP Reference GL eDEP USER 1 1 13 EARLY CLIMB ACROSS MULTIPLE POINTS THIS RESOURCE IS DEPRECATED FALSE AUTOMATIC_SID_AND STAR Causes SID and STAR orders to be issued automatically to follow the SID STAR trajectory MINIMUM_CAP_UPDATE_INTERVAL The fastest rate at which CAP messages are sent PWP DEFAULTS The default PWPs None SET_TIME FROM_TRACKS Uses the time from track updates to set the local component clock RECEIVED_STATE_VECTOR_DEBUG Debug output when a state vector received RECEIVED_ADSB_DEBUG Debug output when receiving ADSB reports ON OFF or DEBUG FALSE GENERATE_ADSB_DEBUG Debug output when generating ADSB reports ON OFF or DEBUG FALSE GENERATE_ADSB Sets whether PM generates ADSB reports FALSE PM PWP_DELAY ORDERS Whether or not orders generated from the PWP should be delay by FALSE the PM PM PWP_ORDERS DELAY MEAN The average delay to be suffered in seconds 0 PM PWP_ORDERS DELAY SPREAD The spread about the average delay i e min delay average 0 spread 2 and max delay average spread 2 in secon
82. that the above recording log files are copied over to the classes directory e Run the replay launch configuration This launch configuration should bring up e A single CWP e A Significant orders panel listing the significant events that occurred in both CWP 1 and CWP2 Page 54 of 63 eDEP Reference GL eDEP USER 1 1 13 7 6 3 The Discovery Monitor In order to examine which components are dispatching events which events they dispatch and how many components are paying attention to each event eDEP comprises the Discovery Monitor The monitor can either be run as part of the same application launch as the rest of the software run as a separate application on the same computer or be run remotely To run it as part of the same application simply insert this line into the component list gsdk middleware monitor Monitor Monitor To run it remotely or on the same computer as a separate application create a new GSDK resource with the following code substitute the name of the computer where the main application is running for Discovery Host if you re not running remotely substitute the name of your computer LOAD atcapp resources acceptancetests validation2002 resources common_cwp gsdk GSDK MIDDLEWARE DISCOVERY HOST lt Discovery Host gt GSDK MIDDLEWARE OPTIMISE COLLOCATION false GSDK MIDDLEWARE USE DISCOVERY SERVER true COMPONENTS gsdk middleware monitor Monitor Monitor When it is run t
83. the STAR The STAR may define STAR EGGW R1 1SP AIRPORT EGGW RUNWAY EGGW R10 COMPRISING A FIX EGGWO7 FLIGHT LEVEL 200 MACH SPEED 0 75 PHASE INITIAL FIX EGGWO6 FLIGHT LEVEL 100 CAS_SPEED 250 PHASE INTERMEDIATE FIX EGGWO5 FLIGHT LEVEL 60 PHASE FINAL FIX EGGWO4 FLIGHT LEVEL 20 CAS_SPEED 180 PHASE FINAL END Keyword Data description Data type Mandatory STAR Name String y AIRPORT Airport name String y RUNWAY Runway name String y No data just indicates COG start of fix list FIX Fix name String y FLIGHT_LEVEL dl eht level on Bus areir y n CAS SPEED and CAS _ SPEED CAS speed at fix Integer MACH_SPEED are mutually exclusive MACH_SPEED Mach speed at fix double n refer above INITIAL INTERMEDIATE FINAL If the value is not one of PHASE Approach phase the previous the y approach phase will be UNKNOWN This field is case sensitive Page 41 of 63 eDEP Reference GL eDEP USER 1 1 13 6 1 12 Unit Syntax Sectors may be grouped into units for control and coordination purposes The following example demonstrates the file syntax UNIT UNIT_FEEDER COMPRISING SECTOR FEEDER_1 SECTOR FEEDER_2 END 6 2 TRAFFIC FILE The traffic file read and processed by the IFPL component contains all the Initial Flight Plans of the simulation The eDEP supports two variants of IFPLs e 2D RFL the IFPL defines the route to be taken and an RFL The airspace AGREEMENTS are
84. the resource value 5 1 6 Resource File Locations The Edep platform resource files are located using the Java SDK resources mechanism This Java mechanism allows resource filenames to be specified in a similar fashion to package Imports i e simple pathnames independent of the filesystem For example packaged within the Edep delivery under the lt Edep Home gt ATC src atcapp directory are a number of example resource files As far as the SDK resource loader is concerned the path of such files is atcapp More specifically the SDK with search through all directories and jar files listed within the CLASSPATH variable in order to locate a resource file When using IDE tools such as Jbuilder and Eclipse the source Java code is kept separate from the compiled class code Obviously when running applications the CLASSPATH refers to the classes directory and not the source directory Therefore these IDE tools will automatically copy all resource files into this classes directory before running 5 1 7 Reserved Resource Names The resources file also defines a small number of reserved resource names as indicated in the table below Resource Name Description LOGICAL COLOURS User defined list of named colours mapped to an item name PHYSICAL COLOURS User defined list of RGB values identifying physical colours FONTS User defined list of font name strings 5 1 8 Scoped Resource Names amp Over
85. then used to dynamically determine the altitude profile e 3D the IFPL consists of a sequence of control points defining 2D and altitude values 6 2 1 Flight Plan Syntax The IFPL is constructed from a number of separate elements which resolve into a distinct constraint list identifying the preferred route and profile of the flight An example civil flight plan is shown below FLIGHTPLAN BAW2601 ACTIVATION 13305200 ORIGIN KJFK DESTINATION EHAM RFL 260 IFL 120 CFL 200 SSR_CODE 2304 SSR_MODE c ICAO ADDRESS 12ed445 ETD 12 52 0 0 MODEL B752 WAKE HEAVY WEIGHT MEDIUM CRUISE_CAS 480 TAIL NUMBER GBPEE AIRLINE Speedbird ROUTE SID NCL_R6_1 ROUTE_SEGMENT ROUTE ROUTE_4 FROM GOLES TO KIPPA CONTROL POINT FIX SPRAT CAS SPEED 400 CONTROL POINT FIX REDFA FLIGHT LEVEL 290 ROUTE SEGMENT ROUTE ROUTE 8 FROM GABAD TO LOGAN STAR EGGW_R1_1 END Page 42 of 63 eDEP Reference GL eDEP USER 1 1 13 An example military flight plan is shown below FLIGHTPLAN 5200 ACTIVATION 16 02 40 ORIGIN LHHR DESTINATION EHAM RFL 310 SSR_CODE 5200 SSR_MODE C FLIGHT TYPE MILITARY ETD 2023500 MODEL B744 WAKE HEAVY TAIL NUMBER MERGE1 DATALINK Non_Equipped AIRLINE Arctic Circle Air ROUTE CONTROL_POINT FIX MULIT CONTROL_POINT FIX BACAL CONTROL_POINT FIX GARBT END Page 43 of 63 eDEP Reference GL eDEP USER 1 1 13 Keyword Data descripti
86. ths through any set of fixes or indeed flying to anonymous points in space identified simply by a latitude and a longitude Each plan can also define information about the flight including its RFL and aircraft type information The traffic file syntax is elaborated in section 6 2 2 1 5 Java Security Policy Files Java security policy files need to be defined to enable the Java RMI to clear its compulsory security checks when it initialises and when information is passed through an RMI method invocation For standalone purposes the file will simply grant full access rights to the process If running across a network or over the Internet it might be necessary to allow access only to the required data sources 2 1 6 Graphics Displays When running an experiment the graphics displays will typically be provided by 7ctioned7ion CWP components The graphics may be output to MS Windows based displays or to Unix Linux based X Window based displays depending on the host operating system being used and the corresponding Java Virtual Machine JVM being run 2 1 7 Console The console provides a simple input and display device to monitor and control the progress of the simulation The baseline version simply controls the rate of flow of time and provides pause and resume functions 2 1 8 Logging and Analysis The logging and analysis facilities will allow inter component messages to be logged along with graphics events and other I O performed b
87. ugh a control point i e the following syntax is invalid CONTROL POINT BACON 53 855928 1 739048 If a new fix point is required it should be explicitly created in the airspace file Page 46 of 63 eDEP Reference GL eDEP USER 1 1 13 6 3 AIRCRAFT PERFORMANCE FILE 6 3 1 Methods of reading Aircraft Performance There are three supported ways to obtain aircraft performance data handcoded eDEP files BADA files which are then converted into the required type online and automatically generated eDEP files which were converted from the BADA data using an offline tool To specify which of these to use simply change the ACR SCENARIO and ACR SCENARIO_READER parameters in the resource as specified below Even if you believe that explicitly setting the ACR SCENARIO READER is unnecessary it introduces potential risks of future clashes and so it is always recommended to set the SCENARIO READER whenever you change the ACR SCENARIO 6 3 2 Hand coded eDEP Files In order to load using a basic eDEP file include the following lines in the resource file ACR SCENARIO atcapp resources common atc acrtypes dat ACR SCENARIO READER gsdk scenario ScenarioReaderImp1 The first line must specify the relative path of the file to be used the server requires an input file detailing the performance characteristics of all known aircraft types The format is as follows AIRCRAFT_TYPE B733 NOMINAL TURN_RADIUS
88. um When set to true the simulation start time is set to the system time and the simulation is started as soon as the TS component is started The play pause and fast forward buttons on the console are disabled when in this mode If the CLOCK SYNCHRONIZED_TO_UTC resource is set to true the CLOCK STARTTIME is ignored Defines the centre of projection in degrees for the application The values are simple floating point numbers Note this value should be identical for all components forming part of the same Edep application The coordinate conversion algorithm Defines the implementation class for the Constraint interface The default value is gsdk trajectory ConstraintImpl Defines the implementation class for the Trajectory interface The default value is gsdk trajectory Trajectorylmpl Defines the implementation class for the Waypoint interface The default value is gsdk trajectory WaypointImpl Page 17 of 63 true 00 00 00 None False 52 0 0 0 Gsdk geometry Lambert eDEP Reference GL eDEP USER 1 1 13 5 3 1 6 Core ATC Component Resources Resource Description Default ACSG Component CONNECTED Sets the TCAS source to ACAS server if true scripted if FALSE false The following resources are only required when CONNECTED TRUE ACS PORT_MTRK The port on which to send to the ACS for MTRK mes
89. ure sockets layer SSL based RMI GSDK MIDDLEWARE SSL KEYSTORE_FILEPATH Defines the file path to the key store Null containing the certificates to use to create the SSL sockets GSDK MIDDLEWARE SSL KEYSTORE_PASSPHRASE Defines the pass phrase to access Null the key store certificates Page 15 of 63 eDEP 5 3 1 4 Graphics Resources Reference GL eDEP USER 1 1 13 Resource Description Default CURSOR_SIZE 1 Default cursor mouse pointer 1 2 more visible cursor 3 larger more visible cursor DEBUG AWS PATCH FONTS Defines the list of fonts to use GSDK AWS OPTIMISE_ REDRAW Determines whether graphics optimisation should be used NONE GSDK AWS UPDATE_THRESHOLD GSDK AWS USE_VOLATILE_IMAGES GSDK AWS FULL_VOLATILE_IMAGES GSDK AWS LINK HEADING_FORMAT_CH ARS GSDK AWS LINK RANGE_FORMAT_ CHAR S GSDK AWS LINK HEADING_GRADUATIO N GSDK AWS MENU VERTICAL_MARGIN and GSDK AWS MENU HORIZONTAL_MARGIN GSDK AWS MENU DESTROY_ON_EXIT GSDK AWS MENU DESTROY_ON_BUTTON 3 GSDK RANGERING FREQ GSDK REGION LANE AIRLANE_WIDTH GSDK SWING_GRAPHICS_UPDATE_RATE GSDK REPORT HANDLERS GSDK REPORT LOGFILE GSDK REPORT TIMESTAMP GSDK REPORT TIMFORMAT GSDK AWS ZOOM_TO_MOUSE GSDK AWS USE_CENTRE_BUTTON_RECE NTRE GSDK AWS USE_CENTRE_BUTTON_PAN GSDK AWS PAN_SCALE_ FACTOR GSDK MAXIMUM_TRAIL_HISTORY GSDK EXTENDED_RANGE_AND_BEARIN G GSDK SPEED_FILTER_LOWER_BOUND GSDK SPEED_FILTER_UPPER_BOUND GSDK NUMBER_OF SPEED VECTOR BUT TONS
90. verter The user will be prompted to locate two dat files The first is the types dat file for the new BADA data as explained in section 6 3 3 specifying this wrongly will cause a program error although you will be able to respecify and try again The second is the target location to save typing in the name of a nonexistant file will create this and is recommended for this purpose Once the new file is generated simply specify it as the new ACR SCENARIO field in the resource Note that often BADA will change file format with each new release The current reader is known to work for version 3 5 however future versions are not guaranteed to be compatible with either the BADA offline converter or the BADA reader 6 4 MAP FILE 6 4 1 Map definitions The map details are stored in a single file which defines the bounding latitude longitude of the area from the South West corner to the North East corner It then defines a sequence of coastline and contour polygons with vertices given in floating point latitude longitude co ordinates All positions are quoted in degrees The syntax of the map file allows a wide range of two dimensional objects to be defined by providing a generic syntax for area linear and point features Each item in the map is classed as AREA LINEAR or POINT feature By default the feature is an AREA Each item can define a height above its local environment which is either sea level the default value or the height
91. y the platform This facility is to be completed Page 7 of 63 eDEP Reference GL eDEP USER 1 1 13 3 PLATFORM amp TOOLS INSTALLATION This section has been superseded by the Development Environment section of the eDEP Software Configuration Management Plan SCMP Ref 7 Page 8 of 63 eDEP Reference GL eDEP USER 1 1 13 4 DELIVERY STRUCTURE The Edep platform is delivered in one of two forms as a team developer project or as a restricted developer project The main difference between the two deliveries is that in the former the GSDK is delivered as source code whilst in the latter it is delivered as a compiled jar file 4 1 CVS STRUCTURE The Graffica developers work with the following CVS driven directory structure The configured column indicates which items are configured and must be placed under configuration control Directory Configured Description lt home gt Y project and classpath The Eclipse project files lt home gt products Contains derived products such as jar files 9ctione class files etc lt home gt scripts Y Contains useful script files bat csh ant including Edep xml used to generate the RMI stubs lt home gt TOOLS Y Contains auxiliary software such as JAXP DOM and Retroguard lt home gt ATC Y The ATC module lt home gt ATC scripts Y The script files e g launch files related to the ATC module lt home gt ATC sre Y The source code related to the ATC module This includes

eDEP User Guide eDEP - EUROCONTROL Experimental Centre

Contents

Download Pdf Manuals

Related Search

Related Contents