ComputeMaxInfoGains: Max information gains

Description Usage Arguments Value Examples

View source: R/information_gain.R

Description

Max information gains

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
ComputeMaxInfoGains(
  data,
  decision,
  dimensions = 1,
  divisions = NULL,
  discretizations = 1,
  seed = NULL,
  range = NULL,
  pc.xi = 0.25,
  return.tuples = FALSE,
  return.min = FALSE,
  interesting.vars = vector(mode = "integer"),
  require.all.vars = FALSE,
  use.CUDA = FALSE
)

Arguments

data

input data where columns are variables and rows are observations (all numeric)

decision

decision variable as a binary sequence of length equal to number of observations

dimensions

number of dimensions (a positive integer; 5 max)

divisions

number of divisions (from 1 to 15; additionally limited by dimensions if using CUDA; NULL selects probable optimal number)

discretizations

number of discretizations

seed

seed for PRNG used during discretizations (NULL for random)

range

discretization range (from 0.0 to 1.0; NULL selects probable optimal number)

pc.xi

parameter xi used to compute pseudocounts (the default is recommended not to be changed)

return.tuples

whether to return tuples (and relevant discretization number) where max IG was observed (one tuple and relevant discretization number per variable) - not supported with CUDA nor in 1D

return.min

whether to return min instead of max (per tuple, always max per discretization) - not supported with CUDA

interesting.vars

variables for which to check the IGs (none = all) - not supported with CUDA

require.all.vars

boolean whether to require tuple to consist of only interesting.vars

use.CUDA

whether to use CUDA acceleration (must be compiled with CUDA)

Value

A data.frame with the following columns:

Additionally attribute named run.params with run parameters is set on the result.

Examples

1
2
ComputeMaxInfoGains(madelon$data, madelon$decision, dimensions = 2, divisions = 1,
                    range = 0, seed = 0)

MDFS documentation built on Feb. 10, 2021, 1:08 a.m.