From 7dfc11b786e81a1b3f803ed40a54ec26acbf620a Mon Sep 17 00:00:00 2001 From: Joe Taylor Date: Thu, 28 Sep 2017 19:51:04 +0000 Subject: [PATCH] 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 | 4 ++++ doc/user_guide/en/images/FreqCal_Results.png | Bin 0 -> 7230 bytes doc/user_guide/en/measurement_tools.adoc | 12 ++++++++++++ mainwindow.cpp | 2 +- 4 files changed, 17 insertions(+), 1 deletion(-) create mode 100644 doc/user_guide/en/images/FreqCal_Results.png diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index 8ba6b20a9..48922b208 100644 --- a/doc/CMakeLists.txt +++ b/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 diff --git a/doc/user_guide/en/images/FreqCal_Results.png b/doc/user_guide/en/images/FreqCal_Results.png new file mode 100644 index 0000000000000000000000000000000000000000..d1e93f5c8c2d66064e2436556dcbfc9adf893c19 GIT binary patch literal 7230 zcmb7JWl$VUlU{^`R;Iilf z!H@U5KVQ{do&1=YnyQ}Z9_j9So{rMiR3gNq#RC8UgeuDNI*;S_V{5~C^4OCi7;YX1 zG&db3SwQvpv)#uDhOLZ-3;<9UkAG{0`8db@tZd{401);4)6fQ;%WMDux)~LD8Q>Rl zWRABfg+bHc-8T62ZEl8u^T(Buk)I``)EHvw+Rs>)zq*H%mC3k7Jr!Gu#LtX%!Bu=m zPEPriL*U~dQGtR$&KT+BeoP8&7c?XJA31*og#`YPvEFH(^YJ%VK(jv4PA+~sD*e%x z?R$8!zt{|IgD%d_&MvikpIx8t!{Kl}Jw1bJ)AGv7cE2lE1qB6fZ|{sCozVPl)p?eg z5)D>O5(R#^T!FlQo}4zT9oY}>^F6&uhb#jF(_VDqP9hnY55^ickgu1q%s5m^8-^2* zu8aI?Lfi>m5!f1-M}tGfYKWhDfJVa^#muX#Dl00;`A9a5@+uJ)0pLuM2W@ew?H5X5 zQ&InU`!)VwWmWXl;QfSRq;JL1>ci0@wiZKV3C{E$XBib+o7Flv{+kx!1!5L?2VTi6 zeT#k`K=>DKVzwmaQX% z0P*cdi@nsRQ|G@c{e{LavXl1e-5lCt4lNib$naklg*W4BQTBx!KBVIbOebKYkvi}g zi*C&JCD$lz>Gcedg$}0=(3VB+zR>4o5z*!?mY-St&<*)Br{9C1doxVb^{!N2jd|gz zNh=##J0%rWG%1#HD6hc#C*=+mPzHN+25;1yFXr8dh)2P?$R)#&&~-rD+&1HWYqCRo zlar3d_rp5(ioTV1;AXy7L*IA2ia~MHhjfbJ^v{`j+2%}uKYm0qdrG6J09EDK3v?X? z8hIs_cGx-OwiXL?&V{GL25O7G!}Nsbh1e;@*-xB63RLe54gWH}xO;v}xsF9azNxI& zb`^7DCi(5+WXdsoN0N-H{rb2o$KOTYmUrgh;mc(8QADMLkW;WZ{cVxsZ0f^nxb;;I z<$D1mSWqAZXk_*RJx(NvKz zF-a_@pmhY2iG%=Qg@Y?z`}vm_GdJ;VtD74pNQO?ty}uIjB>vizVJr83_ea@Hegg`v z5M|!y+~p&`A24IVI|qox-DSp|T(d+!6{z(|$2hv%EPR1YK*Pg2*r=jf6rN=lw4fsk z+Q<8r`NY2a=rp#z7HpKSdS&eYjB( z^!%jC<8t=q?>_b|GI=J4KaQB*ltH}h?cUO^jKTTT<%*FTXvq{jx#+_P%9**;ZClyl zrLrz#1h^n}14e6s35g#E%5nQ_PP7H}=wPyBLQjnChFdap64ORp5k#*a@MlVs;qw8%aYET|^|no06^--z(;b zfY-0zx?{kb0`@jMz<(=|DGdet17lU>!2Oz|S_iY{_b=+6;?o3OyD*(;-9!9Ht@3uY zGw3-&ify_vFKcNU>|X9?Jwapj&E!XS5KgoPs!qQw)SUCm?->ZRXtoezWHaPP8>@%;0J?gE6xnwVluUI-;Ol24?u!Z{B|1IXB`Cu+O6H-m7Eos(hCF|i7UF50K_?pWpmA<#t z(Ja_{xi{&51xLj&3wP_Ebyzmk_O;TmX>~5K|vmDSAha!w1Qbd6)TP?q>A> zKdPDX{rUoAuyms(^{^KI;B;f*b^kZ5;Ls5g_g3HBHqlli>;!9&;hi=gpm+H^9ub6y zFl&=S&gmYNT-PmEmj|@pZA-0QyLCCYn+A8^iLqG+YN`&6Zdm#D#V4b@{lps~_{;hZi7Llyp_>%|;nL#ft?|2?PVIgs8< z!&z>F{wD!D2Ke0U?8fHSz~MrJ|8gsP4E02YBpnfsGzA$mK7qV0Mjefbo{7GGlbEQd z5pZ@qN4%k-VPs?^;Ci?8ITjP(-Q(@N1PHyPieZi<6gGo-9j$1ntDAQDgZ1^PLPth; z;%w;SmvdV_7|bDR8s4sCH#x{HU5~Y09%%6Lw_spdVhw0x^cKWW&JCbi zkCdF2ho_piHhQ0Jp&Eq^wa+xSN@{jts~ds6r-#*&q_{Kx zt_|%nGDKg0G4WC4cq&KAiPNv3B#JHwzS>L+%lf<6m?7@PuLSMzI{Kzrnj}U!os*NJ z65nXdS2X#y6E&@tk&!`0m&wV@!GVP(AIm9|(+FC;K)@W|J4l|ID%`}z66BMH_dMsS zlGX+K9xk;I3J6g1o0he^va?nk?}t2?*6wb_!kYV}+Jx*i#{Q->EAh4nY=rEQ##G3r z>BkxSak)<|OyRrr-KW+ctXI{t$;ogMY07&wt?lipK6gFc7;1k^*O)@fRVHHIx-!@% z&7Z=$*9YU#(b1Xl0#q28)uW|tmzS3}b*$}yFx^s3cFG`jZ|~ZlZkt?_3<~|t!ul0d zsVbAE9v&Y4GClWTY4O+Qx!#(l|X~0*s zSX?#jr_q0=;Rll?(JnOdnJFnLKv-iW68b^%rwPkMhxb{@(pwf5S(nOgX+gx6t|$mm zG-apUy3@-$S5DPbbbL<~!>;VP-BZ7?U!!RZ2Hy^guNOGSo4MGIo|>?xnriWo1k|kE z*IbuZR5ZG&K4FdVaGSX5@>Qfx6hkdH*0uzH?!o zR+1#Ji9u%g;@9*Y*oh!XDMTNZq`;b7@86pnjp>iOLc4}{*W-$TSo z1H#Et4dUFT#-LdB+b}FOew7ydmCK2s3CZ)t3#4c0exAN5Ht6Rr>7Ma9)==l}B6`0| zKx!Wa9-u!eS7>e7zGI0N7Q)k;(Xub0C(Qo#jH)ibvhtZ}klfU)XkOpT&+<7;VYjz_ z+&IcEuCBo{`CKn|YHQ}3Ky>15K$a>jduWCV3oAK{rX5CHs z%Bgz9%7!!Q4Ii*7%z9SVP*5fB*XBr?u2B8V2N7@#E0r0;iOl9PF+VZuVDCr|K9Bp^a7iVvl-cb%oK6a~Wb|7| zV9(?1gNtrU#Y+NK9($VbV7}EZp{XR+C+$9Or z;YBngDY2q$amqSn0w%)}snDj9l8;6}3MV!_A@qV73xX5wayS4Tr!$Wk?Eq9|#F-1R1${*pEgDRLNrw!YrG z?f-rOkfrPiOqhNH4U2ky{)7p$EN%SF0+J+B)lPh& zK@s8leg@;Wo{VV8LEz-af4tac<_TA$6-JYH$pE8{u_?^ErA6H9ke91PIN*GZ^eC5J zxa-wRGR+2lnm9~gFzA~Twocw>8{uJa&6g5>(1p4)|UrECvLWmV0u1pRdCbzFX>3yMB{@#^`?CU?@IRU-Bzyv={m?J|o(D zg)IjlqVAGB3|bw{rY8K<(_%;%Y#3M!HLL$3kbOE~QSW`6ZM{c>**T+iqe)H-M>U|A zWFNlfCZAm}ZG&|JIin#wspPF`mE0NWgSUQkDg>n3Mxfx(|%!+dYD~9 z$zc;cE9>-8&<52UJ)6ZP>O2`G#g0hwakhP+-}~MFn<_g7&J>AhSc*8l%EHzh*^}B0 zy%hIeAwRp;l31_?mNWze7jld*yy%gkKcY==Kiw!#F1kB8aWSYMfFe59@o3$e0~ z;;IG0Y$9IncX(uS?cQ-bJI52B@{+9{jO=4Fn&f$=>5q%_BY%Tgvaywe$R%lWUVU3X zci;KzG7gF!*ZG+Z($`}^QrGZiT%*l;vMfyWkYtn?j~bd{f&C$IJGg0Q6RexA^Qbb& zMxzR+Uxtvaq2V%F1QcSn%pw zaE+moUUZ>zebU-zltyshkXT*En-x~eo7u<@qTjww$uI{^PHNY`?B1EFhytiHKdm*8 zESJon^h67(ceNf$liC>1^2|?5VX`L^?}={F&=EuFd94)ykVM8i6x;i?}OJ#?JCg&06 zCz^Z0wyScQP&v(GgI78^;3V@iwa;fa4l`+sPVJ`(gE&v}gan^$%uqv=T{m?hxw%@% zD2!cgZd$d@TeOzh*8&Y@FsJmqbbPeyCrQfWnKI^1ywP{{Mf}H#JWqI&GusJm_?7u{ zXvsjdsnArv;m>Qm{me;CodR!mVKPzt2zlxUdD~aFWHR-dndnGA;_rJzJ)IXn*W`?h z7Q8+!3zvCzHC)%maQ7KWOy}s?^FwE=?@zuVv_KEZL8=jt5SCpIw;nxg2ua9ayv{EW zPU9isXQiMs%x%fXHf}qfZJz>RYbj!XpPfGin}f9Gg$QHzLgM2zm>JbQv$Hk}mDKdq zq^7`LJuIQy%X=!+uHo*V|R~&A}U| z+Y17E3eVbk`Fh#zFCMi?@C=pt1 z6TdR^UfQn@c(p~={fgyUi*>RvR918YwfrT)b(33n=Y?_oB*$wu7H2elzW+>(+HbO&g@DG(9z$Qhn4_2 z;wX1T8P9{}1ZC1pe4*!JCGYCX*^3RgHT3zs6KlWq(4|Da=U)W&g!LPmPxRW zfX_AR*Q&oS9u!H}SOTh%tM+f97ip=^B+n5ZY`wO!VXayPB9%xu)9JpdcWD*wX%_D&><@F1ER3bjVAT{Rkn>3<}!GH5>@&lN46W(cG zooRiDHrR^&?BrSUlG5c^TVk%hY3EYAS1RiZCXIJ|fDyL#uB6g0&t9dIQFT^2PYy63 z%$7ZH8Cq?K&3wF;i6x&*`(T!!CJ)c>Zr{uP9iDCMvs^mRI*~S)&MY$qG!=d3hjrdZ zscetuJlw{B)<{Pp;^I#6&Cv!Yr$$O9%+LD`#Q9BmvCv`ybL zz4JXpXuV%VOCs;es4R0o{3v%A62W+~lhRJX9Ba^N_}zf-^vSX(?m-yGrVWKVY@XqY?__fStQkS6$bQh-IG zrYJ5Clq&S+xa5MnPMzqQ?H>yJdWW9**$E+)SoXWkOCh9U9Xb375YPRTtpUfXpFWr^ z5#T)B)6>)6-;Y}Qsc2YSPng6sB*C(RRTuV{^|MIH8>CO$o0Gio&C&Yrn` z0kbDD2OXfsG0It%`U%U>H{JQ7=xcO%3b2sYf#UQukb5WPg$m^c?GrTAm?GL${|jzi zQAB%JBFe9~!y%EH!VRPbJqUA?^P{v0fQt0uSh8cMQNlN+_t~HDqY8Qv5klwe2 z?7Y0O8{DacgoNxL55VngYUZIfLpgyT6cw>r`XMU=oZiD&e98^99@U1!zem44ekX|S zL~V0a5?y7K-3F9B(-M8-P+!G}1VbfJVz?hjs!RBDWQ4VOT{d|oO+4VmfQMB~ywq2^0x$&1j>>?UH-1n}=J9C~z0W9=!-K z3uwdCJ-c?&!{-`Fdl5mMl3x~R+IC?4smiVCADN{J{nG=QelKrjY|QRwRQ}!`(wZ53;7MlxQ5)u|iC?atz)M*slP?NHt(;G_;&UHV6!N{5dLr-8x63Z%`a{bG~qUsBl)xy=8K?M&oO zY5(P@|6dv}659V*REiUQ%rD~LYgD;zsjHh?JfoC9YG+C%iGz}YB0D<%Uvuc)|KK}o4} zPVQ4gL1Z~rH$m)RJR@s{$=WK=hD#caAyHlAi>hF_Pa zdoFTLzNm}f>pNU->(6+JPtf*M5Nr0!pC7mhn?p&@WpeXWNF3h1o9d6Deqf9n_;PUf TOFiqc<_Azw(3G#1wG93b?zRz7 literal 0 HcmV?d00001 diff --git a/doc/user_guide/en/measurement_tools.adoc b/doc/user_guide/en/measurement_tools.adoc index 756724b29..1dc367c7d 100644 --- a/doc/user_guide/en/measurement_tools.adoc +++ b/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 diff --git a/mainwindow.cpp b/mainwindow.cpp index bc4b71384..e1490fed0 100644 --- a/mainwindow.cpp +++ b/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="";