diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index 7d25bac6b..1bd72c7fe 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -53,7 +53,7 @@ set (UG_SRCS tutorial-example4.adoc tutorial-example5.adoc tutorial-example6.adoc - tutorial-main-window.adoc + tutorial-download-samples.adoc tutorial-wide-graph-settings.adoc utilities.adoc vhf-features.adoc diff --git a/doc/user_guide/en/images/download_samples.png b/doc/user_guide/en/images/download_samples.png index fd2787f4e..cd4ed7580 100644 Binary files a/doc/user_guide/en/images/download_samples.png and b/doc/user_guide/en/images/download_samples.png differ diff --git a/doc/user_guide/en/tutorial-download-samples.adoc b/doc/user_guide/en/tutorial-download-samples.adoc new file mode 100644 index 000000000..4f878c4f3 --- /dev/null +++ b/doc/user_guide/en/tutorial-download-samples.adoc @@ -0,0 +1,15 @@ +// Status=review + +[[DOWNLOAD_SAMPLES]] +=== Download Samples + +The following steps will download sample audio Wave files that were originally recorded +by WSJT-X. These files can be read in to simulate realtime operation. + +- Select *Download samples...* from the *Help* menu. + +- Download some or all of the available sample files using checkboxes +on the screen shown below. For this tutorial you will need at least +the FT8 files. + +image::download_samples.png[width=400,align="center",alt="Download Samples"] diff --git a/doc/user_guide/en/tutorial-example3.adoc b/doc/user_guide/en/tutorial-example3.adoc index 1669f18df..3cd84ed31 100644 --- a/doc/user_guide/en/tutorial-example3.adoc +++ b/doc/user_guide/en/tutorial-example3.adoc @@ -1,14 +1,9 @@ // Status=review .Main Window: -- Select *FT8* on the *Mode* menu. +- Click the *Stop* button on the main window to halt any data acquisition. +- Select *FT8* from the *Mode* menu and *Deep* from the *Decode* menu. - Double-click on *Erase* to clear both text windows. -.Wide Graph Settings: - -- *Bins/Pixel* = 5, *Start* = 100 Hz, *N Avg* = 2 -- Adjust the width of the Wide Graph window so that the upper -frequency limit is approximately 3300 Hz. - .Open a Wave File: - Select *File | Open* and navigate to @@ -53,6 +48,11 @@ box *Hold Tx Freq*. TIP: Keyboard shortcuts *Shift+F11* and *Shift+F12* provide an easy way to move your Tx frequency down or up in 60 Hz steps. +TIP: Sliders and spinner controls respond to *Arrow* key presses +and *Page Up/Down* key presses, with the *Page* keys moving the +controls in larger steps. You can also type numbers directly into +the spinner controls or use the mouse wheel. + TIP: An online {ft8_tips} by ZL2IFB offers many additional tips on operating procedures. diff --git a/doc/user_guide/en/tutorial-main-window.adoc b/doc/user_guide/en/tutorial-main-window.adoc deleted file mode 100644 index d832e72a5..000000000 --- a/doc/user_guide/en/tutorial-main-window.adoc +++ /dev/null @@ -1,25 +0,0 @@ -// Status=review - -- Click the *Stop* button on the main window to halt any data acquisition. - -- Select *JT9* from the *Mode* menu and *Deep* from the *Decode* menu. - -- Set the audio frequencies to *Tx 1224 Hz* and *Rx 1224 Hz*. - -+ - -TIP: Sliders and spinner controls respond to *Arrow* key presses -and *Page Up/Down* key presses, with the *Page* keys moving the -controls in larger steps. You can also type numbers directly into -the spinner controls or use the mouse wheel. - -[[DOWNLOAD_SAMPLES]] -=== Download Samples - -- Select *Download samples...* from the *Help* menu. - -- Download some or all of the available sample files using checkboxes -on the screen shown below. For this tutorial you will need at least -the JT9 files. - -image::download_samples.png[align="center",alt="Downlod Samples"] diff --git a/doc/user_guide/en/tutorial-wide-graph-settings.adoc b/doc/user_guide/en/tutorial-wide-graph-settings.adoc index cdef3f1e1..a5444f0d0 100644 --- a/doc/user_guide/en/tutorial-wide-graph-settings.adoc +++ b/doc/user_guide/en/tutorial-wide-graph-settings.adoc @@ -1,13 +1,20 @@ // Status=review -- *Bins/Pixel* = 4 -- *Start* = 200 Hz -- *N Avg* = 5 -- *Palette* = Digipan -- *Flatten* = checked +Set up the Wide Graph (also called the Waterfall). It is important to set appropriate lower and upper +audio frequency limits for the Wide Graph because these limits define the FT8 decoder's search window. + +- Set *Start* = 100 Hz. +- Set *Bins/Pixel* = 5. Smaller/larger values make the Wide Graph cover a smaller/larger +frequency range. +- Use the mouse to grab the left or right edge of the *Wide Graph*, and +adjust its width so that the upper frequency limit is about 3300 Hz. +- Set *N Avg* = 2. Smaller/larger values will make the wide graph update more/less frequently, resulting +in signals being more/less spread out in the vertical (time) direction on the Wide Graph spectrogram. +Larger values make it easier to see very weak signals. +- *Palette* = Digipan +- *Flatten* = checked - Select *Cumulative* for data display - *Gain* and *Zero* sliders for waterfall and spectrum set near midscale -- *Spec* = 25% +- Set *Spec* = 25%. This value determines the percentage of the vertical size of the Wide Graph +that will be used for the line plot of the spectrum. -- Use the mouse to grab the left or right edge of the *Wide Graph*, and -adjust its width so that the upper frequency limit is about 2400 Hz. diff --git a/doc/user_guide/en/wsjtx-main.adoc b/doc/user_guide/en/wsjtx-main.adoc index 019545d8e..120cafb2b 100644 --- a/doc/user_guide/en/wsjtx-main.adoc +++ b/doc/user_guide/en/wsjtx-main.adoc @@ -141,27 +141,20 @@ include::transceiver-setup.adoc[] == Basic Operating Tutorial This section introduces the basic user controls and program behavior -of _WSJT-X_, with particular emphasis on the JT9, JT65, and FT8 modes. +of _WSJT-X_, with particular emphasis on the FT8 mode. We suggest that new users should go through the full HF-oriented -tutorial, preferably while at your radio. Note that as of late 2018, -digital usage on the HF bands has mostly moved from JT65 and JT9 to FT8. So -you may wish to pay particular attention to *FT8*, in Section 6.6. +tutorial, preferably while at your radio. Subsequent sections cover additional details on <>, <> and <>. -[[TUT_MAIN]] -=== Main Window Settings -include::tutorial-main-window.adoc[] +[[TUT_SAMPLES]] +include::tutorial-download-samples.adoc[] [[TUT_WIDE_GRAPH]] === Wide Graph Settings include::tutorial-wide-graph-settings.adoc[] -[[TUT_EX1]] -=== JT9 -include::tutorial-example1.adoc[] - [[TUT_EX3]] === FT8 include::tutorial-example3.adoc[]