Module raytracer

Class Collector3d

All Implemented Interfaces:
Collector, Spectrum, DoubleToDouble, Serializable, Cloneable
Direct Known Subclasses:
Collector3dList

public class Collector3d extends Spectrum3d implements Collector, Serializable
This class stores some useful information about incoming rays of an corresponding object, which has received a certain ray. This class extended all properties of Spectrum3d. It means that this Collector is also a Spectrum.
Author:
Stephan Rogge
See Also:
  • Field Details

    • rayCount

      protected long rayCount
    • asCollector

      protected boolean asCollector
    • squareSumDirectionX

      protected double squareSumDirectionX
    • squareSumDirectionY

      protected double squareSumDirectionY
    • squareSumDirectionZ

      protected double squareSumDirectionZ
    • sumDirectionX

      protected double sumDirectionX
    • sumDirectionY

      protected double sumDirectionY
    • sumDirectionZ

      protected double sumDirectionZ
    • squareSumSpectrumX

      protected double squareSumSpectrumX
    • squareSumSpectrumY

      protected double squareSumSpectrumY
    • squareSumSpectrumZ

      protected double squareSumSpectrumZ
    • sumSpectrumX

      protected double sumSpectrumX
    • sumSpectrumY

      protected double sumSpectrumY
    • sumSpectrumZ

      protected double sumSpectrumZ
  • Constructor Details

    • Collector3d

      public Collector3d()
      Just a new instance of this class.
    • Collector3d

      public Collector3d(double x, double y, double z)
      This constructor creates a Collector-instance with a certain Spectrum.
      Parameters:
      x - Red-component of Spectrum3d
      y - Green-component of Spectrum3d
      z - Blue-component of Spectrum3d
    • Collector3d

      public Collector3d(Spectrum spectrum)
      This constructor creates a Collector-instance with a certain Spectrum.
      Parameters:
      spectrum - Spectrum, which is used by the LightModel
  • Method Details

    • newInstance

      public Collector3d newInstance()
      Returns a new instance of this class.
      Specified by:
      newInstance in interface Collector
      Specified by:
      newInstance in interface Spectrum
      Overrides:
      newInstance in class Spectrum3d
      Returns:
      new instance of same class
    • setAsCollector

      public void setAsCollector()
      The initial value of asCollector is false. It means that the collector works like a Spectrum. Thats useful when this Collector-instance is used for the calculations in LightModel.
      Specified by:
      setAsCollector in interface Collector
    • isCollector

      public boolean isCollector()
      If the collector should works like a Spectrum, this method returns false, otherwise true.
      Specified by:
      isCollector in interface Collector
      Returns:
    • add

      public void add(Spectrum spectrum)
      Add the newSpectrum to the spectrum of this Collector-instance and update the statistics.
      Specified by:
      add in interface Spectrum
      Overrides:
      add in class Spectrum3d
      Parameters:
      newSpectrum - New to added spectrum.
    • addToStatistic

      public void addToStatistic(Tuple3d rayOrigin, Spectrum spectrum, double scaleFactor, boolean isPrimary)
      Description copied from interface: Collector
      Here the information of LightModel computation are stored.
      Specified by:
      addToStatistic in interface Collector
      Parameters:
      rayOrigin - May this contains a certain vector (direction for example).
      spectrum - To added Spectrum.
      scaleFactor - For the added Spectrum.
      isPrimary - To distinguish from primary or secondary rays.
    • addToStatistic

      public void addToStatistic(Tuple3d rayOrigin, Spectrum3d spectrum, double scaleFactor, boolean isPrimary)
      Add the Vector of the origin of a certain ray, which hits the object for this corresponding Collector-instance. Notice: The direction and the weight of the direction doesn't depends on the absorbed power but on the intensity of the incoming ray.
      Parameters:
      rayOrigin - Where the light comes from.
      scale - The factor for weighting this direction (usually intensity of incoming light)
    • getSpectrumVariance

      public void getSpectrumVariance(Spectrum spectrum)
      This methods returns the variance of the spectrums. The calculation for this is: sigma^2 = 1/N * ((sum of all spectra^2) - (N * x^2)) N ... The number of rays x ... The arithmetic mean of all direction To get the standard deviation, just extract the root of the variance. For more information see .
      Specified by:
      getSpectrumVariance in interface Collector
    • getDirectionVariance

      public void getDirectionVariance(Tuple3d tuple)
      This methods returns the variance of the light-direction (not normalized). The calculation for this is: sigma^2 = 1/N * ((sum of all directions^2) - (N * x^2)) N ... The number of rays x ... The arithmetic mean of all direction To get the standard deviation, just extract the root of the variance. For more information see .
      Specified by:
      getDirectionVariance in interface Collector
    • getDirectionVariance

      public void getDirectionVariance(Tuple3f tuple)
    • getDirectionArithmeticMean

      public void getDirectionArithmeticMean(Tuple3d tuple)
      Set the arithmetic mean of all directions (not normalized) to vector. The parameter vector should be initialized before.
      Specified by:
      getDirectionArithmeticMean in interface Collector
      Parameters:
      vector - Returns the arithmetic mean of all direction for this Collector-instance.
    • getDirectionArithmeticMean

      public void getDirectionArithmeticMean(Tuple3f tuple)
    • getSpectrumArithmeticMean

      public void getSpectrumArithmeticMean(Spectrum spectrum)
      Set the arithmetic mean of all spectra to spectrum. The parameter spectrum should be initialized before.
      Specified by:
      getSpectrumArithmeticMean in interface Collector
      Parameters:
      spectrum - Returns the arithmetic mean of all spectra for this Collector-instance.
    • getRayCount

      public long getRayCount()
      Returns the number of rays which hit the corresponding object of this instance.
      Specified by:
      getRayCount in interface Collector
      Returns:
      Number of rays.
    • setZero

      public void setZero()
      Sets all values the instance to zero. Useful when the instance is still used as container for information/ results of the LightModel computation.
      Specified by:
      setZero in interface Spectrum
      Overrides:
      setZero in class Spectrum3d
    • normalize

      public static void normalize(Tuple3d t)
    • normalize

      public static void normalize(Tuple3f t)
    • add

      public void add(Collector col)
      To combine two Collector-instances. All values of col added to the values of this instance.
      Specified by:
      add in interface Collector
      Parameters:
      col - To added Collector-instance.
    • getCollectedValues

      public void getCollectedValues(Tuple3d sumDir, Tuple3d sumSquareDir, Tuple3d sumSpec, Tuple3d sumSquareSpec)
      Specified by:
      getCollectedValues in interface Collector
    • clone

      public Collector3d clone()
      Creates a copy of the Spectrum or a deep-copy of this instance.
      Specified by:
      clone in interface Collector
      Specified by:
      clone in interface Spectrum
      Overrides:
      clone in class Spectrum3d
      Returns:
      Copy of this instance.