Add some FreqCal info to User Guide.

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

doc/CMakeLists.txt

@@ -34,6 +34,7 @@ set (UG_SRCS
   protocols.adoc
   logging.adoc
   make-qso.adoc
+  measurement_tools.adoc
   new_features.adoc
   platform-dependencies.adoc
   protocols.adoc
@@ -72,6 +73,9 @@ set (UG_IMGS
   images/decodes.png
   images/download_samples.png
   images/file-menu.png
+  images/FreqCal.png
+  images/FreqCal_Graph.png
+  images/FreqCal_Results.png
   images/freemsg.png
   images/ft8_decodes.png
   images/help-menu.png

doc/user_guide/en/measurement_tools.adoc

@@ -56,6 +56,7 @@ measurements, as shown for these measurements in the graph plotted
 below.  Software tools for completing this task are included with the
 _WSJT-X_ installation, and detailed instructions for their use are
 available at https://physics.princeton.edu/pulsar/k1jt/FMT_User.pdf.
+
 Using these tools and no specialized hardware beyond your
 CAT-interfaced radio, you can calibrate the radio to better than 1 Hz
 and compete very effectively in the ARRL's periodic Frequency
@@ -63,6 +64,17 @@ Measuring Tests.
 
 image::FreqCal_Graph.png[align="left",alt="FreqCal_Graph"]
 
+After running *Execute frequency calibration cycle* at least once with
+good results, the line-fitting procedure can be carried out
+automatically by clicking *Solve for calibration parameters* on the
+*Tools* menu.  The results will be displayed as in the following
+screen shot.  Estimated uncertainties are included for slope and
+intercept; `N` is the number of averaged frequency measurements included
+in the fit, and `StdDev` is the root mean square deviation of
+averaged measurements from the fitted straight line.  
+
+image::FreqCal_Results.png[align="center",alt="FreqCal_Results"]
+
 === Reference Spectrum
 
 _WSJT-X_ provides a tool that can be used to determine the detailed

mainwindow.cpp

@@ -2113,7 +2113,7 @@ void MainWindow::on_actionSolve_FreqCal_triggered()
   strncpy(data_dir,dpath.toLatin1(),len);
   calibrate_(data_dir,&iz,&a,&b,&rms,&sigmaa,&sigmab,&irc,len);
   QString t1;
-  t1.sprintf("Slope:     %10.3f ±%7.3f ppm\nIntercept:  %7.2f ±%5.2f    Hz\n\nNgroups:   %6d\nStdDev:  %8.2f  Hz",
+  t1.sprintf("Slope:     %10.3f ±%7.3f ppm\nIntercept:  %7.2f ±%5.2f    Hz\n\nN:   %18d\nStdDev:  %8.2f  Hz",
              b,sigmab,a,sigmaa,iz,rms);
   QString t2{"Solution looks good."};
   if(irc<0) t1="";