1
0
mirror of https://github.com/f4exb/sdrangel.git synced 2024-11-16 13:21:50 -05:00
sdrangel/plugins/feature/antennatools
Jon Beniston c966f1cb5a dd maximize button to MainSpectrum and expandible Channels and Features.
Add sizeToContents in ChannelGUI and FeatureGUI, called when widget is
rolled, so we can remove resizing code from all of the individual
channels and features.

In RollupContents, use minimumSizeHint for calculated size, so that
minimumWidth can come from .ui file.

In DeviceGUI::sizeToContents(), call adjustSize(), so Device GUIs start
out at minimum needed size (which should restore appearance prior to
last patch).

In stackSubWindows, use available space for channels if no
spectrum/features present.
In stackSubWindows, fix spectrum from being sized too big, resulting in
scroll bars appearing.
Reset user-defined channel width in stackSubWindows, when channels are
removed.
Don't stack maximized windows.

There's one hack in Channel/FeatureGUI::maximizeWindow(). It seems that
when maximimzing a window, QOpenGLWidgets aren't always paint properly
immediately afterwards, so the code forces an additional update. I can't
see why the first call to paintGL doesn't work.
2022-11-11 12:24:27 +00:00
..
antennatools Add antenna tools feature 2021-05-20 17:15:14 +01:00
antennatools.cpp Fixed some signal/slot connects. Removed unnecessary m_channelMessageQueue in ChannelAPI. Fixes #1185 2022-03-23 22:32:23 +01:00
antennatools.h Remove dead code 2022-09-20 21:13:55 +01:00
antennatools.qrc Add antenna tools feature 2021-05-20 17:15:14 +01:00
antennatoolsgui.cpp dd maximize button to MainSpectrum and expandible Channels and Features. 2022-11-11 12:24:27 +00:00
antennatoolsgui.h dd maximize button to MainSpectrum and expandible Channels and Features. 2022-11-11 12:24:27 +00:00
antennatoolsgui.ui dd maximize button to MainSpectrum and expandible Channels and Features. 2022-11-11 12:24:27 +00:00
antennatoolsplugin.cpp Updated main and plugin versions 2022-05-14 13:16:33 +02:00
antennatoolsplugin.h Add antenna tools feature 2021-05-20 17:15:14 +01:00
antennatoolssettings.cpp Massive UI revamping (v7): created configurations with just Features for now 2022-04-05 16:28:07 +02:00
antennatoolssettings.h Massive UI revamping (v7): created configurations with just Features for now 2022-04-05 16:28:07 +02:00
antennatoolswebapiadapter.cpp Add antenna tools feature 2021-05-20 17:15:14 +01:00
antennatoolswebapiadapter.h Add antenna tools feature 2021-05-20 17:15:14 +01:00
CMakeLists.txt Install debug symbols on Windows for debug builds 2022-02-06 12:56:58 +00:00
readme.md Fix typing errors in readme's 2022-05-15 12:39:57 +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)