Package org.apache.datasketches.theta

Class PairwiseSetOperations

  • @Deprecated
public class PairwiseSetOperations
extends Object
    Deprecated.
    v2.0.0. This class has been deprecated as equivalent functionality has been added to the SetOperation classes: Union, Intersection and AnotB.
    Set Operations where the arguments are presented in pairs as in C = Op(A,B). These are stateless operations and the result is returned immediately.

    These operations are designed for convenience and accept Sketches that may be either Heap-based or Direct.

    Author:
    Lee Rhodes

    • Constructor Detail

      • PairwiseSetOperations

        public PairwiseSetOperations()
        Deprecated.

    • Method Detail

      • intersect

        @Deprecated
public static CompactSketch intersect​(Sketch skA,
                                      Sketch skB)
        Deprecated.
        v2.0.0. Use Intersection.intersect(Sketch, Sketch) instead, which has more complete seed handling.
        This implements a stateless, pair-wise Intersect operation on sketches that are either Heap-based or Direct. If either inputs are null or empty an EmptyCompactSketch is returned.
        Parameters:
        skA - The first Sketch argument.
        skB - The second Sketch argument.
        Returns:
        the result as an ordered CompactSketch on the heap.

      • aNotB

        @Deprecated
public static CompactSketch aNotB​(Sketch skA,
                                  Sketch skB)
        Deprecated.
        v2.0.0. Use AnotB.aNotB(Sketch, Sketch) instead, which has more complete seed handling.
        This implements a stateless, pair-wise A AND NOT B operation on Sketches that are either Heap-based or Direct. If both inputs are null an EmptyCompactSketch is returned.
        Parameters:
        skA - The first Sketch argument.
        skB - The second Sketch argument.
        Returns:
        the result as an ordered CompactSketch on the heap.

      • union

        @Deprecated
public static CompactSketch union​(CompactSketch skA,
                                  CompactSketch skB)
        Deprecated.
        v2.0.0. Please use Union.union(Sketch, Sketch) instead, which has more complete seed handling.
        This implements a stateless, pair-wise union operation on ordered, CompactSketches that are either Heap-based or Direct. Having the input sketches be compact and ordered enables extremely fast union operation. If both inputs are null an EmptyCompactSketch is returned. If one is null the other is returned, which can be either Heap-based or Direct. This is equivalent to union(skA, skB, k) where k is the default of 4096.
        Parameters:
        skA - The first ordered, CompactSketch argument.
        skB - The second ordered, CompactSketch argument
        Returns:
        the result as an ordered CompactSketch.

      • union

        @Deprecated
public static CompactSketch union​(CompactSketch skA,
                                  CompactSketch skB,
                                  int k)
        Deprecated.
        v2.0.0. Please use Union.union(Sketch, Sketch) instead, which has more complete seed handling.
        This implements a stateless, pair-wise union operation on ordered, CompactSketches that are either Heap-based or Direct. The returned sketch will be cutback to k if required, similar to the regular Union operation. If a cutback is required, the returned sketch will always be on the heap. If both inputs are null a null is returned. If either sketch is empty its Theta is ignored. If one is null the other is returned, which may be either Direct or heap-based if a cutback is required.
        Parameters:
        skA - The first ordered, CompactSketch argument.
        skB - The second ordered, CompactSketch argument
        k - The upper bound of the number of entries to be retained by the sketch
        Returns:
        the result as an ordered CompactSketch.