Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- user-interface:import [2018/05/21 14:49] – [ASCII-Daten] Michael Lösler
+++ user-interface:import [2022/09/29 23:21] (aktuell) – Grenzwert formatiert Michael Lösler
@@ Zeile 1: / Zeile 1: @@
 ====== Datenimport ======
-Der Datenaustausch zwischen dem Instrument und der Ausgleichungssoftware JAG3D kann auf verschiedenen Wegen erfolgen. Ziel des Datenimports ist es, die für die Ausgleichungsrechnung notwendigen Eingangsdaten in der projektspezifischen SQL-Datenbank zu hinterlegen. Technisch gesehen kann daher ein Import von Daten direkt über [[#import_via_sql|SQL-Standardbefehle]] erfolgen. Diese Variante empfiehlt sich, wenn JAG3D als Modul in einer automatisierten Monitoring-Software betreiben wird und keine Administration über die graphische Benutzeroberfläche erfolgt.
+Der Datenaustausch zwischen dem Instrument und der Ausgleichungssoftware JAG3D kann auf verschiedenen Wegen erfolgen. Ziel des Datenimports ist es, die für die Ausgleichungsrechnung notwendigen Eingangsdaten in der projektspezifischen SQL-Datenbank zu hinterlegen. Technisch gesehen kann daher ein Import von Daten direkt über [[#import_via_sql|SQL-Standardbefehle]] erfolgen. Diese Variante empfiehlt sich, wenn JAG3D als Modul in einer automatisierten Monitoring-Software betrieben wird und keine Administration über die graphische Benutzeroberfläche erfolgt.
 Neben dem direkten Import von Daten via SQL-Statements bietet JAG3D zahlreiche Möglichkeiten zum Importieren von Daten über die graphische Benutzeroberfläche an, die sich hinter dem [[user-interface:menu|Hauptmenüpunkt]] ''Import'' befinden. Neben proprietären Formaten von verschiedenen Herstellern unterstützt JAG3D ein flaches, intuitives [[#ascii-daten|ASCII-Format]] zum schnellen und direkten Datenaustausch. Für strukturierte Datenformate steht darüber hinaus auch ein Import für frei-definierbare, [[#spaltenbasierte_daten|spaltenbasierte Daten]] zur Verfügung.
@@ Zeile 7: / Zeile 7: @@
 ===== ASCII-Daten =====
-Seit der Version 2 unterstützt JAG3D ein rudimentär aufgebautes, spaltenbasiertes Textformat, welches als Trennzeichen mindestens ein Leerzeichen und/oder Tabulator (Whitspaces) voraussetzt. Die Anzahl der Whitspaces kann zwischen den Spalten //und// Zeilen variieren. Das Format setzt sich aus zwingend notwendigen Spalten und optionalen Spalten mit Zusatzinformationen zusammen. Kommentare in der Datei sollten mit einem Doppelkreuz (''#'') am Zeilenanfang eingeleitet werden. Für die nachfolgende Formatbeschreibung werden spitze Klammern (''<'' und ''>'') für eine Spaltendefinition verwendet. Eckige Klammern (''['' und '']'') werden eingesetzt, wenn es sich um optionale Werte handelt. Die Defaultwerte bei optionalen Spalten werden jeweils numerisch am Ende angegeben. Die numerischen Größen müssen ferner in der Einheit vorliegen, die auch im Ausgleichungsprojekt eingestellt ist ggf. ist vor dem Import die Einheit umzuschalten.
+Seit der Version 2 unterstützt JAG3D ein rudimentär aufgebautes, spaltenbasiertes Textformat, welches als Trennzeichen mindestens ein Leerzeichen und/oder Tabulator (Whitspaces) voraussetzt. Die Anzahl der Whitespaces kann zwischen den Spalten //und// Zeilen variieren. Das Format setzt sich aus zwingend notwendigen Spalten und optionalen Spalten mit Zusatzinformationen zusammen. Kommentare in der Datei sollten mit einem Doppelkreuz (''#'') am Zeilenanfang eingeleitet werden. Für die nachfolgende Formatbeschreibung werden spitze Klammern (''<'' und ''>'') für eine Spaltendefinition verwendet. Eckige Klammern (''['' und '']'') werden eingesetzt, wenn es sich um optionale Werte handelt. Die Defaultwerte bei optionalen Spalten werden jeweils numerisch am Ende angegeben. Die numerischen Größen müssen ferner in der Einheit vorliegen, die auch im Ausgleichungsprojekt eingestellt ist ggf. ist vor dem Import die Einheit umzuschalten.
 ==== Terrestrische Beobachtungen ====
@@ Zeile 13: / Zeile 13: @@
 Eine terrestrische Beobachtung ist definiert zwischen einem Standpunkt und einem Endpunkt und benötigt einen Messwert. Optionale Zusatzwerte sind die Instrumenten- und Reflektorhöhe sowie die a-priori Standardunsicherheit und die Entfernung, die zur Bildung der kombinierten Messunsicherheit heranzuziehen ist. Die Unterscheidung zwischen a-priori Standardunsicherheit und Entfernung erfolgt über die numerische Größe des Wertes. Ist der eingelesene Wert $\lt 1$, so wird dieser als Unsicherheit betrachtet ansonsten als Entfernung.
-<code><start point name> <end point name> [<instrument height|0> <reflector height|0>] <observation value> [<uncertainty|length approximation|0>]</code>
+<code><start point name> <end point name> [<instrument height|0> <reflector height|0>] <observation value> [<uncertainty|length approximation>]</code>
 //Beispiel 1:// Minimale Konfiguration einer Beobachtungsdatei
@@ Zeile 47: / Zeile 47: @@
 MS	 P31	1.6	1.5	 4.35	0.05</code>
+//Hinweis:// Die letzte Spalte ist optional und kann wahlweise die a-priori Messunsicherheit der Beobachtung enthalten oder den Abstand $d$ zwischen Stand- und Zielpunkt. Beim Datenimport wird die Größe des eingelesenen Wertes geprüft. Ist diese kleiner als 1 m, so wird der gelesene Wert als a-priori Messunsicherheit der Beobachtung interpretiert, ansonsten als Abstand $d$, welcher bei der Bildung des gruppenbasierten [[least-squares-adjustment:observation#terrestrische_beobachtungen|stochastischen Modells]] herangezogen wird. Werte, die kleiner oder gleich Null sind, werden ignoriert.
 ==== Punkte und Koordinaten ====
-Eine Punkt benötigt zwingend eine //eindeutige// Bezeichnung, den Punktnamen bzw. die Punktnummer, und entsprechend der Dimension des Punktes bis zu drei numerische Werte für die einzelnen Koordinatenkomponenten. Zusätzlich bzw. optional können für die Dimensionen a-priori Standardunsicherheiten angegeben werden. Im Folgenden wird das Format für den räumlichen 3D-Punkt explizit angeben. Die Formate für Höhen- und Lagepunkte ergeben sich durch entsprechende Vereinfachungen, sodass diese hier nicht angegeben werden. Die optionalen a-priori Unsicherheiten können komponentenweise aber auch für mehrere Koordinatenkomponenten spezifiziert werden.
+Ein Punkt benötigt zwingend eine //eindeutige// Bezeichnung, den Punktnamen bzw. die Punktnummer, und entsprechend der Dimension des Punktes bis zu drei numerische Werte für die einzelnen Koordinatenkomponenten. Zusätzlich bzw. optional können für die Dimensionen a-priori Standardunsicherheiten angegeben werden. Im Folgenden wird das Format für den räumlichen 3D-Punkt explizit angeben. Die Formate für Höhen- und Lagepunkte ergeben sich durch entsprechende Vereinfachungen, sodass diese hier nicht angegeben werden. Die optionalen a-priori Unsicherheiten können komponentenweise aber auch für mehrere Koordinatenkomponenten spezifiziert werden.
 <code><point name> <east> <north> <height> [[[<uncertainty east/north/height|uncertainty east/north|uncertainty east>] <uncertainty north|uncertainty height>] <uncertainty height>]</code>