de.grogra.lignum.sky

Class FirmamentNode

java.lang.Object

de.grogra.graph.impl.Edge

de.grogra.graph.impl.Node

de.grogra.imp3d.objects.Null

de.grogra.imp3d.objects.ShadedNull

de.grogra.blocks.NullWithShaderNode

de.grogra.lignum.sky.FirmamentNode

All Implemented Interfaces:

Transformation, Pickable, Renderable, Manageable, PersistenceCapable, Shareable, UserFields, XObject, Map, Instantiator<Instantiation>, java.io.Serializable

public class FirmamentNode
extends NullWithShaderNode
implements Instantiator<Instantiation>

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class de.grogra.graph.impl.Node

Node.AccessorBridge, Node.FieldAttributeAccessor, Node.NType

Nested classes/interfaces inherited from interface de.grogra.util.Map

Map.Chain

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Vector<java.lang.Double>	areasByInclination
protected java.util.Vector<java.lang.Integer>	azimDivisions
protected java.util.Vector<java.lang.Integer>	azimuthIndex
protected double	deltaIncl
protected GMatrix	diffuseRad
protected double	diffuseRadBall
protected double	diffuseRadPlane
protected double	diffuseRadScale
protected double	diffuseRadZenith
protected java.util.Vector<java.lang.Double>	dir_x
protected java.util.Vector<java.lang.Double>	dir_y
protected java.util.Vector<java.lang.Double>	dir_z
protected double	directRadPlane
protected double	halfDeltaIncl
protected java.util.Vector<java.lang.Integer>	inclinationIndex
protected java.util.Vector<java.lang.Double>	inclinations
protected int	num_of_azim
protected static int	NUM_OF_AZIM
protected int	num_of_incl
protected static int	NUM_OF_INCL
protected int	numOfSectors
protected double	standDensity
protected java.util.Vector<java.lang.Double>	sunPosition
protected double	thetZ
protected GMatrix	zoneAzims

Fields inherited from class de.grogra.blocks.NullWithShaderNode

$TYPE

Fields inherited from class de.grogra.imp3d.objects.ShadedNull

INFINITE_MASK, interior, interior$FIELD, shader, shader$FIELD, treatedAsInfinite$FIELD, USED_BITS

Fields inherited from class de.grogra.imp3d.objects.Null

transform, transform$FIELD, TRANSFORMING_MASK, transforming$FIELD

Fields inherited from class de.grogra.graph.impl.Node

ADDITIONAL_FIELDS, bits, DELETED, EXTENT_BIT, EXTENT_MASK, extentIndex$FIELD, extentTail$FIELD, HAS_OBSERVERS, IS_INTERPRETIVE, isInterpretive$FIELD, LAST_EXTENT_INDEX, layer$FIELD, MARK, mark$FIELD, MIME_TYPE, MIN_UNUSED_SPECIAL_OF_SOURCE, MIN_UNUSED_SPECIAL_OF_TARGET, name$FIELD

Fields inherited from interface de.grogra.util.Map

DEFAULT_VALUE, EMPTY_MAP

Constructor Summary

Constructors

Constructor and Description
FirmamentNode()
FirmamentNode(int no_incl, int no_azim)

Method Summary

Methods

Modifier and Type	Method and Description
double	diffuseBallSensor()
double	diffuseForestRegionRadiationSum(int n, double z, double x, double la, double ke, double H, double Hc, java.util.Vector<java.lang.Double> direction, double dens) This method calculates the radiation reaching a segment in a tree that is growing in a stand among identical trees (dens trees/ha).
double	diffuseHalfRegionRadiationSum(int n, java.util.Vector<java.lang.Double> direction)
double	diffusePlaneSensor()
double	diffuseRadiationSum(java.util.Vector<java.lang.Double> direction)
double	diffuseRegionRadiationSum(int n, java.util.Vector<java.lang.Double> direction)
double	directHalfRegionRadiationSum(int n, java.util.Vector<java.lang.Double> direction)
double	directRadiation(java.util.Vector<java.lang.Double> direction) returns the intensity of the direct (sun) radiation on the plane perpendicular to the dirction of the sun (return) direction of the sun (in vector direction) Obs, sunPosition[2] = sin(iclination)
int	getAzimDivision(int n)
double	getAzimuth(int n)
int	getAzimuthIndex(int n)
Vector3d	getDirection(int n)
double	getInclination(int n)
int	getInclinationIndex(int n)
Instantiator	getInstantiator()
int	getNoOfAzimuths()
int	getNoOfInclinations()
double	getSectorArea(int n)
java.util.Vector<java.lang.Double>	getSunPosition()
void	instantiate(Instantiation state)
int	numberOfRegions()
void	outInclinations()
void	resize(int no_incl, int no_azim, double diffuse_rad_plane)
void	setDiffuseRadiation(double rad) Sets the radiation of sectors to correspond input.
void	setDirectRadiation(double rad)
void	setSunPosition(java.util.Vector<java.lang.Double> v) Sets the the vector of Firmament that points to the sun v declared const in cLignum

Methods inherited from class de.grogra.blocks.NullWithShaderNode

draw, getNTypeImpl, newInstance, pick

Methods inherited from class de.grogra.imp3d.objects.ShadedNull

getInterior, getShader, getSurfaceArea, getSymbolColor, getVolume, isTreatedAsInfinite, setBackShader, setColor, setColor, setFrontShader, setInterior, setMaterial, setShader, setShaders, setTreatedAsInfinite

Methods inherited from class de.grogra.imp3d.objects.Null

getLocalTransformation, getTransform, getTranslation, isTransforming, postTransform, preTransform, setRotation, setScale, setTransform, setTransform, setTransform, setTransform, setTransform, setTransform, setTransform, setTransform, setTransforming, setTranslation

Methods inherited from class de.grogra.graph.impl.Node

addEdgeBitsTo, addReference, appendBranchNode, appendBranchNode, appendReferencesTo, clone, clone, cloneGraph, dump, dumpTree, dup, dupUnmanagedFields, edgeChanged, fieldModified, findAdjacent, findRefinementType, get, getAccessor, getAccessor, getAttributes, getAxisParent, getBoolean, getBranch, getBranchLength, getBranchNode, getBranchTail, getByte, getChar, getCommonAncestor, getCurrentGraphState, getDirectChildCount, getDouble, getEdgeAttributeAccessor, getEdgeAttributes, getEdgeBitsTo, getEdgeTo, getExtentIndex, getFirst, getFirstEdge, getFloat, getGraph, getId, getIndex, getInt, getLayer, getLong, getManageableType, getName, getNeighbor, getNext, getNType, getObject, getOrCreateEdgeTo, getOrNull, getPersistenceManager, getPredecessor, getProvider, getShort, getSource, getStamp, getSuccessor, getSymbol, getTarget, getTransaction, getUserField, getUserFieldCount, getXClass, getXData, hasName, initProvider, initXClass, insertBranchNode, insertBranchNode, instantiateGraph, isAncestorOf, isDirection, isEncoarseOf, isManagingInstance, isMarked, isRoot, isSource, isTarget, manageableReadResolve, manageableWriteReplace, paramString, removeAll, removeEdgeBitsTo, removeFromChain, removeFromChain, removeReference, setBranch, setBranch, setExtentIndex, setGraphForDeserialization, setLayer, setMark, setName, setSuccessor, setSuccessor, specialEdgeAdded, specialEdgeRefModified, specialEdgeRemoved, toString, writeReplace

Methods inherited from class de.grogra.graph.impl.Edge

addEdgeBits, getBitMark, getEdgeBits, getObjectMark, getSpecialEdgeDescriptor, parseEdgeKeys, remove, removeEdgeBits, setBitMark, setEdgeBits, setObjectMark, testEdgeBits

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.grogra.persistence.PersistenceCapable

getBitMark, getObjectMark, setBitMark, setObjectMark

Field Detail

areasByInclination

protected java.util.Vector<java.lang.Double> areasByInclination

azimDivisions

protected java.util.Vector<java.lang.Integer> azimDivisions

azimuthIndex

protected java.util.Vector<java.lang.Integer> azimuthIndex

deltaIncl

protected double deltaIncl

diffuseRad

protected GMatrix diffuseRad

diffuseRadBall

protected double diffuseRadBall

diffuseRadPlane

protected double diffuseRadPlane

diffuseRadScale

protected double diffuseRadScale

diffuseRadZenith

protected double diffuseRadZenith

dir_x

protected java.util.Vector<java.lang.Double> dir_x

dir_y

protected java.util.Vector<java.lang.Double> dir_y

dir_z

protected java.util.Vector<java.lang.Double> dir_z

directRadPlane

protected double directRadPlane

halfDeltaIncl

protected double halfDeltaIncl

inclinationIndex

protected java.util.Vector<java.lang.Integer> inclinationIndex

inclinations

protected java.util.Vector<java.lang.Double> inclinations

num_of_azim

protected int num_of_azim

NUM_OF_AZIM

protected static int NUM_OF_AZIM

num_of_incl

protected int num_of_incl

NUM_OF_INCL

protected static int NUM_OF_INCL

numOfSectors

protected int numOfSectors

standDensity

protected double standDensity

sunPosition

protected java.util.Vector<java.lang.Double> sunPosition

thetZ

protected double thetZ

zoneAzims

protected GMatrix zoneAzims

Constructor Detail

FirmamentNode

public FirmamentNode()

FirmamentNode

public FirmamentNode(int no_incl,
             int no_azim)

Method Detail

diffuseBallSensor

public double diffuseBallSensor()

diffuseForestRegionRadiationSum

public double diffuseForestRegionRadiationSum(int n,
                                     double z,
                                     double x,
                                     double la,
                                     double ke,
                                     double H,
                                     double Hc,
                                     java.util.Vector<java.lang.Double> direction,
                                     double dens)

This method calculates the radiation reaching a segment in a tree that is growing in a stand among identical trees (dens trees/ha). The idea here is that the tree grows in a "hole" in the stand. The "hole" is a circular cylinder, the gross-sectional area of which is 10000/dens m2 and height equal to tree height. Outside this "hole" the foliage area (calculated with the aid of tree's leaf area and dens) is evenly distributed in the crown volume (leaf area density) that is between top height and the height of the crown base. The shading caused by the surrounding stand depends on the distance light beam travels in the stand volume on its way from a point in the sky to the segment: traveled distance * leaf area density * extinction coefficient ( extinction coefficient = 0.14 for Scots pine) The radiation coming from a point in the sky (sector) is obtained from method Firmament::regionRadiationSum(int n, vector& direction). Both height of the segment and its distance from the tree stem affect the path lenght in the surrounding canopy. The path length of the beam inside the canopy depends on the height it hits the mantle of the "hole". Since the the segment is not in the middle of the (bottom) circle of the "hole", the distance the beam travels inside the "hole" and consequently the height at which it hits the wall depends on the direction of the beam. This effect is treated here in an average manner. For all azimuthal directions of the coming beam the mean distance from a point (inside the circle) to the circumference of it is used in calculations. It seems that as an fairly accurate approximation mean distance = r*(1 - 0.35*(x/r)^2.5), where r is the radius of the circle and x is the distance of the point from center of the circle (0 <= x <= r).

Parameters:

n - number of region

z - height of the point from ground, m

x - distance of the point from the tree stem, m

la - needle area (total area) per tree (= sf * Wf), m2

ke - extinction cofficient (= 0.14 for Scots pine), unitless

H - height of tree (h. of stand), m

Hc - height of the crown base of the tree (stand), m

direction -

dens - Density of the stand (trees/ha)

Returns:

The annual radiation sum (MJ) from the nth region of the firmament as shaded by the neighboring stand direction the direction of nth region, If n < 0 or n > total number of regions - 1, return -1.0

diffuseHalfRegionRadiationSum

public double diffuseHalfRegionRadiationSum(int n,
                                   java.util.Vector<java.lang.Double> direction)

diffusePlaneSensor

public double diffusePlaneSensor()

diffuseRadiationSum

public double diffuseRadiationSum(java.util.Vector<java.lang.Double> direction)

diffuseRegionRadiationSum

public double diffuseRegionRadiationSum(int n,
                               java.util.Vector<java.lang.Double> direction)

directHalfRegionRadiationSum

public double directHalfRegionRadiationSum(int n,
                                  java.util.Vector<java.lang.Double> direction)

directRadiation

public double directRadiation(java.util.Vector<java.lang.Double> direction)

returns the intensity of the direct (sun) radiation on the plane perpendicular to the dirction of the sun (return) direction of the sun (in vector direction) Obs, sunPosition[2] = sin(iclination)

Parameters:

direction -

Returns:

Method returns type MJ in cLignum

getAzimDivision

public int getAzimDivision(int n)

getAzimuth

public double getAzimuth(int n)

getAzimuthIndex

public int getAzimuthIndex(int n)

getDirection

public Vector3d getDirection(int n)

getInclination

public double getInclination(int n)

getInclinationIndex

public int getInclinationIndex(int n)

getInstantiator

public Instantiator getInstantiator()

Overrides:

getInstantiator in class Node

getNoOfAzimuths

public int getNoOfAzimuths()

getNoOfInclinations

public int getNoOfInclinations()

getSectorArea

public double getSectorArea(int n)

getSunPosition

public java.util.Vector<java.lang.Double> getSunPosition()

instantiate

public void instantiate(Instantiation state)

Specified by:

instantiate in interface Instantiator<Instantiation>

numberOfRegions

public int numberOfRegions()

outInclinations

public void outInclinations()

resize

public void resize(int no_incl,
          int no_azim,
          double diffuse_rad_plane)

setDiffuseRadiation

public void setDiffuseRadiation(double rad)

Sets the radiation of sectors to correspond input. Updates also diffuseRadPlane, diffuseRadBall, diffuseRadZenith -variables

Parameters:

rad - , Diffuse radiation falling on a horizontal plane

setDirectRadiation

public void setDirectRadiation(double rad)

setSunPosition

public void setSunPosition(java.util.Vector<java.lang.Double> v)

Sets the the vector of Firmament that points to the sun v declared const in cLignum

Parameters:

v - Vector pointing to sun