― Manual of RGBFisheye.

exe―

A application software for automatic calculation of diffuse transmittance

(%PPFD) with hemispherical photographs

2005. 3

Megumi Ishida

Center of Educational research in Field Science,

Gifu Faculty of Applied Biological Science

1-1 Yanagido, Gifu, 501-1193, Japan

http://www.gifu-u.ac.jp/~ishidam/RGBFisheye.htm

e-mail: ishidam@cc.gifu-u.ac.jp
 Index
Summary.........................................................................................................................................2
1.Exposure setting based on the luminance of sky zenith (procedure of AE-Lock method ) ....3
2. How to use RGBFisheye ................................................................................................................4
2-1. Operating requirements..........................................................................................................4
2-2. Selection of image files .........................................................................................................5
2-3. Trimming of the hemispherical photographs ......................................................................5
2-4. Start the calculation .............................................................................................................6
2-5. Save the results of the calculation .......................................................................................6
2-6. Calculation with manual thresholding ................................................................................8
2-7. Menu......................................................................................................................................8
2-8. Trouble shooting .................................................................................................................10
Histograms of pixels are pectinate (comb-like) and calculation results are abnormal. ................10
Spinal noise pattern occurs at the low level of the histograms and calculation results are
abnormal...........................................................................................................................................11
Acknowledgements .......................................................................................................................12
References .....................................................................................................................................12

“RGBFisheye.exe” is a application software for automatic calculation of diffuse transmittance

(%PPFD) from digital hemispherical photographs taken with exposure setting based on the
luminance of the zenith of the sky. See accompanying paper about the details of the
automatic thresholding.

ISHIDA M.(2004)Automatic thresholding for digital hemispherical photography. Canadian

Journal of Forest Research: 34(11): 2208-2216

1
 Summary

Fig. 0-1. Screenshot of RGBFisheye.exe

Operating procedure
1. Setup of the software (decompress RGBFisheyeSetup.zip and run setup.exe)
2. Execution (run RGBFisheye.exe)
3. Select image files
4. Automatic thresholding Run “>” a image files, “>>” all image files selected
5. Complete the calculation and Save the results（*.csv）

*Trimming of the hemispherical photographs are regulated with the coordinates (x,y) of the
center and radius of hemi-circle. These values are saved in a configuration file
(RGBFisheyeCGF.csv).

2
1.Exposure setting based on the luminance of sky zenith

(procedure of AE-Lock method )

Fig.1-1. Photography with AE-Lock

1.Set Manual mode、 2.Metering : Spot、3AE-Lock:ON, Reset、4. take a photograph with the lens
facing directly up the zenith and set the exposure.

Fig.1-2. Comparison of hemispherical photographs taken with Auto and AE-Lock

The exposure was based on the zenith luminance of the sky (Chen, 1991; Clearwater et al.,
1999). The procedure with the Nikon Coolpix 950 involves five steps: 1, select Manual-Record
Mode; 2, go into Menu; 3, set Metering: Spot; 4, set AE-Lock: Reset; 5, take a photograph with
3
the lens facing directly up the zenith and set the exposure. With this camera, one must take a
photograph of the zenith in order to set the exposure with AE-Lock, because one cannot set
shutter speed and lens aperture on manual. The photography for the exposure setting needs to
be taken in open, canopy gap, and forest edge, because it is necessary that the sky at the zenith
is not unobstructed for the metering space. The sampling angle for spot photometry is ca.10
degree with the normal lens.

2. How to use RGBFisheye

2-1. Operating requirements

RGBFisheye was coded with MS Visual Basic ver. 6.0(Japanese) on WindowsXP(Japanese). On setup
procedure with Windows OS of US version, the messages with unreadable characters should be
shown. Nevertheless, the software installed is usable. The software operates on Win32
(Windows 95, 2000 , Me, XP). Windows OS recommended is Windows XP.

Table 2-1. Operating requirements of RGBFisheye

OS Win32 (Windows 2000 , Me, XP) XP recommended
Screen 1024 * 768 pixels or higher indispensableness
Screen color True color (32 bit) indispensableness
Quarity of images
Normal or higher indispensableness
(Nikon Coolpix)

On the ordinary setup procedure, following two files are installed under a folder”C:\Program
Files\RGBFisheye”,

RGBFisheye.exe
RGBFisheyeCGF.csv

The former is a execute file, and the later is configuration file including the information
such as directory of image files, and the values for position of a hemicircle.

4
2-2. Selection of image files

File > Open

Open dialog box “File Open”. RGBFisheye can select a number of image files with left click of a
mouse pushing Shift-key or Ctrl-key.

2-3. Trimming of the hemispherical photographs

Trimming of the hemispherical photographs are regulated with the coordinates (x, y) of the

5
center and radius (r) of hemi-circle. In order to improve the trimming position, input the value,
x, y, or r in textbox of hemicircle, and push return key.
Approximate values is, x = width/2, y = height/2, and r = height/2. The precision values
should be determined using the hemispherical photographs of sky with the each condition, such
as the camera type. Please note that the maximum zenith angle is not usually 90 degree, for
example the angle of Nikkor FC-E8 Nikon is 93 degree. The values of x, y, r are saved in a
configuration file (RGBFisheyeCGF.csv), and retained as default values until next alteration.

2-4. Start the calculation

Click the calculation button for automatic thresholding. The image files selected (see 4-2) are
calculated one-by-one by ”>” button and continuously by ”>>” button.

2-5. Save the results of the calculation

6
File > Save > Analysis results (table)
The photography condition and the calculation results are saved in files of “Analysis results
(table)”. The column of Diffuse transmittances (%PPFD) is “36.SOC(%)”.

Table 2-2. The items saved in the file (default name: DiffusesiteFactor.csv) of calculation results.
Row no. Label Caption
1 No_ sequential serial number
2 file file names
3 Date_Time Date and Time taken photograph
4 fmm focal length
5 F_stop f stop
6 S_Speed shutter speed
7 Sqr(F)/Exp
8
9
10
11 Rmean_All mean value of all pixels sampled in Red plane*
12 Gmean_All mean value of all pixels sampled in Green plane*
13 Bmean_All mean value of all pixels sampled in Blue plane*
14 Rmin_All minimum value of all pixels sampled in Red plane*
15 Gmin_All minimum value of all pixels sampled in Green plane*
16 Bmin_All minimum value of all pixels sampled in Blue plane*
17 Rmax_All maximum value of all pixels sampled in Red plane*
18 Gmax_All maximum value of all pixels sampled in Green plane*
19 Bmax_All maximum value of all pixels sampled in Blue plane*
20
21 Rmean_Sky mean value of sky pixels sampled in Red plane*
7
 22 Gmean_Sky mean value of sky pixels sampled in Green plane*
23 Bmean_Sky mean value of sky pixels sampled in Blue plane*
24 Rmin_Sky minimum value of sky pixels sampled in Red plane*
25 Gmin_Sky minimum value of sky pixels sampled in Green plane*
26 Bmin_Sky minimum value of sky pixels sampled in Blue plane*
27 Rmax_Sky maximum value of sky pixels sampled in Red plane*
28 Gmax_Sky maximum value of sky pixels sampled in Green plane*
29 Bmax_Sky maximum value of sky pixels sampled in Blue plane*
30
31 Rthreshold threshold of Red plane
32 Gthreshold threshold of Green plane
33 Bthreshold threshold of Blue plane
34
35 UOC(%) Diffse transmittance (uniform overcast model)
36 SOC(%) Diffse transmittance (standard overcast model)
37 Area(%) sky(red) area in right analyzed window
*44 632 pixels per hemispherical photographrange (see Ishida 2004)

2-6. Calculation with manual thresholding

RGBFisheye can calculate with manual thresholding on one-by-one image analysis. The
threshold values for binary division of hemispherical photographs set with the scroll bars or the
text boxes. After the values are changed, the calculation starts in a second.

2-7. Menu
File
Open select image files
Save
Analysis results (table)
Binary (Black & White)
image
AutoSave
8
 RGB pixel values (left window)

Frequency of RGB pixel values

Binary (Black & White)

image
Exit

Option
threshold
Maximum curvature
Starting pixel value
Auto level fix
Twilit correct
Show sampling area
About

9
2-8. Trouble shooting
Histograms of pixels are pectinate (comb-like) and calculation results are abnormal.

The pixel values for each RGB plane

must take 8-bits 256 resolutions. Please
set the computer screen to true color
(32Bit).

10
Spinal noise pattern occurs at the low level of the histograms and calculation results are
abnormal.

The spinal noise pattern is caused by compression of the image files. The quality of the
photographs (images) must be set “Normal” or higher on the digital camera. Essentially have to
calculate the high compression (low quality) image files, adjust a value of the “Starting pixel value”
searching the threshold (Option - threshold - Starting pixel value, ordinary about 10).

11
Acknowledgements
I wish to thank R.K.Kobe, S.M.Flinn, A. Komiyama, S. Kato, M. Tsukahara, and M.Noguchi, for
the valuable comments on the manuscript.

References
Anderson, M.C. 1964. Studies of the woodland light climate I. The photographic computation of
light conditions. J. Ecol. 52: 27–41.
Becker, P., Erhart D. W., and Smith A. P. 1989. Analysis of forest light environments Part I.
Computerized estimation of solar radiation from hemispherical canopy photographs. Agric.
For. Meteorol. 44:217-232.
Canham C.D.(1988)An index for understory light levels in and around canopy gaps. Ecology
69:1634-1638.
Canham C.D., Finzi A.C., Pacala S.W. and Burbank, D.H. (1994) Causes and consequences of
resource heterogeneity in forests: interspecific variation in light transmission by canopy
trees. Can. J. For. Res. 24: 337-349.
Chazdon, R.L., and Field, C.B. 1987. Photographic estimation of photosysthetically active
radiation: evaluation of a computerized technique. Oecologia 73:525–532.
Chen, J.M., Black, T.A., and Adams R.S. 1991. Evaluation of hemispherical photography for
determining plant area index and geometry of a forest stand. Agric. For. Meteorol. 56 :
129–143.
Clark, D.B., D.A. Clark, P.M. Rich, S.B. Weiss, and S.F. Oberbauer. 1996. Landscape-scale
evaluation of understory light and canopy structure: methods and application in a
neotropical lowland rain forest. Can. J. For. Res. 26:747-757.
Clearwater, M.J., Nifinluri, T., and van Gardingen, P.R. 1999. Forest fire smoke and a test of
hemispherical photography for predicting understorey light in Bornean tropical rain forest,
Agric. For. Meteorol. 97: 129–139.
Englund, S.R. , O'Brien, J.J., and Clark, D.B. 2000. Evaluation of digital and film hemispherical
photography and spherical densiometry for measuring forest light environments. Can. J.
For. Res. 30: 1999–2005.
Frazer, G.W., Fournier, R.A., Trofymow, J.A., and Hall, R.J. 2001. A comparison of digital and
film fisheye photography for analysis of forest canopy structure and gap light transmission,
Agric. For. Meteorol. 109: 249–263.
Gendron, F., Messier, C., and Comeau, P.G. 1998. Comparison of various methods for estimating
the mean growing season percent photosynthetic photon flux density in forests, Agric. For.
Meteorol. 92: 57–72.
Hale, S.E. and Edwards, C. 2002. Comparison of film and digital hemispherical photography
across a wide range of canopy densities. Agric. For. Meteorol. 112: 51–56.
12
Inoue, A., Yamamoto, K., Mizoue, N., and Kawahara, Y. 2002. Estimation of Relative
lilluminance using Digital Hemispherical Photography. For. Plann. 8: 67–70.
Kato, S. and Komiyama, A. 2000. A calibration method for adjusting hemispherical photographs
to appropriate black–and –white images. J. For. Res. 5: 109–111.
Macfarlane, C., Coote, M., White, D.A. and Adams, M.A. 2000. Photographic exposure affects
indirect estimation of leaf area in plantations of Eucalyptus globulus Labill, Agric. For.
Meteorol. 100: 155–168.
Madgwick, H.A.I. and Brumfield, G.L. 1969. The use of hemispherical photographs to asses light
climate in the forest. J. Ecol. 57: 537–542.
Messier, C. and Puttonen P. 1995. Spatial and temporal variation in the light environment Scots
pine stands: the basic for a quick and efficient method of characterizing light. Can. J. For.
Res. 25: 343–354.
Moon, P. and Spencer, D.E. 1942. Illumination from a non–uniform sky. Trans. Illum. Engng
Soc.N.Y. 37: 707.
Parent, S. and Messier, C. 1996 A simple and efficient method to estimate microsite light
availability under a forest canopy. Can. J. For. Res. 26, 151-154.
Rich, P.M. 1989. A manual for analysis of hemispherical canopy photography. Los Alamos
National Laboratory Report LA-11733-M.
ter Steege H. 1993. HEMIPHOT a programme to analyze vegetation indices light and quality
from hemispherical photographs. Tropenbos Documents 3 Wageningen The Netherlands:
44pp.
Wagner S. 1998. Calibration of grey values of hemispherical photographs for image analysis,
Agric. For. Meteorol. 90: 103–117.

13