pyuncertainnumber.calibration.data_peeling.fuzzy
================================================

.. py:module:: pyuncertainnumber.calibration.data_peeling.fuzzy


Functions
---------

.. autoapisummary::

   pyuncertainnumber.calibration.data_peeling.fuzzy.samples_to_fuzzy_projection
   pyuncertainnumber.calibration.data_peeling.fuzzy.samples_to_fuzzy_multivariate
   pyuncertainnumber.calibration.data_peeling.fuzzy.boxes_to_fuzzy_projection
   pyuncertainnumber.calibration.data_peeling.fuzzy.coverage_samples
   pyuncertainnumber.calibration.data_peeling.fuzzy.width


Module Contents
---------------

.. py:function:: samples_to_fuzzy_projection(ux: numpy.typing.NDArray, c: list) -> numpy.typing.NDArray

   :param ux: an (mxd_) array of samples, usually uniform. m is a large integer.
   :type ux: NDArray
   :param c: a list (of length l) of subindices of coverage samples belonging to each level.
             `len(levels) < m` must yield `True`, `sum([sum(len(subi)) for subi in levels])==m` must yield `True`.
   :type c: list

   :returns: returns a d-dimensional fuzzy number, i.e. an (lxdx2) array.
   :rtype: fx (NDArray)


.. py:function:: samples_to_fuzzy_multivariate(u: numpy.ndarray, levels: list, p: list = None)

.. py:function:: boxes_to_fuzzy_projection(boxes: list, p: list = None)

   :param boxes: sequence of boxes, each box is a (dx2) array. Also iterable of interval objects. Second output of the forward data-peeling algorithm.
   :type boxes: list

   :returns: an (lxdx3) fuzzy projection data structure
   :rtype: f (NDArray)


.. py:function:: coverage_samples(lo: numpy.typing.NDArray, hi: numpy.typing.NDArray, m: int = 1000)

   :param lo: an (d,) array (or list) of left endpoints. Coverage means samples are generated using low-discrepancy schemes.
   :type lo: NDArray
   :param hi: an (d,) array (or list) of right endpoints, with hi > lo.
   :type hi: NDArray

   :returns: an (mxd_) array of coverage samples
   :rtype: u (NDArray)


.. py:function:: width(x: numpy.typing.NDArray) -> numpy.typing.NDArray

   :param x: an interval iterable, i.e. an (dx2) array
   :type x: NDArray

   :returns: the width of the intervals
   :rtype: w (NDArray)