FFGo: Difference between revisions

<ol style="list-style-type: decimal"><li><strong>First session:</strong> installing FFGo (and some of its dependencies, such as [http://people.via.ecp.fr/~flo/projects/CondConfigParser/ CondConfigParser]) using pip in a virtual environment:</p>

# automatically done if you install it using pip):

apt-get install libpython3-dev tcl-dev tk-dev

#  apt-get build-dep python3-pil.imagetk

# Optional: to have magnetic declination, magnetic headings,

#          etc.

apt-get install geographiclib-tools

/usr/sbin/geographiclib-get-magnetic minimal

# Highly optional, for better precision (no idea if one can

# see the difference for typical aviation needs):

/usr/sbin/geographiclib-get-magnetic emm2015</pre>

<p>Then, <strong>as an unprivileged user:</strong></p>

<pre>~ % mkdir -p ~/my-venvs && cd ~/my-venvs

# Check what we have in there

~/my-venvs % ls venv1

bin  include  lib  lib64  pyvenv.cfg

# Install FFGo in this venv using the pip executable

# *** from this venv ***. This is the crucial point. Don't

# run this with any pip executable you find, otherwise you

# won't be able to know where the installation is taking

# place.

~/my-venvs % venv1/bin/pip install ffgo

Cleaning up...

# Run FFGo

~/my-venvs % venv1/bin/ffgo

Detected FlightGear version: 2016.1.0

# FFGo works. It just told us about the two optional

# dependencies we haven't installed. Let's install them now.

# There is another way that uses Debian packages (creating

# the venv with --system-site-packages); it is explained in

# docs/INSTALL/INSTALL_en, but I can't replicate all of its

# contents here...

# OK, so let's install these optional dependencies now.

~/my-venvs % venv1/bin/pip install Pillow geographiclib

Cleaning up...

# Let's start FFGo again...

~/my-venvs % venv1/bin/ffgo

Detected FlightGear version: 2016.1.0

# No warning anymore: all optional dependencies have been

# installed.</pre>

<li><strong>Second session:</strong> installing some of FFGo's dependencies (such as [http://people.via.ecp.fr/~flo/projects/CondConfigParser/ CondConfigParser]) using pip in a virtual environment, while using FFGo directly from a clone of its [https://github.com/frougon/FFGo Git repository]:</p>

~/my-venvs % /usr/bin/python3.4 -m venv venv2

# Install CondConfigParser in this venv using the pip

# executable *** from this venv ***

~/my-venvs % venv2/bin/pip install CondConfigParser

Cleaning up...

~ % mkdir -p ~/src && cd ~/src

# Clone FFGo's Git repository

Checking connectivity... done.

 

# This must be done whenever you work with FFGo's Git repo

# (unless you know what you are doing), after 'git clone'

# and every 'git pull' to have exisiting and up-to-date

# icons and translation (.mo) files. This requires to have

# installed stuff as indicated in the “Installation from the

# Git repository” section of FFGo's docs/INSTALL/INSTALL_en

# file.

make[1]: Leaving directory '/home/flo/src/ffgo.git/ffgo/data/locale'

# Since FFGo was not installed with pip in this case, no

# 'ffgo' executable has been created. The recommended way to

# run FFGo in such a case is via the ffgo-launcher.py

# script. The full path to ffgo-launcher.py is not needed

# here since it is in the current directory, however if you

# create an alias for this command, or if you configure an

# icon in your menu bar/whatever to run it, you will need

# the path (and maybe '/home/username' instead of '~' too).

# The path to the Python interpreter

# (~/my-venvs/venv2/bin/python), however, is crucial since

# it is for *this* Python interpreter that we have installed

# CondConfigParser.

~/src/ffgo.git % ~/my-venvs/venv2/bin/python ~/src/ffgo.git/ffgo-launcher.py

Detected FlightGear version: 2016.1.0

~/src/ffgo.git %

# optional dependencies it couldn't find. They can be

</pre></li></ol>