

=head1 NAME

  Elevation - a program to view Elevation patterns

=head1 SYNOPSIS

  Elevation [NEC2outputfile]

=head1 DESCRIPTION

B<Elevation> reads files produced by NEC2 and provides three graphical
depictions of that data, as well as a ``fact sheet'' summary.
The default NEC2outputfile is ``fort.2''.

The three ``plots'' of output data include an ARRL-scaled polar graph,
a linearly-scaled polar graph, and a cartesian graph of the same data.
The user is cautioned that the usual NEC practice is to regard
0 degrees of elevation as "straight up".  Therefore, if the maximum
gain of an antenna is at "67 degrees of elevation", this represents
maximum gain at 23 degrees above "horizontal".

If the minimum gain of an antenna is below -60 db, the program
assumes a minimum gain of -60 db for the purposes of scaling the
graphs
properly.

In order to use B<Elevation> you must have NEC2 calculate certain data.
The ``RP card'' for NEC2 input must be of this form:

S<RP  0  180    1 1001  -90.0  0.0  1.0  0.0  10000.0 0.00E+00>


This will insure that B<Elevation> has the data it expects.


A sample data file which describes a rhombic is included with Elevation,
and is reproduced here also.  


S<
CM NEC Input File for Rhombic
CE
GW  1 10   0.00000   0.00000  10.00000  17.30000  10.00000  10.00000 0.01000
GW  2 10   0.00000   0.00000  10.00000  17.30000 -10.00000  10.00000 0.01000
GW  3 10  17.30000  10.00000  10.00000  34.60000   0.00000  10.00000 0.01000
GW  4 10  17.30000 -10.00000  10.00000  34.60000   0.00000  10.00000 0.01000
GE  1
GN  1  0    0    0  0.00E+00  0.00E+00  0.00E+00  0.00E+00  0.00E+00 0.00E+00
FR  0  1    0    0  3.00E+01  0.00E+00  0.00E+00  0.00E+00  0.00E+00 0.00E+00
EX  0  1    1    0  1.00E+00  0.00E+00  0.00E+00  0.00E+00  0.00E+00 0.00E+00
EX  0  2    1    0 -1.00E+00  0.00E+00  0.00E+00  0.00E+00  0.00E+00 0.00E+00
LD  0  3   10   10  2.90E+02  0.00E+00  0.00E+00  0.00E+00  0.00E+00 0.00E+00
LD  0  4   10   10  2.90E+02  0.00E+00  0.00E+00  0.00E+00  0.00E+00 0.00E+00
RP  0  180    1 1001  -90.0  0.0  1.0  0.0  10000.0 0.00E+00
EN
>

A NEC2outputfile that results from this input file is included in
the Elevation distribution directory as "fort.2".  A file called "elevationcard"
is also included.  That file contains only an appropriate "RP card".



B<Elevation> is part of the W5GFE Perl Antenna Toolkit.  It is released
under terms of the GNU Public License.



=head1 AUTHOR

Bill Walker, W5GFE, bw@cs.ecok.edu

=head1 SEE ALSO

perl(1), Wires.pl (W5GFE), Elevation.pl (W5GFE), necview (W5GFE)



=cut
  
