quantiles.hpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2019-2024, NVIDIA CORPORATION.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #pragma once
18 
19 #include <cudf/scalar/scalar.hpp>
22 #include <cudf/types.hpp>
23 #include <cudf/utilities/export.hpp>
24 
26 #include <rmm/resource_ref.hpp>
27 
28 namespace CUDF_EXPORT cudf {
58 std::unique_ptr<column> quantile(
59  column_view const& input,
60  std::vector<double> const& q,
61  interpolation interp = interpolation::LINEAR,
62  column_view const& ordered_indices = {},
63  bool exact = true,
65 
96 std::unique_ptr<table> quantiles(
97  table_view const& input,
98  std::vector<double> const& q,
99  interpolation interp = interpolation::NEAREST,
100  cudf::sorted is_input_sorted = sorted::NO,
101  std::vector<order> const& column_order = {},
102  std::vector<null_order> const& null_precedence = {},
104 
127 std::unique_ptr<column> percentile_approx(
128  tdigest::tdigest_column_view const& input,
129  column_view const& percentiles,
131  // end of group
133 } // namespace CUDF_EXPORT cudf
A non-owning, immutable view of device data as a column of elements, some of which may be null as ind...
A set of cudf::column_view's of the same size.
Definition: table_view.hpp:200
Given a column_view containing tdigest data, an instance of this class provides a wrapper on the comp...
std::unique_ptr< column > percentile_approx(tdigest::tdigest_column_view const &input, column_view const &percentiles, rmm::device_async_resource_ref mr=rmm::mr::get_current_device_resource())
Calculate approximate percentiles on an input tdigest column.
std::unique_ptr< table > quantiles(table_view const &input, std::vector< double > const &q, interpolation interp=interpolation::NEAREST, cudf::sorted is_input_sorted=sorted::NO, std::vector< order > const &column_order={}, std::vector< null_order > const &null_precedence={}, rmm::device_async_resource_ref mr=rmm::mr::get_current_device_resource())
Returns the rows of the input corresponding to the requested quantiles.
std::unique_ptr< column > quantile(column_view const &input, std::vector< double > const &q, interpolation interp=interpolation::LINEAR, column_view const &ordered_indices={}, bool exact=true, rmm::device_async_resource_ref mr=rmm::mr::get_current_device_resource())
Computes quantiles with interpolation.
cuda::mr::async_resource_ref< cuda::mr::device_accessible > device_async_resource_ref
device_memory_resource * get_current_device_resource()
interpolation
Interpolation method to use when the desired quantile lies between two data points i and j.
Definition: types.hpp:192
sorted
Indicates whether a collection of values is known to be sorted.
Definition: types.hpp:167
cuDF interfaces
Definition: aggregation.hpp:35
Class definitions for cudf::scalar.
Class definitions for (mutable)_table_view
tdigest data APIs
Type declarations for libcudf.