Changeset 11102 in ntrip

Timestamp:

Oct 21, 2026, 1:56:26 AM (10 hours ago)

Author:

stuerze

Message:

minor changes

Location:

trunk/BNC

Files:

• CHANGELOG.md (modified) (1 diff)
• src/bncantex.cpp (modified) (3 diffs)
• src/bncantex.h (modified) (1 diff)
• src/bnchelp.html (modified) (3 diffs)

trunk/BNC/CHANGELOG.md

@@ -14 +14 @@
 - CHANGED: Combination: an AC excluded from the clock datum because of inconsistent code biases is used again only after 12 passing checks in a row (1 hour), not after the first one (a borderline AC changed the clock datum every 5 minutes)
 - ADDED: Combination of APC (SSRA) and CoM (SSRC) streams together: with an ANTEX file the combination is done in the CoM frame, the orbits of the APC streams are converted to CoM; ACs not combined because of a different reference point are reported
-- ADDED: Option 'Reference Signals' (key ssrRefSignals): reference signals of the satellite clocks per GNSS for the combination (AC clock referral, code biases from the Bias SINEX file) and the SSR QC, default IGS Real-Time convention G:1W&2W R:1P&2P E:1C&5Q C:2I&6I J:1C&2L S:1C&5Q, e.g. for a switch of BDS to C1P/C5P or of QZSS to L1/L5
+- ADDED: Option 'Reference Signals' (key ssrRefSignals): reference signals of the satellite clocks per GNSS for the combination (AC clock referral, code biases from the Bias SINEX file) and the SSR QC, default IGS Real-Time convention G:1W&2W R:1P&2P E:1C&5Q C:2I&6I J:1C&2L S:1C&5Q, e.g. for a switch of BDS to C1X/C5X or of QZSS to L1/L5
 - ADDED: Detection and conversion of outdated or erroneous IGS-SSR epoch time encodings (GLONASS as UTC seconds of day or of week, BDS as BDT) with an hourly warning, and a plausibility check of the orbit/clock epochs of all systems of a stream
 - ADDED: ANTEX file name, number of entries and latest satellite entry are logged; satellites without a valid ANTEX entry are reported (and not combined)

trunk/BNC/src/bncantex.cpp

@@ -523 +523 @@
 // simple sz×xSun formula.
 ////////////////////////////////////////////////////////////////////////////
+// GPS block types with a yaw model in gpsYawAngle() (ANTEX "BLOCK ..." names);
+// other blocks (e.g. a future IIIF) use the nominal Sun-pointing yaw
+////////////////////////////////////////////////////////////////////////////
+bool bncAntex::gpsYawModelKnown(const QString& blockType) {
+  return blockType == "IIA" || blockType.startsWith("IIR") ||
+         blockType == "IIF" || blockType == "IIIA";
+}
+
 double bncAntex::gpsYawAngle(const QString& prn, const QString& blockType,
                               double Mjd,
@@ -531 +539 @@
   // Max yaw rate [rad/s] by GPS block type
   double psiDotMax;
-  if      (blockType == "IIA")   psiDotMax = 0.12 * M_PI / 180.0;
-  else if (blockType == "IIR")   psiDotMax = 0.20 * M_PI / 180.0;
-  else if (blockType == "IIR-M") psiDotMax = 0.20 * M_PI / 180.0;
-  else if (blockType == "IIF")   psiDotMax = 0.11 * M_PI / 180.0;
-  else if (blockType == "IIIA")  psiDotMax = 0.15 * M_PI / 180.0;
-  else return 0.0; // unknown block: caller uses simple Sun-pointing
+  if      (blockType == "IIA")         psiDotMax = 0.12 * M_PI / 180.0;
+  else if (blockType.startsWith("IIR")) psiDotMax = 0.20 * M_PI / 180.0; // IIR-A, IIR-B, IIR-M
+  else if (blockType == "IIF")         psiDotMax = 0.11 * M_PI / 180.0;
+  else if (blockType == "IIIA")        psiDotMax = 0.15 * M_PI / 180.0;
+  else return 0.0; // unknown block: not called, see gpsYawModelKnown()
 
   const double MAX_CALL_GAP = 1800.0 / 86400.0; // 30 min in days
@@ -844 +851 @@
       }
       else if (mode == ATT_COMPUTED && prn[0] == 'G' && vSat.size() == 3
-               && !map->blockType.isEmpty()) {
+               && gpsYawModelKnown(map->blockType)) {
         psiEff = gpsYawAngle(yawKey, map->blockType, Mjd, xSat, vSat, xSun);
         useVelocityFrame = true;

trunk/BNC/src/bncantex.h

@@ -145 +145 @@
                           const ColumnVector& vSat, const ColumnVector& xSun);
 
+  static bool gpsYawModelKnown(const QString& blockType);
   double gpsYawAngle(const QString& prn, const QString& blockType, double Mjd,
                      const ColumnVector& xSat, const ColumnVector& vSat,

trunk/BNC/src/bnchelp.html

@@ -5028 +5028 @@
     Antenna IOD is GNSS-specific, so the same Metadata entries serve as the trust anchor for every GNSS. In
     addition, since a Satellite Antenna IOD is only guaranteed unique within a rolling 64-day period, BNC discards
-    any Satellite Antenna correction that is 64 days or older, even if its IOD would otherwise still match, and
-    falls back to using ANTEX-based satellite antenna corrections instead.
+    any Satellite Antenna correction that is 64 days or older, even if its IOD would otherwise still match. If the
+    referenced Satellite Antenna information is not available or not trusted for a satellite, the satellite is
+    excluded. ANTEX is never used for the satellite antenna with new RTCM-SSR: without a Metadata reference, no
+    satellite antenna correction is applied at all, because orbits, clocks and biases refer to the provider's point
+    on the nadir axis and form a consistent set. The receiver antenna is corrected with ANTEX as usual.
   </p>
   <p>
@@ -8530 +8533 @@
   <p>
     Specify the reference signals of the satellite clocks per GNSS as '&lt;system&gt;:&lt;band&gt;&lt;attribute&gt;&amp;&lt;band&gt;&lt;attribute&gt;',
-    separated by blanks, e.g. 'C:1P&amp;5P J:1C&amp;5Q'. The clocks refer to the ionosphere-free linear combination of
+    separated by blanks, e.g. 'C:1X&amp;5X J:1C&amp;5Q'. The clocks refer to the ionosphere-free linear combination of
     the code signals of these two signals. Systems not specified keep the default of the IGS Real-Time Committee:
   </p>
@@ -8553 +8556 @@
   <p>
     Changing the reference signals is meant for a coordinated switch of the IGS Real-Time convention, e.g. for BDS from
-    C2I/C6I to C1P/C5P (B1C/B2a) following the IGS products, or for QZSS to an L1/L5 pair because the QZSS Block III
+    C2I/C6I to C1X/C5X (B1C/B2a data+pilot) following the IGS products - note that IGS-SSR cannot carry the BDS signals 1X/5X (signal IDs reserved), so that ACs would have to provide them in RTCM-SSR -, or for QZSS to an L1/L5 pair because the QZSS Block III
     satellites no longer transmit L2. All ACs of a combination should then provide the code biases of the new reference
     signals. A switch changes the combined clocks of the affected satellites by the ionosphere-free combination of the