Prototyp und Beschreibung der Funktion gettransresidualrms() (Funktion der freischaltpflichtigen Gruppe "Transformationsparameter") |
gettransresidualrms() Berechnen der "Quadratischen Mittleren Klaffung" (RMS) aus einer Gruppe Kaffungen. Prototyp der DLL-Funktion in C++ Syntax (Kleinschreibung beachten!): extern "C" __declspec(dllimport) unsigned long __stdcall gettransresidualrms( double aResid[][3], unsigned long nCount, double *fResidRms); Prototyp der DLL-Funktion in Visual Objects Syntax: _DLL function gettransresidualrms(; aResid as real8 ptr,; // 4 Byte nCount as dword,; // 4 Byte fResidRms ref real8); // 4 Byte as logic pascal:geodll32.gettransresidualrms // 4 Byte Die Funktion ermittelt aus einem Array mit zuvor berechneten Klaffungen die "Quadratische Mittlere Klaffung" (RMS) Dieser Wert ist ein Qualitätsmerkmal für die Genauigkeit des Helmert- oder Molodensky-Parametersatzes, mit dem die Klaffungen zuvor berechnet worden sind (siehe Funktion gettransresiduals()). Da die Funktion wegen der umfangreichen Berechnungen zeitintensiv ist, kann mit der Funktion seteventloop() die Event-Bearbeitung während der Berechnung durch Unterbrechung der Bearbeitungsschleife zugelassen werden. Die Parameter werden folgendermaßen übergeben bzw. zurückgegeben: aResid[][3] Zuvor ermittelte Klaffungen in einem zweidimensionalen Array des (ref) Typs double mit den jeweiligen X-, Y- und Z-Komponenten in Meter. Der Aufbau des Arrays ist weiter unten beschrieben. nCount Anzahl der verfügbaren Klaffungen im Array aResid. fResidRms Der aus dem Klaffungs-Array errechnete Wert für die"Quadratische (ref) Mittlere Klaffung" (RMS). returnWert Im Fehlerfall gibt die Funktion FALSE zurück, sonst TRUE. Das zweidimensionale Array aResid[][3] ist mit Werten des Typs double gefüllt und folgendermaßen aufgebaut: ---------------------------------------------------------------------- | K1-X | K1-Y | K1-Z | K2-X | K2-Y | K2-Z | ... | Kn-X | Kn-Y | Kn-Z | ---------------------------------------------------------------------- mit K1 -› Kn: Klaffungen 1 bis n X: X-Komponente Y: Y-Komponente Z: Z-Komponente Freischaltung: Die Funktion ist Bestandteil der freischaltpflichtigen Funktionsgruppe "Transformationsparameter". Sie wird zusammen mit den anderen Funktionen der Gruppe durch die Eingabe der bei der Vertriebsfirma erworbenen Freischaltparameter per Aufruf der Funktion setunlockcode() zur uneingeschränkten Nutzung frei geschaltet. Ohne Freischaltung werden maximal 25 Klaffungen verarbeitet. |