libcudf  24.04.00
stream_compaction.hpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2019-2023, 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/types.hpp>
21 
22 #include <rmm/mr/device/per_device_resource.hpp>
23 
24 #include <memory>
25 #include <vector>
26 
27 namespace cudf {
72 std::unique_ptr<table> drop_nulls(
73  table_view const& input,
74  std::vector<size_type> const& keys,
75  cudf::size_type keep_threshold,
76  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
77 
104 std::unique_ptr<table> drop_nulls(
105  table_view const& input,
106  std::vector<size_type> const& keys,
107  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
108 
146 std::unique_ptr<table> drop_nans(
147  table_view const& input,
148  std::vector<size_type> const& keys,
149  cudf::size_type keep_threshold,
150  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
151 
179 std::unique_ptr<table> drop_nans(
180  table_view const& input,
181  std::vector<size_type> const& keys,
182  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
183 
205 std::unique_ptr<table> apply_boolean_mask(
206  table_view const& input,
207  column_view const& boolean_mask,
208  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
209 
214  KEEP_ANY = 0,
215  KEEP_FIRST,
216  KEEP_LAST,
217  KEEP_NONE
218 };
219 
247 std::unique_ptr<table> unique(
248  table_view const& input,
249  std::vector<size_type> const& keys,
251  null_equality nulls_equal = null_equality::EQUAL,
252  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
253 
273 std::unique_ptr<table> distinct(
274  table_view const& input,
275  std::vector<size_type> const& keys,
277  null_equality nulls_equal = null_equality::EQUAL,
279  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
280 
295 std::unique_ptr<column> distinct_indices(
296  table_view const& input,
298  null_equality nulls_equal = null_equality::EQUAL,
300  rmm::cuda_stream_view stream = cudf::get_default_stream(),
301  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
302 
325 std::unique_ptr<table> stable_distinct(
326  table_view const& input,
327  std::vector<size_type> const& keys,
329  null_equality nulls_equal = null_equality::EQUAL,
331  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
332 
349  null_policy null_handling,
350  nan_policy nan_handling);
351 
362  null_equality nulls_equal = null_equality::EQUAL);
363 
385  null_policy null_handling,
386  nan_policy nan_handling);
387 
398  null_equality nulls_equal = null_equality::EQUAL);
399 
401 } // 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
rmm::cuda_stream_view const get_default_stream()
Get the current default stream.
std::unique_ptr< column > distinct_indices(table_view const &input, duplicate_keep_option keep=duplicate_keep_option::KEEP_ANY, null_equality nulls_equal=null_equality::EQUAL, nan_equality nans_equal=nan_equality::ALL_EQUAL, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
Create a column of indices of all distinct rows in the input table.
std::unique_ptr< table > stable_distinct(table_view const &input, std::vector< size_type > const &keys, duplicate_keep_option keep=duplicate_keep_option::KEEP_ANY, null_equality nulls_equal=null_equality::EQUAL, nan_equality nans_equal=nan_equality::ALL_EQUAL, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
Create a new table without duplicate rows, preserving input order.
std::unique_ptr< table > unique(table_view const &input, std::vector< size_type > const &keys, duplicate_keep_option keep, null_equality nulls_equal=null_equality::EQUAL, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
Create a new table with consecutive duplicate rows removed.
cudf::size_type unique_count(column_view const &input, null_policy null_handling, nan_policy nan_handling)
Count the number of consecutive groups of equivalent rows in a column.
duplicate_keep_option
Choices for drop_duplicates API for retainment of duplicate rows.
std::unique_ptr< table > distinct(table_view const &input, std::vector< size_type > const &keys, duplicate_keep_option keep=duplicate_keep_option::KEEP_ANY, null_equality nulls_equal=null_equality::EQUAL, nan_equality nans_equal=nan_equality::ALL_EQUAL, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
Create a new table without duplicate rows.
std::unique_ptr< table > apply_boolean_mask(table_view const &input, column_view const &boolean_mask, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
Filters input using boolean_mask of boolean values as a mask.
cudf::size_type distinct_count(column_view const &input, null_policy null_handling, nan_policy nan_handling)
Count the distinct elements in the column_view.
std::unique_ptr< table > drop_nulls(table_view const &input, std::vector< size_type > const &keys, cudf::size_type keep_threshold, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
Filters a table to remove null elements with threshold count.
std::unique_ptr< table > drop_nans(table_view const &input, std::vector< size_type > const &keys, cudf::size_type keep_threshold, rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
Filters a table to remove NANs with threshold count.
@ KEEP_ANY
Keep an unspecified occurrence.
@ KEEP_NONE
Keep no (remove all) occurrences of duplicates.
@ KEEP_LAST
Keep last occurrence.
@ KEEP_FIRST
Keep first occurrence.
null_equality
Enum to consider two nulls as equal or unequal.
Definition: types.hpp:149
int32_t size_type
Row index type for columns and tables.
Definition: types.hpp:93
null_policy
Enum to specify whether to include nulls or exclude nulls.
Definition: types.hpp:124
nan_policy
Enum to treat NaN floating point value as null or non-null element.
Definition: types.hpp:132
nan_equality
Enum to consider different elements (of floating point types) holding NaN value as equal or unequal.
Definition: types.hpp:141
@ EQUAL
nulls compare equal
@ ALL_EQUAL
All NaNs compare equal, regardless of sign.
cuDF interfaces
Definition: aggregation.hpp:34
Type declarations for libcudf.