Class DiscreteProbabilityCollectionSampler<T>

    • Constructor Detail

      • DiscreteProbabilityCollectionSampler

        public DiscreteProbabilityCollectionSampler​(UniformRandomProvider rng,
                                                    Map<T,​Double> collection)
        Creates a sampler.
        Parameters:
        rng - Generator of uniformly distributed random numbers.
        collection - Collection to be sampled, with the probabilities associated to each of its items. A (shallow) copy of the items will be stored in the created instance. The probabilities must be non-negative, but zero values are allowed and their sum does not have to equal one (input will be normalized to make the probabilities sum to one).
        Throws:
        IllegalArgumentException - if collection is empty, a probability is negative, infinite or NaN, or the sum of all probabilities is not strictly positive.
      • DiscreteProbabilityCollectionSampler

        public DiscreteProbabilityCollectionSampler​(UniformRandomProvider rng,
                                                    List<T> collection,
                                                    double[] probabilities)
        Creates a sampler.
        Parameters:
        rng - Generator of uniformly distributed random numbers.
        collection - Collection to be sampled. A (shallow) copy of the items will be stored in the created instance.
        probabilities - Probability associated to each item of the collection. The probabilities must be non-negative, but zero values are allowed and their sum does not have to equal one (input will be normalized to make the probabilities sum to one).
        Throws:
        IllegalArgumentException - if collection is empty or a probability is negative, infinite or NaN, or if the number of items in the collection is not equal to the number of provided probabilities.