The following is a quick guide to compiling, installing and operating a text-based version of VOACAP under Apple Macintosh OS X. This guide requires familiarity with UNIX-based operating systems. If you don't feel comfortable with this guide, please do not continue. This guide has originally been tested with Mac OS X 10.5 (Leopard); however, afterwards, some changes have been made in Jim Watson's voacapl package, and so, this guide may or may not be 100% accurate in that respect.
Running VOACAP under Apple Macintosh OS X
VOACAP Quick Guide: Home
1. Installing the XCode Tools from Mac OS X disksThe Mac OS X Xcode Tools package provides additional tools that you will need to install to round out your development environment. These are not part of the default installation, but are essential to you. They contain some of the most important tools, such as the compiler (gcc) and debugger (gdb).
You can find the Xcode Tools Installer on your Mac OS X DVD (or as one of the CDs in the CD version). In Leopard, this is the Installer Disk 2.
2. Installing the GFortran compilerThe ready-built GFortran Compiler for Mac OS X is available for downloading at http://gcc.gnu.org/wiki/GFortranBinaries. Download the appropriate installer. GFortran is available as a nice Apple-style installer for Mac OS X Tiger (10.4), Leopard (10.5) and Snow Leopard (10.6). Install the package. The binaries will be installed under the /usr/local/bin directory.
3. Compiling the VOACAP engine (VOACAPL)
- Get the voacapl source code package for Jim Watson's site. Unzip it.
- Open the Terminal app and go to the directory of the unzipped voacapl package.
- First, enter the following command to build the Make file:
- sudo ./configure
- Your password will be prompted, and then the Make file will be built.
- Then, to build the voacapl application, enter:
- sudo make
- After a successful build (and a lot of warnings), install the app by issuing
- sudo make install
By default, this will install your voacapl binary under the /usr/local/bin directory.
4. Compiling the ITSHFBC components
- After you have compiled the voacapl application, type
- sudo makeitshfbc
This will compile the coefficient files, needed for running VOACAPL, for you. If you need assistance in compiling and installing the necessary files, please visit Jim Watson's site at http://www.qsl.net/hz1jw/voacapl/index.html
5. Running VOACAP predictionsNow you can try that everything works, by entering the following commandvoacapl ~/itshfbc
This should output something like this to the screen:jpe:run jpe$ voacapl ~/itshfbc Run Directory : /Users/jpe/itshfbc/run Opening Data File : voacapx.dat TRANSMIT=2-D Table [default/const17.voa ]=Const 17dB beam= 0.0 az= 57.4 RECEIVE =2-D Table [default/swwhip.voa ]=SWWhip.VOA beam= 0.0 az= 254.7 Method 30 Jun 100ssn Freqs= 6.1 7.2 9.7 11.9 13.7 15.4 17.7 21.6 25.9
Now you know that voacapl works well for you.
Using the previous example, you can investigate the result file e.g. as follows:less ~/itshfbc/run/voacapx.out