org.jscience.earth
Class EarthSurfaceOrientation

java.lang.Object
  org.jscience.earth.EarthSurfaceOrientation

public class EarthSurfaceOrientation
extends java.lang.Object

This class represents the orientation of a surface exposed to sunlight. Its class variables define the surface's position on Earth (a EarthSurfacePosition object) and orientation. Its methods calculate the angle of incidence of sunlight falling on it.

Constructor Summary

EarthSurfaceOrientation(EarthSurfacePosition location, double surface_azimuth, double surface_tilt)

Create an EarthSurfaceOrientation object, which represents the orientation of a surface exposed to sunlight.

Method Summary

double	getCosTheta(int daynum, int solar_time) Returns cosine of angle between solar radiation and normal to surface, given solar time, in seconds, and day number.
EarthSurfacePosition	getEarthSurfacePosition() DOCUMENT ME!
double	getSurfaceAzimuth()
double	getSurfaceTilt()
double	getTheta(int daynum, int solar_time) Returns angle between solar radiation and normal to surface, given solar time, in seconds, and day number.

Methods inherited from class java.lang.Object

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

Constructor Detail

EarthSurfaceOrientation

public EarthSurfaceOrientation(EarthSurfacePosition location,
                               double surface_azimuth,
                               double surface_tilt)

Create an EarthSurfaceOrientation object, which represents the orientation of a surface exposed to sunlight. The parameters defining the orientation are:

• a EarthSurfacePosition object, specifying the surface's location on Earth,
• surface azimuth(in degrees) - measured from South, with Eastward deviation negative and Westward deviation positive,
• and its surface tilt from the horizontal (in degrees).

Parameters:

location - DOCUMENT ME!

surface_azimuth - DOCUMENT ME!

surface_tilt - DOCUMENT ME!

Method Detail

getCosTheta

public double getCosTheta(int daynum,
                          int solar_time)

Returns cosine of angle between solar radiation and normal to surface, given solar time, in seconds, and day number.

Parameters:

daynum - DOCUMENT ME!

solar_time - DOCUMENT ME!

Returns:

DOCUMENT ME!

getTheta

public double getTheta(int daynum,
                       int solar_time)

Returns angle between solar radiation and normal to surface, given solar time, in seconds, and day number.

Parameters:

daynum - DOCUMENT ME!

solar_time - DOCUMENT ME!

Returns:

DOCUMENT ME!

getEarthSurfacePosition

public EarthSurfacePosition getEarthSurfacePosition()

DOCUMENT ME!

Returns:

DOCUMENT ME!

getSurfaceAzimuth

public double getSurfaceAzimuth()

getSurfaceTilt

public double getSurfaceTilt()