15337cac66
Most plugins that use reverse API to PATCH settings updates to remote server only do so when `useReverseAPI` is toggled, but not when the relevant settings are being updated. So lets fix the precondition to use the `m_useReverseAPI` flag instead. |
||
|---|---|---|
| .. | ||
| antennatools | ||
| antennatools.cpp | ||
| antennatools.h | ||
| antennatools.qrc | ||
| antennatoolsgui.cpp | ||
| antennatoolsgui.h | ||
| antennatoolsgui.ui | ||
| antennatoolsplugin.cpp | ||
| antennatoolsplugin.h | ||
| antennatoolssettings.cpp | ||
| antennatoolssettings.h | ||
| antennatoolswebapiadapter.cpp | ||
| antennatoolswebapiadapter.h | ||
| CMakeLists.txt | ||
| 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)