WSJT-X/doc/source/tutorial-example2.adoc
Joe Taylor 784e246557 1. Fix a bug that could cause decoder to hang when presented with
bad data.

2. Fix a bug that could allow a Koetter-Vardy false decode instead of
a valid Berlekamp-Massey decode, sometimes leading to program crash.

3. Many more edits in the User's Guide, *.adoc files.



git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@3664 ab8295b8-cf94-4d9e-aec4-7959e3be5d79
2014-01-27 21:28:54 +00:00

98 lines
3.8 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// Status=review
.Wide Graph Settings:
- *Bins/Pixel* = 7
- *Zero* = -3
- Adjust the width of the Wide Graph window so that its upper
frequency limit is approximately 4000 Hz.
.Main Window:
- Select *JT9+JT65* on the *Mode* menu
- Toggle the *Tx mode* button to read *Tx JT65*, and set the Tx and Rx
frequencies to 1718 Hz.
- Double-click on *Erase* to clear both text windows.
.Open a Wave File:
- Select *File | Open* and navigate to +...\save\samples\130610_2343.wav+.
The waterfall should look like this:
//.130610_2343.wav Decode
[[X14]]
image::images/130610_2343-wav-80.png[align="left",alt="Wide Graph Decode 130610_2343"]
This sample file contains 17 decodable signals — nine in JT65 mode
(flagged with the character # in the decoded text windows), and eight
in JT9 mode (flagged with @).
... Figure here showing text windows ...
Since the Tx mode was set to *Tx JT65*,
signals in that mode were decoded first. If you had selected *Tx JT9*,
JT9 signals would have been decoded first.
TIP: Notice the [blue]*BLUE* marker on the waterfall scale, by default
set at 2500 Hz. Its position is set by the spinner control *JT65 nnnn
JT9*, where nnnn is a frequency in Hz. In *JT9+JT65* mode the program
will automatically decode JT65 signals below this frequency and JT9
signals above it.
- Confirm that mouse-click behavior is similar to that described
<<X13,above>>, in Example 1. The program automatically determines the
mode of each JT9 or JT65 signal.
- Double-click on the waterfall near 815 Hz: a JT65 message
originating from W7VP will be decoded and appear in the *Rx Frequency*
window.
[width="70%",cols="3,^3,^3,^4,^4,30",options="header"]
|=================================
|UTC|db|dt|Freq|Mode|Message
|2343|-7|0.3|815|#|KK4DSD W7VP -16
|=================================
- Double-click on the waterfall at 3196 Hz and the program will decode a JT9
message from IZ0MIT:
[width="70%",cols="3,^3,^3,^4,^4,30",options="header"]
|=====================================
|UTC|db|dt|Freq|Mode|Message
|2343|-7|0.3|3196|@|WB8QPG IZ0MIT -11
|=====================================
TIP: Notice that when a signal is decoded in this way, the Tx mode
automatically switches to that of the decoded signal and the Rx and Tx
frequency markers on the waterfall scale resize themselves
accordingly.
- Scroll back in the *Band Activity* window and double-click on the
message CQ DL7ACA JO40. The program will set *Tx mode* to JT65 and Tx
and Rx frequencies to that of DL7ACA, 975 Hz. If you had checked
*Double-click on call sets Tx Enable* on the *Setup* menu, the program
would configure itself to start a QSO with DL7ACA.
- Double-click on the decoded JT65 message CQ TA4A KM37. The program
will set Tx mode to JT9 and the Rx and Tx frequencies to 3567 Hz. The
program is now configured properly for a JT9 QSO with TA4A.
.Reopen the First Sample File:
- Select *File | Open* and navigate to +...\save\samples\130418_1742.wav+.
These data were recorded with a much narrower Rx bandwidth, roughly
200 to 2600 Hz. If you have no Rx filter wider than about 2.7 kHz, you
will be using data like this. For best viewing, adjust *Bins/Pixel*
and the width of the Wide Graph so that only the active part of the
spectrum shows, say 0 to 2600 Hz. Re-open the example file after any
change of *Bins/Pixel* or Wide Graph width, to refresh the waterfall.
The signals in this file are all JT9 signals. To decode them in
JT9+JT65 mode youll need to move the JT65 nnnn JT9 delimiter down to
1000 Hz or less.
.Start, Zero, and Gain
Now is a good time to experiment with the *Start*, *Zero*, and
*Gain* parameters. *Start* sets the starting frequency at the left
side of the waterfall scale. *Zero* sets the baseline level for
colors, and *Gain* sets the sensitivity for color changes. For the
receiver setup of this file good values are *Zero*=0, *Gain*=0.
Re-open the wave file after each change, to see the new results.