| 1 |
|
.TH "EVALGLARE" "1" "2016-06-15" "RADIANCE" "Radiance Manual" |
| 2 |
|
.SH "NAME" |
| 3 |
< |
evalglare (version v2.07) - determines and evaluates glare sources within a 180 degree fisheye HDR image |
| 3 |
> |
evalglare (version v2.10) - determines and evaluates glare sources within a 180 degree fisheye HDR image |
| 4 |
|
.br |
| 5 |
|
|
| 6 |
|
.SH "SYNOPSIS" |
| 7 |
< |
\fBevalglare \fR[ \fB-s \fR] [ \fB-y \fR] [ \fB-Y \fR\fIvalue\fR ] [ \fB-A \fR\fImaskfile\fR ][ \fB-B \fR\fIangle\fR ] [ \fB-b \fR\fIfactor\fR ] [ \fB-c \fR\fIcheckfile\fR ] [ \fB-f\fR ] [ \fB-t \fR\fIxpos\fR \fIypos\fR \fIangle\fR ] [ \fB-T \fR\fIxpos\fR \fIypos\fR \fIangle\fR ] [ -d ] [ \fB-r \fR\fIangle\fR ] [ \fB-i \fR\fIEv\fR ] [ \fB-I \fR\fIEv\fR \fIyfill_max\fR \fIy_fill_min\fR ] [ \fB-v \fR] [ \fB-V \fR] [ \fB-g \fR\fItype\fR ] [ \fB-G \fR\fItype\fR ] [\fB-q\fR \fBbackground_luminance_mode\fR ][ \fB-u \fR\fIr\fR \fIg\fR \fIb\fR ] [ \fB-vf \fR\fIviewfile\fR ] [ \fB-vt\fR\fIt\fR ] [ \fB-vv \fR\fIvertangle\fR ] [ \fB-vh \fR\fIhorzangle\fR ] [\fIhdrfile\fR] |
| 7 |
> |
\fBevalglare \fR[ \fB-s \fR] [ \fB-y \fR] [ \fB-Y \fR\fIvalue\fR ] [ \fB-A \fR\fImaskfile\fR ][ \fB-B \fR\fIangle\fR ] [ \fB-b \fR\fIfactor\fR ] [ \fB-c \fR\fIcheckfile\fR ] [ \fB-C\fR correctionmode ] [ \fB-f\fR ] [ \fB-t \fR\fIxpos\fR \fIypos\fR \fIangle\fR ] [ \fB-T \fR\fIxpos\fR \fIypos\fR \fIangle\fR ] [ -d ] [ \fB-r \fR\fIangle\fR ] [ \fB-i \fR\fIEv\fR ] [ \fB-I \fR\fIEv\fR \fIyfill_max\fR \fIy_fill_min\fR ] [ \fB-v \fR] [ \fB-V \fR] [ \fB-g \fR\fItype\fR ] [ \fB-G \fR\fItype\fR ] [\fB-q\fR \fBbackground_luminance_mode\fR ][ \fB-u \fR\fIr\fR \fIg\fR \fIb\fR ] [ \fB-vf \fR\fIviewfile\fR ] [ \fB-vt\fR\fIt\fR ] [ \fB-vv \fR\fIvertangle\fR ] [ \fB-vh \fR\fIhorzangle\fR ] [\fIhdrfile\fR] |
| 8 |
|
.br |
| 9 |
|
|
| 10 |
|
.SH "DESCRIPTION" |
| 11 |
|
\fBEvalglare \fRdetermines and evaluates glare sources within a 180 degree fisheye image, given in the RADIANCE image format (.pic or .hdr). If \fIhdrfile\fR is not given as an argument, the standard input is read. The image should be rendered as fisheye (e.g. using the \fB-vt\fR\fIa\fR or \fB-vt\fR\fIh\fR option) using 180 degrees for the horizontal and vertical view angle (\fB-vv \fR\fI180\fR, \fB-vh \fR\fI180\fR.) Due to runtime reasons of the \fBevalglare \fRcode, the image should be smaller than 1500x1500 pixels. The recommended size is 1000x1000 pixels, the minimum recommended size is 800x800 pixels. In the first step, the program uses a given threshold to determine all glare sources. Three different threshold methods are implemented. The recommended method is to define a task area by \fB-t \fRor \fB-T \fRoption. In this (task) area the average luminance is calculated. Each pixel, exceeding this value multiplied by the \fB-b \fRfactor, default 5, is treated as a potential glare source. The other two methods are described below, see \fB-b\fR. In the second step the program tries to merge glare source pixels to one glare source, when they are placed nearby each other. This merging is performed between search areas, given by an opening angle \fB-r\fR, default 0.2 radians. If a check file is written \fB-c \fRfname, the detected glare sources will be colored to different colors where the rest of the image is set to gray. The luminance values of all pixels are kept to the initial value. The color is chosen by chance, no significance is given by the color. Using the option \fB-u\fR \fIr\fR \fIg\fR \fIb\fR applies a uniform coloring of the glare sources. Luminance peaks can be extracted to separate glare sources by using the \fB-y \fRor \fB-Y \fR\fIvalue\fR option (default since version v0.9c). The default value \fB-y \fRis 50000 cd/m2, which can be changed by using the \fB-Y \fR\fIvalue\fR option. A smoothing option, \fB-s\fR, counts initial non-glare source pixels to glare sources, when they are surrounded by a glare source. |
| 12 |
|
.br |
| 13 |
|
|
| 14 |
< |
The program calculates the daylight glare probability (DGP) as well as other glare indexes (DGI, DGI_MOD, UGR, UGR_EXP, VCP, CGI, UDP) to the standard output. The DGP describes the fraction of persons disturbed caused by glare from daylight as a number from 0 to 1, where 0 is no-one disturbed and 1 is everyone. Values lower than 0.2 are out of the range of the user assessment tests, where the program is based on and should be interpreted carefully. A low light correction is applied to the DGP when the vertical illumiance is lower than 500 lux. By the use of \fB-g \fRor \fB-G \fRthe field of view is cut according the the definition of Guth. The option \fB-B \fRangle (in radians) calculates the average luminance of a horizontal band. In the case of non-180 degree images, an external measured illuminance value can be provided by using the \fB-i \fRor \fB-I \fRoption. The use of the \fB-I \fRoption enables the filling up of images, which are horizontally cut. The age correction is not supported any more and disabled. |
| 14 |
> |
The program calculates the daylight glare probability (DGP) as well as other glare indexes (DGI, DGI_MOD, UGR, UGR_EXP, VCP, CGI, UDP) to the standard output. The DGP describes the fraction of persons disturbed caused by glare from daylight as a number from 0 to 1, where 0 is no-one disturbed and 1 is everyone. Values lower than 0.2 are out of the range of the user assessment tests, where the program is based on and should be interpreted carefully. A low light correction is applied to the DGP when the vertical illumiance is lower than 500 lux (correction mode \fB-C\fR \fR\fIl+\fR, = default). The lowlight-correction can be disabled by using \fB-C\fR \fR\fIl-\fR. The option \fB-C\fR \fR\fI0\fR turns off all corrections. By the use of \fB-g \fRor \fB-G \fRthe field of view is cut according the the definition of Guth. The option \fB-B \fRangle (in radians) calculates the average luminance of a horizontal band. In the case of non-180 degree images, an external measured illuminance value can be provided by using the \fB-i \fRor \fB-I \fRoption. The use of the \fB-I \fRoption enables the filling up of images, which are horizontally cut. The age correction is not supported any more and disabled. |
| 15 |
|
.br |
| 16 |
|
|
| 17 |
|
A masking option \fB-A \fRenables the user to specify an area to be statistically analysed (e.g. the window). Masking is applied after glare source detecting, therefore it has no influence on most of the metrics. The maskfile must be of the same size than the evaluated image. The maskfile simply defines the area to be statistically evaluated in the evaluation image. All pixels larger than 0 in the masking pic define the masking area. For the masked area in the evaluation image, the average luminance, median luminance, 75% and 95% percentile luminance, the min and max luminance, the illuminance of the masked area Ev_mask as well as the PSGV (PGSVsat, PGSVcon and PGSV) are calculated. The PSGV can be only used, when the masking area is a window and the camera viewing direction is facing perpendicular to the facade (restriction of PSGV). Masking requires the \fB-d \fRoption and may not be combined with the zoning options \fB-l \fRor \fB-L\fR. |
| 59 |
|
\fB-c \fR\fIfname\fR |
| 60 |
|
.br |
| 61 |
|
writes a checkfile in the RADIANCE picture format |
| 62 |
+ |
.br |
| 63 |
+ |
|
| 64 |
+ |
\fB-C \fR\fImode\fR |
| 65 |
+ |
.br |
| 66 |
+ |
Correction mode. Type \fI0\fR: all corrections turned off , Type \fIl+\fR: Low light correction applied (default) , Type \fIl-\fR: Low light correction disabled. |
| 67 |
+ |
Note: Only one \fImode\fR after -C allowed. Multiple -C option possible, they will be applied one after the other in the order of occurrence. |
| 68 |
|
.br |
| 69 |
|
|
| 70 |
|
\fB-d \fRenables detailed output (default: disabled) |
