The easier way... Ubuntu (9.04) users
may now install the calculation engine from a .deb file.
Note: Ubuntu users who have
previously installed from the tar.gz should take care to
manually remove the old installation from the /usr/local
tree. The deb file is built in accordance with Debian
guidelines and installs the files under /usr/bin and
/user/share. Install the deb then skip own to step
2.
The (slightly) harder way...The
following assumes some familiarity with command lines,
makefiles and ideally VOACAP itself. Where
applicable, distro specific instructions have been provided
for Fedora (F10), Ubuntu (9.04) and Suse. The
installation should be performed logged in with your normal
user name unless otherwise stated.
The main binaries are built with the GFortran compiler,
included with most distributions;
Fedora (F10): GFortran may be
installed with the following 'yum' command (run with root
privileges);
Ubuntu (9.04): GFortran may be
installed with the following 'apt' command;
Suse (11.1): GFortran may be
installed with the following 'zypper' command (or use the
yast gui);
All Distributions
The complete installation may be broken down to three
stages;
- VOACAP: The main voacap 'engine' and
associated data files.
- GUI: The friendly face of voacapl, a
GUI written by Jari Perkiömäki (OH6BG).
- pythonProp: Some python scripts
providing graphical output.
STEP 1: VOACAP In this step, the main
voacap engine will be built and installed along with all of
the required data files.
Download the voacapl archive, from the downloads section and decompress it.
Configure / Build / Install: Open up a terminal
window and From the ~/voacapl-x.x.x/ folder, use the
following commands to build and install the
application.
The 'sudo' prefix is required on Ubuntu, other systems
will probably require the 'su' command or similar.
The 'makeitshfbc' command creates a local copy of the
itshfbc directory structure in user's home directory.
Hint: A slimmed down binary may be
installed by using the 'make install-strip' command
instead.
Test the installation by typing the command 'voacapl
~/itshfbc'. You should see output similar to the
following;
If you see something similar to the above (with no error
messages) voacapl and the data files are built and
installed correctly. The GUI and plotting scripts now need
to be installed.
STEP 2: GUI In this step we'll install
the GUI which will be used to create VOACAP input
files.
The GUI is written in RealBasic which requires, GTK+ 2.8
(or higher), glibc-2.4, CUPS and libstdc++.so.6.
Fedora (F10): The following 'yum'
command will install the libraries required by the GUI;
Ubuntu (8.10): The required
libraries are installed by default for most users.
Note: Users with 64 bit machines may
also need to install 32 bit support with the following
command;
All Users: Download the GUI from
the link in the downloads section
and install in /usr/local/bin (or similar).
Note: you will need to be logged in with
root permissions (or use sudo) to write to /usr/local/bin
and change the permissions on the GUI application to allow
it to be run as an executable.
Hint: Start the program and don't
forget to set the program paths using the 'File -> Set
Program Paths...' menu item. The following screen shot
illustrates how they're set on my system (you'll obviously
need a different home path on your system)
STEP 3: pythonProp Detailed
instructions for installing the scripts may be found
here. Once
installed, they will be called up by the GUI or may run
directly from the command line.
