Index: trunk/BNC/Example_Configs/Input/BNC_IGS20.CRD
===================================================================
--- trunk/BNC/Example_Configs/Input/BNC_IGS20.CRD	(revision 10972)
+++ trunk/BNC/Example_Configs/Input/BNC_IGS20.CRD	(revision 11026)
@@ -1,17 +1,69 @@
-# Apriori coordinates with eccentricities, antenna and receiver, Reference System IGS20 (IGS0OPSSNX_20260480000_01D_01D_CRD.SNX)
-# ------------------------------------------------------------------------------------------------------------------------------ 
+################################################################################################
+# Apriori coordinates file #
+################################################################################################
+# including: 
+# - a priori XYZ coordinate, 
+# - optionally, right after the a priori XYZ coordinate:
+#     -- reference epoch as decimalYear with keyword EPOCH:<decimalYear>
+#     -- ITRF velocity in X, Y, Z [m/year] with keyword VEL:<vx>,<vy>,<vz>
+# - eccentricities, 
+# - antenna, and 
+# - receiver
+################################################################################################
+# Reference System: IGS20 (IGS0OPSSNX_1994002_2026185_00U_CRD.SNX)
+#
 # REAL-TIME 
-FFMJ00DEU0  4.05345556487862e+06  6.17730016327370e+05  4.86939592304988e+06    0.0000   0.0000   0.0450 LEIAR25.R3      LEIT JAVAD TRE_3S DELTA
-FFMJ01DEU0  4.05345556487862e+06  6.17730016327370e+05  4.86939592304988e+06    0.0000   0.0000   0.0450 LEIAR25.R3      LEIT LEICA GR50
-REYK00ISL0  2.58738387057569e+06 -1.04303361185251e+06  5.71656422200577e+06    0.0000   0.0000   0.0635 LEIAR25.R4      LEIT LEICA GR50
-WTZR00DEU0  4.07558020555194e+06  9.31854158691225e+05  4.80156833793210e+06    0.0000   0.0000   0.0710 LEIAR25.R3      LEIT LEICA GR50
-PARK00AUS0 -4.55425545428602e+06  2.81665244690025e+06 -3.45405944048519e+06    0.0000   0.0000   0.0250 LEIAR25         NONE SEPT POLARX5TR
+FFMJ01DEU0  4053455.66002983  617729.911377446  4869395.86849437 EPOCH:2020.0 VEL:-0.0148149200700258,0.0173394525889122,0.00993903277554994   0.0000  0.0000  0.0450 LEIAR25.R3      LEIT JAVAD TRE_3S DELTA
+FFMJ00DEU0  4053455.66002983  617729.911377446  4869395.86849437 EPOCH:2020.0 VEL:-0.0148149200700258,0.0173394525889122,0.00993903277554994   0.0000  0.0000  0.0450 LEIAR25.R3      LEIT LEICA GR50
+REYK00ISL0  2587384.00247951 -1043033.56115071  5716564.13589216 EPOCH:2020.0 VEL:-0.0207865982784698,-0.00747886369391668,0.0137890318975325  0.0000  0.0000  0.0635 LEIAR25.R4      LEIT LEICA GR50
+WTZR00DEU0  4075580.31080608  931854.054497059  4801568.28044933 EPOCH:2020.0 VEL:-0.0159339741187387,0.0171837084647012,0.0101792476637174    0.0000  0.0000  0.0710 LEIAR25.R3      LEIT LEICA GR50
+PARK00AUS0 -4554255.23564276  2816652.46115249 -3454059.72019472 EPOCH:2020.0 VEL:-0.0360614781690518,-0.00224882614802764,0.0466110997530548  0.0000  0.0000  0.0250 LEIAR25         NONE SEPT POLARX5TR
+BRUX00BEL0  4027881.37719374  306998.748539549  4919499.01582683 EPOCH:2020.0 VEL:-0.0136005676831508,0.0167589259554315,0.0103501502632278  0.0010  0.0000  0.4689 JAVRINGANT_DM   SCIS SEPT POLARX5TR
 # RINEX
-FFMJ00DEU  4.05345556487862e+06  6.17730016327370e+05  4.86939592304988e+06    0.0000   0.0000   0.0450 LEIAR25.R3      LEIT JAVAD TRE_3S DELTA
-FFMJ01DEU  4.05345556487862e+06  6.17730016327370e+05  4.86939592304988e+06    0.0000   0.0000   0.0450 LEIAR25.R3      LEIT LEICA GR50
-REYK00ISL  2.58738387057569e+06 -1.04303361185251e+06  5.71656422200577e+06    0.0000   0.0000   0.0635 LEIAR25.R4      LEIT LEICA GR50
-WTZR00DEU  4.07558020555194e+06  9.31854158691225e+05  4.80156833793210e+06    0.0000   0.0000   0.0710 LEIAR25.R3      LEIT LEICA GR50
-BRUX00BEL  4.02788144502047e+06  3.06998664677153e+05  4.91949896387484e+06    0.0010   0.0000   0.4689 JAVRINGANT_DM   SCIS SEPT POLARX5TR 
+FFMJ01DEU  4053455.66002983  617729.911377446  4869395.86849437 EPOCH:2020.0 VEL:-0.0148149200700258,0.0173394525889122,0.00993903277554994   0.0000  0.0000  0.0450 LEIAR25.R3      LEIT JAVAD TRE_3S DELTA
+FFMJ00DEU  4053455.66002983  617729.911377446  4869395.86849437 EPOCH:2020.0 VEL:-0.0148149200700258,0.0173394525889122,0.00993903277554994   0.0000  0.0000  0.0450 LEIAR25.R3      LEIT LEICA GR50
+REYK00ISL  2587384.00247951 -1043033.56115071  5716564.13589216 EPOCH:2020.0 VEL:-0.0207865982784698,-0.00747886369391668,0.0137890318975325  0.0000  0.0000  0.0635 LEIAR25.R4      LEIT LEICA GR50
+WTZR00DEU  4075580.31080608  931854.054497059  4801568.28044933 EPOCH:2020.0 VEL:-0.0159339741187387,0.0171837084647012,0.0101792476637174    0.0000  0.0000  0.0710 LEIAR25.R3      LEIT LEICA GR50
+PARK00AUS -4554255.23564276  2816652.46115249 -3454059.72019472 EPOCH:2020.0 VEL:-0.0360614781690518,-0.00224882614802764,0.0466110997530548  0.0000  0.0000  0.0250 LEIAR25         NONE SEPT POLARX5TR
+BRUX00BEL  4027881.37719374  306998.748539549  4919499.01582683 EPOCH:2020.0 VEL:-0.0136005676831508,0.0167589259554315,0.0103501502632278  0.0010  0.0000  0.4689 JAVRINGANT_DM   SCIS SEPT POLARX5TR
 # RINEX2  
 VM01            0.0            0.0            0.0          0.0000     0.0000     0.0000 
  
+
+################################################################################################
+# Howto extract the correct values from a cumulative SINEX file to fill BNCs  coordinates file #
+################################################################################################
+# Two different "epochs" are in play in a cumulative SINEX file
+# 
+# Step 1 — find which SOLN is currently active (SOLUTION/EPOCHS block) 
+#
+# CODE  PT  SOLN  T  DATA_START      DATA_END        MEAN_EPOCH
+# PARK  A    5    P  22:255:00000    26:185:86399    24:220:86399
+#
+# This just tells you the validity window of each solution segment (a new SOLN is assigned whenever there's a discontinuity). 
+# You want the SOLN whose window covers your processing date — or, if it's the highest-numbered SOLN and there's no newer one, 
+# and the equipment/eccentricity logs are still open-ended (00:000:00000) after it, that SOLN is still current today 
+# even though DATA_END looks like it stops a while back. That date is just where this particular SINEX combination's 
+# input data happened to end, not evidence of a new discontinuity.
+#
+# Step 2 — get the reference epoch of the coordinate itself (SOLUTION/ESTIMATE block)
+#
+# 18931 STAX   PARK  A    5 20:001:00000 m    2 -4.55425523564276e+06 1.47304e-04
+# 
+# The column 20:001:00000 here is the EPOCH field of this specific record.
+# It's the epoch the STAX (and STAY/STAZ/VELX/VELY/VELZ) value is stated at. 
+# This is not the SOLN's DATA_START/DATA_END/MEAN_EPOCH from step 1 — it's usually a fixed, round reference epoch 
+# the whole SINEX solution is normalized to.
+# 
+# Here, 20:001:00000 = 2020-day001 = Jan 1, 2020 for every station/SOLN in this file, decimal year 2020.0.
+#
+# Convert to decimal year: YY:DOY:SOD → year + (DOY-1+SOD/86400)/365.25. For 20:001:00000: 2020 + 0/365.25 = 2020.0 exactly.
+# 
+# That 2020.0 is what goes into EPOCH: — it's the epoch the STAX/STAY/STAZ position is valid at, and BNC uses VELX/VELY/VELZ 
+# to propagate that position forward from 2020.0 to whatever epoch your observations are actually processed at.
+#
+# So: 
+# - SOLN (step 1) picks which row of numbers to use; 
+# - The record's own epoch column (step 2) is the value you write into EPOCH:.
+#
+################################################################################################
