[Backport 8.19] Add cartesian_bounds, cartesian_centroid and change_point aggregations (#5439)

* Add cartesian_bounds, cartesian_centroid and change_point aggregations (#5418) (#5436)

* fix search validation

* add variants to changetype

* Update specification/_types/aggregations/AggregationContainer.ts

* add ext docs to table csv

---------

(cherry picked from commit 23222d9)

Co-authored-by: Laura Trotta <[email protected]>
Co-authored-by: Quentin Pradet <[email protected]>

* update ext doc table

---------

Co-authored-by: Quentin Pradet <[email protected]>

Author: l-trotta

specification/_doc_ids/table.csv

@@ -649,6 +649,9 @@ search-aggregations-bucket-significantterms-aggregation,https://www.elastic.co/g
 search-aggregations-metrics-avg-aggregation,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-aggregations-metrics-avg-aggregation.html,,
 search-aggregations-metrics-boxplot-aggregation,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-aggregations-metrics-boxplot-aggregation.html,,
 search-aggregations-metrics-cardinality-aggregation,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-aggregations-metrics-cardinality-aggregation.html,,
+search-aggregations-metrics-cartesian-bounds-aggregation,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-aggregations-metrics-cartesian-bounds-aggregation.html,,
+search-aggregations-metrics-cartesian-centroid-aggregation,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-aggregations-metrics-cartesian-centroid-aggregation.html,,
+search-aggregations-change-point-aggregation,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-aggregations-change-point-aggregation.html,,
 search-aggregations-metrics-extendedstats-aggregation,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-aggregations-metrics-extendedstats-aggregation.html,,
 search-aggregations-pipeline-avg-bucket-aggregation,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-aggregations-pipeline-avg-bucket-aggregation.html,,
 search-aggregations-pipeline-bucket-path,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-aggregations-pipeline.html#buckets-path-syntax,,

specification/_types/Geo.ts

@@ -95,12 +95,6 @@ export type GeoTile = string
 
 /** A map hex cell (H3) reference */
 export type GeoHexCell = string
-
-export class LatLon {
-  lat: double
-  lon: double
-}
-
 /**
  * A latitude/longitude as a 2 dimensional point. It can be represented in various ways:
  * - as a `{lat, long}` object
@@ -128,6 +122,11 @@ export class LatLonGeoLocation {
   lon: double
 }
 
+export class CartesianPoint {
+  x: double
+  y: double
+}
+
 export class GeoHashLocation {
   geohash: GeoHash
 }

specification/_types/aggregations/Aggregate.ts

@@ -20,12 +20,14 @@
 import { CompositeAggregateKey } from '@_types/aggregations/bucket'
 import { AggregateName, Field, FieldValue, Metadata } from '@_types/common'
 import {
+  CartesianPoint,
   GeoBounds,
   GeoHash,
   GeoHexCell,
   GeoLine,
   GeoLocation,
-  GeoTile
+  GeoTile,
+  TopLeftBottomRightGeoBounds
 } from '@_types/Geo'
 import { double, integer, long } from '@_types/Numeric'
 import { DurationLarge, EpochTime, UnitMillis } from '@_types/Time'
@@ -59,11 +61,14 @@ export type Aggregate =
   | SimpleValueAggregate
   | DerivativeAggregate
   | BucketMetricValueAggregate
+  | ChangePointAggregate
   // Multi value
   | StatsAggregate
   | StatsBucketAggregate
   | ExtendedStatsAggregate
   | ExtendedStatsBucketAggregate
+  | CartesianBoundsAggregate
+  | CartesianCentroidAggregate
   // Geo
   | GeoBoundsAggregate
   | GeoCentroidAggregate
@@ -322,6 +327,17 @@ export class ExtendedStatsAggregate extends StatsAggregate {
 /** @variant name=extended_stats_bucket */
 export class ExtendedStatsBucketAggregate extends ExtendedStatsAggregate {}
 
+/** @variant name=cartesian_bounds */
+export class CartesianBoundsAggregate extends AggregateBase {
+  bounds?: TopLeftBottomRightGeoBounds
+}
+
+/** @variant name=cartesian_centroid */
+export class CartesianCentroidAggregate extends AggregateBase {
+  count: long
+  location?: CartesianPoint
+}
+
 //----- Geo
 
 /**
@@ -369,6 +385,68 @@ export class MultiBucketBase
   doc_count: long
 }
 
+/** @variant name=change_point */
+export class ChangePointAggregate extends MultiBucketAggregateBase<ChangePointBucket> {
+  type: ChangeType
+  bucket?: ChangePointBucket
+}
+
+export class ChangePointBucket extends MultiBucketBase {
+  key: FieldValue
+}
+
+/**
+ * @variants typed_keys_quirk
+ */
+export type ChangeType =
+  | Dip
+  | DistributionChange
+  | Indeterminable
+  | NonStationary
+  | Spike
+  | Stationary
+  | StepChange
+  | TrendChange
+
+export class AbstractChangePoint {
+  p_value: double
+  change_point: integer
+}
+
+/** @variant name=dip */
+export class Dip extends AbstractChangePoint {}
+
+/** @variant name=distribution_change */
+export class DistributionChange extends AbstractChangePoint {}
+
+/** @variant name=spike */
+export class Spike extends AbstractChangePoint {}
+
+/** @variant name=step_change */
+export class StepChange extends AbstractChangePoint {}
+
+/** @variant name=indeterminable */
+export class Indeterminable {
+  reason: string
+}
+
+/** @variant name=non_stationary */
+export class NonStationary {
+  p_value: double
+  r_value: double
+  trend: string
+}
+
+/** @variant name=stationary */
+export class Stationary {}
+
+/** @variant name=trend_change */
+export class TrendChange {
+  p_value: double
+  r_value: double
+  change_point: integer
+}
+
 /**
  * @variant name=histogram
  * @ext_doc_id search-aggregations-bucket-histogram-aggregation

specification/_types/aggregations/AggregationContainer.ts

@@ -60,6 +60,8 @@ import {
   AverageAggregation,
   BoxplotAggregation,
   CardinalityAggregation,
+  CartesianBoundsAggregation,
+  CartesianCentroidAggregation,
   ExtendedStatsAggregation,
   GeoBoundsAggregation,
   GeoCentroidAggregation,
@@ -87,6 +89,7 @@ import {
   BucketScriptAggregation,
   BucketSelectorAggregation,
   BucketSortAggregation,
+  ChangePointAggregation,
   CumulativeCardinalityAggregation,
   CumulativeSumAggregation,
   DerivativeAggregation,
@@ -183,13 +186,32 @@ export class AggregationContainer {
    * @ext_doc_id search-aggregations-metrics-cardinality-aggregation
    */
   cardinality?: CardinalityAggregation
+  /**
+   * A metric aggregation that computes the spatial bounding box containing all values for a Point or Shape field.
+   * @ext_doc_id search-aggregations-metrics-cartesian-bounds-aggregation
+   */
+  cartesian_bounds?: CartesianBoundsAggregation
+  /**
+   * A metric aggregation that computes the weighted centroid from all coordinate values for point and shape fields.
+   * @ext_doc_id search-aggregations-metrics-cartesian-centroid-aggregation
+   */
+  cartesian_centroid?: CartesianCentroidAggregation
   /**
    * A multi-bucket aggregation that groups semi-structured text into buckets.
    * @ext_doc_id search-aggregations-bucket-categorize-text-aggregation
    * @availability stack stability=experimental
    * @availability serverless stability=experimental
    */
   categorize_text?: CategorizeTextAggregation
+  /**
+   * A sibling pipeline that detects, spikes, dips, and change points in a metric.
+   * Given a distribution of values provided by the sibling multi-bucket aggregation,
+   * this aggregation indicates the bucket of any spike or dip and/or the bucket at which
+   * the largest change in the distribution of values, if they are statistically significant.
+   * There must be at least 22 bucketed values. Fewer than 1,000 is preferred.
+   * @ext_doc_id search-aggregations-change-point-aggregation
+   */
+  change_point?: ChangePointAggregation
   /**
    * A single bucket aggregation that selects child documents that have the specified type, as defined in a `join` field.
    * @ext_doc_id search-aggregations-bucket-children-aggregation
@@ -245,6 +267,7 @@ export class AggregationContainer {
   /**
    * A bucket aggregation which finds frequent item sets, a form of association rules mining that identifies items that often occur together.
    * @ext_doc_id search-aggregations-bucket-frequent-item-sets-aggregation
+   * @aliases frequent_items
    */
   frequent_item_sets?: FrequentItemSetsAggregation
   /**

specification/_types/aggregations/metric.ts

@@ -111,6 +111,10 @@ export class ExtendedStatsAggregation extends FormatMetricAggregationBase {
   sigma?: double
 }
 
+export class CartesianBoundsAggregation extends MetricAggregationBase {}
+
+export class CartesianCentroidAggregation extends MetricAggregationBase {}
+
 /**
  * @ext_doc_id search-aggregations-metrics-geobounds-aggregation
  */

specification/_types/aggregations/pipeline.ts

@@ -203,6 +203,8 @@ export class BucketSortAggregation extends Aggregation {
   sort?: Sort
 }
 
+export class ChangePointAggregation extends PipelineAggregationBase {}
+
 /**
  * @ext_doc_id search-aggregations-pipeline-cumulative-cardinality-aggregation
  */