User Tools

Site Tools


api:dk11:activex:tatukgis_xdk11.itgis_classificationvector

ITGIS_ClassificationVector interface

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

Class that enables performing advanced vector data classification in the process of creating choropleth (thematic) maps.

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

Syntax

// C#
public interface ITGIS_ClassificationVector: ITGIS_ClassificationAbstract
{
}
' VisualBasic
Public Interface ITGIS_ClassificationVector
  Implements ITGIS_ClassificationAbstract
End Class
// Oxygene
type
  ITGIS_ClassificationVector = public interface( ITGIS_ClassificationAbstract )
  end;

Implements

Methods

Inherited Overrides Protected
Name Visibility Description
AddClassBreak public Adds a new class break.
(Inherited from ITGIS_ClassificationAbstract)
AttachDelphiObj public Only for internal use of TatukGIS.
(Inherited from ITBaseObject)
Classify public Performs the classification.
(Inherited from ITGIS_ClassificationAbstract)
Classify_2 public Performs the classification and applies to defined ParamsList.
(Inherited from ITGIS_ClassificationAbstract)
Create_ public
DelphiObj public Only for internal use of TatukGIS.
(Inherited from ITBaseObject)
EstimateNumClasses public Performs the pre-classification and sets NumClasses property.
(Inherited from ITGIS_ClassificationAbstract)
MustCalculateStatistics public If True, statistics from layer assigned to classification need to be calculated.
(Inherited from ITGIS_ClassificationAbstract)

Properties

Inherited Protected
Name Visibility Description
ClassBreaks public Computed class breaks.
(Inherited from ITGIS_ClassificationAbstract)
ClassIdField public If not empty, the attribute field of the specified name will be populated with the class id values.
ColorRamp public The color ramp that is used to assign colors for class breaks; none by default If not provided, StartColor and EndColor will be used.
(Inherited from ITGIS_ClassificationAbstract)
ColorRampName public The name of the built-in color ramp that is used to assign colors for class breaks; empty by default.
(Inherited from ITGIS_ClassificationAbstract)
EndColor public Ending color used to generate ramp for class breaks; Black by default.
(Inherited from ITGIS_ClassificationAbstract)
EndSize public Ending size or width for generating Params section; default value is 480.
Field public Numeric field with values to be used in classification.
ForceStatisticsCalculation public Forces the calculation of layer statistics; True by default.
(Inherited from ITGIS_ClassificationAbstract)
Interval public Class interval size; default value is 1.
(Inherited from ITGIS_ClassificationAbstract)
Layer public Layer assigned to object.
(Inherited from ITGIS_ClassificationAbstract)
Method public Classification method; NaturalBreaks by default.
(Inherited from ITGIS_ClassificationAbstract)
NumClasses public Number of classes; default is 5, max is 30.
(Inherited from ITGIS_ClassificationAbstract)
RenderType public Visual property which will be affected during classification; Color by default.
ShapeType public Defines which visual parameter will be used for classification: Marker for Points, Line for Arcs, Area for Polygons.
ShowLegend public If True, features will be shown in legend panel; True by default.
(Inherited from ITGIS_ClassificationAbstract)
StartColor public Starting color used to generate ramp for class breaks; White by default.
(Inherited from ITGIS_ClassificationAbstract)
StartSize public Starting size or width for generating Params section; default value is 1.
Target public Indicates the data to be used for classification; empty by default.
(Inherited from ITGIS_ClassificationAbstract)

Remarks

Example

Pseudocode:

// while 'lyr' is opened vector layer with added empty 'CLASS_ID' field
classifier = new TGIS_Classification( lyr );

// select one of available classification methods
classifier.Method = TGIS_ClassificationMethod.NaturalBreaks;

// specify number of classes
classifier.NumClasses = 5;

// specify attribute field with numerical values
classifier.Field = 'POPULATION';

// select visual property to be affected
classifier.RenderType = TGIS_ClassificationRenderBy.Color;

// write class ids to existing layer's field
classifier.ClassIdField = 'CLASS_ID';

// check if layer's statistics require recalculation
if classifier.MustCalculateStatistics then
  lyr.Statistics.Calculate ;

// run classification process, visual properties will be applied automatically
classifier.Classify ;

// check generated class breaks values
// class breaks count equals NumClasses + 1
for i from 0 to classifier.NumClasses
  value = classifier.ClassBreaks[i];

2024/10/03 01:03

Page Tools