Package com.flir.thermalsdk.image

Class ImageParameters

java.lang.Object
com.flir.thermalsdk.image.ImageParameters
public final class ImageParameters extends Object
Defines the parameters of an environment, where the ThermalImage was taken. These parameters define, how to interpret the Thermal data. They have impact on the measured temperature and as such should be defined very carefully. Setting the right value of parameters defined in this class is the first step to get the right measurements on ThermalImage.

There are several parameters to set. The most important are reflected temperature and emissivity. They define, how much heat object emits. The reflected temperature should be measured first, then emissivity. Other parameters can be measured afterwards. They do not have such big impact on the temperature's value, but allow fine adjustments.

All available parameters are:
  1. Reflected temperature is a parameter used to compensate for the radiation reflected in the object. If the emissivity is low and the object's temperature relatively far from that of the reflected, it will be important to set and compensate for the reflected apparent temperature correctly.
  2. Emissivity is a value between 0 and 1 that specifies how much radiation an object emits, compared to the radiation of a theoretical reference object of the same temperature (called a 'black body').
  3. Atmospheric temperature is a temperature of an atmosphere surrounding the camera. 'The atmosphere' is the medium between the object being measured and the camera, normally air.
  4. Distance is a numerical description of how far apart objects are.
  5. External optics temperature is a temperature of an external accessory attached to the Thermal camera. It is used to compensate for optical accessory, such as a heat shield or a macro lenses. External optics will absorb some of the radiation.
  6. External optics transmission defines the amplitude, intensity, or total power of a transmitted wave relative to an incident wave. Used to compensate for optical accessory, such as a heat shield or a macro lenses. External optics will absorb some of the radiation.
  7. Reference temperature is a temperature, which the ordinary measured values can be compared with.
  8. Relative humidity is a term used to describe the amount of water vapor that exists in a gaseous mixture of air and water.
  9. Transmission is the amplitude, intensity, or total power of a transmitted wave relative to an incident wave. Defines how well the atmosphere transmits the heat.

  • Method Details

    • getAtmosphericTemperature

      public ThermalValue getAtmosphericTemperature()
      Gets an atmospheric temperature.

      'The atmosphere' is the medium between the object being measured and the camera, normally air.

      Returns:
      an atmospheric temperature.

    • setAtmosphericTemperature

      public void setAtmosphericTemperature(ThermalValue atmosphericTemperature)
      Sets an atmospheric temperature.
      Parameters:
      atmosphericTemperature - an atmospheric temperature to set.
      See Also:

    • getDistance

      public double getDistance()
      Gets a distance from camera to focused object in currently set DistanceUnit.
      Returns:
      a distance from camera to focused object in currently set DistanceUnit.
      See Also:

    • setDistance

      public void setDistance(double distance)
      Sets a distance from camera to focused object in currently set DistanceUnit.
      Parameters:
      distance - a distance from camera to focused object in currently set DistanceUnit.
      See Also:

    • getEmissivity

      public double getEmissivity()
      Gets a default emissivity for the Thermal Image.

      Emissivity is a value between 0 and 1 that specifies how much radiation an object emits, compared to the radiation of a theoretical reference object of the same temperature (called a 'black body').

      Returns:
      a default emissivity for the Thermal Image.

    • setEmissivity

      public void setEmissivity(double emissivity)
      Sets a default emissivity for the Thermal Image.
      Parameters:
      emissivity - a default emissivity for the Thermal Image to set.
      See Also:

    • getExternalOpticsTemperature

      public ThermalValue getExternalOpticsTemperature()
      Gets an external optics temperature.

      Used to compensate for optical accessory, such as a heat shield or a macro lenses. External optics will absorb some of the radiation. Use setExternalOpticsTemperature(ThermalValue) and setExternalOpticsTransmission(double) to correct for this effect.

      Returns:
      an external optics temperature.

    • setExternalOpticsTemperature

      public void setExternalOpticsTemperature(ThermalValue externalOpticsTemperature)
      Sets an external optics temperature.
      Parameters:
      externalOpticsTemperature - an external optics temperature to set.
      See Also:

    • getExternalOpticsTransmission

      public double getExternalOpticsTransmission()
      Gets an external optics transmission.

      Used to compensate for optical accessory, such as a heat shield or a macro lenses. External optics will absorb some of the radiation. Use setExternalOpticsTemperature(ThermalValue) and setExternalOpticsTransmission(double) to correct for this effect.

      Returns:
      an external optics transmission.

    • setExternalOpticsTransmission

      public void setExternalOpticsTransmission(double externalOpticsTransmission)
      Sets an external optics transmission.
      Parameters:
      externalOpticsTransmission - an external optics transmission to set.
      See Also:

    • getReflectedTemperature

      public ThermalValue getReflectedTemperature()
      Gets a reflected temperature.

      This parameter is used to compensate for the radiation reflected in the object. If the emissivity is low and the object temperature relatively far from that of the reflected it will be important to set and compensate for the reflected apparent temperature correctly.

      Returns:
      a reflected temperature.

    • setReflectedTemperature

      public void setReflectedTemperature(ThermalValue reflectedTemperature)
      Sets a reflected temperature.
      Parameters:
      reflectedTemperature - a reflected temperature to set.
      See Also:

    • getRelativeHumidity

      public double getRelativeHumidity()
      Gets a relative humidity in range (0.0 - 1.0).

      Relative humidity is a term used to describe the amount of water vapor that exists in a gaseous mixture of air and water.

      Returns:
      a relative humidity.

    • setRelativeHumidity

      public void setRelativeHumidity(double relativeHumidity)
      Sets a relative humidity in range (0.0 - 1.0).
      Parameters:
      relativeHumidity - a relative humidity to set.
      See Also:

    • getTransmission

      public double getTransmission()
      Gets an atmospheric transmission.

      'The atmosphere' is the medium between the object being measured and the camera, normally air. Specify the transmission of, e.g., an external lens or heat shield.

      Returns:
      an atmospheric transmission.

    • setTransmission

      public void setTransmission(double transmission)
      Sets an atmospheric transmission.
      Parameters:
      transmission - an atmospheric transmission to set.
      See Also:

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object