> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# aggregate_convex_hull

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/aggregate_convex_hull.rs#L26-L39)
pub async fn [aggregate\_convex\_hull](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/aggregate-convex-hull.md#method.aggregate_convex_hull)( \&self, table\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), x\_column\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), y\_column\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AggregateConvexHullResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AggregateConvexHullResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Calculate and return the convex hull for a datasetCalculates and returns the convex hull for the values in a table specified by `table_name`.

##### Arguments

<ul>
  <li>`table_name` - Name of table on which the operation will be performed. Must be an existing table, in \[schema\_name.]table\_name format, using standard name resolution rules.</li>
  <li>`x_column_name` - Name of the column containing the x coordinates of the points for the operation being performed.</li>
  <li>`y_column_name` - Name of the column containing the y coordinates of the points for the operation being performed.</li>
</ul>

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/aggregate_convex_hull.rs#L57-L77)
pub async fn [aggregate\_convex\_hull\_with\_opts](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/aggregate-convex-hull.md#method.aggregate_convex_hull_with_opts)( \&self, table\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), x\_column\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), y\_column\_name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), options: [AggregateConvexHullRequestOptions](https://docs.kinetica.com/content/api/rust/generated/api/struct.AggregateConvexHullRequestOptions.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AggregateConvexHullResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AggregateConvexHullResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Calculate and return the convex hull for a datasetCalculates and returns the convex hull for the values in a table specified by `table_name`.

##### Arguments

<ul>
  <li>`table_name` - Name of table on which the operation will be performed. Must be an existing table, in \[schema\_name.]table\_name format, using standard name resolution rules.</li>
  <li>`x_column_name` - Name of the column containing the x coordinates of the points for the operation being performed.</li>
  <li>`y_column_name` - Name of the column containing the y coordinates of the points for the operation being performed.</li>
  <li>`options` - The optional parameters; any left unset take the server’s defaults.</li>
</ul>

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/aggregate_convex_hull.rs#L80-L91)
pub async fn [aggregate\_convex\_hull\_raw](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/aggregate-convex-hull.md#method.aggregate_convex_hull_raw)( \&self, request: &[AggregateConvexHullRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.AggregateConvexHullRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AggregateConvexHullResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AggregateConvexHullResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Sends a pre-built [`AggregateConvexHullRequest`](https://docs.kinetica.com/content/api/rust/generated/api/struct.AggregateConvexHullRequest) to the `/aggregate/convexhull` endpoint.

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/aggregate_convex_hull.rs#L95-L107)
pub async fn [aggregate\_convex\_hull\_from\_url](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/aggregate-convex-hull.md#method.aggregate_convex_hull_from_url)( \&self, url: &[str](https://doc.rust-lang.org/1.98.1/std/primitive.str.html), request: &[AggregateConvexHullRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.AggregateConvexHullRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AggregateConvexHullResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AggregateConvexHullResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Sends a pre-built [`AggregateConvexHullRequest`](https://docs.kinetica.com/content/api/rust/generated/api/struct.AggregateConvexHullRequest) to a specific worker URL, bypassing HA head-node selection. Used for multi-head access.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.