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 
24 #include <rmm/mr/device/per_device_resource.hpp>
25 #include <rmm/resource_ref.hpp>
26 
27 namespace cudf {
57 std::unique_ptr<column> quantile(
58  column_view const& input,
59  std::vector<double> const& q,
61  column_view const& ordered_indices = {},
62  bool exact = true,
63  rmm::device_async_resource_ref mr = rmm::mr::get_current_device_resource());
64 
95 std::unique_ptr<table> quantiles(
96  table_view const& input,
97  std::vector<double> const& q,
99  cudf::sorted is_input_sorted = sorted::NO,
100  std::vector<order> const& column_order = {},
101  std::vector<null_order> const& null_precedence = {},
102  rmm::device_async_resource_ref mr = rmm::mr::get_current_device_resource());
103 
126 std::unique_ptr<column> percentile_approx(
127  tdigest::tdigest_column_view const& input,
128  column_view const& percentiles,
129  rmm::device_async_resource_ref mr = rmm::mr::get_current_device_resource());
130  // end of group
132 } // namespace 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:187
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.
interpolation
Interpolation method to use when the desired quantile lies between two data points i and j.
Definition: types.hpp:190
sorted
Indicates whether a collection of values is known to be sorted.
Definition: types.hpp:165
@ LINEAR
Linear interpolation between i and j.
@ NEAREST
i or j, whichever is nearest
cuDF interfaces
Definition: aggregation.hpp:34
Class definitions for cudf::scalar.
Class definitions for (mutable)_table_view
tdigest data APIs
Type declarations for libcudf.