Complete redesign of GnssProcessing to make usage a little bit easier…

… and more flexible.

Co-authored-by: Sebastian Strasser <[email protected]>
Co-authored-by: Patrick Dumitraschkewitz <[email protected]>

CHANGELOG.md

@@ -1,10 +1,19 @@
 # main
+
+# Release 2021-09-06
+- Interface change: Complete redesign of GnssProcessing to make usage a little bit easier and more flexible.
+    - Direct use of orbits without integrating variational equations in case of fixed transmitters (e.g., PPP).
+    - New class to add flexible parametrizations to the normal equation system.
+    - New class to select transmitters/receivers for each parametrization.
+    - Unified all transmitter classes into single class and merged all transmitter data and metadata into one folder at https://ftp.tugraz.at/outgoing/ITSG/groops/data/gnss/.
+    - Example scenarios with config files at https://ftp.tugraz.at/outgoing/ITSG/groops/scenario/.
+    - Updated and expanded documentation and cookbooks to reflect all GNSS-related changes.
 - New program:      InstrumentAccelerometer2ThermosphericDensity: Estimate neutral density from accelerometer data.
 - New class:        In Thermosphere: new model nrlmsis2
 - New class:        In Condition: Matrix to evaluate matrix elements.
-- New class:        GnssParametrizationTransmitterQzss: QZSS constellation support in GNSS processing.
 - New class:        In PlotMapProjection: added Mollweide map projection.
 - Bugfix:           FileSatelliteModel: removed if-statement for shaded plates, not necessary when applying the algorithm following Sentman 1961
+- Other:            Expression parser: constants are now defined with brackets, e.g pi().
 - Other:            Additional constants in the mathematical parser like speed of light c().
 
 # Release 2021-02-02

README.md

@@ -93,4 +93,4 @@ Here is a list of current and past contributors:
 
 [Torsten Mayer-Guerr](https://github.com/tmayerguerr), Annette Eicker, Daniel Rieser, Norbert Zehentner,
 Christian Pock, [Matthias Ellmer](https://github.com/x49), Beate Koch, [Andreas Kvas](https://github.com/akvas), Saniya Behzadpour,
-[Sebastian Strasser](https://github.com/sestras), Sandro Krauss, Barbara Suesser-Rechberger
+[Sebastian Strasser](https://github.com/sestras), Sandro Krauss, Barbara Suesser-Rechberger, [Patrick Dumitraschkewitz](https://github.com/zhedumi)

docs/html/GnssAntex2AntennaDefinition.html

@@ -78,16 +78,8 @@ <h1>GnssAntex2AntennaDefinition</h1><p>
 <table class="table table-hover">
 <tr class="table-primary"><th>Name</th><th>Type</th><th>Annotation</th></tr>
 <tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileAntennaDefinitionStation</div></div></td><td>filename</td><td>antenna center variations</td></tr>
-<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileAntennaDefinitionGps</div></div></td><td>filename</td><td>antenna center variations</td></tr>
-<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileAntennaDefinitionGlonass</div></div></td><td>filename</td><td>antenna center variations</td></tr>
-<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileAntennaDefinitionGalileo</div></div></td><td>filename</td><td>antenna center variations</td></tr>
-<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileAntennaDefinitionBeiDou</div></div></td><td>filename</td><td>antenna center variations</td></tr>
-<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileAntennaDefinitionQzss</div></div></td><td>filename</td><td>antenna center variations</td></tr>
-<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileTransmitterInfoGps</div></div></td><td>filename</td><td>PRN is appended to file name</td></tr>
-<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileTransmitterInfoGlonass</div></div></td><td>filename</td><td>PRN is appended to file name</td></tr>
-<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileTransmitterInfoGalileo</div></div></td><td>filename</td><td>PRN is appended to file name</td></tr>
-<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileTransmitterInfoBeiDou</div></div></td><td>filename</td><td>PRN is appended to file name</td></tr>
-<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileTransmitterInfoQzss</div></div></td><td>filename</td><td>PRN is appended to file name</td></tr>
+<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileAntennaDefinitionTransmitter</div></div></td><td>filename</td><td>antenna center variations</td></tr>
+<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileTransmitterInfo</div></div></td><td>filename</td><td>PRN is appended to file name</td></tr>
 <tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileSvnBlockTableGps</div></div></td><td>filename</td><td>SVN to satellite block mapping</td></tr>
 <tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileSvnBlockTableGlonass</div></div></td><td>filename</td><td>SVN to satellite block mapping</td></tr>
 <tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileSvnBlockTableGalileo</div></div></td><td>filename</td><td>SVN to satellite block mapping</td></tr>

docs/html/GnssAttitude2Orbex.html

@@ -71,22 +71,23 @@
         <div id="content" class="container">
             <h1>GnssAttitude2Orbex</h1><p>
 
-Convert attitude of GNSS satellites to <a href="http://acc.igs.org/misc/proposal_orbex_april2019.pdf">ORBEX file format</a> (quaternions).</p><p>ORBEX format contains quaternions for rotation from TRF to satellite body frame.</p><p>See also <a class="groops-program" href="GnssOrbex2StarCamera.html">GnssOrbex2StarCamera</a>.
+Convert attitude of GNSS satellites to <a href="http://acc.igs.org/misc/proposal_orbex_april2019.pdf">ORBEX file format</a> (quaternions).</p><p>If <a class="groops-class" href="earthRotationType.html">earthRotation</a> is provided, the output file contains quaternions for rotation from TRF to satellite
+body frame (IGS/ORBEX convention), otherwise the rotation is from CRF to satellite body frame.</p><p>See also <a class="groops-program" href="GnssOrbex2StarCamera.html">GnssOrbex2StarCamera</a>, <a class="groops-program" href="SimulateStarCameraGnss.html">SimulateStarCameraGnss</a>.
 </p>
 <table class="table table-hover">
 <tr class="table-primary"><th>Name</th><th>Type</th><th>Annotation</th></tr>
 <tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">outputfileOrbex</div></div></td><td>filename</td><td>ORBEX file</td></tr>
-<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset-unbounded">inputfileTransmitterList</div></div></td><td>filename</td><td>ASCII list with transmitter PRNs used in solution</td></tr>
-<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">inputfileVariational</div></div></td><td>filename</td><td>variational file containing attitude and Earth rotation</td></tr>
+<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset-unbounded">inputfileTransmitterList</div></div></td><td>filename</td><td>ASCII list with transmitter PRNs</td></tr>
+<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">inputfileAttitude</div></div></td><td>filename</td><td>instrument file containing attitude</td></tr>
 <tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">variablePrn</div></div></td><td>string</td><td>loop variable for PRNs from transmitter list</td></tr>
 <tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset-unbounded">timeSeries</div></div></td><td><a href="timeSeriesType.html">timeSeries</a></td><td>attitude output epochs</td></tr>
-<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">interpolationDegree</div></div></td><td>uint</td><td>for attitude and Earth rotation interpolation</td></tr>
-<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">description</div></div></td><td>string</td><td>description of file contents</td></tr>
-<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">createdBy</div></div></td><td>string</td><td>name of agency</td></tr>
-<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">inputData</div></div></td><td>string</td><td>description of input data (see ORBEX description)</td></tr>
-<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">contact</div></div></td><td>string</td><td>email address</td></tr>
-<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">referenceFrame</div></div></td><td>string</td><td>reference frame used in file</td></tr>
-<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">orbitType</div></div></td><td>string</td><td>3-char code (FIT, EXT, ...)</td></tr>
+<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">earthRotation</div></div></td><td><a href="earthRotationType.html">earthRotation</a></td><td>rotate data into Earth-fixed frame</td></tr>
+<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">interpolationDegree</div></div></td><td>uint</td><td>for attitude and Earth rotation interpolation</td></tr>
+<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">description</div></div></td><td>string</td><td>description of file contents</td></tr>
+<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">createdBy</div></div></td><td>string</td><td>name of agency</td></tr>
+<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">inputData</div></div></td><td>string</td><td>description of input data (see ORBEX description)</td></tr>
+<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">contact</div></div></td><td>string</td><td>email address</td></tr>
+<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">referenceFrame</div></div></td><td>string</td><td>reference frame used in file</td></tr>
 <tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional-unbounded">comment</div></div></td><td>string</td><td></td></tr>
 </table>
 

docs/html/GnssGlonassFrequencyNumberUpdate.html

@@ -71,15 +71,12 @@
         <div id="content" class="container">
             <h1>GnssGlonassFrequencyNumberUpdate</h1><p>
 
-Update/set GLONASS frequency number in <a class="groops-class" href="fileFormat_gnssStationInfo.html">inputfileTransmitterInfo</a> and
-<a class="groops-class" href="fileFormat_gnssReceiverDefinition.html">inputfileReceiverDefinition</a> files.</p><p>PRN/SVN to frequency number source: <a href="http://semisys.gfz-potsdam.de/semisys/api/?symname=2002&format=json&satellite=GLO" target="_blank">http://semisys.gfz-potsdam.de/semisys/api/?symname=2002&format=json&satellite=GLO</a>.</p><p>See also <a class="groops-program" href="GnssReceiverDefinitionCreate.html">GnssReceiverDefinitionCreate</a> and <a class="groops-program" href="GnssAntex2AntennaDefinition.html">GnssAntex2AntennaDefinition</a>.
+Update/set GLONASS frequency number in <a class="groops-class" href="fileFormat_gnssStationInfo.html">inputfileTransmitterInfo</a> files.</p><p>PRN/SVN to frequency number source: <a href="http://semisys.gfz-potsdam.de/semisys/api/?symname=2002&format=json&satellite=GLO" target="_blank">http://semisys.gfz-potsdam.de/semisys/api/?symname=2002&format=json&satellite=GLO</a>.</p><p>See also <a class="groops-program" href="GnssAntex2AntennaDefinition.html">GnssAntex2AntennaDefinition</a>.
 </p>
 <table class="table table-hover">
 <tr class="table-primary"><th>Name</th><th>Type</th><th>Annotation</th></tr>
 <tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileTransmitterInfo</div></div></td><td>filename</td><td>templated for PRN list (variableNamePrn)</td></tr>
-<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">outputfileReceiverDefinition</div></div></td><td>filename</td><td></td></tr>
-<tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">inputfileTransmitterInfo</div></div></td><td>filename</td><td>templated for PRN list (variableNamePrn)</td></tr>
-<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">inputfileReceiverDefinition</div></div></td><td>filename</td><td></td></tr>
+<tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">inputfileTransmitterInfo</div></div></td><td>filename</td><td>templated for PRN list (variableNamePrn)</td></tr>
 <tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config mustset">inputfilePrn2FrequencyNumber</div></div></td><td>filename</td><td>GROOPS matrix with columns: GLONASS PRN, SVN, mjdStart, mjdEnd, frequencyNumber</td></tr>
 <tr class=""><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional-unbounded">prn</div></div></td><td>string</td><td>PRN (e.g. G01) for transmitter info files</td></tr>
 <tr class="table-light"><td class="m-0"><div class="h-100 config-tree depth-0"><div class="h-100 config optional">variableNamePrn</div></div></td><td>string</td><td>variable name for PRN in transmitter info files</td></tr>