diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index 7a5eb43b2..2f5d172a4 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -12,6 +12,7 @@ set (UG_SRCS docinfo.html docinfo.xml acknowledgements.adoc + astro_data.adoc compiling.adoc config-details.adoc controls-functions-center.adoc @@ -58,8 +59,11 @@ set (UG_SRCS set (UG_IMGS images/130610_2343-wav-80.png + images/AstroData_2.png + images/Astronomical_data.png images/band-settings.png images/colors.png + images/config-menu.png images/decode-menu.png images/decodes.png images/file-menu.png @@ -69,7 +73,7 @@ set (UG_IMGS images/keyboard-shortcuts.png images/log-qso.png images/MacAppMenu.png - images/main-ui-1.5.png + images/main-ui.png images/main-ui-controls.png images/misc-controls-center.png images/misc-main-ui.png diff --git a/doc/user_guide/en/astro_data.adoc b/doc/user_guide/en/astro_data.adoc new file mode 100644 index 000000000..d02a5ab1f --- /dev/null +++ b/doc/user_guide/en/astro_data.adoc @@ -0,0 +1,44 @@ +A text box entitled Astronomical Data provides information needed for +tracking the sun or moon, moon, compensating for EME Doppler shift, +and estimating EME Doppler spread and path degradation. Toggle the +*Astronomical data* on the *View* menu to display or remove this window. + +image::AstroData_2.png[align="center",alt="Astronomical Data"] + +Available information includes the current *Date* and *UTC* time; *Az* +and *El*, azimuth and elevation of the moon at your own location, in +degrees; *SelfDop*, *Width*, and *Delay*, the Doppler shift, full +limb-to-limb Doppler spread, and delay of your own EME echoes; and +*DxAz* and *DxEl*, *DxDop*, and *DxWid*, corresponding parameters for +a station located at the DX Grid entered on the main window. These +numbers are followed by *Dec*, the declination of the moon; *SunAz* +and *SunEl*, the azimuth and elevation of the Sun; *Freq*, your stated +operating frequency in MHz; *Tsky*, the estimated sky background +temperature in the direction of the moon, scaled to the operating +frequency; *Dpol*, the spatial polarization offset in degrees; *MNR*, +the maximum non-reciprocity of the EME path in dB, owing to spatial +polarization; and finally *Dgrd*, an estimate of the signal +degradation in dB, relative to the best possible time with the moon +at perigee in a cold part of the sky. + +The state of the art for establishing three-dimensional locations of +the sun, moon, and planets at a specified time is embodied in a +numerical model of the solar system maintained at the Jet Propulsion +Laboratory. The model has been numerically integrated to produce +tabular data that can be interpolated with very high accuracy. For +example, the celestial coordinates of the moon or a planet can be +determined at a specified time to within about 0.0000003 degrees. The +JPL ephemeris tables and interpolation routines have been incorporated +into _WSJT-X_. Further details on accuracy, especially concerning +calculated EME Doppler shifts, are described in + +The sky background temperatures reported by _WSJT-X_ are derived from +the all-sky 408 MHz map of Haslam et al. (Astronomy and Astrophysics +Supplement Series, 47, 1, 1982), scaled by frequency to the (-2.6) +power. This map has angular resolution of about 1 degree, and of +course most amateur EME antennas have much broader beamwidths than +this. Your antenna will therefore smooth out the hot spots +considerably, and the observed extremes of sky temperature will be +less. Unless you understand your sidelobes and ground reflections +extremely well, it is unlikely that more accurate sky temperatures +would be of much practical use. diff --git a/doc/user_guide/en/controls-functions-center.adoc b/doc/user_guide/en/controls-functions-center.adoc index 92b72a1c0..90b868f8e 100644 --- a/doc/user_guide/en/controls-functions-center.adoc +++ b/doc/user_guide/en/controls-functions-center.adoc @@ -1,22 +1,24 @@ // Status=review At the center of the main window are a number of controls used when -making QSOs: +making QSOs. Controls not relevant to a particular mode or submode +may be "grayed out" (diabled) or removed from the display. //.Misc Controls Center image::misc-controls-center.png[align="center",alt="Misc Controls Center"] -* Check *Tx even* to transmit in even-numbered UTC minutes. Uncheck -this box to transmit in the odd minutes. This selection is made -automatically when you double-click on a decoded text line, as -described in the <>. +* Check *Tx even* to transmit in even-numbered UTC minutes or +sequences, starting at 0. Uncheck this box to transmit in the odd +sequences. The correct selection is made automatically when you +double-click on a decoded text line, as described in the +<>. -* The Tx and Rx audio frequencies are usually set automatically by -double-clicking on decoded text or a signal in the waterfall. They -can also be adjusted with spinner controls. +* The Tx and Rx audio frequencies can be set automatically by +double-clicking on decoded text or a signal in the waterfall. They +can also be adjusted using the spinner controls. * You can force Tx frequency to the current Rx frequency by clicking -the *Tx