org.jscience.earth
Class EarthSolarRadiation

java.lang.Object
  org.jscience.earth.EarthSolarRadiation

public class EarthSolarRadiation
extends java.lang.Object

This class represents a surface of specific area exposed to the sun. The SOLorientation object required by the constructor specifies the surface's orientation and location on Earth's surface. This object defines the area and ground reflectance.

It contains methods to calculate:

• diffuse irradiance
• diffuse radiation
• diffuse irradiance simple
• diffuse radiation simple
• ground reflected irradiance
• ground reflected radiation
• direct irradiance
• direct radiation
• total radiation

  Constructor Summary

  EarthSolarRadiation(EarthSurfaceOrientation direction, double area, double rho)
  Create a EarthSolarRadiation object, given A Direction object, The area of the surface (m²), The ground reflectance.

  Method Summary

  double	getArea()
  double	getDiffuseIrradiance(double Dh, double I, int daynum, int solar_time) Return diffuse irradiance on the surface, calculated according to Perez (1990) (in Watts/m2), given Diffuse Horizontal Irradiance (Dh), Direct Normal Irradiance (I), Day Number in the year (daynum), Elevation at the site.
  double	getDiffuseIrradianceSimple(double Dh) Return diffuse irradiance (in Watts/m2) by the simpler formula, Dh(cos2(tilt)), given Diffuse horizontal irradiance.
  double	getDiffuseRadiation(double Dh, double I, int daynum, int solar_time) Return diffuse radiation on the surface (in Watts), calculated according to Perez (1990), given Diffuse Horizontal Irradiance (Dh), Direct Normal Irradiance (I), Day Number in the year (daynum), Elevation at the site.
  double	getDiffuseRadiationSimple(double Dh) Return diffuse Radiation on the surface (in Watts) by the simpler formula, Dh(cos2(tilt)), given Diffuse horizontal irradiance.
  double	getDirectIrradiance(double I, int daynum, int solar_time) Return the direct irradiance on the surface (in W/m2), given Direct normal irradiance, Day number in the year.
  double	getDirectRadiation(double I, int daynum, int solar_time) Return the direct radiation on the surface (in Watts), given Direct normal irradiance, Day number in the year.
  EarthSurfaceOrientation	getEarthSurfaceOrientation()
  EarthSurfacePosition	getEarthSurfacePosition()
  double	getGroundReflectedIrradiance(double Ih) Return ground reflected irradiance on the surface (in Watts/m2), given The global horizontal irradiance (W/m2) The ground reflectance.
  double	getGroundReflectedRadiation(double Ih) Return ground reflected radiation on the surface, given The global horizontal irradiance (in Watts) The ground reflectance.
  double	getRho()
  double	getTotalIncidentRadiation(double Dh, double I, double Ih, int daynum, int solar_time) Return the total irradiance (Watts/m2) on the surface, given Diffuse horizontal irradiance (w/m2), Direct normal irradiance (w/m2), Global horizontal irradiance (w/m2), Day number in year,Elevation (meters).
  void	setArea(double area)
  void	setRho(double rho)

  Methods inherited from class java.lang.Object

  clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  Constructor Detail

  EarthSolarRadiation

  public EarthSolarRadiation(EarthSurfaceOrientation direction,
                             double area,
                             double rho)

  Create a EarthSolarRadiation object, given

  • A Direction object,
  • The area of the surface (m²),
  • The ground reflectance.

  Method Detail

  getDiffuseIrradiance

  public double getDiffuseIrradiance(double Dh,
                                     double I,
                                     int daynum,
                                     int solar_time)

  Return diffuse irradiance on the surface, calculated according to Perez (1990) (in Watts/m²), given

  • Diffuse Horizontal Irradiance (Dh),
  • Direct Normal Irradiance (I),
  • Day Number in the year (daynum),
  • Elevation at the site.

  getDiffuseRadiation

  public double getDiffuseRadiation(double Dh,
                                    double I,
                                    int daynum,
                                    int solar_time)

  Return diffuse radiation on the surface (in Watts), calculated according to Perez (1990), given

  • Diffuse Horizontal Irradiance (Dh),
  • Direct Normal Irradiance (I),
  • Day Number in the year (daynum),
  • Elevation at the site.

  getDiffuseIrradianceSimple

  public double getDiffuseIrradianceSimple(double Dh)

  Return diffuse irradiance (in Watts/m²) by the simpler formula, Dh(cos²(tilt)), given

  Diffuse horizontal irradiance.

  getDiffuseRadiationSimple

  public double getDiffuseRadiationSimple(double Dh)

  Return diffuse Radiation on the surface (in Watts) by the simpler formula, Dh(cos²(tilt)), given

  Diffuse horizontal irradiance.

  getGroundReflectedIrradiance

  public double getGroundReflectedIrradiance(double Ih)

  Return ground reflected irradiance on the surface (in Watts/m²), given

  • The global horizontal irradiance (W/m²)
  • The ground reflectance.

  getGroundReflectedRadiation

  public double getGroundReflectedRadiation(double Ih)

  Return ground reflected radiation on the surface, given

  • The global horizontal irradiance (in Watts)
  • The ground reflectance.

  getDirectIrradiance

  public double getDirectIrradiance(double I,
                                    int daynum,
                                    int solar_time)

  Return the direct irradiance on the surface (in W/m²), given

  • Direct normal irradiance,
  • Day number in the year.

  getDirectRadiation

  public double getDirectRadiation(double I,
                                   int daynum,
                                   int solar_time)

  Return the direct radiation on the surface (in Watts), given

  • Direct normal irradiance,
  • Day number in the year.

  getTotalIncidentRadiation

  public double getTotalIncidentRadiation(double Dh,
                                          double I,
                                          double Ih,
                                          int daynum,
                                          int solar_time)

  Return the total irradiance (Watts/m²) on the surface, given

  • Diffuse horizontal irradiance (w/m²),
  • Direct normal irradiance (w/m²),
  • Global horizontal irradiance (w/m²),
  • Day number in year,
  • Elevation (meters).

  getArea

  public double getArea()

  setArea

  public void setArea(double area)

  getEarthSurfacePosition

  public EarthSurfacePosition getEarthSurfacePosition()

  getEarthSurfaceOrientation

  public EarthSurfaceOrientation getEarthSurfaceOrientation()

  getRho

  public double getRho()

  setRho

  public void setRho(double rho)