update_keys.hpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2020-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 #pragma once
17 
18 #include <cudf/column/column.hpp>
20 #include <cudf/utilities/span.hpp>
21 
22 #include <rmm/mr/device/per_device_resource.hpp>
23 
24 namespace cudf {
25 namespace dictionary {
59 std::unique_ptr<column> add_keys(
60  dictionary_column_view const& dictionary_column,
61  column_view const& new_keys,
62  rmm::cuda_stream_view stream = cudf::get_default_stream(),
63  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
64 
91 std::unique_ptr<column> remove_keys(
92  dictionary_column_view const& dictionary_column,
93  column_view const& keys_to_remove,
94  rmm::cuda_stream_view stream = cudf::get_default_stream(),
95  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
96 
114 std::unique_ptr<column> remove_unused_keys(
115  dictionary_column_view const& dictionary_column,
116  rmm::cuda_stream_view stream = cudf::get_default_stream(),
117  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
118 
147 std::unique_ptr<column> set_keys(
148  dictionary_column_view const& dictionary_column,
149  column_view const& keys,
150  rmm::cuda_stream_view stream = cudf::get_default_stream(),
151  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
152 
164 std::vector<std::unique_ptr<column>> match_dictionaries(
166  rmm::cuda_stream_view stream = cudf::get_default_stream(),
167  rmm::mr::device_memory_resource* mr = rmm::mr::get_current_device_resource());
168  // end of group
170 } // namespace dictionary
171 } // namespace cudf
A non-owning, immutable view of device data as a column of elements, some of which may be null as ind...
A wrapper class for operations on a dictionary column.
Class definition for cudf::column.
Class definition for cudf::dictionary_column_view.
rmm::cuda_stream_view const get_default_stream()
Get the current default stream.
std::unique_ptr< column > set_keys(dictionary_column_view const &dictionary_column, column_view const &keys, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
Create a new dictionary column by applying only the specified keys to the existing dictionary_column.
std::unique_ptr< column > add_keys(dictionary_column_view const &dictionary_column, column_view const &new_keys, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
Create a new dictionary column by adding the new keys elements to the existing dictionary_column.
std::unique_ptr< column > remove_keys(dictionary_column_view const &dictionary_column, column_view const &keys_to_remove, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
Create a new dictionary column by removing the specified keys from the existing dictionary_column.
std::vector< std::unique_ptr< column > > match_dictionaries(cudf::host_span< dictionary_column_view const > input, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
Create new dictionaries that have keys merged from the input dictionaries.
std::unique_ptr< column > remove_unused_keys(dictionary_column_view const &dictionary_column, rmm::cuda_stream_view stream=cudf::get_default_stream(), rmm::mr::device_memory_resource *mr=rmm::mr::get_current_device_resource())
Create a new dictionary column by removing any keys that are not referenced by any of the indices.
cuDF interfaces
Definition: aggregation.hpp:34
APIs for spans.
C++20 std::span with reduced feature set.
Definition: span.hpp:224