Terrain Processor: Area: High-density Cluster

From Bohemia Interactive Community
Jump to: navigation, search

Task details

Task name : Area: Hight-density Cluster

Dll plugin name : BITasksPlugin.dll

Geometry type : Polygon, PolygonM, PolygonZ

Heightmap : No


Random placement of multiple objects inside the polygons specified in the given shapefile. First step is to create lifegrid. Lifegrid is 2D table where every cell has information about its Object prototype. Algorithm puts some first seeds. Counts and types of seeds depends on input parameters. Ideal for high density areas like forest.


  • Spruce 85% PROB
  • Pine 10% PROB
  • Larch 5% PROB

See the bottom of the page for the data from the example.

Task parameters

  • Random seed - number used to initialize pseudorandom number generator.
  • Hectare density - density of the filling, in number of objects for hectare. For example 100 objects per hectare means an average distance of 10 meters between each object.
  • Fraction - initial seeds count for smallest probability object prototype on hectare.
  • Blend distance - distance to get object prototype.

Object prototype parameters

  • OBJECT - Object's prototype name
  • PROB - Object's probability
  • MINHEIGHT - Minimal size in %
  • MAXHEIGHT - Maximal size in %
  • MINDIST - Minimal distance in meters


Use for areas with high objects density, where particular object types tend to aggregate in groups, e.g. in mixed forests.


For each shape (areal) do :

  1. Create and populate "lifegrid"
    1. Find shape bounding.
    2. Create empty "lifegrid" for this area.
    3. Generate base seeds (for each object prototype)
      1. seeds_count = HECTARES * CDENSHA
      2. Randomly generate seeds_count in shape and set this grid item prototype.
  2. instances_count = HECTARES * DENSHA
  3. For instances_count try to find position :
    1. Random position in bounding box.
    2. If position is inside shape, continue to c. else a.
    3. Test with objects if minimal distance is ok, continue to d. else a.
    4. Find object prototype - random grid item in radius 50 meters. This grid item has information about object prototype.

If this loop a <-> d has no new output for last 100 attempts, area is full and iteration of this shape will end.

Example data

Fragmentation Spruce seeds count Pine seeds count Larch seeds count Preview
1 17 2 1 TerrainProcessor HightFrag1.png
2 34 4 2 TerrainProcessor HightFrag2.png
5 85 10 5 TerrainProcessor HightFrag3.png

Legend: TerrainProcessor HightFragLegend.png