This add-on automatically keeps a log of your flights, saving each flight to a CSV file. It does not require any additional user action, just add an add-on to FlightGear.
Installation is standard:
--addon=path
), and click "Fly!".The add-on tries to automatically detect if an aircraft has taken off by checking the Weight on Wheels. Then the add-on starts collecting information about the flight. This means that if you are parked, taxiing, etc., it is not yet included in the flight log. If you are in the air, the add-on tries to detect if you have landed also by testing Weight on Wheels. Thus, logging takes place from the moment the aircraft is lifted off the ground until it is put back on the ground.
If the aircraft has no wheels, only the floats, then the add-on will also try to recognize if the floats are resisting the water (if the aircraft uses JSBSim), thus recognizing whether you are in the air or not.
The add-on also recognizes the moment of launch of the Space Shuttle from the starting position, which required a separate consideration due to the different launch.
You will find the CSV file in the directory $FG_HOME/Export/Addons/org.flightgear.addons.logbook/logbook-v4.csv
, where $FG_HOME
on Windows is:
C:\Users\{user name}\AppData\Roaming\flightgear.org\
and on Linux/macOS:
/home/{user name}/.fgfs/
You can always open it and edit by any Spreadsheet program like LibreOffice Calc, MS Excel, etc. However please don't put the characters ,
in the cells, because the Logbook parser will recognize them as a column separator, which will cause errors in the operation of the add-on. It is safer to edit the log data through the GUI in the simulator.
The following information is logged into the file:
c172p
in the Aircraft as well as Variant column. If you select the float variant ("Cessna 172P Float"), you will see c172p
in the Aircraft column, but c172p-float
in the Variant column. This way you have the main group of aircraft in the Aircraft column, and its variants in the Variant column. This will allow you to extract Totals statistics for a general group of aircraft no matter what variant (filtering by Aircraft), as well as more precisely for a specific variant of a given aircraft (filtering by Variant).The add-on also provides the ability to view the entire flight logbook from the simulator. You should select "Logbook" -> "Logbook" from the menu. The main window will open with the entire logbook in tabular form. The last row signed "Totals", contains a summary, not only of the visible entries on a given page, but of the entire logbook. The same "Totals" row is visible on every page. The exception for totals is the Max Alt
column, in which you don't have the sum of all altitudes, but the highest one.
At the very bottom there is a row of buttons, mainly for moving through the log pages. The |<<
button means moving to the first page, <
moving to the previous page, >
moving to the next page, >>|
moving to the last page. In the middle there is text information in the format {on which page you are} / {number of all pages} (number of entries in the log)
. On the right is the dark
/light
button to switch between window styles. The ?
button opens a window with help (the same as from the "Logbook" -> "Help" menu).
Each log entry can be hovered over and clicked. Then an additional window will open presenting the details of the given entry. In general, you have the same information here as in the main window, except:
Note
field, which is not displayed in the main window, due to the possibility of placing any length of text here.The addon 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 (!)
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.
Each logbook entry can be edited from the simulator. You need to select "Logbook" -> "Logbook" from the menu. The main window with the entire logbook will open. Here you can search for the entry you want to edit and click on it. The details window for the entry will open. Now you can click on the specific entry you want to edit. Another window with a text field will open. Just enter the new value and confirm with the "Save" button. The change will immediately be saved to a file.
At the bottom of the details window there is a Delete
button, with which you can completely delete the selected entry.
Before each saving of a single change, the add-on creates a copy of the original CSV file, to which it appends the .bak
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 .bak
from the copy name. Remember, you only have a copy of one recent file operation.
This add-on includes a mechanism to save the current flight status to a separate file recovery.csv
every minute. If FlightGear unexpectedly closes 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.
recovery.csv
file. The data in the recovery.csv
file will be automatically transferred to the logbook.csv
file when the simulator is restarted.If this add-on has a problem with recognizing the landing gear correctly, then you can put the appropriate properties to indicate which indexes from /gear/gear[index]
are used by the aircraft.
The structure of the property to be passed to FlightGear is as follows:
<PropertyList>
<sim>
<addon-hints>
<Logbook>
<landing-gear-idx type="int">12</landing-gear-idx>
<landing-gear-idx type="int">13</landing-gear-idx>
</Logbook>
</addon-hints>
</sim>
</PropertyList>
Each <landing-gear-idx>
tag should contain an integer indicating the index of the /gear/gear
property array. Thus, <landing-gear-idx>
with values of 12 and 13, indicate that the aircraft uses /gear/gear[12]
and /gear/gear[13]
.
These properties can be add in a number of ways, such as by placing them in the aircraft files, or by using command line options:
--prop:int:/sim/addon-hints/Logbook/landing-gear-idx[0]=12
--prop:int:/sim/addon-hints/Logbook/landing-gear-idx[1]=13
Thanks to MariuszXC for this feature.
Logbook is an Open Source project and it is licensed under the GNU Public License v3 (GPLv3).
Dodatek ten automatycznie prowadzi dziennik naszych lotów, zapisując każdy odbyty lot do pliku CSV. Nie wymaga to od użytkownika żadnych czynności, wystarczy dodać wtyczkę do FlightGeara.
Instalacja jest standardowa:
--addon=ścieżka
) i kliknij „Lećmy!”.Dodatek stara się automatycznie wykryć czy statek powietrzny wystartował, poprzez sprawdzenie Weight on Wheels. Wtedy dodatek rozpoczyna zbieranie informacji o locie. Oznacza to, że jeśli stoimy zaparkowani, kołujemy itp. to ten czas jeszcze nie jest wliczany do dziennika lotów. Jeśli jesteśmy w powietrzu, to dodatek stara się wykryć czy wylądowaliśmy także testując Weight on Wheels. Zatem logowanie następuje od chwili oderwania statku powietrznego od ziemi, do posadzenia go na ziemi z powrotem.
Jeśli samolot nie ma kół tylko pływaki, to dodatek także postara się rozpoznać, czy pływaki stawiają opór wodzie (o ile samolot wykorzystuje JSBSim), tym samym rozpoznając czy jesteśmy w powietrzu czy nie.
Dodatek rozpoznaje także moment startu Wahadłowca Kosmicznego z pozycji startowej, co wymagało osobnego uwzględnienia, ze względu na odmienność startu.
Plik CSV znajdziesz w katalogu $FG_HOME/Export/Addons/org.flightgear.addons.logbook/logbook-v4.csv
, gdzie $FG_HOME
pod Windows to:
C:\Users\{user name}\AppData\Roaming\flightgear.org\
pod Linuxem/macOS-em:
/home/{user name}/.fgfs/
Zawsze możesz otworzyć ten plik w dowolnym programie typu arkusz kalkulacyjny, jak LibreOffice Calc, MS Excel itp. Proszę jednak nie umieszczać tam w komórce znaków ,
, ponieważ parser Logbooka rozpozna przecinki jako separator kolumn, co spowoduje błędy w działaniu dodatku. Bezpieczniej jest edytować dane w dzienniku poprzez GUI w symulatorze.
Do pliku logowane są następujące informacje:
c172p
. Jeśli wybierzesz wariant z pływakami ("Cessna 172P Float"), to w kolumnie Aircraft zobaczysz c172p
, ale w kolumnie Variant c172p-float
. W ten sposób masz główną grupę samolotu w kolumnie Aircraft oraz jego warianty w kolumnie Variant. Dzięki temu będziesz mógł wydobyć statystyki Totals dla ogólnej grupy samolotu bez znaczenia w jakim wariancie (filtrując po Aircraft), jak i precyzyjniej dla konkretnego wariantu danego samolotu (filtrując po Variant).Dodatek udostępnia także możliwość przeglądania całego dziennika lotów z poziomu symulatora. Należy z menu wybrać pozycję "Logbook" -> "Logbook". Otworzy się okno główne z całym dziennikiem w postaci tabelarycznej. Ostatni rząd podpisany "Totals", zawiera podsumowanie, nie tylko widocznych wpisów na danej stronie, ale całego dziennika. Rząd "Totals" widoczny jest na każdej stronie. Wyjątkiem dla "Totals" jest kolumna Max Alt
, w której nie mamy sumy wszystkich wysokości, tylko tę najwyższą.
Na samym dole znajduje się rząd przycisków, głównie do przemieszczania się po stronach dziennika. Przycisk |<<
oznacza przejście do pierwszej strony, <
przejście do poprzedniej strony, >
przejście do następnej strony, >>|
przejście do ostatniej strony. Na środku znajduje się informacja tekstowa w formacie {na której jesteśmy stronie} / {ilość wszystkich stron} (ilość wpisów w dzienniku)
. Po prawej znajduje się przycisk dark
/light
do przełączania się między stylami okna. Przycisk ?
otwiera okno z pomocą (to samo co z menu "Logbook" -> "Help").
Każdy wpis w dzienniku można najechać myszką i kliknąć. Wówczas otworzy się dodatkowe okno prezentujące szczegóły danego wpisu. Ogólnie mamy tutaj to samo co w oknie głównym, poza tym:
Note
, które nie jest wyświetlane w oknie głównym, ze względu na możliwość umieszczenia tutaj, dowolnie długiego tekstu.Dodatek umożliwia filtrowanie niektórych kolumn w głównym oknie dziennika. W tej chwili możesz filtrować po kolumnach "Date" (jako rok), "Aircraft", "Variant", "Type", "Callsign", "From", "To", "Landing" i "Crash". Aby użyć filtrowania należy najechać kursorem myszy na nazwę kolumny (podświetli się) i kliknąć na nią. Pokaże się nowe okno z wyborem wartości. Dla filtrowania po kolumnie "Aircraft" będą to identyfikatory statków powietrznych, którymi już latałeś. Dla filtrowania po kolumnie "Type" będą to nazwy typów statków powietrznych itd. Każde okno z filtrami, ma także pozycję "Default All", co oznacza że filtr zostanie wyłączony i zostaną pokazanie wszystkie pozycje. Po włączeniu filtra, przy filtrowanej kolumnie pokaże się znak (!)
ostrzegający o użyciu filtra.
Po użyciu filtra, rząd "Totals" także zostanie zaktualizowany, biorąc pod uwagę przefiltrowane dane. W ten sposób możesz zobaczyć statystyki dla konkretnego samolotu czy typów samolotów.
Każdy wpis w dzienniku można edytować z poziomu symulatora. Należy z menu wybrać pozycję "Logbook" -> "Logbook". Otworzy się okno główne z całym dziennikiem. Możesz tu wyszukać wpisu, który chcesz edytować i kliknąć na niego. Otworzy się okno szczegółów dla danego wpisu. Teraz możesz kliknąć na konkretną pozycję, którą chcesz edytować. Otworzy się kolejne okienko z polem tekstowym. Wystarczy wprowadzić nową wartość i potwierdzić przyciskiem "Save". Zmiana od razu zostanie zapisana do pliku.
Na dole okna szczegółów znajduje się przycisk Delete
, za pomocą którego możesz całkowicie usunąć wybrany wpis.
Przed każdym zapisem pojedynczej zmian, dodatek tworzy kopię oryginalnego pliku CSV, do którego dokleja na koniec rozszerzenie .bak
. Tak więc gdyby podczas edycji danych coś się nie powiodło i oryginalny plik został by uszkodzony, zawsze możesz go odzyskać, usuwając z nazwy kopi dopisek .bak
. Pamiętaj, że masz tylko jedną kopię ostatniej operacji na pliku.
Dodatek ten zawiera mechanizm zapisywania co minutę aktualnego stanu lotu do osobnego pliku recovery.csv
. Gdyby FlightGear niespodziewanie zamknął się z powodu błędu, plik ten zostanie przeczytany przy ponownym uruchomieniu i wpis z tego pliku zostanie przeniesiony do głównego pliku dziennika. W ten sposób żaden, nawet przerwany lot, nie powinien być utracony.
recovery.csv
. Dane z pliku recovery.csv
zostaną automatycznie przeniesione do pliku logbook.csv
po ponownym uruchomieniu symulatora.Jeśli dodatek ten ma problem z prawidłowym rozpoznaniem podwozia, to możesz umieścić odpowiednie właściwości, które wskażą, jakie indeksy z /gear/gear[index]
są używane przez dany statek powietrzny.
Struktura właściwości, którą należy przekazać do FlightGeara, wygląda następująco:
<PropertyList>
<sim>
<addon-hints>
<Logbook>
<landing-gear-idx type="int">12</landing-gear-idx>
<landing-gear-idx type="int">13</landing-gear-idx>
</Logbook>
</addon-hints>
</sim>
</PropertyList>
Każdy znacznik <landing-gear-idx>
powinien zawierać liczbę całkowitą wskazującą na indeks tablicy /gear/gear
. Zatem <landing-gear-idx>
z wartościami 12 i 13, wskazują że statek powietrzny używa /gear/gear[12]
oraz /gear/gear[13]
.
Właściwości te można przekazać na wiele sposób, np. poprzez umieszczenie ich w plikach statku powietrznego, albo poprzez użycie opcji wiersza poleceń:
--prop:int:/sim/addon-hints/Logbook/landing-gear-idx[0]=0
--prop:int:/sim/addon-hints/Logbook/landing-gear-idx[1]=1
Podziękowania dla MariuszXC za tę funkcję.
Logbook jest projektem Open Source i jest objęty licencją GNU Public License v3 (GPLv3).