home *** CD-ROM | disk | FTP | other *** search
/ Chip: Special Di Besten Simulation / Chip_Special-Die_besten_Simulationen.iso / FLIEGEN / FS40 / ATPUTIL / ATPUTIL.DOC < prev    next >
Text File  |  1992-08-05  |  17KB  |  366 lines

  1.             ATP Utilities V1.60
  2.         (C) 1992 Simon Hradecky (CIS: 100031,336)
  3.  
  4.  
  5. The ATP utilities consist of: Career Assignment Editor, Logbook Editor,
  6. Career Results Editor, Flightplanner with Display/Print of Routes and detailed
  7. Fuel Calculation, Node-, Route-, Primary Airport- and ATC-Center Editor.
  8.  
  9. The ATP utilities are free to be copied to everyone. If you are satisfied
  10. and/or want to support further development, you may send US$ 20 cash in
  11. envelope to:
  12.  
  13.         Simon Hradecky
  14.         St. Julienstr. 2/406
  15.         A-5020 Salzburg
  16.         Austria
  17.         Europe
  18.  
  19. Another way of registration: I am able to collect fees via Mastercharge,
  20. Eurocard and VISA credit cards. In such case send Name, Adress, Credit card type,
  21. Card number and Expiration date to above adress via mail, fax
  22. (Fax No.: 43 - 662 - 877 689/14) or email (100031.336@compuserve.com).
  23. The charge will appear in your account as "NOMISSOFT G.m.b.H., Salzburg".
  24. Due to differences of exchange rates (when i present the charges in local
  25. currency and when you will be charged) the US$ amount may vary a little around
  26. US$ 20.
  27.  
  28. With those fees you support development of version 2.0 with following features:
  29. - Scan scenery for nodes and put them into the nodes file
  30. - Edit VORs, NDBs and ILSs within scenery
  31. - Airway database for ease of creating Routes
  32. - CISAIR support
  33.  
  34. If sufficient support is done, version 2.0 will appear until end of 1992.
  35.  
  36. Hardware:   (PC XT),PC AT 286/386/486 running DOS 3.x and above
  37.         minimum 560kB of free main memory
  38.         harddisk (minimum space 2MB)
  39.         optional mouse (recommended)
  40.         optional math coprocessor
  41.  
  42. Installation:  All Files of the ATPUTIL must be copied into the
  43. ------------- directory of ATP.
  44.            CONFIG.SYS must contain line:
  45.            FILES=20 (or more)
  46.  
  47. Start of Program: make your ATP directory the default directory, then
  48. ----------------- type ATPUTIL [print device [/nff]]<CR> at the DOS prompt.
  49.  
  50.            print device is an optional parameter. You may choose:
  51.            any regular device (LPT1,LPT2,COM1,COM2,COM3) (Note: no ":" at
  52.            the end!) or any regular filename including path. All print data
  53.            created by ATPUTIL will be sent to this device (Hardcopy still
  54.            works as before). If no printdevice is given, LPT1 will be used.
  55.            Examples: ATPUTIL LPT2                   prints to LPT2
  56.              ATPUTIL TEST.PRN /NFF          prints to file without
  57.                             formfeeds
  58.              ATPUTIL COM1                   prints to COM1
  59.              ATPUTIL D:\SPOOL\PRINT.JOB     prints to file
  60.              ATPUTIL                        prints to LPT1 with
  61.                             formfeeds
  62.  
  63.            The option /nff (NO FORM FEED) turns off printing of formfeeds
  64.            (all text on one page).
  65.  
  66. Configuration of ATPUTIL:
  67. -------------------------
  68.  
  69.            ATPUTIL is now able to read sceneries for being completely
  70.            compatible to ATP, when calculating directions. ATPUTIL needs
  71.            to know about the used scenery. Therefore the file "scenery.dat"
  72.            was introduced. Line 1 identifies the complete path of the
  73.            scenery including the name of scenery, but without extension.
  74.            If the scenery consists of more than one area files (GB1,GB2,GB),
  75.            a wildcard may be used. Line 2 identifies the coordinate
  76.            transformation between ATP coordinates and Lat./Long coordinates.
  77.            A 0 sets up for default transformation (USA,scenery F1) and a 2
  78.            sets up for GB scenery collections transformation. 1 and 3 are
  79.            unknown at this time. For use of GB transformation, "LATLON.BIN"
  80.            must exist in the default directory.
  81.  
  82.            If no "scenery.dat" is available, standard transformation is
  83.            used, but no north deviation will be calculated. If "latlon.bin"
  84.            does not exist in the default directory, only standard transfor-
  85.            mation will be used.
  86.  
  87.            Example:  Configuration for Standard Scenery:
  88.                 c:\atp\f1
  89.                 0
  90.              Configuration for GB Scenery collection:
  91.                 c:\atp\atpgb\gb*
  92.                 2
  93.              Configuration for IPS Scenery:
  94.                 c:\atp\atpips\??st-*
  95.                 0
  96.  
  97.  
  98. General Rules of user interface:
  99. --------------------------------
  100.  
  101. End and Leave a form with ENTER or ESC, while not editing a field.
  102. If you want to edit a field, press F3. Press INS for inserting or DEL for
  103. deleting data. While showing Informations, you may scroll down and up using
  104. Page_dn or Page_up (or click arrows with mouse).
  105.  
  106. Special Handling for Showing Career Results: you may alternate between
  107. normal flights and checkflights by pressing SHIFT-Left or SHIFT-Right. This
  108. also applies for showing the frequencies of ILSs and Centers.
  109.  
  110. Special Handling for Lat/Long Coordinates: In the Node, Primary and Center
  111. Editor you may press grey + ("+" in the number block), when editing a
  112. coordinate field. A second window will be brought, containing the Lat/Long.
  113. Coordinates, which may be edited. (see below, too).
  114.  
  115. Flightplan:
  116. -----------
  117.  
  118. The flightplanner is open for every airport. It uses the routes info of
  119. ATP, if both airports are primary airports. Otherwise it will find an
  120. ifr route, based upon the nodes info of ATP. The goals of the route finder
  121. are: There must always be contact to a VOR (if there is any chance). The
  122. route should be as short as possible (but due to timing problems the finder
  123. will not find the best, but a good route, which may last up to 30s [486/25]).
  124. The route finder does not know anything about airways or types of VORs.
  125.  
  126. You may add your own airport data to the file "AIRPORT.ATP", which contains
  127. the data of all to ATPUTIL available airports. The file can be edited with
  128. every text editor. In every line there is described one airport. First there
  129. is the code, then the location of the airport within parenthesis, then the
  130. runways, which are controlled by ATC for landing, then ";" and the other
  131. available runways (but not controlled by ATC). After the "-" there are the
  132. coordinates and the altitude of the airport.
  133.  
  134. You may choose a flightplan out of a career assignment (if a logbook is open,
  135. the next career-flight will be suggested) or input the airports manually.
  136. After manually input no weather conditions are used within calculation. In
  137. career calculation weather information within career file is used. You may
  138. view fuel results only after viewing routes.
  139.  
  140. Fuel data:
  141. Takeoff:   Fuel/time needed for takeoff and climbing 4000-5000 ft AGL.
  142. Departure: Fuel/time needed until command to climb cruising altitude.
  143. Climb:     Fuel/time needed to climb cruising altitude
  144. Enroute:   Fuel/time needed from reaching to leaving cruising altitude
  145. Descend:   Fuel/time needed for descend to far approach
  146. approach:  Fuel/time needed from entering approach control zone to
  147.        landing clearance.
  148. landing:   Fuel/time needed for final approach and reverse thrust.
  149.  
  150. All calculations are based upon experiences with ATP and are optimized for
  151. ATP. They must not be used for real navigation.
  152.  
  153. After choosing Fuel the best calculation will be shown. You may choose other
  154. altitudes with Page_dn or Page_up.
  155.  
  156. Print Flightplan:
  157. -----------------
  158.  
  159. The flightplan can be printed by answering YES to the question "print ...".
  160. You will be given the opportunity after viewing route and frequency
  161. information (route and frequencies will be printed), and after viewing fuel
  162. (the fuel information is printed). There is no configuration for the used print
  163. device necessary, the printer need to support CR (Carriage Return), LF
  164. (Line Feed) and FF (Form Feed). If the printdevice is a file, the output will
  165. be appended to the end of the file (so you may store a lot of flightplan
  166. and fuel informations in one file).
  167.  
  168. Node Editor:
  169. ------------
  170.  
  171. The node editor may hold up to 1500 nodes (original ATP database has 576
  172. nodes). If your PC has not enough memory, the program may crash (unrecoverable
  173. error in the user interface library). The nodes database is for ATC use only.
  174. Therefore changes do not alter the scenery files (which means, that you will
  175. not see any new VOR, or position changes of VORs, while navigating in ATP).
  176. ATC will guide you based upon the nodes and assume, that given VORs are
  177. located on the given positions and are working properly. If you want to edit
  178. a new NODES database, you have to clear NODES.BIN within Nodes menu.
  179.  
  180. Route Editor:
  181. -------------
  182.  
  183. The route editor may change only routes between primary airports (altering
  184. ROUTES.BIN). The route editor is not capable of editing two routes between
  185. the same airports, regardless to direction of routing (the file must not
  186. exceed 60k), if there was only one route for both directions (which is
  187. the case in the default ROUTES.BIN). If you want to generate a new
  188. ROUTES.BIN, you have to clear routes within nodes menu (NOTE: ATP perhaps will
  189. lock up, if you try to start with an empty route file. At least the route from
  190. airport 12 (=LAX) to airport 23 (=SFO) must exist, you have to reedit this
  191. route). After finishing the route, ATPUTIL checks the given radials according
  192. to the locations of VORs and yells, if there is a deviation of more than 5 degrees.
  193. Then you may choose ATPUTIL to change the radials by itself.
  194.  
  195. If there are only unidirectional routes, you may convert them to bidirectional
  196. routes by activating "Bidir. Routes" in menu NODES/PRIMARY. ATPUTIL checks
  197. for existance of one way routes and opens the way retour.
  198.  
  199. Adapting ATP for a new scenery:
  200. -------------------------------
  201.  
  202. If you want to generate ATC routes for different sceneries, you will have
  203. to do following steps:
  204.  
  205. 1.) duplicate your ATP directory
  206.     (you may want to choose to fly within USA or other sceneries)
  207.     otherwise you will have to rename the files described in 9.)
  208.     frequently
  209. 2.) Edit Primary Airports
  210.     You will have to install airports of the new scenery as primary
  211.     airports.
  212. 3.) Edit ATC Control Centers
  213. 4.) Generate a new NODES.BIN and a new ROUTES.BIN
  214. 5.) Generate a new AIRPORT.ATP File, according to above description
  215.     Be sure to enter the primary airports in the first 26 lines in correct
  216.     order, then the secondary airports
  217. 6.) Edit the NODES within ATPUTIL
  218. 7.) Edit the ROUTES within ATPUTIL (you'll have to edit the nodes and
  219.     AIRPORT.ATP first!)
  220.     NOTE: The route from airport 12 (=LAX in USA scenery) to airport 23
  221.     (=SFO in USA scenery) must exist, otherwise ATP may lock up at the demo
  222.     flight at the start.
  223. 8.) Alter the career assignments according to the new airports
  224.     just as you like
  225. 9.) Contribute your new AIRPORT.ATP,NODES.BIN,ROUTES.BIN and CAREER.ATP
  226.     and the Primary Airport File to ATP Lib (dont forget to PKZIP them)
  227.     for the benefit of other users.
  228.  
  229. Primary and Center Editor:
  230. --------------------------
  231.  
  232. The Editors are only available, if your ATP.EXE is recognized correctly by
  233. ATPUTIL (i designed that algorithm to be compatible with all known patches
  234. and changes by other tools). If the message appears, that ATPUTIL can not
  235. identify your version of ATP.EXE, be sure that ATP.EXE and FOREIGN.ATP exist
  236. in your default directory. If the error still exists, PKZIP your original
  237. ATP.EXE and FOREIGN.ATP and send it to me via EMAIL. An Upgrade of the UTILs
  238. will appear as soon as possible.
  239.  
  240. You may change all data of the primary airports. The sum of the length of
  241. all airport names must not exceed 254 Bytes (including a NUL Byte at the end
  242. of every name), also the runway table must not exceed its original length.
  243. ATPUTIL checks for this and refuses update of ATP.EXE, if an error is recognized.
  244. Data are: Location and direction of aircraft at terminal, Location and
  245. direction of aircraft after autotaxi, several frequencies (approach=departure
  246. frequency), the controlled landing runways and uncontrolled runways. Do not
  247. forget to change the airport data in AIRPORT.ATP, too!
  248.  
  249. Note, that the airport name may be a center name, too. 10 Centers out of the
  250. primary airports are possible. Each center consists of 4 subareas, which are
  251. conrolled on different frequencies. If the coordinates indicate to be within
  252. one control center, but no subarea fits, the default frequency will be chosen.
  253.  
  254. Frequency Display:
  255. ------------------
  256.  
  257. After displaying the route information, which you left with ESC, a second
  258. screen will be shown with all necessary frequency informations. Even the
  259. Center frequencies, you will be connected to, will be shown. The centers are
  260. identified at every node, given within the route. The frequency display only
  261. appears, if ATP.EXE is identified by ATPUTIL (see above) and both airports
  262. are primary.
  263.  
  264. Lat/Long. Coordinates:
  265. ----------------------
  266.  
  267. In the node, primary and center editor you may use Lat/Long coordinates
  268. instead of the ATP Coordinates. Enter the coordinate field (North or East),
  269. then press the grey + key ("+" in the number block). A window with Lat/Long.
  270. Coordinates will appear. Change the data, press ENTER. The window will close
  271. and both ATP Coodinates will be updated according to the Lat/Long. data.
  272. The correct transformation will be identified by Line 2 of file "scenery.dat":
  273. 0 .. ATP default scenery (USA)
  274. 1 .. unknown at this time
  275. 2 .. GB scenery collection
  276. 3 .. unknown at this time
  277.  
  278. Scenery read:
  279. -------------
  280.  
  281. ATPUTIL automatically reads the sceneries for getting north deviation, whenever
  282. it is needed. You need to setup scenery.dat properly (see above) for using
  283. that feature. If ATPUTIL does not find the scenery or has not enough memory
  284. for reading the scenery, no north deviation will be calculated (making
  285. differences of about -35 to +20 degrees).
  286.  
  287. Possible error messages about scenery read problems:
  288.  
  289. Illegal Scenery Code encountered  ...  Contact Author
  290. No matching area found            ...  There was no area matching the given
  291.                        location, therefore no north dev.
  292.                        can be used - continue work
  293. SCENERY.DAT not found             ...  The configuration file is missing
  294.                        - exit ATPUTIL and create file
  295. Scenery files not found           ...  The path or filename given in
  296.                        SCENERY.DAT does not match
  297.                        - exit ATPUTIL and correct
  298. Not enough memory to process scenery.  1) Not 560 kB of free memory
  299.                       - exit ATPUTIL and correct
  300.                        2) Earlier heavy action causing memory
  301.                       fragmentation. ATPUTIL is not able
  302.                       to locate a contiguous memory block
  303.                       large enough for scenery read.
  304.                       - restart ATPUTIL
  305.  
  306.  
  307. Import and Export of Primary airports:
  308. --------------------------------------
  309.  
  310. ATPUTILs are able to interchange primary airports between several versions of
  311. ATP (as well as users) by exporting the primary airports and then importing
  312. the resulting file to a new ATP. This feature can also be used to send primary
  313. airport configuration to other users without sending the EXE-File.
  314.  
  315. After selecting Export ATPUTIL will ask you for the name of the file, which
  316. will store the primary airport configuration. You may enter a path and file-
  317. name with extension (as in DOS). ATPUTIL will then write all primary data
  318. including center data to that file.
  319.  
  320. After selecting Import ATPUTIL you may enter the file name including path and
  321. extension (as in DOS), where ATPUTIL previous stored primary configurations.
  322. ATPUTIL will then read all data. NOTE: You must update the file, before the
  323. new primaries come in effect for flights.
  324.  
  325.  
  326.  
  327. Revision History:
  328. -----------------
  329. 1.00  2/15/92      First Release
  330. 1.01  2/17/92      some bugs corrected
  331. 1.10  3/03/92      flight planner opened for all airports
  332. 1.11  3/10/92      bugs corrected
  333. 1.20  4/26/92      Node and Route Editor added
  334. 1.30  5/09/92      Primary Airport-, Air Traffic Control Center-Editor added
  335.            Frequency Display at Route Information
  336.            Clear Node+Route Files built in
  337.            "DIRECT" bug corrected
  338.            Temperature problem fixed
  339.            Formula for magnetic north deviation revised
  340.               (but there is a difference of up to 4 degrees to ATP
  341.             remaining)
  342. 1.31   5/10/92     ATP.EXE Version 12/19/90 supported
  343. 1.40   5/21/92     lost cluster bug fixed
  344.            Transformation between ATP and Lat/Long coordinates added
  345.            Print Routines added to Flightplanner
  346.            Memory Usage reduced by 64k
  347. 1.41   7/11/92     Bug in Fuel printout corrected
  348.            /nff option added (no form feed)
  349.            change to Compiler MSC 7
  350. 1.42   7/17/92     Change back to Compiler MSC 6 (MATH ERROR in View Route
  351.             corrected)
  352. 1.50   7/28/92     ATP-Scenery read for getting North Deviation
  353.             (no more difference to ATP)
  354.            Full support of all current Lat/Lon coordinate transformations
  355.            Make existing routes bidirectional
  356.            Import and Export of primary airports
  357. 1.60   8/06/92     Bug in Lat/Long Coordinates (seconds) corrected
  358.            Bug in scenery read corrected (MATH Error, if scenery not found)
  359.            crashes due to Scenery Overrun fixed
  360.            Bug in Bidirectional routes fixed (Null Pointer Assignment due
  361.               to compiler bug, no action)
  362.            Support of FS4 Sceneries added
  363.  
  364.  
  365. Hope, you enjoy these tools.
  366.