1,388
edits
Logbook Add-on: Difference between revisions
Jump to navigation
Jump to search
no edit summary
No edit summary |
No edit summary |
||
| Line 6: | Line 6: | ||
| developedby = Roman Ludwicki (PlayeRom, SP-ROM) | | developedby = Roman Ludwicki (PlayeRom, SP-ROM) | ||
| initialrelease = December 11th, 2022 | | initialrelease = December 11th, 2022 | ||
| latestrelease = 1.3. | | latestrelease = 1.3.1, Dec 31st, 2022 | ||
| writtenin = Nasal | | writtenin = Nasal | ||
| developmentstatus = Active (2022-) | | developmentstatus = Active (2022-) | ||
| Line 43: | Line 43: | ||
# <code>Time</code> – aircraft take-off time. As for <code>Date</code> this is the time taken from the OS. | # <code>Time</code> – aircraft take-off time. As for <code>Date</code> this is the time taken from the OS. | ||
# <code>Aircraft</code> – the code name of the aircraft. | # <code>Aircraft</code> – the code name of the aircraft. | ||
# <code>Variant</code> – the code name of the aircraft as its variant. Some aircraft are available in | # <code>Variant</code> – the code name of the aircraft as its variant. Some aircraft are available in several variants, such as the default "Cessna 172P", which includes different variants like "Cessna 172P Float". If you select "Cessna 172P," you will see <code>c172p</code> in the <code>Aircraft</code> as well as <code>Variant</code> column. If you select the float variant ("Cessna 172P Float"), you will see <code>c172p</code> in the Aircraft column, but <code>c172p-float</code> in the <code>Variant</code> column. This way you have the main group of aircraft in the <code>Aircraft</code> column, and its variants in the <code>Variant</code> column. This will allow you to extract <code>Totals</code> statistics for a general group of aircraft no matter what variant (filtering by <code>Aircraft</code>), as well as more precisely for a specific variant of a given aircraft (filtering by <code>Variant</code>). | ||
# <code>Type</code> – aircraft type as a one of following value: | # <code>Type</code> – aircraft type as a one of following value: | ||
#* "heli" (helicopter), | #* "heli" (helicopter), | ||
| Line 60: | Line 60: | ||
# <code>From</code> – the ICAO code of the airport from which you have taken off. If you are starting immediately in the air, this field will remain blank. | # <code>From</code> – the ICAO code of the airport from which you have taken off. If you are starting immediately in the air, this field will remain blank. | ||
# <code>To</code> – the ICAO code of the airport where you landed. If you did not land (e.g. by closing FG in flight) or by landing at an adventurous location, this field will remain blank. | # <code>To</code> – the ICAO code of the airport where you landed. If you did not land (e.g. by closing FG in flight) or by landing at an adventurous location, this field will remain blank. | ||
# <code> | # <code>Landing</code> – if you landed anywhere, a 1 will be entered here. If the flight ended without landing or the add-on was unable to detect a valid landing, this field will be left blank. | ||
# <code>Crash</code> – if the add-on recognizes an aircraft crash, a 1 will be entered here, otherwise this field will be left blank. | # <code>Crash</code> – if the add-on recognizes an aircraft crash, a 1 will be entered here, otherwise this field will be left blank. | ||
# <code>Day</code> – the number of hours spent flying during the day. | # <code>Day</code> – the number of hours spent flying during the day. | ||
# <code>Night</code> – number of hours spent flying during the night. | # <code>Night</code> – number of hours spent flying during the night. | ||
# <code>Instrument</code> – the number of hours flown during the IMC (Instrument Meteorological Conditions). | # <code>Instrument</code> – the number of hours flown during the IMC (Instrument Meteorological Conditions). | ||
# <code>Duration</code> – total duration of the flight in hours, as the sum of <code>Day</code> and <code>Night</code>. The | # <code>Duration</code> – total duration of the flight in hours, as the sum of <code>Day</code> and <code>Night</code>. The <code>Instrument</code> is not added up here, as it is simply counted separately, regardless of whether it was day or night. <code>Duration</code> is calculated in real time, so if you speed up or slow down the simulation time, it will not be affected. | ||
# <code>Distance</code> – total distance flown from take-off to landing, in nautical miles. | # <code>Distance</code> – total distance flown from take-off to landing, in nautical miles. | ||
# <code>Fuel</code> – total fuel burned, in | # <code>Fuel</code> – total amount of fuel burned in flight, in U.S. gallons. | ||
# <code>Max Alt</code> – maximum altitude, in feet, reached during flight. | # <code>Max Alt</code> – maximum altitude, in feet, reached during flight. | ||
# <code>Note</code> – notes, by default the full name of the aircraft. '''This is a good place to enter your own notes as well'''. | # <code>Note</code> – notes, by default the full name of the aircraft. '''This is a good place to enter your own notes as well'''. | ||
| Line 85: | Line 85: | ||
== Data filtering == | == Data filtering == | ||
The add-on allows you to filter some columns in the main log window. At the moment you can filter by the "Date" (as a year), "Aircraft", "Variant", "Type", "Callsign", "From", "To", " | The add-on allows you to filter some columns in the main log window. At the moment you can filter by the "Date" (as a year), "Aircraft", "Variant", "Type", "Callsign", "From", "To", "Landing" and "Crash" columns. To use filtering, hover the mouse cursor over a column name (it will be highlighted) and click it. A new window will appear with a choice of values. For filtering on the "Aircraft" column, these will be the IDs of aircraft you have flown before. For filtering by the "Type" column, these will be the names of aircraft types, etc. Each window with filters also has the "Default All" position, which means that the filter will be turned off and all items will be shown. When the filter is enabled, a <code>(!)</code> sign will be shown next to the filtered column to warn that the filter has been used. | ||
After using the filter, the "Totals" row will also be updated with the filtered data. In this way, you can see statistics for a specific aircraft or types of aircraft. | After using the filter, the "Totals" row will also be updated with the filtered data. In this way, you can see statistics for a specific aircraft or types of aircraft. | ||
| Line 100: | Line 100: | ||
Before each saving of a single change, the add-on creates a copy of the original CSV file, to which it appends the <code>.bak</code> extension at the end. So, if something goes wrong while editing the data and the original file is corrupted, you can always recover it by removing the <code>.bak</code> from the copy name. '''Remember, you only have a copy of one recent file operation'''. | Before each saving of a single change, the add-on creates a copy of the original CSV file, to which it appends the <code>.bak</code> extension at the end. So, if something goes wrong while editing the data and the original file is corrupted, you can always recover it by removing the <code>.bak</code> from the copy name. '''Remember, you only have a copy of one recent file operation'''. | ||
== Recovery mode == | |||
This add-on includes a mechanism to save the current flight status to a separate file recovery.csv every minute. If FlightGear unexpectedly close due to an error, this file will be read on reboot and an entry from this file will be moved to the main log file. In this way, no flight, even aborted, should be lost. | |||
= Note = | = Note = | ||