Package edu.cmu.tetrad.search.test

Class IndTestBasisFunctionBlocks

java.lang.Object
edu.cmu.tetrad.search.test.IndTestBasisFunctionBlocks
All Implemented Interfaces:
RawMarginalIndependenceTest, IndependenceTest, EffectiveSampleSizeSettable
public class IndTestBasisFunctionBlocks extends Object implements IndependenceTest, RawMarginalIndependenceTest, EffectiveSampleSizeSettable
IndTestBasisFunctionBlocks - Builds a per-variable truncated basis expansion (via Embedding) - Constructs the blocks mapping (original var -> list of embedded column indices) - Delegates CI testing to IndTestBlocks over those blocks

CONTRACT: 'blocks' maps each ORIGINAL variable index v (0..V-1) to the list of embedded column indices in the embedded matrix produced here.

  • Constructor Details

    • IndTestBasisFunctionBlocks

      public IndTestBasisFunctionBlocks(DataSet raw, int degree, int basisType)
      Constructs an instance of IndTestBasisFunctionBlocks. This class is designed to perform independence tests based on basis function transformations of the provided dataset, using specified degree and basis type.
      Parameters:
      raw - the input dataset, which provides the raw data to be analyzed. Cannot be null.
      degree - the degree of the basis function transformation. Must be a non-negative integer.
      basisType - the type of basis functions to use for transformations (e.g., polynomial, Fourier, etc.). This value determines the embedding style and configuration specifics.
      Throws:
      IllegalArgumentException - if the raw dataset is null or if the degree is negative.

  • Method Details

    • checkIndependence

      public IndependenceResult checkIndependence(Node x, Node y, Set<Node> z)
      Checks for statistical independence between two given variables (nodes), conditioned on a set of other variables.
      Specified by:
      checkIndependence in interface IndependenceTest
      Parameters:
      x - the first variable (node) to test for independence
      y - the second variable (node) to test for independence
      z - the set of conditioning variables (nodes) for the independence test
      Returns:
      an IndependenceResult containing details about the test result, including whether the variables are independent, the p-value, and the significance level used

    • getVariables

      public List<Node> getVariables()
      Retrieves the list of nodes (variables) associated with this instance. The nodes returned are exactly the ones used internally by the delegate, ensuring identity consistency and preventing "unknown node" issues.
      Specified by:
      getVariables in interface IndependenceTest
      Returns:
      a list of nodes representing the variables

    • getData

      public DataModel getData()
      Retrieves the original dataset represented by this instance.
      Specified by:
      getData in interface IndependenceTest
      Returns:
      the underlying data as a DataModel object

    • isVerbose

      public boolean isVerbose()
      Indicates whether this instance is operating in verbose mode. Verbose mode allows for detailed output or logging to assist in debugging or monitoring execution.
      Specified by:
      isVerbose in interface IndependenceTest
      Returns:
      true if verbose mode is enabled; false otherwise

    • setVerbose

      public void setVerbose(boolean verbose)
      Sets the verbosity mode for this instance. Enabling verbosity allows for more detailed output or logging during execution.
      Specified by:
      setVerbose in interface IndependenceTest
      Parameters:
      verbose - true to enable verbose output, false to disable it

    • computePValue

      public double computePValue(double[] x, double[] y) throws InterruptedException
      Description copied from interface: RawMarginalIndependenceTest
      Computes the p-value for the statistical test of marginal independence between the two given variables represented by the input arrays.
      Specified by:
      computePValue in interface RawMarginalIndependenceTest
      Parameters:
      x - the first variable, represented as an array of doubles
      y - the second variable, represented as an array of doubles
      Returns:
      the computed p-value for the test of marginal independence
      Throws:
      InterruptedException - if the computation is interrupted

    • computePValue

      public double computePValue(double[] x, double[][] Y) throws InterruptedException
      Default multivariate fallback: run BFIT on each column of Y and combine with Fisher. If you later add a true multivariate BFIT, override this to call it directly.
      Specified by:
      computePValue in interface RawMarginalIndependenceTest
      Parameters:
      x - the first variable (scalar), represented as an array of doubles of length n
      Y - the multivariate variable, represented as a 2D array of shape [n][m] (n samples, m variables)
      Returns:
      the computed p-value for the test of independence
      Throws:
      InterruptedException - if the computation is interrupted

    • getAlpha

      public double getAlpha()
      Retrieves the alpha value currently set for this instance. The alpha value is typically used as a threshold or parameter in statistical tests or computations.
      Specified by:
      getAlpha in interface IndependenceTest
      Returns:
      the alpha value, which is a double strictly between 0 and 1

    • setAlpha

      public void setAlpha(double alpha)
      Sets the alpha value used as a threshold or parameter for statistical tests or computations. The alpha value must be within the range (0, 1), exclusive.
      Specified by:
      setAlpha in interface IndependenceTest
      Parameters:
      alpha - the desired alpha value, strictly between 0 and 1
      Throws:
      IllegalArgumentException - if alpha is less than or equal to 0 or greater than or equal to 1

    • getBlocks

      public List<List<Integer>> getBlocks()
      Retrieves the list of blocks, where each block is represented as a list of integers. These blocks may correspond to partitions or groupings derived from the data or configuration.
      Returns:
      a list of blocks, with each block being a list of integers

    • getEmbeddedData

      public org.ejml.simple.SimpleMatrix getEmbeddedData()
      Retrieves the embedded data matrix corresponding to the transformed or processed data based on the configuration of this instance.
      Returns:
      the embedded data matrix as a SimpleMatrix object

    • getEffectiveSampleSize

      public int getEffectiveSampleSize()
      Description copied from interface: EffectiveSampleSizeSettable
      Returns the effective sample size.
      Specified by:
      getEffectiveSampleSize in interface EffectiveSampleSizeSettable
      Returns:
      the effective sample size

    • setEffectiveSampleSize

      public void setEffectiveSampleSize(int nEff)
      Description copied from interface: EffectiveSampleSizeSettable
      Sets the effective sample size, or -1 if the actual sample size should be used.
      Specified by:
      setEffectiveSampleSize in interface EffectiveSampleSizeSettable
      Parameters:
      nEff - the effective sample size