377
edits
FFGo: Difference between revisions
→Installation tips: Add section “A word about GeographicLib”
(→Features: Mention the Pressure Converter dialog, the “Show available fgfs options” feature and be more accurate concerning which FG versions --parkpos is broken in) |
(→Installation tips: Add section “A word about GeographicLib”) |
||
| Line 922: | Line 922: | ||
Installation should be similar to how it is done on Linux with ''pip'' in most ways, once you have installed a suitable Python version. OS X expert needed for the little OS X-specific details (how to install Python in a non-intrusive way for the system, how to run ''pip'' in this particular installation, and how to create a shortcut to the resulting ''ffgo'' executable for convenience). | Installation should be similar to how it is done on Linux with ''pip'' in most ways, once you have installed a suitable Python version. OS X expert needed for the little OS X-specific details (how to install Python in a non-intrusive way for the system, how to run ''pip'' in this particular installation, and how to create a shortcut to the resulting ''ffgo'' executable for convenience). | ||
=== A word about GeographicLib === | |||
[http://geographiclib.sourceforge.net/ GeographicLib] is a powerful C++ library that can perform many kinds of geographic calculations (such as finding the shortest “walkable” path between two points on Earth), and also provides information about Earth's magnetic field. This library has been written by researcher Charles F. F. Karney, who designed well-known algorithms to solve the geodetic direct and inverse problems. | |||
Apart from the C++ library and accompanying programs such as [http://geographiclib.sourceforge.net/html/MagneticField.1.html MagneticField], Charles Karney provides a standalone Python 2 & 3 implementation of the geodetic algorithms. This Python implementation is what you get when running commands such as (depending on your setup): | |||
<syntaxhighlight lang="shell" enclose="div"> | |||
pip install geographiclib | |||
</syntaxhighlight> | |||
or: | |||
<syntaxhighlight lang="shell" enclose="div"> | |||
<venv-dir>/bin/pip install geographiclib | |||
</syntaxhighlight> | |||
It is ''not'' a binding for the C++ library; rather, it is a ''reimplementation'' in Python of ''some'' of the algorithms featured by the GeographicLib C++ library. | |||
FFGo uses the following software components if it can find them: | |||
* GeographicLib's implementation for Python 3; | |||
* GeographicLib's MagneticField program. | |||
The former is normally obtained via pip, while the latter comes with the “full GeographicLib package” as published on [http://geographiclib.sourceforge.net/ GeographicLib's home page]. | |||
== Related content == | == Related content == | ||