Class SOLsurfaceBase

java.lang.Object
  |
  +--SOLsurfaceBase

Direct Known Subclasses:

SOLsurface

public class SOLsurfaceBase

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

  Field Summary

  double	area
  protected SOLlocation	location
  java.lang.String	name Name of object.
  protected SOLorientation	orientation
  double	rho Ground reflectance associated with this surface.

  Constructor Summary

  SOLsurfaceBase(SOLorientation orientation, double area, double rho, java.lang.String name)
  Create a SOLsurfaceBase object, given A SOLorientation 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.
  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.
  java.lang.String	getName()
  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

  Field Detail

  area

  public double area

  name

  public java.lang.String name

  Name of object. Useful when displaying multiple instances of SOLsurfaceBase.

  rho

  public double rho

  Ground reflectance associated with this surface. Between 0 and 1.

  orientation

  protected SOLorientation orientation

  location

  protected SOLlocation location

  Constructor Detail

  SOLsurfaceBase

  public SOLsurfaceBase(SOLorientation orientation,
                        double area,
                        double rho,
                        java.lang.String name)

  Create a SOLsurfaceBase object, given

  • A SOLorientation 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).

  getName

  public java.lang.String getName()

  getArea

  public double getArea()

  setArea

  public void setArea(double area)

  setRho

  public void setRho(double rho)