Generates random conical spots. The map is divided into square regions, and within each region, candidate points are chosen at random and target density, spot quantity, and radius are calculated for each point (or one of every skip_span
candidate points) by configured expressions. Each spot contributes a quantity to a regional target total (which is the average of sampled target densities times the area of the region) until the total has been reached or a maximum spot count is hit. The output value of the function is the maximum height of any spot at a given point.
The parameters that provide expressions to be evaluated for each point (all named something_expression) need to actually return expression objects.
The quantity of the spot is assumed to be the same as its volume. Since the volume of a cone is pi * radius^2 * height / 3
, the height ('peak value') of any given spot is calculated as 3 * quantity / (pi * radius^2)
The infinite series of candidate points (of which candidate_point_count
are actually considered) generated by spot-noise
expressions with the same seed0
, seed1
, region_size
, and suggested_minimum_candidate_point_spacing
will be identical. This allows multiple spot-noise expressions (e.g. for different ore patches) to avoid overlap by using different points from the same list, determined by skip_span
and skip_offset
.