1
0
mirror of https://github.com/f4exb/sdrangel.git synced 2024-12-23 01:55:48 -05:00
sdrangel/plugins/feature/antennatools
DreamNik 202fc96de6 Append prefix to plugin name when running on Android.
Android libraries can't be placed inside subdirectory, so to
distinguish plugins from regular libraries the new prefix is used.
2024-09-05 13:37:51 +03:00
..
antennatools
antennatools.cpp Fix bug that prevents settings changes updates via reverse API 2024-04-14 18:58:12 +02:00
antennatools.h Rewriting of copyright notices for plugins/features. Part of #1893 2023-11-18 13:12:18 +01:00
antennatools.qrc
antennatoolsgui.cpp Removed destroy method leftovers and Sonar lint 2024-08-27 09:54:09 +02:00
antennatoolsgui.h Rewriting of copyright notices for plugins/features. Part of #1893 2023-11-18 13:12:18 +01:00
antennatoolsgui.ui Remove unused resources 2024-06-23 17:32:48 +02:00
antennatoolsplugin.cpp Updated versions and changelogs 2024-06-25 22:19:14 +02:00
antennatoolsplugin.h Rewriting of copyright notices for plugins/features. Part of #1893 2023-11-18 13:12:18 +01:00
antennatoolssettings.cpp Rewriting of copyright notices for plugins/features. Part of #1893 2023-11-18 13:12:18 +01:00
antennatoolssettings.h Remove unused includes and use more direct includes 2024-04-20 19:10:18 +02:00
antennatoolswebapiadapter.cpp Rewriting of copyright notices for plugins/features. Part of #1893 2023-11-18 13:12:18 +01:00
antennatoolswebapiadapter.h Rewriting of copyright notices for plugins/features. Part of #1893 2023-11-18 13:12:18 +01:00
CMakeLists.txt Append prefix to plugin name when running on Android. 2024-09-05 13:37:51 +03:00
readme.md plugins: remove UTF-8 BOMB from readme.md 2024-04-26 08:37:24 +02:00

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

Half wave dipole calculator GUI

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

Parabolic Dish Calculator GUI

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)