-
Notifications
You must be signed in to change notification settings - Fork 8
Home
This guide describes the basic installation and operation of the voacapl application. As voacapl is port of VOACAP, much of the information here is applicable to VOACAP as well.
voacapl requires access to a number of data files containing input parameters, ionospheric coefficient, antenna characteristics etc. These are stored in a defined hiearchy under a nominated directory name, usually itshfbc. This may be created in your home directory by running the command makeitshfbc.
When running voacapl, the location of the itshfbc directory must be specified, i.e.;
$ voacapl ~/itshfbc
The above command will run voacapl, reading input parameters from the default location (itshfbc/run/voacapx.dat) and writing results to the default output file location (itshfbc/run/voacapx.dat). Input and output files may be specified at the command line i.e.
$ voacapl ~/itshfbc my_input.dat
$ voacapl ~/itshfbc my_input.dat my_output.out
By convention, input and output files use the suffixes .dat and .out respectively.
Current sun spot predictions may be found at the proppy website.
Voacapl supports both the standard and older IONCAP absorption models. In addition, modified forms are available for each of these (refer to the news on Greg Hand's website for further details. The alternative models may be selected by modifying the contents of the file itshfbc/database/version.w32;
- Version 16.1207W = normal code
- Version 16.1207I = use old IONCAP absorption model
- Version 16.1207A = use Alex's changes with normal absorption
- Version 16.1207a = use Alex's changes with IONCAP absorption
In the interests of compatibility with the original Windows based application, the default value is 'W'. A comparison between the models indicates that the modified IONCAP model ('a') is the most accurate when compared to the ITU's D1 Databank of HF field strength data.
The absorption model is global and affects both point-to-point and area predictions.
Input files are text based and made up of rows of data, or cards. The collection of cards is soemtimes referred to as the 'deck', harking back to the card based I/O of early computer systems.
The formatting of the input deck is critical to the operation of voacap and many 'bugs' can be traced to a malformed deck. This section defines the formatting of the individual input cards.
This card is used to define the characteristics of the transmit and receive antennas and is formatted as follows;
ANTENNA 1 1 2 30 0.000[harris/[email protected] ] 0.0 0.4000
ANTENNA 2 2 2 30 0.000[harris/1950BD10.anw ] 23.2 0.0000
This is read by voacapl with the following;
1510 FORMAT(10X,4I5,f10.3,1x,a21,1x,f5.1,f10.4)
READ(INPUT,1510) IAT,iantr,minfreq,maxfreq,designfreq(iantr),antfile(iantr),beammain(iantr),pwrkw(iantr)
| Columns | Name | Format | Description |
|---|---|---|---|
| 1-10 | Label | 10X | ANTENNA Label |
| 11-15 | IAT | I5 | Antenna Type (1 = Transmit, 2 = Receive) |
| 16-20 | iantr | I5 | integer value to identify antenna |
| 21-25 | minfreq | I5 | Minimum frequency of operation |
| 26-30 | maxfreq | I5 | maximum frequency of operation |
| 31-40 | designfreq | F10.3 | Antenna design frequency |
| 41-61 | antfile | A21 | Filepath to the relevant antenna file (relative to the itshfbc directory) |
| 62-66 | beammain | f5.1 | Antenna bearing (degrees) |
| 67-76 | pwerkw | f10.4 | Power (kW) |