umapparams.h

Go to the documentation of this file.

/*
 * Copyright (c) 2019-2024, NVIDIA CORPORATION.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
#pragma once
 
#include <cuml/common/callback.hpp>
#include <cuml/common/logger.hpp>
 
#include <raft/neighbors/nn_descent_types.hpp>
 
#include <cuvs/distance/distance.hpp>
 
namespace ML {
 
using nn_index_params = raft::neighbors::experimental::nn_descent::index_params;
 
class UMAPParams {
 public:
  enum MetricType { EUCLIDEAN, CATEGORICAL };
  enum graph_build_algo { BRUTE_FORCE_KNN, NN_DESCENT };
 
  int n_neighbors = 15;
 
  int n_components = 2;
 
  int n_epochs = 0;
 
  float learning_rate = 1.0;
 
  float min_dist = 0.1;
 
  float spread = 1.0;
 
  float set_op_mix_ratio = 1.0;
 
  float local_connectivity = 1.0;
 
  float repulsion_strength = 1.0;
 
  int negative_sample_rate = 5;
 
  float transform_queue_size = 4.0;
 
  int verbosity = CUML_LEVEL_INFO;
 
  float a = -1.0;
 
  float b = -1.0;
 
  float initial_alpha = 1.0;
 
  int init = 1;
 
  graph_build_algo build_algo = graph_build_algo::BRUTE_FORCE_KNN;
 
  nn_index_params nn_descent_params = {};
 
  int target_n_neighbors = -1;
 
  MetricType target_metric = CATEGORICAL;
 
  float target_weight = 0.5;
 
  uint64_t random_state = 0;
 
  bool deterministic = true;
 
  cuvs::distance::DistanceType metric = cuvs::distance::DistanceType::L2SqrtExpanded;
 
  float p = 2.0;
 
  Internals::GraphBasedDimRedCallback* callback = nullptr;
};
 
}  // namespace ML