ITGIS_StatisticsResult interface

DK11 for ActiveX | TatukGIS_XDK11.ITGIS_StatisticsResult | Interfaces | Methods | Properties

Container for statistics results.

Available also on: Delphi | .NET | Java | ActiveX.

// C#
public interface ITGIS_StatisticsResult: ITBaseObject
{
}

' VisualBasic
Public Interface ITGIS_StatisticsResult
  Implements ITBaseObject
End Class

// Oxygene
type
  ITGIS_StatisticsResult = public interface( ITBaseObject )
  end;

ITBaseObject

This class is strongly linked with TGIS_StatisticsAbstract class but it can be also used independently for creating statistics from custom dataset (not layers).

Statistics are calculated for all data types, like numbers, booleans, dates and strings whereby:

• Boolean value True is converted to 1 and False to 0.
• Strings are used directly for functions: Majority, Minority, Variety and Unique. The rest of functions take string length into account.

Use IgnoreValue property to omit specific value in statistics calculations. For pixel layers NoDataValue is used.

The example below shows how quickly calculate statistics from list of values.

Pseudocode:

// create an instance of TGIS_StatisticsResult
stats_result = TGIS_StatisticsResult.Create(
  TGIS_FieldType.Float,                       // type of dataset
  'my_stats',                                 // name for result
  TGIS_StatisticalFunctions.BasicStatistics,  // use predefined set with basic statistical functions 
  0                                           // ignore value
);
  
// collect data (send values to statistics engine) 
for value in data
  stats_result.Update(value);

// finalize (calculate statistics & fill properties)
stats_result.Complete ;

//check values
if stats_result.Count.Calculated
  count = stats_result.Count.Value;