Prototype and description of the function gettransresidualaverage()

(Function of the unlock requiring group "Transformation Parameter")

gettransresidualaverage()
Calculation of the "Average Spatial Residual" from a group of residuals.

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" __declspec(dllimport) unsigned long __stdcall
  gettransresidualaverage(
     double aResid[][3],
     unsigned long nCount,
     double *fResidAv);

Prototype of the DLL function in Visual Objects syntax:
_DLL FUNCTION gettransresidualaverage(;
     aResid as real8 ptr,;                       // 4 Byte
     nCount as dword,;                           // 4 Byte
     fResidAv ref real8);                        // 4 Byte
AS logic pascal:geodll32.gettransresidualaverage // 4 Byte


The function calculates the "Average Spatial Residual" from an array with
previously determined residuals. This value is a quality criterion for the
accuracy of the Helmert or Molodensky parameter set, which has been used
previously to calculate the residuals (see function gettransresiduals()).

Since the function due to the extensive calculations is time-consuming,
the event handling during the calculation by interrupting the processing loop
can be are allowed bei calling the function seteventloop().


The parameters are passed and/or returned as follows:
aResid[][3] Previously calculated residuals with their X, Y and Z components in
(ref)       meter, stored in a two dimensional array of type double. The
            structure of the array is described further below.

nCount      Count of the available residuals in the array aResid.

fResidAv   From the residuals array calculated value for the "Average Spatial
(ref)       Residual".

returnVal   In case of an error the function returns FALSE, otherwise TRUE.


The two dimensional array aResid[][3] is filled with values of type double and
is structured as follows:
----------------------------------------------------------------------
| R1-X | R1-Y | R1-Z | R2-X | R2-Y | R2-Z | ... | Rn-X | Rn-Y | Rn-Z |
----------------------------------------------------------------------
with R1 -› Rn: Residuals 1 to n
X:             X component
Y:             Y component
Z:             Z component


Unlocking:
This function is a component of the unlock requiring function group
"Transformation parameter". It is unlocked for unrestricted use together
with other functions of the group by passing the unlock parameters, acquired
from the software distribution company, trough the function setunlockcode().
Without unlocking at most 25 residuals can be processed.