ftran_dir_loc

Local uncollided transmission at lower boundary for direct illumination from finitesized sun


This is the transmission of light originating within the solar disc that traverses the canopy unhindered down to some reference x,y location (within the canopy scene) at a height level of 0.5 m above the background surface (it is thus similar to the direct transmission estimates of the TRAC instrument, for example). Three different transects of such direct transmissions are to be generated. To account for the physical size of the solar disc all incident directions that lie within 0.25 degree of the solar illumination direction are to be included in these local direct transmission estimates. Furthermore the flux density of the radiation is to be assumed uniform 1) across the solar disc and 2) across the top-of-canopy level of the RAMI scene of interest. The ftran_dir_loc measurement applies to all RAMI scenes that are at least 1 hectare in area (i.e., HOMOGENEOUS ABSTRACT canopies are thus excluded). More specifically, ftran_dir_loc prescribes three different transects located at a height of 0.5 metres within the canopy scene and composed of 1201 local direct transmission measurements carried out at 5 cm interval. In the hypothetical case that a given local transmission measurement point along the transect is actually situated within a tree trunk then obviously the resulting transmission is 0. The location of the three transects is as follows:

RAMI scenes that have the origin of the coordinate system in the lower left corner of the scene

  • Transect A: from x,y location 20,80 to 80,80 in intervals of 0.05 m
  • Transect B: from x,y location 20,50 to 80,50 in intervals of 0.05 m
  • Transect C: from x,y location 50,20 to 50,80 in intervals of 0.05 m

RAMI scenes that have the origin of the coordinate system in the center of the scene

  • Transect A: from x,y location −30,30 to 30,30 in intervals of 0.05 m
  • Transect B: from x,y location −30,0 to 30,0 in intervals of 0.05 m
  • Transect C: from x,y location 0,−30 to 0,30 in intervals of 0.05 m

The following graphics provide an overview of the concept of this measurements as well as the labelling of the various transects:

ftran_dir_loc transmission
ftran_dir_loc transmission
The reference plane
The reference plane.

Since ftran_dir_loc measurements are independent of wavelength, and in order to specify the transect location (A,B,C) within the filename itself, the RAMI file-naming convention will have to be adapted. please use the spectral tag to indicate the position of the fisheye camera as follows Therefore, please use the spectral tag to indicate the position of the transect as follows: two zeros followed by the letter indicating the location of the transect (e.g., 00A, 00B or 00C) in the measurement filename. This naming strategies then results in the following filenames, for example, HET07_JPS_SUM_00C_Z36A090-ftran_dir_loc_raytran.mes for a ftran_dir_loc measurement along transect C in the Jaervselja pine stand and HET07_JPS_SUM_00C_Z50A900-ftran_dir_loc_raytran.mes for a ftran_dir_loc measurement along transect A in the Wellington citrus orchard if the sun is located at a $\theta_i$=50 and has an $\phi_i$ of 90 degrees. Similarly, one should use HET07_JPS_SUM_00C_Z20A090-ftran_dir_loc_raytran.mes for the ftran_dir_loc measurement applied to transect B in the heterogeneous abstract canopy HET10_DIS_UNI with illumination conditions having an $\theta_i$ of 20 degrees.

Header line content Header line format
# rows in file (# of local transmission estimates) %4d
# columns in file %4d
height of transmission measurements [m] %.6f
Body lines content Body lines format
X coordinate of local transmission estimate [m] %.2f
Y coordinate of local transmission estimate [m] %.2f
ftran_dir_loc %.6f

The order in which the transmission values are to be reported in transects A and B is by starting with from the smallest X coordinate value and going towards the largest X coordinate value. For transect C one starts with the smallest Y coordinate value and moves towards the largest Y coordinate value.

Transect A in the case of a RAMI scene having the origin of the coordinate system near the center of the scene.

3603	3	0.500000
     
-30.00 80.00 0.668422
-29.95 80.00 0.192887
-29.90 80.00 0.068017
-29.85 80.00 0.122837
-29.80 80.00 0.284787
-29.75 80.00 0.172861
-29.70 80.00 0.107715
-29.65 80.00 0.897916
-29.60 80.00 0.342299
-29.55 80.00 0.415999
-29.50 80.00 0.414099
-29.45 80.00 0.411679
....
20.00 50.00 0.675000
20.05 50.00 0.649350
20.10 50.00 0.623699
20.15 50.00 0.598051
20.20 50.00 0.572400
20.25 50.00 0.546750
20.30 50.00 0.521100
20.35 50.00 0.513901
20.40 50.00 0.543599
20.45 50.00 0.573300
20.50 50.00 0.603000
20.55 50.00 0.632700
....
50.00 20.00 0.243000
50.00 20.05 0.256500
50.00 20.10 0.270000
50.00 20.15 0.283500
50.00 20.20 0.297000
50.00 20.25 0.310500
50.00 20.30 0.324000
50.00 20.35 0.199801
50.00 20.40 0.232199
50.00 20.45 0.264600
50.00 20.50 0.297000