source: doc/manual/en/index.html@ 232:e8102d6ba023

Last change on this file since 232:e8102d6ba023 was 228:bc6592d202b4, checked in by István Váradi <ivaradi@…>, 12 years ago

Minor fixes and added the screenshots for the English manual
File size: 38.1 KB
Line 
1<html>
2<head>
3 <title>MAVA Logger X User's Manual</title>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
5</head>
6<body>
7 <div align="center"><h1>MAVA Logger X User's Manual</h1></div>
8
9 <h2><a name="overview">Overview</a></h2>
10
11 <p>
12 MAVA Logger X is an application that monitors the execution of a
13 Malév Virtual flight, and collects data that can be sent to the MAVA
14 website for further evaluation. This manual describes how to use
15 this program. To be able to use all features of the program, you
16 need to have a working Internet connection, even if you don't fly
17 on-line on VATSIM or IVAO. However, it is possible to perform a
18 flight completely offline as well.
19 </p>
20
21 <p>
22 While monitoring your flight, the program continuously checks if your
23 airplane's configuration is always within the parameters prescribed
24 by the airline's operating procedures. For example, you have to turn
25 on or off the various lights of your aircraft according to rules,
26 you cannot exceed certain weight or speed limits, and so on. Any
27 deviation from the expected parameters, also known as a fault, can
28 result in points subtracted from the initial 100 points (or
29 percentage). The result is your <i>flight rating</i>. Some
30 deviations are so serious, that they are deemed <i>NO GO</i> faults
31 and result in the rejection of your flight.
32 </p>
33
34 <p>
35 Besides the faults the program also monitors many other parameters,
36 which are recorded in a textual <i>log</i>. This log is sent as a
37 part of your PIREP (<b>PI</b>lot's <b>REP</b>ort), and will be
38 analyzed, and possibly commented on by more experienced pilots of
39 Malév Virtual. This way you can perfect the way you execute your
40 flights.
41 </p>
42
43 <p>
44 The application breaks up your flight into
45 several <i>stage</i>s. The advancement from one stage to another is
46 detected automatically. These stages and the conditions under which
47 they are entered are as follows:
48 <ol>
49 <li><b>boarding</b>: This is the initial stage when you start the
50 flight.</li>
51 <li><b>push-back and taxi</b>: If you release the parking brakes
52 or your ground speed becomes 5 knots or greater during the
53 boarding stage, your flight enters this stage.</li>
54 <li><b>takeoff</b>: If you turn on the landing and/or the strobe
55 lights or your ground speed exceeds 80 knots during taxi or after
56 a rejected takeoff (RTO).</li>
57 <li><b>climb</b>: When you retract the gears or you reach 3000
58 feet altitude AGL with a positive climb rate after takeoff.</li>
59 <li><b>RTO</b>: If you switch off both the landing and the
60 strobe lights, and your speed is reduced below 50 knots while on
61 the ground during takeoff.</li>
62 <li><b>cruise</b>: When the aircraft's altitude is within 2000
63 feet of the cruise altitude and you are climbing.</li>
64 <li><b>descent</b>: If the altitude decreases to more than 2000
65 feet below the cruise altitude during cruise.</li>
66 <li><b>landing</b>: If the gears are lowered and the altitude is
67 less than 2000 feet AGL during descent or go-around.</li>
68 <li><b>go-around</b>: If you retract the gears during landing.</li>
69 <li><b>taxi after landing</b>: When the aircraft is in the
70 ground and its ground speed is below 50 knots after landing.</li>
71 <li><b>parking</b>: If the parking brake is activated after taxi.</li>
72 <li><b>end</b>: If the N<sub>1</sub> of the turbines becomes
73 less than 0.5, or the RPM of the piston engines becomes 0 during
74 parking. This is the final stage.</li>
75 </ol>
76
77 <p>
78 To enhance the simulation, the program can play various sound files
79 during the various stages of your flight, such as the announcements
80 made by the flight attendants. These files are supplied with the
81 application, and they can be played automatically, or when you press
82 a certain hotkey in the flight simulator. You can also organize
83 pre-recorded sound files into checklists for the each aircraft
84 type, and these files can also be played back one-by-one when you
85 repeatedly press a key combination in the simulator. See below for
86 more information on this.
87 </p>
88
89 <p>
90 Malév Virtual have implemented an <i>Online ACARS System</i>, which
91 displays the status of the flights in progress. The data appears on
92 the front page of the MAVA website and also on a map.
93 </p>
94
95 <p>
96 Malév Virtual have also implemented an <i>Online Gate System</i>
97 which maintains a database of the aircraft in the airline's fleet
98 and their location. An aircraft may be parked at the Budapest
99 Ferihegy Airport, in which case the number of the gate or stand it
100 is located at is recorded in the database. If so, this number is
101 displayed to you when starting your flight from Ferihegy, and you
102 are recommended to place your aircraft at the indicated gate or
103 stand in the simulator. If your flight begins at Ferihegy and the
104 aircraft is away (usually due to someone else's flight), you can
105 select from which gate or stand you start your flight. The database
106 of the Online Gate System can also be displayed by using the
107 application.
108 </p>
109
110 <p>
111 These online systems can only be used when flying online.
112 </p>
113
114 <p>
115 The program can automatically update itself. When it starts up, it
116 checks if there is a newer version available. If so, it downloads
117 its files and replaces the program's current files with the new
118 ones. Then the program is restarted so that you can use the new
119 version. Besides acquiring bug fixes, updating is also important,
120 because the program can be extended with new checks or more refined
121 checks, and if you are using too old a version, the PIREP reviewers
122 may refuse your flight.
123 </p>
124
125 <h3><a name="gui">Graphical User Interface</a></h3>
126
127 <p>
128 The GUI of the application is made up of traditional building blocks
129 (buttons, checkboxes, lists, text entry boxes, etc.) found in other
130 applications as well. Many such controls have informative tooltips
131 that supplement the contents of this User's Guide in helping you
132 using the application. Many controls are also accessible by pressing
133 the <b>Alt</b> plus the underlined letter in the control's label.
134 </p>
135
136 <p>
137 The most often used part of the program is the main window, to be
138 described in detail below. When you minimize or close the window, it
139 disappears by default, but the program continues to run. You can
140 redisplay the window by clicking on the tray icon of the program,
141 which looks like the one on the picture below.
142 </p>
143
144 <div align="center">
145 <table>
146 <tr>
147 <td>
148 <img src="statusIcon1.png" alt="The status icon" hspace="20"/>
149 </td>
150 <td>
151 <img src="statusIcon2.png" alt="The status icon menu" hspace="20"/>
152 </td>
153 </table>
154 </div>
155
156 <p>
157 If you click on the tray icon when the program's window is hidden,
158 the window will be displayed. If you hover the mouse pointer over
159 the icon, the flight stage and the current rating will be
160 displayed. The tray icon has a right-button menu as well with the
161 following items:
162 <ul>
163 <li><b>Show main window</b>: displays or hides the main window.</li>
164 <li><b>Show monitor window</b>: displays or hides the monitor
165 window (see below).</li>
166 <li><b>Quit</b>: quit the application. A confirmation window will
167 be displayed.</li>
168 </ul>
169 </p>
170
171 <p>
172 You can also quit the application by selecting the <b>File/Quit</b>
173 menu item, or by pressing <b>Ctrl+Q</b>.
174 </p>
175
176 <p>
177 If you start the application, when it is already running, the main
178 window of the already running instance will be displayed instead of
179 starting a new instance of the program.
180 </p>
181
182 <h2><a name="mainWindow">The Main Window</a></h2>
183
184 <p>
185 The figure below depicts the main window of the application. The top
186 of it contains the usual menu bar, which will be described in more
187 detail later. The content area consists of several tabs the use of
188 which is described below.
189 </p>
190
191 <div align="center"><img src="mainWindow.png" alt="The main window"/></div>
192
193 <p>
194 The bottom of the window is a status bar. Its left side contains the
195 icon indicating the status of the connection to the simulator. Since
196 the application continuously monitors the parameters of your
197 aircraft, it needs to communicate with the simulator. The icon's
198 colour indicates the health of this communication channel.
199 </p>
200
201 <p>
202 If it is grey, the program is not connected. This is normal before
203 and after the flight. If it is green, the connection is alive and
204 working properly. If it is red, the connection is broken. In this
205 case a dialog window is displayed. The most likely cause for such a
206 disruption is the crash of the simulator. If this is the case,
207 restart the simulator and try to restore the flight to a state as
208 close to the one before the crash as possible. Then click
209 the <b>Reconnect</b> button, and the program will try to
210 re-establish the connection to the simulator. It preserves all data
211 of your flight, so you can continue where you left off easily.
212 </p>
213
214 <p>
215 If the reason for the failure of the connection is something else,
216 do whatever is needed to be done to restore it. Of course, it is
217 possible that the logger application itself fails, in which case
218 you, unfortunately, have to restart the flight. Do not forget to
219 notify the author if this happens. In this case, try to copy and
220 save the debug log and send it with your bug report.
221 </p>
222
223 <p>
224 If you click the <b>Cancel</b> button in the reconnection dialog,
225 the logger will be reset as if it were stopped and restarted.
226 </p>
227
228 <p>
229 To the right of the connection status icon, you can see the current
230 stage of the flight, if the monitoring has begun. Otherwise it is a
231 single dash. It is followed by the simulator time, if the program is
232 already connected to the simulator. Then comes the current flight
233 rating.
234 </p>
235
236 <p>
237 The right of the status bar is normally empty, but if there is some
238 potentially long operation going on (typically communicating with
239 the MAVA servers), information about the operation is displayed
240 here. This is accompanied by the cursor becoming that of signaling
241 a busy state and most parts of the main window becoming
242 unresponsive.
243 </p>
244
245 <h3><a name="tabFlight">The Flight Tab</a></h3>
246
247 <p>
248 The flight tab is the most important tab. It consists of a sequence of
249 pages similar to wizards found in many programs. The first several of
250 these pages guide you through the various steps of the preparations
251 for your flight, while the last pages allow you to enter some
252 information about your flight necessary for its evaluation and to
253 send the PIREP (Pilot's Report) assembled by the program to the MAVA
254 website.
255 </p>
256
257 <p>
258 Each page has a title at the top indicating the purpose of the
259 page. There is a short text below this, which describes what the
260 page contains and/or what is expected from you to do with the page.
261 Below the text you can find the main information and possibly data
262 entry areas for the page. Finally, you can find the button row at
263 the bottom.
264 </p>
265
266 <p>
267 Most of the pages contain two buttons: <b>Next</b> and
268 <b>Previous</b>. These help in navigating between the pages. In most
269 cases you can go back to previously visited pages by using
270 the <b>Previous</b> button, although you cannot edit the contents of
271 those pages once finalized by moving to the next page using
272 the <b>Next</b> button. There are a few exceptions though, as
273 detailed below.
274 </p>
275
276 <p>
277 Many of the pages also contain a <b>Cancel flight</b>
278 button. Clicking this button will allow you to cancel the flight and
279 go back to the flight selection if you have logged in to the MAVA
280 website, or the login page, after a confirmation of your intent.
281 </p>
282
283 <h4><a name="loginPage">The <i>Login</i> Page</a></h4>
284
285 <p>
286 Each flight starts with the Login page where you can enter the your
287 pilot's ID and password for the MAVA website. Both data are given
288 to you when joining Malév Virtual. The pilot's ID usually starts
289 with the letter <q>P</q> followed by three digits.
290 </p>
291
292 <p>
293 If you check <b>Remember password</b>, the password will be saved by
294 the program, so you don't have to enter it all the time. Note,
295 however, that the password is saved plainly into a configuration
296 file, so you this possibility only if your home directory can be
297 accessed only by people you trust. The pilot's ID is saved anyway.
298 </p>
299
300 <p>
301 If you are about to perform the entrance flight, check
302 <b>Entrance exam</b>. In this case you don't have to (and cannot)
303 enter the password, as that is not needed for the entrance exam.
304 </p>
305
306 <p>
307 The login to the MAVA server, and proceed to the next page, press
308 the <b>Login</b> button.
309 </p>
310
311 <p>
312 If you would like to fly without an Internet connection, use
313 the <b>Fly offline</b> button. This immediately takes you to the
314 next page, without trying to log in to the MAVA website.
315 </p>
316
317 <h4><a name="flightSelectionPage">The <i>Flight selection</i> Page</a></h4>
318
319 <img src="flightSelection.png" alt="The Flight selection page"/>
320
321 <p>
322 This page displays the list of the flight you have booked previously
323 on the MAVA website, if you have logged in properly. If you chose to
324 fly offline, the list is empty.
325 </p>
326
327 <p>
328 If you have selected a flight, you can also save it by using
329 the <b>Save flight</b> button. This is useful when planning to fly
330 offline at some later time. When preparing for that flight, you can
331 properly log in to the MAVA website, and acquire the list of your
332 booked flights. Then you can save the flight you wish to perform
333 later offline, on which occasion, you can load the saved flight.
334 </p>
335
336 <p>
337 You may need to refresh the list of flights. For example, you notice
338 that you have forgotten to book the flight you want to perform. Then
339 you can book the flight on the MAVA website, and press
340 the <b>Refresh flights</b> button to update the list.
341 </p>
342
343 <p>
344 You can also load a flight from a file by pressing the <b>Load
345 flight from file</b> button. This displays a file selection dialog
346 where you select the flight file (usually with a suffix
347 of <code>.vaflight</code>). This is mostly useful when flying
348 offline, or during the entrance exam.
349 </p>
350
351 <p>
352 Select a flight from the list, and press <b>Next</b> button to
353 proceed with that flight.
354 </p>
355
356 <h4><a name="gataSelectionPage">The <i>LHBP gate selection</i> Page</a></h4>
357
358 <img src="gateSelection.png" alt="The LHBP gate selection page"/>
359
360 <p>
361 This page is displayed after the flight selection page only if your
362 flight starts at the Budapest Ferihegy Airport and the number of the
363 gate or stand at which your aircraft is located cannot be
364 determined.
365 </p>
366
367 <p>
368 Select a number from the list presented, and press <b>Next</b>.
369 </p>
370
371 <h4><a name="connectPage">The <i>Connect to the simulator</i> Page</a></h4>
372
373 <img src="connect.png" alt="The Connect to the simulator page"/>
374
375 <p>
376 This page displays some important information about your flight,
377 such as the type and tail number of the aircraft to use, the
378 departure airport and possibly the gate.
379 </p>
380
381 <p>
382 Select the aircraft indicated and park it at the departure airport,
383 then press <b>Connect</b> to establish the connection with the
384 simulator. If the connection cannot be established, a dialog will be
385 displayed about it, and you can <b>Try again</b> the connection
386 or <b>Cancel</b> to go back to the login page.
387 </p>
388
389 <p>
390 Note, that after a successful connection, the monitoring of your
391 flight does not begin immediately, but some data can be queried by
392 the logger at this stage.
393 </p>
394
395 <h4><a name="payloadPage">The <i>Payload</i> Page</a></h4>
396
397 <img src="payload.png" alt="The Payload page"/>
398
399 <p>
400 This page displays the components of the flight's payload and the
401 calculated Zero-Fuel Weight (ZFW). You can enter here the cargo
402 weight you determined for your flight. You can also press the <b>ZFW
403 from FS</b> button, which queries the ZFW from the simulator and
404 displays the retrieved value. If the ZFW calculated from the payload
405 data differs too much from the queried one, the calculated value is
406 displayed in red. This the right time to set up the payload in the
407 simulator. If you forget about it, it will be a NO GO fault.
408 </p>
409
410 <p>
411 If you have finished with this page, press the <b>Next</b>
412 button. At this point, the <i>Help</i> tab becomes available, which
413 you can use if you have failed to set up the correct payload in the
414 simulator. See a more detailed description of it below.
415 </p>
416
417 <h4><a name="timePage">The <i>Time</i> Page</a></h4>
418
419 <img src="time.png" alt="The Time page"/>
420
421 <p>
422 This page displays the departure and arrival times of your
423 flight in UTC. Press the <b>Time from FS</b> button to query the
424 current UTC time of the simulator. To be able to simulate the real
425 lighting circumstances of the flight, the simulator's time should match
426 the time of the flight according to the schedule. Therefore you are
427 expected to set the simulator's time properly. It is recommended to
428 set it to about 15 minutes before the departure at this stage so
429 that you have enough time to set up your flight.
430 </p>
431
432 <p>
433 When you have set the time of the simulator properly, press
434 the <b>Next</b> button.
435 </p>
436
437 <h4><a name="fuelPage">The <i>Fuel</i> Page</a></h4>
438
439 <img src="fuel.png" alt="The Fuel page"/>
440
441 <p>
442 This page contains a graphical representation of the fuel tanks of
443 your aircraft. The yellowish colour represents the current level of
444 the fuel in the tank, and turquoise slider is the expected level,
445 which is also displayed numerically (in kilograms) below each graph.
446 </p>
447
448 <p>
449 You can enter the requested amount of fuel numerically, or you can
450 set it by the turquoise sliders, though this method less accurate. The
451 lever can be moved by clicking in the fuel tank's representation,
452 and you can drag it if you keep the button pressed. If your mouse
453 has a wheel, that can also be used to modify the expected level. To
454 use the wheel, keep the mouse pointer within the fuel tank's
455 graphic. Each click of the wheel increment or decrements the amount
456 by 10 kilograms. If you hold down the <b>Shift</b> key, the
457 increment will be 100, if you hold down the <b>Ctrl</b> key, the
458 increment will be 1.
459 </p>
460
461 <p>
462 When all tanks have the correct amount of fuel set, press
463 the <b>Next</b> button. This causes the pumping of the fuel to
464 start. The progress is represented by the yellowish fuel bars
465 growing or shrinking (fuel may be pumped out of a tank as
466 well). This is a relatively quick process and should finish within a
467 few seconds.
468 </p>
469
470 <h4><a name="routePage">The <i>Route</i> Page</a></h4>
471
472 <img src="route.png" alt="The Route page"/>
473
474 <p>
475 This page displays the cruise level and the flight plan route. The
476 cruise level starts out at FL240, but the route comes from the
477 booked flight. Set the cruise level to the one you have calculated
478 with, and modify the flight plan if needed. For example, if you will
479 enter some airspace that will require you to change the flight
480 level, you should add that here.
481 </p>
482
483 <p>
484 When satisfied with the information on the page, press
485 the <b>Next</b> button to advance. Note, that these data can be
486 edited later as well if you come back to this page.
487 </p>
488
489 <h4><a name="briefingPage">The <i>Briefing</i> Pages</a></h4>
490
491 <img src="briefing.png" alt="The Briefing page"/>
492
493 <p>
494 These pages display the NOTAMs and the METAR for the departure and
495 the arrival airports. You can edit the METAR if your network
496 provides a different weather, or you do not fly with real
497 weather. The METAR of the arrival airport will be updated when
498 entering the landing stage, unless you have edited it before. The
499 METARs can be edited during the whole duration of the flight. If you
500 do so, please, comment it in the <i>Comments</i> sections of
501 the <i>Flight info</i> tab.
502 </p>
503
504 <p>
505 On the second briefing page (that of the arrival airport), confirm
506 that you have read the briefing and are ready to start the flight by
507 clicking the button. This begins the monitoring of your flight with
508 the boarding stage.
509 </p>
510
511 <h4><a name="takeoffPage">The <i>Takeoff</i> Page</a></h4>
512
513 <img src="takeoff.png" alt="The Takeoff page"/>
514
515 <p>
516 On this page you have to enter the name of the departure runway, the
517 name of the Standard Instrument Departure procedure you follow after
518 takeoff and the takeoff V-speeds. While you can edit these data
519 anytime, it is recommended to do so before takeoff.
520 <p>
521
522 <p>
523 You can proceed to the next page after takeoff, and if all data has
524 been entered, by pressing the <b>Next</b> button.
525 </p>
526
527 <h4><a name="landingPage">The <i>Landing</i> Page</a></h4>
528
529 <img src="landing.png" alt="The Landing page"/>
530
531 <p>
532 On this page you have to enter the name of the STAR and/or transition followed
533 (if you get vectors from ATC, enter <q>VECTORS</q> here), the
534 approach type (e.g. <q>ILS</q>, <q>VOR</q>, <q>VISUAL</q>, etc.),
535 the name of the landing runway, and the landing reference speed,
536 V<sub>ref</sub>. You can enter this data during the flight, or after
537 you have landed, at your discretion.
538 </p>
539
540 <p>
541 When you have entered all data, press the <b>Next</b> button. It is
542 active only, if the flight has ended.
543 </p>
544
545 <h4><a name="finishPage">The <i>Finish</i> Page</a></h4>
546
547 <img src="finish.png" alt="The Finish page"/>
548
549 <p>
550 This is the final page of the flight wizard. It contains a summary
551 of your flight: the rating, the flight and block times, the distance
552 flown and the amount of fuel burnt.
553 </p>
554
555 <p>
556 You also have to provide a few pieces of information. You have to
557 select the type of the flight from the list provided (scheduled,
558 old-timer, VIP, charter) and whether it was an online flight or
559 not. If you arrive at the Budapest Ferihegy Airport, and are using
560 the Online Gate System, you also need to specify the number of the
561 gate or stand you have parked you aircraft at.
562 </p>
563
564 <p>
565 With all data entered, you may want it review your flight, then save
566 or send the PIREP created from it. These can be accomplished by
567 pressing one of the buttons at the bottom. A saved PIREP can be
568 loaded later and sent, if the sending fails for some reason. When a
569 PIREP is sent, it becomes available for review by the designated
570 PIREP reviewers of Malév Virtual.
571 </p>
572
573 <p>
574 You can also start a new flight using the <b>New flight</b>
575 button. If you have not saved or sent the PIREP, you will be asked
576 to confirm your intention. When starting a new flight you are taken
577 to the flight selection page, if you have logged in to the MAVA
578 website, or to the login page, if your flight has been an offline
579 flight.
580 </p>
581
582 <h3><a name="flightInfoTab">The Flight info Tab</a></h3>
583
584 <img src="flightInfoTab.png" alt="The Flight info tab"/>
585
586 <p>
587 This tab allows one to enter some additional information about the
588 flight, if necessary.
589 </p>
590
591 <p>
592 The <i>Comments</i> text area should contain any general information
593 that you would like the PIREP reviewer to know about. For example,
594 why you changed the METAR, why you lowered the gears accidentally
595 (i.e. pressed the wrong key on the keyboard), etc.
596 </p>
597
598 <p>
599 The <i>Flight defects</i> text area should contain information about
600 any problems you encountered with the plane during the flight. For
601 example an engine stopped and why (if known), that flaps could not
602 be extended or retracted, etc.
603 </p>
604
605 <p>
606 In the <i>Delay codes</i> area you can mark one or more reasons why
607 the flight was delayed, if it was. The options are self-explanatory.
608 </p>
609
610 <h3><a name="helpTab">The Help Tab</a></h3>
611
612 <img src="helpTab.png" alt="The Help tab"/>
613
614 <p>
615 This tab provides some help for calculating and setting the payload
616 weight of the aircraft. It can be used once the <i>Payload</i>
617 (i.e. the cargo weight) is finalized. To use this tab, check
618 the <b>Using help</b> checkbox. It causes the page to become
619 sensitive and filled with data. Note, that the fact of using the
620 help is logged, so the PIREP reviewers will know about it.
621 </p>
622
623 <p>
624 The most important information is after the <i>Payload:</i> label,
625 which is the payload weight of the aircraft. This value should be
626 set in the simulator as the airplane's payload weight. By pressing
627 the <b>Simulator data</b> button, the data coming from the simulator
628 can be queried and displayed. If the data is out of the tolerances,
629 it is displayed in red, otherwise in green.
630 </p>
631
632 <p>
633 The gross weight is also displayed with some maximum weights of the
634 aircraft, so it can be checked or estimated if you will remain within
635 those maximums during the flight.
636 </p>
637
638 <h3><a name="logTab">The Log Tab</a></h3>
639
640 <img src="logTab.png" alt="The Log tab"/>
641
642 <p>
643 This is the main log of your flight that will be analyzed by the
644 PIREP reviewers. Its contents is generated automatically by the
645 program, and most lines are prefixed by the simulator times the
646 information in the given line belongs to.
647 </p>
648
649 <p>
650 While the log's contents is mainly useful for PIREP reviewers, it
651 can come handy when things start to happen very fast, and you have
652 no time check each fault message passing by (if you have enabled
653 such messages at all). Later, when things calm down, you can check
654 the log to see what happened exactly, so that you know why so many
655 fault points have been awarded. For example, you may even decide to
656 abort the flight, if you think some of the faults are to
657 embarrassing :) For quick identification, the lines containing the
658 fault messages are highlighted.
659 </p>
660
661 <h3><a name="gatesTab">The Gates Tab</a></h3>
662
663 <img src="gatesTab.png" alt="The Gates tab"/>
664
665 <p>
666 This tab displays information retrieved from the MAVA Online Gate
667 System. If the program needs to retrieve data, this tab's contents
668 are refreshed automatically, but you can refresh them manually
669 anytime using the <b>Refresh data</b> button.
670 </p>
671
672 <p>
673 The left side of the tab contains the fleet information. The tail
674 number of each aircraft is listed with the plane's status, as known
675 by the Online Gate System. The two major statuses are <i>LHBP-nn</i>
676 and <i>AWAY</i>. The former indicates that the aircraft is parked at
677 the Budapest Ferihegy Airport at gate or stand <i>nn</i>, while the
678 latter one denotes that the airplane is parked at another
679 airport. Another possible status is <i>PARKED</i>, which means that
680 the airplane is parked somewhere at the Ferihegy Airport, but we
681 (or at least the Gate System) don't know where. It may happen that
682 several aircraft are parked at the same gate or stand at
683 Ferihegy. In this case the tail numbers and the statuses of those
684 airplanes are displayed in red.
685 </p>
686
687 <p>
688 The right side contains the list of the numbers of the gates and
689 parking positions. A number is black if no aircraft is positioned at
690 the corresponding gate or stand, and it is orange, if the location
691 is occupied.
692 </p>
693
694 <h3><a name="debugLog">The Debug log</a></h3>
695
696 <img src="debugLogTab.png" alt="The Debug log tab"/>
697
698 <p>
699 This tab is not visible by default, but can be displayed by
700 selecting <b>View/Show debug log</b> or by
701 pressing <b>Ctrl+D</b>. It is another kind of log, which is mainly
702 useful for debugging. If you experience some problem with the
703 program, please, include the contents of this log with your bug
704 report. It can help a low with finding a solution to the problem.
705 </p>
706
707 <h2><a name="loadingPIREPs">Loading PIREPs</a></h2>
708
709 <p>
710 Saved PIREPs can be loaded and sent by the program. This can
711 become necessary, for example, if you cannot send a PIREP due to
712 some network problem right after your flight, or when you
713 deliberately performed a flight without connecting to the Internet.
714 </p>
715
716 <p>
717 To load a PIREP select the <b>File/Load PIREP...</b> menu option or
718 press the <b>Ctrl+L</b> key. A file selection dialog appears, from
719 which you can select the PIREP to load. If you select a valid PIREP
720 file, it will be loaded and a new window will be displayed with the
721 most important data of your flight. By clicking <b>Send
722 PIREP...</b>, the PIREP will be sent (or at least an attempt will be
723 made at sending it). A dialog window will be displayed about the
724 results of the attempt.
725 </p>
726
727 <div align="center">
728 <img src="pirepLoaded.png" alt="The loaded PIREP window"/>
729 </div>
730
731 <p>
732 You may also want to view a saved PIREP, for example, if it is a
733 PIREP about an entrance exam flight. To do so, click the <b>View
734 PIREP...</b> button. This displays the PIREP viewer window, which
735 groups the data into three tabs. The <i>Data</i> tab contains the
736 itemized data of the flight. The <i>Comments & defects</i> tab
737 displays the comments and or flight defects entered by the
738 user. The <i>Log</i> tab contains the flight log.
739
740 <div align="center">
741 <img src="pirepViewer.png" alt="The PIREP Viewer"/>
742 </div>
743
744 <h2><a name="checklistEditor">Editing checklists</a></h2>
745
746 <img src="checklistEditor.png" alt="The Checklist Editor"/>
747
748 <p>
749 The checklists are lists of audio files. When checklist playback is
750 enabled (see the description of the <i>Preferences</i> window below), and
751 there is a checklist for the type of the aircraft used for the
752 flight, the files constituting the checklist can be played
753 one-by-one by pressing the checklist hotkey repeatedly.
754 </p>
755
756 <p>
757 The checklist editor dialog box allows for editing the checklist. It
758 can be displayed by selecting <b>Tools/Checklist Editor...</b> or
759 pressing <b>Ctrl+C</b>. The top of the window contains an aircraft
760 type selector.
761 </p>
762
763 <p>
764 The files making up the checklist for the currently selected flight
765 are displayed on the right. You can move a file up or down by
766 dragging it with the mouse. You can also select one or more files
767 from the list. Then you can remove them with the <b>Remove</b>
768 button, or move them up or down by pressing <b>Move up</b>
769 and <b>Move down</b>.
770 </p>
771
772 <p>
773 To add new files to the checklist, select them in the file selector
774 on the left, and press <b>Add to checklist</b>. The file(s) will be
775 appended to the end of the checklist.
776 </p>
777
778 <p>
779 Note, that any changes you make are effective only if you press
780 the <b>OK</b> button when having finished the modifications. If the
781 flight has already started, no changes made to the corresponding
782 checklist have any effect during the flight (i.e. you will still use
783 the old checklist, or no checklist if there was none).
784 </p>
785
786 <h2><a name="prefs">The Preferences Window</a></h2>
787
788 </p>
789 The Preferences window can be displayed by
790 selecting <b>Tools/Preferences</b> or by
791 pressing <b>Ctrl+P</b>. Here you can set options that you usually
792 don't have to change for every flight. This window also consists of
793 tabs grouping the options logically.
794 </p>
795
796 <h3><a name="prefsGeneral">The <i>General</i> Tab<a></h3>
797
798 <img src="prefsGeneral.png" alt="The General Tab of Preferences"/>
799
800 <p>
801 These are some general settings for various parts of the
802 program. The <i>GUI</i> frame contains options regarding the
803 behaviour of the graphical user interface. The <i>Language</i> combo
804 box can be used to selected what language the program should
805 use. Currently English and Hungarian are supported. The value
806 of <i>system default</i> means that the operating system's default
807 language is used if it is one of the supported ones or English
808 otherwise. Note, that the program must be restarted for the change
809 to take effect if you modify this setting. If the <b>Hide main window
810 when minimized</b> checkbox is checked, and you minimize the window,
811 it will actually disappear completely (i.e. not appear among the
812 other minimized windows). You can make it appear by using the tray
813 icon.
814 </p>
815
816 <p>
817 The <i>MAVA Online Systems</i> frame contains settings related to
818 the online systems of MAVA, the gate and the ACARS systems mentioned
819 above. It is recommended to enabled these for normal operations.
820 </p>
821
822 <p>
823 The <i>Simulator</i> frame contains settings for how the program
824 interacts with the simulator. Most options are self-explanatory, but
825 the ones related to smoothing requires some discussion. Flight
826 Simulator is known to produce wind speed changes that are not
827 entirely realistic and can result in the simulated aircraft
828 experiencing some very high indicated airspeeds, which in turn can
829 also cause the autopilot to suddenly increase the climb rate to
830 counter the high speeds. Since this phenomenon is difficult to
831 protect oneself against without buying extra products, like FSUIPC,
832 the logger provides the possibility to average the IAS and/or the VS
833 over a few seconds so that spikes in these values are
834 smoothed. The <b>Enable the smoothing of IAS/VS over N sec.</b>
835 options allow controlling this feature. The number of seconds may
836 need experimenting with, but note that every change for which you
837 press the <b>OK</b> button is taken into account immediately.
838 </p>
839
840 <h3><a name="prefsMessages">The <i>Messages</i> Tab</a></h3>
841
842 <img src="prefsMessages.png" alt="The Messages Tab of Preferences"/>
843
844 <p>
845 The program can display messages about certain events in the
846 simulator and/or it can play a warning sound when those events
847 occur. The tab allows configuring this.
848 <p>
849
850 <p>
851 The categories of the message are listed on the left. These are the
852 following:
853 </p>
854
855 <ul>
856 <li><b>Logger Error Messages</b>: error messages about the
857 internal working of the logger.</li>
858 <li><b>Information Messages</b>: informational messages about,
859 e.g., the flight stage, the end of an audio checklist, etc.</li>
860 <li><b>Fault Messages</b>: messages about the non-NO GO faults the program detects.</li>
861 <li><b>NO GO Fault Messages</b>: messages about the NO GO faults the program detects</li>
862 <li><b>Gate System Messages</b>: messages related to the Online
863 Gate System. For example, when you have landed at Ferihegy, it can display
864 the list of the available gates so that you can choose where to
865 park, if there is no ATC available.</li>
866 <li><b>Environment Messages</b>: other messages, e.g. the welcome
867 message when the flight has ended.</li>
868 <li><b>Help Messages</b>: help messages, e.g. warning about
869 entering the V-speeds into the Takeoff page before takeoff.</li>
870 <li><b>Visibility Messages</b>: messages about the visibility
871 during descent and landing.</li>
872 </ul>
873
874 <p>
875 There are two checkboxes associated with each messages category. If the
876 left one (<i>Displayed in FS</i>) is checked, the messages of the
877 category will be displayed in the simulator. If the right one
878 (<i>Sound alert</i>) is checked, and a message of the given category
879 is about to be displayed, a warning sound will be played. It is
880 mainly intended to accompany the text messages, but the two options
881 can be controlled separately, so you can select the sound alert, but
882 not the displaying of the messages. This may be useful if you don't
883 want these messages to clutter up the windscreen of your aircraft,
884 but still get some notification that some problem occurred.
885 </p>
886
887 <h3><a name="prefsSounds">The <i>Sounds</i> Tab</a></h3>
888
889 <img src="prefsSounds.png" alt="The Sounds Tab of Preferences"/>
890
891 <p>
892 This tab controls how the sounds are played by the application.
893 </p>
894
895 <p>
896 The top part is for the background sounds. These are pre-recorded
897 sound files that are played when certain conditions hold during the
898 flight. Typical examples are the various announcements the flight
899 attendants make during the flight. The <b>Enable background
900 sounds</b> checkbox controls whether such sounds are enabled at
901 all. If the <b>Pilot controls sounds</b> checkbox is enabled, the
902 pilot should start the playback of these sound files by pressing a
903 hotkey in the simulator. Note, that you should still be in the right
904 flight stage (and sometimes fulfill other conditions) to be able to
905 play the sound files. Also, one file can be played only once. If you
906 enable this option, the hotkey to press in the simulator can be
907 selected below. You can choose one of the alphanumeric keys (0-9,
908 A-Z) optionally combined with one or both of the <i>Ctrl</i>
909 and <i>Shift</i> modifiers. If this checkbox is not checked, the
910 sound files will be played automatically.
911 </p>
912
913 <p>
914 If the <b>Enable speedbrake sound at touchdown</b> checkbox is
915 checked, you will hear a distinctive sound when the spoilers deploy
916 automatically after touchdown.
917 </p>
918
919 <p>
920 The lower part, named <i>Checklist</i> contains some settings
921 related to the audio checklists belonging to the aircraft. They are
922 available only if the <b>Enable aircraft-specific checklist></b>
923 checkbox is selected. In this case another hotkey should be
924 specified. If you press this hotkey, the next file from the
925 checklist will be played.
926 </p>
927
928 <h3><a name="prefsAdvanced">The <i>Advanced</i> Tab</a></h3>
929
930 <img src="prefsAdvanced.png" alt="The Advanced Tab of Preferences"/>
931
932 <p>
933 This tab contains some settings that you normally should not
934 change. Currently, these settings are related to the automatic
935 update. If the <b>Update the program automatically</b> checkbox is
936 not checked, the automatic update at program start-up will be
937 omitted. The <i>Update URL</i> text entry field contains the URL
938 from which to download the updates. Occasionally the developers of
939 the application may tell you to change this something else, e.g. to
940 test some development version. Or it may need to be changed due to
941 organizational reasons, such as moving to a new server, etc.
942 </p>
943
944 <h2><a name="monitorWindow">The Monitor Window</a></h2>
945
946 <img src="monitorWindow.png" alt="The Monitor Window"/>
947
948 <p>
949 The monitor window can be used when debugging the program. You can
950 display it by selecting <b>View/Show monitor window</b> or by
951 pressing <b>Ctrl+M</b>. It displays the various parameters from the
952 aircraft as read from the flight simulator. During flight, it is
953 updated once per second. If something is not detected properly by
954 the logger, this window can be used to determine if the problem is
955 in interpreting and translating the data read from the simulator, or
956 when the translated data is being evaluated by other parts of the
957 program.
958 </p>
959
960</html>
Note: See TracBrowser for help on using the repository browser.