ICloud3D
hep.aida

Interface ICloud3D

    • Method Summary

      Methods 
      Modifier and TypeMethod and Description
      voidconvert(double[] binEdgesX, double[] binEdgesY, double[] binEdgesZ)
      Convert internally the ICloud3D to an IHistogram3D with given bin edges.
      voidconvert(int nBinsX, double lowerEdgeX, double upperEdgeX, int nBinsY, double lowerEdgeY, double upperEdgeY, int nBinsZ, double lowerEdgeZ, double upperEdgeZ)
      Convert internally the ICloud3D to an IHistogram3D with given number of bins, upper edge and lower edge.
      voidfill(double x, double y, double z)
      Fill the ICloud3D with a triplet of values and a corresponding weight.
      voidfill(double x, double y, double z, double weight)
      Fill the ICloud3D with a triplet of values and a corresponding weight.
      voidfillHistogram(IHistogram3D hist)
      Project the ICloud3D on an IHistogram3D.
      IHistogram3Dhistogram()
      Get the internal IHistogram3D in which the ICloud3D converted to.
      doublelowerEdgeX()
      Get the lower edge of the ICloud3D along the x axis.
      doublelowerEdgeY()
      Get the lower edge of the ICloud3D along the y axis.
      doublelowerEdgeZ()
      Get the lower edge of the ICloud3D along the z axis.
      doublemeanX()
      Get the mean of the ICloud3D along the x axis.
      doublemeanY()
      Get the mean of the ICloud3D along the y axis.
      doublemeanZ()
      Get the mean of the ICloud3D along the z axis.
      doublermsX()
      Get the RMS of the ICloud3D along the x axis.
      doublermsY()
      Get the RMS of the ICloud3D along the y axis.
      doublermsZ()
      Get the RMS of the ICloud3D along the z axis.
      voidsetConversionParameters(int binsX, double lowerEdgeX, double upperEdgeX, int binsY, double lowerEdgeY, double upperEdgeY, int binsZ, double lowerEdgeZ, double upperEdgeZ)
      Set the parameters for the ICloud conversion to an IHistogram.
      doubleupperEdgeX()
      Get the upper edge of the ICloud3D along the x axis.
      doubleupperEdgeY()
      Get the upper edge of the ICloud3D along the y axis.
      doubleupperEdgeZ()
      Get the upper edge of the ICloud3D along the z axis.
      doublevalueX(int index)
      Get the x value corresponding to a given entry.
      doublevalueY(int index)
      Get the y value corresponding to a given entry.
      doublevalueZ(int index)
      Get the z value corresponding to a given entry.
      doubleweight(int index)
      Get the weight corresponding to a given entry.
    • Method Detail

      • fill

        void fill(double x,        double y,        double z)          throws IllegalArgumentException
        Fill the ICloud3D with a triplet of values and a corresponding weight. If either a coordinate or the weight is NaN the entry will be recorded but it will not contribue to the statistics.
        Parameters:
        x - The x value.
        y - The y value.
        z - The z value.
        Throws:
        IllegalArgumentException - If the ICloud3D is full or if the weight's value is not between 0 and 1.
      • fill

        void fill(double x,        double y,        double z,        double weight)          throws IllegalArgumentException
        Fill the ICloud3D with a triplet of values and a corresponding weight. If either a coordinate or the weight is NaN the entry will be recorded but it will not contribue to the statistics.
        Parameters:
        x - The x value.
        y - The y value.
        z - The z value.
        weight - The corresponding weight. By default it is 1.
        Throws:
        IllegalArgumentException - If the ICloud3D is full or if the weight's value is not between 0 and 1.
      • lowerEdgeX

        double lowerEdgeX()
        Get the lower edge of the ICloud3D along the x axis.
        Returns:
        The lower edge along the x axis.
      • lowerEdgeY

        double lowerEdgeY()
        Get the lower edge of the ICloud3D along the y axis.
        Returns:
        The lower edge along the y axis.
      • lowerEdgeZ

        double lowerEdgeZ()
        Get the lower edge of the ICloud3D along the z axis.
        Returns:
        The lower edge along the z axis.
      • upperEdgeX

        double upperEdgeX()
        Get the upper edge of the ICloud3D along the x axis.
        Returns:
        The upper edge along the x axis.
      • upperEdgeY

        double upperEdgeY()
        Get the upper edge of the ICloud3D along the y axis.
        Returns:
        The upper edge along the y axis.
      • upperEdgeZ

        double upperEdgeZ()
        Get the upper edge of the ICloud3D along the z axis.
        Returns:
        The upper edge along the z axis.
      • valueX

        double valueX(int index)              throws AlreadyConvertedException
        Get the x value corresponding to a given entry.
        Parameters:
        index - The entry's index.
        Returns:
        The x value of the index-th entry.
        Throws:
        AlreadyConvertedException - If the ICloud3D has already been converted.
      • valueY

        double valueY(int index)              throws AlreadyConvertedException
        Get the y value corresponding to a given entry.
        Parameters:
        index - The entry's index.
        Returns:
        The y value of the index-th entry.
        Throws:
        AlreadyConvertedException - If the ICloud3D has already been converted.
      • valueZ

        double valueZ(int index)              throws AlreadyConvertedException
        Get the z value corresponding to a given entry.
        Parameters:
        index - The entry's index.
        Returns:
        The z value of the index-th entry.
        Throws:
        AlreadyConvertedException - If the ICloud3D has already been converted.
      • weight

        double weight(int index)              throws AlreadyConvertedException
        Get the weight corresponding to a given entry.
        Parameters:
        index - The entry's index.
        Returns:
        The weight of the index-th entry.
        Throws:
        AlreadyConvertedException - If the ICloud has already been converted.
      • meanX

        double meanX()
        Get the mean of the ICloud3D along the x axis.
        Returns:
        The mean along the x axis.
      • meanY

        double meanY()
        Get the mean of the ICloud3D along the y axis.
        Returns:
        The mean along the y axis.
      • meanZ

        double meanZ()
        Get the mean of the ICloud3D along the z axis.
        Returns:
        The mean along the z axis.
      • rmsX

        double rmsX()
        Get the RMS of the ICloud3D along the x axis.
        Returns:
        The RMS along the x axis.
      • rmsY

        double rmsY()
        Get the RMS of the ICloud3D along the y axis.
        Returns:
        The RMS along the y axis.
      • rmsZ

        double rmsZ()
        Get the RMS of the ICloud3D along the z axis.
        Returns:
        The RMS along the z axis.
      • convert

        void convert(int nBinsX,           double lowerEdgeX,           double upperEdgeX,           int nBinsY,           double lowerEdgeY,           double upperEdgeY,           int nBinsZ,           double lowerEdgeZ,           double upperEdgeZ)             throws AlreadyConvertedException
        Convert internally the ICloud3D to an IHistogram3D with given number of bins, upper edge and lower edge.
        Parameters:
        nBinsX - The number of bins of the x axis.
        lowerEdgeX - The lower edge of bins of the x axis.
        upperEdgeX - The upper edge of bins of the x axis.
        nBinsY - The number of bins of the y axis.
        lowerEdgeY - The lower edge of bins of the y axis.
        upperEdgeY - The upper edge of bins of the y axis.
        nBinsZ - The number of bins of the z axis.
        lowerEdgeZ - The lower edge of bins of the z axis.
        upperEdgeZ - The upper edge of bins of the z axis.
        Throws:
        AlreadyConvertedException - If the ICloud3D has already been converted.
      • convert

        void convert(double[] binEdgesX,           double[] binEdgesY,           double[] binEdgesZ)             throws AlreadyConvertedException
        Convert internally the ICloud3D to an IHistogram3D with given bin edges.
        Parameters:
        binEdgesX - The bins edges of the x axis.
        binEdgesY - The bins edges of the y axis.
        binEdgesZ - The bins edges of the z axis.
        Throws:
        AlreadyConvertedException - If the ICloud3D has already been converted.
      • histogram

        IHistogram3D histogram()                       throws RuntimeException
        Get the internal IHistogram3D in which the ICloud3D converted to.
        Returns:
        The histogram.
        Throws:
        RuntimeException - If the ICloud3D did not convert either automatically or because of a convert() method invocation.
      • fillHistogram

        void fillHistogram(IHistogram3D hist)                   throws RuntimeException
        Project the ICloud3D on an IHistogram3D.
        Parameters:
        hist - The IHistogram3D to be filled.
        Throws:
        RuntimeException - If the ICloud3D is already converted.
      • setConversionParameters

        void setConversionParameters(int binsX,                           double lowerEdgeX,                           double upperEdgeX,                           int binsY,                           double lowerEdgeY,                           double upperEdgeY,                           int binsZ,                           double lowerEdgeZ,                           double upperEdgeZ)                             throws IllegalArgumentException
        Set the parameters for the ICloud conversion to an IHistogram.
        Parameters:
        binsX - The X axis number of bins of the conversion IHistogram.
        lowerEdgeX - The X axis lower edge of the conversion IHistogram.
        upperEdgeX - The X axis upper edge of the conversion IHistogram.
        binsY - The Y axis number of bins of the conversion IHistogram.
        lowerEdgeY - The Y axis lower edge of the conversion IHistogram.
        upperEdgeY - The Y axis upper edge of the conversion IHistogram.
        binsZ - The Z axis number of bins of the conversion IHistogram.
        lowerEdgeZ - The Z axis lower edge of the conversion IHistogram.
        upperEdgeZ - The Z axis upper edge of the conversion IHistogram.
        Throws:
        IllegalArgumentException

SCaVis 1.8 © jWork.org