Don't call mskrtd if 1st or 2nd half of the 7168 samples are all zero.

Also more UserGuide edits...


git-svn-id: svn+ssh://svn.code.sf.net/p/wsjt/wsjt/branches/wsjtx@7202 ab8295b8-cf94-4d9e-aec4-7959e3be5d79

doc/user_guide/en/install-windows.adoc

@@ -3,15 +3,16 @@
 Download and execute the package file {win32}, following these
 instructions:
 
-- Install _WSJT-X_ into its own directory such as `C:\WSJTX` or
+- Install _WSJT-X_ into its own directory, for example `C:\WSJTX` or
-`C:\WSJT\WSJTX` rather than the conventional location
+`C:\WSJT\WSJTX`, rather than the conventional location
 `C:\Program Files\WSJTX`.
 
 - All program files relating to _WSJT-X_ will be stored in the chosen
 installation directory and its subdirectories. 
 
 - Logs and other writeable files will normally be found in the 
-directory `C:\Users\<username>\AppData\Local\WSJT-X`.
+directory +
+`C:\Users\<username>\AppData\Local\WSJT-X`.
 
 IMPORTANT: Your computer may be configured so that this directory is
 "`invisible`".  It's there, however, and accessible.  An alternative

doc/user_guide/en/vhf-features.adoc

@@ -1,59 +1,59 @@
-[[VHF_SETUP]]
+_WSJT-X_ v1.7 introduces a number of new features designed for use
-=== VHF Setup
+on the VHF and higher bands.  These features now include:
-
-_WSJT-X_ v1.7 builds on the features for VHF and higher bands first
-introduced in v1.6.  These features now include:
 
 - *JT4*, a mode particularly useful for EME on the microwave bands
 
-- *QRA64*, a mode for EME using a "`Q-ary Repeat Accumulate`" code --
+- *JT9* fast modes, useful for scatter propagation on VHF bands
-a low-density partity-check (LDPC) code with a 64-character symbol
+
+- *QRA64*, a mode for EME using a "`Q-ary Repeat Accumulate`" code,
+a low-density partity-check (LDPC) code using a 64-character symbol
 alphabet
 
 - *MSK144*, a mode for meteor scatter using a binary LDPC code and
-Offset Quadrature Phase-Shift Keying (OQPSK), a waveform also
+Offset Quadrature Phase-Shift Keying (OQPSK).  The resulting waveform
-describable as Minimum Shift Keying (MSK)
+is sometimes called Minimum Shift Keying (MSK).
 
 - *ISCAT*, intended for aircraft scatter and other types of scatter
 propagation
 
 - *Echo* mode, for detecting and measuring your own lunar echoes
 
-- Automatic *Doppler tracking* for the EME path.  This is increasingly
+- *Doppler tracking*, which becomes increasingly important for EME
-important on bands above 1.2 GHz.
+on bands above 1.2 GHz.
 
-- Optional *Auto-sequencing* of messages for the fast modes.
+- *Auto-sequencing* of transmitted messages for the fast modes with
+forward error control
+
+[[VHF_SETUP]]
+=== VHF Setup
 
 To activate the VHF-and-up features:
 
-- Check the box labeled *Enable VHF/UHF/Microwave features* on the
+- Check *Enable VHF/UHF/Microwave features* and *Single decode* on the
 *Settings | General* tab.
 
-- In most cases you will also want to check *Single decode*.
+- For EME, check *Decode at t = 52 s* to allow for the extra path
-
+delay on received signals.
-- If you will be doing EME, check the box *Decode at t = 52 s*
-to allow for the EME path delay on received signals.
 
 - If you will use automatic Doppler tracking and your radio accepts
-frequency-setting commands while transmitting, check the box *Allow Tx
+frequency-setting commands while transmitting, check *Allow Tx
 frequency changes while transmitting*.  Transceivers known to permit
 such changes include the IC-735, IC-756 Pro II, IC-910-H, FT-817,
-FT-847, FT-857, FT-897, TS-590S, TS-590SG, TS-2000 (with Rev 9
+FT-847, FT-857, FT-897, TS-590S, TS-590SG, TS-2000 (with Rev 9 or
-firmware upgrade), Flex 1500 and 5000, HPSDR, Anan-10, Anan-100, and
+later firmware upgrade), Flex 1500 and 5000, HPSDR, Anan-10, Anan-100,
-KX3. On the *Radio* tab select *Split Operation* (use either *Rig* or
+and KX3.
-*Fake It*; you may need to experiment with both options to find one
-that works best with your radio).
 
-- If your radio does not accept commands to change frequency while
+IMPORTANT: If your radio does not accept commands to change frequency while
 transmitting, Doppler tracking will be approximated by making a single
 Tx frequency adjustment before a transmission starts, using a value
 computed for the middle of the Tx period.
 
-- The main window will reconfigure itself as necessary to display
+- On the *Radio* tab select *Split Operation* (use either *Rig* or
-controls supporting the features of each mode.  For example, in JT4 mode
+*Fake It*; you may need to experiment with both options to find one
-the central part of the main window looks something like this:
+that works best with your radio).
 
-image::VHF_controls.png[align="center",alt="VHF Controls"]
+The main window will reconfigure itself as necessary to display
+controls supporting the features of each mode.
 
 - If you are using transverters, set appropriate frequency offsets on
 the *Settings | Frequencies* tab.  Offset is defined as (transceiver
@@ -68,8 +68,8 @@ image::Add_station_info.png[align="center",alt="Station information"]
 
 - On the *View* menu, select *Astronomical data* to display a window
 with important information for tracking the Moon and performing
-automatic Doppler control.  Check the box labeled *Doppler tracking*
+automatic Doppler control.  The right-hand portion of the window is
-to ensure that the right-hand portion of the window is visible.
+invisible until you check *Doppler tracking*.
 
 image::Astronomical_data.png[align="center",alt="Astronomical data"]
 
@@ -79,35 +79,39 @@ Three different types of Doppler tracking are provided:
 and he/she will not be using any Doppler control.
 
 - Select *Receive only* to enable EME Doppler tracking of your receive
-frequency to a specific locator; your Tx frequency will remain fixed.
+frequency to a specific locator. Your Tx frequency will remain fixed.
 
 - Select *Constant frequency on Moon* to correct for your own (one-way)
 Doppler shift to or from the Moon.  If your QSO partner does the same
 thing, both stations will have the required Doppler compensation.
 Moreover, anyone else using this option will hear both of you
-without the need for manual frequency changes.  The hypothetical "`man
+without the need for manual frequency changes.
-in the moon`" would copy all of you on the selected nominal frequency.
 
 === JT4
 
-- Select *JT4* from the *Mode* menu.
+JT4 is highly effective for EME on the microwave bands, 2.3 GHz
+and above.
 
-- Select the desired submode, which determines the tone spacing.
+- Select *JT4* from the *Mode* menu.  The central part of the main
-Higher spacings are used on the higher microwave bands, to allow for
+window will look something like this:
-larger Doppler spreads. For example, submode JT4F is generally used
-for EME on the 10 GHz band.
 
-- The JT4 decoder in _WSJT-X_ includes optional capabilities for
+image::VHF_controls.png[align="center",alt="VHF Controls"]
-averaging over successive transmissions, and correlation decoding,
+
-also known as "`Deep Search`".  Either or both of these options may
+- Select the desired *Submode*, which determines the spacing of
-be selected from the *Decode* menu.
+transmitted tones. Wider spacings are used on the higher microwave
+bands to allow for larger Doppler spreads. For example, submode JT4F
+is generally used for EME on the 5.7 and 10 GHz bands.
+
+- For EME QSOs some operators use short-form JT4 messages consisting
+of a single tone.  To activate automatic generation of these messages,
+check the box labeled *Sh*.
+
+- Select *Deep* from the *Decode* menu.  You may also choose to enable
+averaging over successive transmissions and/or correlation decoding,
+also known as "`Deep Search`".
 
 image::decoding_depth.png[align="center",alt="Decoding Depth"]
 
-- By convention, EME with JT4 can use "`short form`" messages
-consisting of a single tone.  To activate automatic generation of
-these messages, check the box labeled *Sh* on the main window.
-
 IMPORTANT: Additional hints for using JT4 and Echo mode on the
 EME path have been compiled by G3WDG and are available here: {jt4eme}.
 

doc/user_guide/en/wsjtx-main.adoc

@@ -39,9 +39,10 @@ include::system-requirements.adoc[]
 [[INSTALL]]
 == Installation
 
-Installation packages for Windows, Linux, and OS X are found on the
+Installation packages for released versions on Windows, Linux, and OS
-the {homepage}. Click on the _WSJT-X_ link at the left margin, and
+X are found on the the {homepage}. Click on the _WSJT-X_ link at the
-then select the appropriate package for your operating system.
+left margin and select the appropriate package for your operating
+system.
 
 [[INSTALL_WIN]]
 === Windows
@@ -109,13 +110,12 @@ include::transceiver-setup.adoc[]
 [[TUTORIAL]]
 == Basic Operating Tutorial
 
-<<TUT_MAIN,Sections 6.1>> through <<TUT_EX2,6.4>> introduce the basic
+<<TUT_MAIN,Sections 6.1>> through <<TUT_EX2,6.4>> introduce basic user
-user controls and program behavior of _WSJT-X_.  We suggest that new
+controls and program behavior of _WSJT-X_.  We suggest that new users
-users should go through the full HF-oriented tutorial, preferably
+should go through the full HF-oriented tutorial, preferably while at
-while at your radio.  Details on the standard message structure used
+your radio.  Subsequent sections cover additional details on
-for making two-way QSOs are found in <<MAKE_QSOS,Section 7>>, followed
+<<MAKE_QSOS,Making QSOs>>, <<WSPR,WSPR mode>> and <<VHF_AND_UP,VHF+
-by sections covering <<WSPR,WSPR mode>> and features for
+Features>>.
-<<VHF_AND_UP,VHF and above>>.
 
 [[TUT_MAIN]]
 === Main Window Settings

doc/user_guide/en/wspr.adoc

@@ -6,10 +6,10 @@ used in WSPR mode.
 
 image::WSPR.png[align="center",alt="WSPR mode"]
 
-- Use the mouse to set the width and height of the main window as
+- Use the mouse to drag the width and height of the main window to the
-desired.
+desired size.
 
-- Select an active WSPR frequency (for example, 10.1387 MHz).
+- Select an active WSPR frequency (for example, 10.1387 or 14.0956 MHz).
 
 - Click *Monitor* to start a WSPR receiving period.
 

lib/hspec.f90

@@ -76,6 +76,11 @@ subroutine hspec(id2,k,nutc0,ntrpdepth,nrxfreq,ntol,bmsk144,ingain,   &
   if(bmsk144) then
      if(k.ge.7168) then
         tsec=(k-7168)/12000.0
+        k0=k-7168
+        tt1=sum(float(abs(id2(k0:k0+3583))))
+        k0=k-3584
+        tt2=sum(float(abs(id2(k0:k0+3583))))
+        if(tt.eq.0.0 .or. tt2.eq.0) print*,k,k/12000.0
         call mskrtd(id2(k-7168+1:k),nutc0,tsec,ntol,nrxfreq,ndepth,   &
              mycall,hiscall,bshmsg,line1)
      endif