sdrangel/plugins/feature/antennatools/readme.md

Antenna Tools Feature Plugin

Introduction

The Antenna Tools feature has a couple of calculators to help with antenna design and tuning.

• A dipole calculator, for calculating the length of a half wave dipole for a given frequency.
• A parabolic dish calculator, for calculating focal length for a dish with a given diameter and depth, as well as corresponding gain and beamwidth for a given frequency.

Each calculator is contained within an individual tab. Settings in one tab do not effect calculations in other tabs.

Half Wave Dipole Calculator

1: Frequency

When entering a frequency in MHz in this field, the calculator will calculate the total and element length for a half wave dipole at this frequency.

When a length is entered in (3) or (5), this field will display the corresponding resonant frequency.

2: Frequency Select

Select how the frequency is chosen:

• MHz - A frequency can be manually entered in (1) in MHz.
• Device set N - The frequency automatically tracks the centre frequency of Device Set N.

3: Dipole Total Length

This field displays the total length of a half wave dipole corresponding to the frequency entered in (1) or element length (5).

When a length is entered in this field, the calculator will calculate the corresponding frequency (1) and element length (5).

The dipole length is calculated as: l=0.5*k*c/f

4: Dipole Length Units

This field selects the units lengths are entered and displayed in. This can be:

• cm - centimetres.
• m - metres.
• feet - feet.

5: Dipole Element Length

This field displays the element length of each dipole for a half wave dipole corresponding to the frequency entered in (1) or total length (3).

When a length is entered in this field, the calculator will calculate the corresponding frequency (1) and total length (3).

6: End Effect Factor

A half wave dipole in free space with total length being half the wavelength of operation has a reactance of 43 Ohms.

To eliminate this reactance, the dipole should be shortened. The amount it needs to be shortened by depends upon the ratio of the diameter of the dipole to wavelength, with factors ranging from 0.98 for a thin dipole (0.00001 wavelengths) to 0.94 (thickness of 0.008 wavelengths) with a commonly used value of 0.95.

The calculator doesn't use an analytical formula for this, as the reactance also depends on the environment (such as distance to ground), so some experimentation is needed in finding the true value.

Parabolic Dish Calculator

7: Frequency

When entering a frequency in MHz in this field, the calculator will calculate the beamwidth (15) and gain (16) for a dish of the given dimensions (10 & 11) at the entered frequency.

8: Frequency Select

Select how the frequency is chosen:

• MHz - A frequency can be manually entered in (7) in MHz.
• Device set N - The frequency automatically tracks the centre frequency of Device Set N.

9: Efficiency

Specifies the efficiency of the dish in %. When entered, the calculator will calculate the gain (16), according to the entered frequency (7) and dimensions (10 & 11).

This value should include losses for things like spillover, illumination loss, feed and support blockage, focus errors.

10: Surface Error

Specifies the RMS surface error of the dish in length units (as determined by (12)).

11: Diameter

When entering the diameter of the dish, the calculator will calculate the focal length (14), f/D ratio (15), beamwidth (16) and gain (17).

12: Dish Length Units

This field selects the units lengths are entered and displayed in. This can be:

• cm - centimetres.
• m - metres.
• feet - feet.

13: Depth

When entering the depth of the dish, the calculator will calculate the focal length (14) and f/D ratio (15).

14: Focal length

Displays the calculated focal length.

Focal length is calculated as: f=d^2/(16*D)

15: f/D Ratio

Displays the calculated focal length to diameter ratio.

16: Beamwidth

Displays the halfpower (-3dB) beamwidth in degrees.

Beamwidth is calculated as: pi/1801.15lambda/D.

Note that the constant 1.15 is dependent upon illumination tapering, which is determined by the feed.

17: Gain

Displays the calculated gain in dB.

The nominal gain is calculated as: g0=10*log10(eff/100.0*(pi*D/lambda)^2)

The gain is then adjusted for surface error with Ruze's equation: g=g0-685.81*(e/lambda)^2

18: Effective area

Displays the effective area in m^2.

Aeff is calculated as: glambda^2/(4pi)