[teqc] helpful tip of week 1922

Lou Estey lou at unavco.org
Wed Nov 9 07:31:56 MST 2016

This week's tip: helping me (or someone else on the teqc list) help you

No software is perfect.  If you find what you think is a problem with teqc,
especially with a new release, here are some things to consider when writing
to me or to the teqc list.  Following as many of these as possible, given the
situation, can help a great deal.

o Did you try the last official version of teqc?

The problem might have existed in an earlier version of teqc, but it might now
be corrected.  (Trying the last official version is probably going to be the
second thing I look at when someone says there's a problem.  The first is almost
always immediately trying the current development version that I have here.)

o Did the problem not exist with one or more prior versions of teqc?
If the problem did not exist with prior versions, which versions?

Again, if you say something used to work and no longer does, but you don't
say which versions worked, then the burden is on me to try to figure this

o Specify which teqc build are you are using.  If you are able to try them,
does the problem occur or not with other builds?

If you are a beginner with teqc, the "build" the exact executable you are running,
say, the statically-linked Linux 32-bit build of a specific code version.  You can
find which build you are using by running `teqc +id` and looking at the build line
of the output.  (The build line is also inserted as a header COMMENT line into any
RINEX that is output by teqc so that anyone can see exactly what was used.)

o If many teqc options are being used, try to figure out, if you can, a minimal
set of options that still causes the problem.

o Include exactly what command(s) you are using.  If you are using a teqc config
file (see tip of week 1894 http://postal.unavco.org/pipermail/teqc/2016/002067.html),
include its contents (since this may contain the pertinent option).

o Email RINEX or qc snippets in Courier or another non-proportional font.

RINEX formatting and the qc formatting from teqc is designed so that when these are
examined by humans, the characters should line up in columns, but this requires using
a non-proportional font like Courier.  If you send these in a proportional font
(as most HTML emails use), one sees a mess and I often have to re-email it
to myself to try to make sense of what's there.

o Don't email the teqc list with large attachments, especially large data files.

There's a 40-kilobyte limit on any email to the teqc list so that the inbox of list
members won't needlessly get slammed with an email with a large attachment.  Also,
unless I ask, don't assume I need your data file(s) to duplicate the problem.

o If possible, try to arrive at a minimal data set that shows the problem.

If the problem can be shown with just one or two epochs, there's no point in sending
along a 2-megabyte file.

o Have an informative and specific subject line on any email.

Let's see ... how many emails have I received over the years with the subject line
of  'teqc problem' or 'teqc bug' or just 'teqc'?  And please don't just re-use
the subject line from a past email from the teqc list or from me if the current
topic is entirely different.  Having a pertinent subject line is just plain good
email etiquette.

Some recent examples to the teqc of good subject lines (that involve possible teqc problems
or use issues):

o And, finally, if I find an actual problem (that is, it is not a user error) and I can
find a coding fix, do you want an interim build to test yourself?

And if I send an interim build, please get back to me on how it is working for you.

Happy teqc-ing!


Louis H. Estey, Ph.D.              office:  [+001] 303-381-7456
UNAVCO, 6350 Nautilus Drive           FAX:  [+001] 303-381-7451
Boulder, CO  80301-5554            e-mail:  lou  unavco.org
      WWW:  http://www.unavco.org   http://jules.unavco.org

"If the universe is the answer, what is the question?"
                                                -- Leon Lederman

Past helpful tips:

week 1894: using teqc config files - http://postal.unavco.org/pipermail/teqc/2016/002067.html
week 1895: qc of high-rate data - http://postal.unavco.org/pipermail/teqc/2016/002071.html
week 1896: UNIX/Linux shells for Windows - http://postal.unavco.org/pipermail/teqc/2016/002072.html
week 1897: '-' vs. '+' teqc options - http://postal.unavco.org/pipermail/teqc/2016/002076.html
week 1898: auto-identification of formats - http://postal.unavco.org/pipermail/teqc/2016/002092.html
week 1899: auto-identification vs. format flags - http://postal.unavco.org/pipermail/teqc/2016/002096.html
week 1900: square brackets in options - http://postal.unavco.org/pipermail/teqc/2016/002105.html
week 1901: using option '+mds' - http://postal.unavco.org/pipermail/teqc/2016/002108.html
week 1902: qc results w/ problematic nav messages - http://postal.unavco.org/pipermail/teqc/2016/002113.html
week 1903: '-no_orb[it]' and '-no_pos[ition]' options - http://postal.unavco.org/pipermail/teqc/2016/002115.html
week 1904: '-week' option - http://postal.unavco.org/pipermail/teqc/2016/002117.html
week 1905: using '+bcf' for XYZ/geodetic conversion - http://postal.unavco.org/pipermail/teqc/2016/002126.html
week 1906: the '+v[erify]' option - http://postal.unavco.org/pipermail/teqc/2016/002128.html
week 1907: '+C2', '+L5', "+L6', '+L7', '+L8', and '+all' options - http://postal.unavco.org/pipermail/teqc/2016/002130.html
week 1908: no doppler shortcut; RINEX L2 - http://postal.unavco.org/pipermail/teqc/2016/002131.html
week 1909: using paths w/ file names - http://postal.unavco.org/pipermail/teqc/2016/002132.html
week 1910: the (un)importance of file names - http://postal.unavco.org/pipermail/teqc/2016/002133.html
week 1911: notices, warnings, and errors - http://postal.unavco.org/pipermail/teqc/2016/002134.html
week 1912: the '-max_rx_SVs' option - http://postal.unavco.org/pipermail/teqc/2016/002137.html
week 1913: the end of '++igs' and '+igs' - http://postal.unavco.org/pipermail/teqc/2016/002140.html
week 1914: splicing together RINEX files - http://postal.unavco.org/pipermail/teqc/2016/002144.html
week 1915: using '-O.int' and '-O.dec' - http://postal.unavco.org/pipermail/teqc/2016/002145.html
week 1916: '+doy' option - http://postal.unavco.org/pipermail/teqc/2016/002146.html
week 1917: '-tbin' and '-ast' options - http://postal.unavco.org/pipermail/teqc/2016/002152.html
week 1918: mp12 RMS before/after Oct 2013 - http://postal.unavco.org/pipermail/teqc/2016/002158.html
week 1919: the global windowing options - http://postal.unavco.org/pipermail/teqc/2016/002159.html
week 1920: '-M.dec' and '-N.dec' options - http://postal.unavco.org/pipermail/teqc/2016/002163.html
week 1921: combining time filtering options - http://postal.unavco.org/pipermail/teqc/2016/002176.html

More information about the teqc mailing list