Package it.unimi.dsi.webgraph.algo

Class ApproximateNeighbourhoodFunctions

java.lang.Object
it.unimi.dsi.webgraph.algo.ApproximateNeighbourhoodFunctions
public class ApproximateNeighbourhoodFunctions
extends java.lang.Object
Static methods and objects that manipulate approximate neighbourhood functions.

A number of statistics that can be used with Jackknife, such as CDF, AVERAGE_DISTANCE, HARMONIC_DIAMETER and SPID are available.

  • Field Summary

    Fields 
    Modifier and Type Field Description
    static Jackknife.Statistic AVERAGE_DISTANCE
    A statistic that computes the average distance.
    static Jackknife.Statistic CDF
    A statistic that divides all values of a sample (an approximate neighbourhood function) by the last value.
    static Jackknife.Statistic EFFECTIVE_DIAMETER
    A statistic that computes the effective diameter.
    static Jackknife.Statistic HARMONIC_DIAMETER
    A statistic that computes the harmonic diameter.
    static Jackknife.Statistic PMF
    A statistic that computes differences between consecutive elements of a sample (an approximate neighbourhood function) and divide them by the last value.
    static Jackknife.Statistic SPID
    A statistic that computes the spid.

  • Method Summary

    Modifier and Type Method Description
    static double[] combine​(java.lang.Iterable<double[]> anf)
    Combines several approximate neighbourhood functions for the same graph by averaging their values.
    static ObjectList<double[]> evenOut​(java.lang.Iterable<double[]> anf)
    Evens out several approximate neighbourhood functions for the same graph by extending them to the same length (by copying the last value).

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

  • Method Details

    • combine

      public static double[] combine​(java.lang.Iterable<double[]> anf)
      Combines several approximate neighbourhood functions for the same graph by averaging their values.

      Note that the resulting approximate neighbourhood function has its standard deviation reduced by the square root of the number of samples (the standard error). However, if the cumulative distribution function has to be computed instead, calling this method and dividing all values by the last value is not the best approach, as it leads to a biased estimate. Rather, the samples should be combined using the jackknife and the CDF statistic.

      If you want to obtain estimates on the standard error of each data point, please consider using the jackknife with the identity statistic instead of this method.

      Parameters:
      anf - an iterable object returning arrays of doubles representing approximate neighbourhood functions.
      Returns:
      a combined approximate neighbourhood functions.

    • evenOut

      public static ObjectList<double[]> evenOut​(java.lang.Iterable<double[]> anf)
      Evens out several approximate neighbourhood functions for the same graph by extending them to the same length (by copying the last value). This is usually a preparatory step for the jackknife.
      Parameters:
      anf - an iterable object returning arrays of doubles representing approximate neighbourhood functions.
      Returns:
      a list containing the same approximate neighbourhood functions, extended to the same length.