| 1 |
< |
.\" RCSid $Id$ |
| 2 |
< |
.TH EVALGLARE 1 7/30/15 RADIANCE |
| 3 |
< |
.SH NAME |
| 4 |
< |
.PP |
| 5 |
< |
evalglare \- determines and evaluates glare sources within a 180 degree |
| 6 |
< |
fish\-eye\-image, given in the RADIANCE RGBE (.hdr) image format. |
| 7 |
< |
.SH SYNOPSIS |
| 8 |
< |
.PP |
| 9 |
< |
evalglare [\-s] [\-y] [\-Y value] [\-B angle] [\-b factor] [\-c checkfile] |
| 10 |
< |
[\-t xpos ypos angle] [\-T xpos ypos angle] [\-d] [\-r angle] [\[en]i |
| 11 |
< |
Ev] [\[en]I Ev yfill_max y_fill_min ] [\-v] [\-V] [\[en]g type] [\-G |
| 12 |
< |
type] [\-u r g b ] [\-vf viewfile] [\-vtt ] [\-vv vertangle] [\-vh horzangle] hdrfile |
| 13 |
< |
.PP |
| 14 |
< |
or |
| 15 |
< |
.PP |
| 16 |
< |
hdr|evalglare [\-s] [\-y] [\-Y value] [\-B angle] [\-b factor] [\-c |
| 17 |
< |
checkfile] [\-t xpos ypos angle][\-T xpos ypos angle] [\-d] [\-r angle] |
| 18 |
< |
[\[en]i Ev] [\[en]I Ev yfill_max y_fill_min ] [\-v] [\-V] ] [\[en]g |
| 19 |
< |
type] [\-G type] [\-u r g b ] [\-vf viewfile][\-vtt ] [\-vv vertangle] [\-vh |
| 20 |
< |
horzangle] |
| 21 |
< |
.SH DESCRIPTION |
| 22 |
< |
.PP |
| 23 |
< |
evalglare determines and evaluates glare sources within a 180 degree |
| 24 |
< |
fish\-eye\-image, given in the RADIANCE image format (.pic or .hdr). |
| 25 |
< |
The image should be rendered as fish eye (e.g. |
| 26 |
< |
using the \-vta or \[en]vth option) using 180 degree for the horizontal and |
| 27 |
< |
vertical view angle (\-vv =180, \-vh=180). |
| 28 |
< |
Due to performance reasons of the evalglare code, the image should be |
| 29 |
< |
smaller than 1200x1200 pixels. The recommended size is 800x800 pixels. |
| 30 |
< |
In the first step, the program uses a given threshold to determine all |
| 31 |
< |
glare sources. |
| 32 |
< |
Three different threshold methods are implemented. |
| 33 |
< |
The recommended method is to define a task area by \-t or \-T option. |
| 34 |
< |
In this (task) area the average luminance is calculated Each pixel, |
| 35 |
< |
exceeding this value multiplied by the \-b factor [default=5] is treated |
| 36 |
< |
as a potential glare source. |
| 37 |
< |
The other two methods are described below [see \-b]. |
| 38 |
< |
In the second step the program tries to merge glare source pixels to one |
| 39 |
< |
glare source, when they are placed nearby each other. |
| 40 |
< |
This merging is performed in\-between a search area, given by an opening |
| 41 |
< |
angle (\-r, default =0.2 in radiant). |
| 42 |
< |
If a check file is written (\-c fname), the detected glare sources will |
| 43 |
< |
be colored to different colors where the rest of the image is set to |
| 44 |
< |
gray. |
| 45 |
< |
The luminance values of all pixels are kept to the initial value. |
| 46 |
< |
The color is chosen by chance, no significance is given by the color. |
| 47 |
< |
To enable a unform coloring for all glare sources, the \-u option can be used. |
| 48 |
< |
Luminance peaks can be extracted to separate glare sources by using the |
| 49 |
< |
\-y or \-Y value option (default since version v0.9c). |
| 50 |
< |
Default value (\-y) is 50000 cd/m2, can be changed by using \-Y value. |
| 51 |
< |
A smoothing option (\-s) counts initial non\-glare source pixels to |
| 52 |
< |
glare sources, when they are surrounded by a glare source. |
| 53 |
< |
.PP |
| 54 |
< |
The program calculates the daylight glare probability (DGP) as well as |
| 55 |
< |
other glare indexes (dgi,ugr,vcp,cgi) to the standard output. |
| 56 |
< |
The DGP describes the fraction of persons disturbed, caused by glare from |
| 57 |
< |
daylight (range 0...1). |
| 58 |
< |
Values lower than 0.2 are out of the range of the user assessment tests, |
| 59 |
< |
where the program is based on and should be interpreted carefully. |
| 60 |
< |
A low light correction is applied to the DGP when the vertical illumiance is lower than 500 lux. |
| 61 |
< |
By the use of \-g or \-G the field of view is cut according the the definition of Guth. |
| 62 |
< |
The option \-B angle (in rad) calculates the average luminance of a horizontal band. |
| 63 |
< |
In the case of non\-180 degree images, an external measured illuminance value |
| 64 |
< |
can be provided by using the \[en]i or \[en]I option. |
| 65 |
< |
The use of the \[en]I option enables the filling up of images, which are |
| 66 |
< |
horizontally cut. |
| 67 |
< |
The age correction is not supported any more and disabled. |
| 68 |
< |
If the option \-d is used, all found glare sources and their position, |
| 69 |
< |
size, and luminance values are printed to the standard output, too. |
| 70 |
< |
The last line gives following values: 1. |
| 71 |
< |
dgp, 2. |
| 72 |
< |
average luminance of image,3. |
| 73 |
< |
vertical eye illuminance, 4. |
| 74 |
< |
background luminance, 5. |
| 75 |
< |
direct vertical eye illuminance, 6. |
| 76 |
< |
dgi, 7. |
| 77 |
< |
ugr, 8. |
| 78 |
< |
vcp, 9. |
| 79 |
< |
cgi, 10. |
| 80 |
< |
average luminance of all glare sources, 11. |
| 81 |
< |
sum of solid angles of all glare sources 12. |
| 82 |
< |
Veiling luminance (disability glare) 13. |
| 83 |
< |
x\-direction of glare source 14. |
| 84 |
< |
y\-direction of glare source 15. |
| 85 |
< |
z\-direction of glare source 16. |
| 86 |
< |
band luminance |
| 87 |
< |
.PP |
| 88 |
< |
The program is based on the studies from J. |
| 89 |
< |
Christoffersen and J. |
| 90 |
< |
Wienold (see \“Evaluation methods and development of a new glare |
| 91 |
< |
prediction model for daylight environments with the use of CCD cameras |
| 92 |
< |
and RADIANCE\“ , Energy and Buildings, 2006. |
| 93 |
< |
More details can be also found in following issertation: J. |
| 94 |
< |
Wienold, \“Daylight glare in offices\”, Fraunhofer IRB, 2010. |
| 95 |
< |
URL for download: |
| 96 |
< |
http://publica.fraunhofer.de/eprints/urn:nbn:de:0011\-n\-1414579.pdf |
| 97 |
< |
.TP |
| 98 |
< |
.B \-B \f[I]angle\f[], |
| 99 |
< |
Calculate average luminance of a horizontal band. The angle is in rad. Output only when using the \-d option. |
| 100 |
< |
.RS |
| 101 |
< |
.RE |
| 102 |
< |
.TP |
| 103 |
< |
.B \-b \f[I]factor\f[], |
| 104 |
< |
Threshold factor; if factor >100, it is used as constant threshold in |
| 105 |
< |
cd/m2, regardless if a task position is given or not if factor is <= 100 |
| 106 |
< |
and a task position is given, this factor multiplied by the average task |
| 107 |
< |
luminance will be used as threshold for detecting the glare sources if |
| 108 |
< |
factor is <= 100 and no task position is given, this factor multiplied |
| 109 |
< |
by the average luminance in the entire picture will be used as threshold |
| 110 |
< |
for detecting the glare sources, default value=5. |
| 111 |
< |
.RS |
| 112 |
< |
.RE |
| 113 |
< |
.TP |
| 114 |
< |
.B \-c \f[I]fname\f[] |
| 115 |
< |
writes a checkfile in the RADIANCE picture format |
| 116 |
< |
.RS |
| 117 |
< |
.RE |
| 118 |
< |
.TP |
| 119 |
< |
.B \-d |
| 120 |
< |
enables detailed output (default: disabled) |
| 121 |
< |
.RS |
| 122 |
< |
.RE |
| 123 |
< |
.TP |
| 124 |
< |
.B \-g \f[I]type\f[] |
| 125 |
< |
cut field of view according to Guth, write checkfile specified by \[en]c |
| 126 |
< |
and exit without any glare evaluation. |
| 127 |
< |
type=1: total field of view type=2: field of view seen by both eyes |
| 128 |
< |
.RS |
| 129 |
< |
.RE |
| 130 |
< |
.TP |
| 131 |
< |
.B \-G \f[I]type\f[] |
| 132 |
< |
cut field of view according to Guth, perform glare evaluation. |
| 133 |
< |
type=1: total field of view type=2: field of view seen by both eyes |
| 134 |
< |
.RS |
| 135 |
< |
.RE |
| 136 |
< |
.TP |
| 137 |
< |
.B \-i \f[I]Ev\f[] |
| 138 |
< |
The vertical illuminance is measured externally. |
| 139 |
< |
This value will be used for calculating the dgp. |
| 140 |
< |
.RS |
| 141 |
< |
.RE |
| 142 |
< |
.TP |
| 143 |
< |
.B \-I \f[I]Ev y_max y_min\f[] |
| 144 |
< |
The vertical illuminance is measured externally. |
| 145 |
< |
This value will be used for calculating the dgp. |
| 146 |
< |
Below y_min and above y_max, the picture is filled up by the last known |
| 147 |
< |
value. |
| 148 |
< |
This option should be used, when the provided picture is cut |
| 149 |
< |
horizontally. |
| 150 |
< |
.RS |
| 151 |
< |
.RE |
| 152 |
< |
.TP |
| 153 |
< |
.B \-r \f[I]angle\f[] |
| 154 |
< |
search radius (angle in radiant) between pixels, where evalglare tries |
| 155 |
< |
to merge glare source pixels to the same glare source (default value: |
| 156 |
< |
0.2 radiant) |
| 157 |
< |
.RS |
| 158 |
< |
.RE |
| 159 |
< |
.TP |
| 160 |
< |
.B \-s |
| 161 |
< |
enables smoothing function (default: disabled) |
| 162 |
< |
.RS |
| 163 |
< |
.RE |
| 164 |
< |
.TP |
| 165 |
< |
.B \-t \f[I]xpos ypos angle\f[] |
| 166 |
< |
definition of task position in x and y coordinates, and its opening |
| 167 |
< |
angle in radiant |
| 168 |
< |
.RS |
| 169 |
< |
.RE |
| 170 |
< |
.TP |
| 171 |
< |
.B \-T \f[I]xpos ypos angle\f[] |
| 172 |
< |
same as \-t, except that the task area is colored bluish in the |
| 173 |
< |
checkfile |
| 174 |
< |
.RS |
| 175 |
< |
.RE |
| 176 |
< |
.TP |
| 177 |
< |
.B \-u \f[I]r g b\f[] |
| 178 |
< |
color glare sources unfiformly when writing check file (implies \-c option). Color given in r g b. |
| 179 |
< |
.RS |
| 180 |
< |
.RE |
| 181 |
< |
.TP |
| 182 |
< |
.B \-v |
| 183 |
< |
show version of evalglare and exit |
| 184 |
< |
.RS |
| 185 |
< |
.RE |
| 186 |
< |
.TP |
| 187 |
< |
.B \-V |
| 188 |
< |
Just calculate the vertical illuminance and exit |
| 189 |
< |
.RS |
| 190 |
< |
.RE |
| 191 |
< |
.TP |
| 192 |
< |
.B \-x |
| 193 |
< |
disable peak extraction |
| 194 |
< |
.RS |
| 195 |
< |
.RE |
| 196 |
< |
.TP |
| 197 |
< |
.B \-y |
| 198 |
< |
enables peak extraction (default: enabled) |
| 199 |
< |
.RS |
| 200 |
< |
.RE |
| 201 |
< |
.TP |
| 202 |
< |
.B \-Y \f[I]value\f[] |
| 203 |
< |
enables peak extraction with value as threshold for extracted peaks |
| 204 |
< |
.RS |
| 205 |
< |
.RE |
| 206 |
< |
.PP |
| 207 |
< |
In case, the view settings within the image are missing or are not valid |
| 208 |
< |
(e.g. |
| 209 |
< |
after the use of pcompos or pcomb), the view options can be set by |
| 210 |
< |
command line options. |
| 211 |
< |
As soon as view options are set within the command line, view options |
| 212 |
< |
within the image are ignored. |
| 213 |
< |
The view options are implemented according to the RADIANCE definition |
| 214 |
< |
(please read man page of rpict for details): |
| 215 |
< |
.TP |
| 216 |
< |
.B \-vtt |
| 217 |
< |
Set view type to t (for fish\-eye views, please use \[en]vta or \[en]vth |
| 218 |
< |
preferably) |
| 219 |
< |
.RS |
| 220 |
< |
.RE |
| 221 |
< |
.TP |
| 222 |
< |
.B \-vf \f[I]viewfile\f[] |
| 223 |
< |
Get view parameters from file |
| 224 |
< |
.RS |
| 225 |
< |
.RE |
| 226 |
< |
.TP |
| 227 |
< |
.B \-vv \f[I]val\f[] |
| 228 |
< |
Set the view vertical size to val |
| 229 |
< |
.RS |
| 230 |
< |
.RE |
| 231 |
< |
.TP |
| 232 |
< |
.B \-vh \f[I]val\f[] |
| 233 |
< |
Set the view horizontal size to \f[I]val\f[] |
| 234 |
< |
.RS |
| 235 |
< |
.RE |
| 236 |
< |
.SH ACKNOWLEDGEMENTS |
| 237 |
< |
.PP |
| 238 |
< |
The evalglare program was developped by Jan Wienold originally at the Fraunhofer |
| 239 |
< |
Institute for Solar Energy Systems in Freiburg, Germany. It is further developped |
| 240 |
< |
and maintained by the same author at EPFL, Lausanne, Switzerland. |
| 241 |
< |
.PP |
| 242 |
< |
The author would like to thank C. |
| 243 |
< |
Reetz for his generous help and his support of providing libraries for |
| 244 |
< |
the program. |
| 245 |
< |
The EU Commission supported this work as part of the EU project “Energy |
| 246 |
< |
and Comfort Control for Building management systems” (ECCO\-Build, |
| 247 |
< |
Contract N°: ENK6\-CT\-2002\-00656). |
| 248 |
< |
.PP |
| 249 |
< |
The dfg\-foundation (contract WI 1304/7\-2 ) supported the research for |
| 250 |
< |
the extension of evalglare for low\-light scenes. |
| 251 |
< |
.SH AUTHORS |
| 1 |
> |
.TH "EVALGLARE" "1" "2016-06-15" "RADIANCE" "Radiance Manual" |
| 2 |
> |
.SH "NAME" |
| 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-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 (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. |
| 18 |
> |
.br |
| 19 |
> |
|
| 20 |
> |
Circular zone evaluation can be activated by \fB-l \fR(one zone) or \fB-L \fR(two zones). If two zones are selected they share the same center. The center of the zone(s) can be specified by the x and y coordinates. The size of the zone(s) is specified by the opening angle(s) in radians. If glare sources crosses the border of a zone, then this glare source will be split up into two or three glare sources, so that no glare source is crossing the border of a zone any more. For each glare source the zonal location is given in the glare source section of the detailed output. Glare sources outside zone 1 or zone 2 are labelled as zone 0. For each zone following values are calculated: The average luminance, median luminance, 75% and 95% percentile luminance, the min and max luminance. Zoning requires the \fB-d \fRoption. |
| 21 |
> |
.br |
| 22 |
> |
|
| 23 |
> |
The luminance distribution of a horizontal band can be analysed by the \fB-B \fR\fIangle\fR option. Within the angle the average lumianance, median luminance, 75% and 95% percentile luminance, the min and max luminance are calculated and printed. It requires the \fB-d\fR option. In case to be combined with \fB-A\fR or \fB-L\fR or \fB-l\fR, the band properties will be calculated first. The band-option has no influence on glare source detection, masking areas or zones. |
| 24 |
> |
.br |
| 25 |
> |
|
| 26 |
> |
If the option \fB-d \fRis used, all found glare sources and their position, size, luminance values, x,y and z-directions and zone belonging are printed to the standard output (first section), too. The last line gives following values (in brackets the column, 1st column is explaining text) : DGP (2), average luminance of image (3), vertical illuminance (4), background luminance (5), direct vertical illuminance (6), DGI (7), UGR (8), VCP (9), CGI (10), average luminance of all glare sources (11), sum of solid angles of glare sources (12), Veiling luminance (disability glare according Poynter)(13), Veiling luminance (sum of disability glare according Stiles-Holladay CIE) (14), DGR (15), UGP (16), UGR_EXP (17), DGI_MOD (18), average luminance weighted by position index (19), average luminance weighted by squared position index (20), median luminance of image (21), median of position index weighted luminance of image (22), median of squared position index weighted luminance of image (23) |
| 27 |
> |
.br |
| 28 |
> |
|
| 29 |
> |
The header of the image is checked for obvious mistakes (but not for all possible, the user should always check the image header in advance for validity!). Obvious mistakes are: |
| 30 |
> |
.br |
| 31 |
> |
-using a -vtv view AND having black corners. This happens, when a fish eye lens is used and the view type is not set correctly. Evalglare is stopping, except the forcing option \fB-f\fR is activated. |
| 32 |
> |
.br |
| 33 |
> |
-invalid exposure in the header. This might be caused by the use of pcomb or pcompos in advance. Evalglare is stopping in any case. |
| 34 |
> |
.br |
| 35 |
> |
-invalid view specified. This might be caused by the use of pcomb or pcompos in advance. Evalglare is stopping. View can be overwritten by giving view options to the command line (see below) |
| 36 |
> |
.br |
| 37 |
> |
|
| 38 |
> |
|
| 39 |
> |
.br |
| 40 |
> |
\fB-A \fR\fImasking-file\fR |
| 41 |
> |
.br |
| 42 |
> |
Use a masking file to enable statistical analysis on a certain area. Does not affect glare source detection. The masking threshold is 0.1 cd/m2 (all pixels exceeding 0.1 cd/m2 are treated as "inside" the mask.) The PGSV equations are also calculated, but require the masking area to be the window. |
| 43 |
> |
.br |
| 44 |
> |
It requires the -d option. The result of the analysis of the masking area is given in the first line of the output. Should not be combined with \fI-l\fR or \fI-L\fR options. |
| 45 |
> |
.br |
| 46 |
> |
|
| 47 |
> |
\fB-B \fR\fIangle\fR |
| 48 |
> |
.br |
| 49 |
> |
Calculate average luminance of a horizontal band. The angle is in radians. This calculation does not affect glare source detection. Output only when using the \fB-d \fRoption. |
| 50 |
> |
.br |
| 51 |
> |
The result of the analysis of the band is given in the first line of the output. |
| 52 |
> |
.br |
| 53 |
> |
|
| 54 |
> |
\fB-b \fR\fIfactor\fR |
| 55 |
> |
.br |
| 56 |
> |
Threshold factor; if \fBfactor\fR is larger than 100, it is used as constant threshold in cd/m2, regardless if a task position is given or not. If \fBfactor\fR is less or equal than 100 and a task position is given, this \fIfactor\fR multiplied by the average task luminance will be used as threshold for detecting the glare sources. If \fBfactor\fR is less than or equal to 100 and no task position is given, this factor multiplied by the average luminance in the entire picture will be used as threshold for detecting the glare sources (not recommended). Default value of \fIfactor\fR is 2000 (fixed threshold method). |
| 57 |
> |
.br |
| 58 |
> |
|
| 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) |
| 71 |
> |
.br |
| 72 |
> |
|
| 73 |
> |
\fB-f \fR forcing option to prevent from stopping when -vtv is used and black corners are detected (default: disabled) |
| 74 |
> |
.br |
| 75 |
> |
|
| 76 |
> |
\fB-g \fR\fItype\fR |
| 77 |
> |
.br |
| 78 |
> |
cut field of view according to Guth, write checkfile specified by \fB-c \fRand exit without any glare evaluation. Type 1: total field of view. Type 2: field of view seen by both eyes |
| 79 |
> |
.br |
| 80 |
> |
|
| 81 |
> |
\fB-G \fR\fItype\fR |
| 82 |
> |
.br |
| 83 |
> |
Cut the field of view according to Guth, perform glare evaluation. Type 1: total field of view. Type 2: field of view seen by both eyes |
| 84 |
> |
.br |
| 85 |
> |
|
| 86 |
> |
\fB-i \fR\fIEv\fR The vertical illuminance \fIEv\fR in lux is measured externally. This value will be used for calculating the DGP. |
| 87 |
> |
.br |
| 88 |
> |
|
| 89 |
> |
\fB-I \fR\fIEv\fR \fIy_max\fR \fIy_min\fR |
| 90 |
> |
.br |
| 91 |
> |
The vertical illuminance \fIEv\fR in lux is measured externally. This value will be used for calculating the DGP. Below \fIy_min\fR and above \fIy_max\fR, the picture is filled up by the last known value. This option should be used, when the provided picture is cut horizontally. |
| 92 |
> |
.br |
| 93 |
> |
|
| 94 |
> |
\fB-l \fR\fIxpos\fR \fIypos\fR \fIangle\fR |
| 95 |
> |
.br |
| 96 |
> |
Activate circular one zone evaluation. The center of the zone is given by \fIxpos\fR and \fIypos\fR. The opening angle of the zone is specified in radians. |
| 97 |
> |
.br |
| 98 |
> |
The result of the analysis of zone1 is given in the first line of the output. |
| 99 |
> |
.br |
| 100 |
> |
|
| 101 |
> |
\fB-L\fR \fIxpos\fR \fIypos\fR \fI\fIangle\fR1\fR \fIangle2\fR |
| 102 |
> |
.br |
| 103 |
> |
Activate circular two zone evaluation. The center of the zone is given by xpos and ypos. The opening angle of the inner zone1 is specified by \fIangle1\fR in radians, the opening angle of the outer zone2 by \fIangle2\fR. |
| 104 |
> |
.br |
| 105 |
> |
The result of the analysis of the zones is given in the first two lines of the output. |
| 106 |
> |
.br |
| 107 |
> |
|
| 108 |
> |
|
| 109 |
> |
.br |
| 110 |
> |
\fB-N\fR \fIxpos\fR \fIypos\fR \fIangle\fR \fIEv\fR \fIfname\fR |
| 111 |
> |
.br |
| 112 |
> |
Pixel replacement in case of pixel overflow in hdr image and measured \fIEv\fR (in lux) is available. Writes the modified image to \fIfname\fR and exists immediately (without glare evaluation). |
| 113 |
> |
.br |
| 114 |
> |
Replaces pixels in a circular zone to match \fIEv\fR. The center of the zone is given by \fIxpos\fR and \fIypos\fR. The opening \fIangle\fR of the zone is specified in radians. |
| 115 |
> |
.br |
| 116 |
> |
\fBThis option should be applied very carefully and only exceptionally. Pixel overflow should be avoided from the beginning by applying shorter exposure times and/or neutral filters.\fR |
| 117 |
> |
.br |
| 118 |
> |
|
| 119 |
> |
.br |
| 120 |
> |
\fB-q\fR \fBmode\fR toggle modes for the background luminance calculation: 0 (default): CIE-mode Lb=(Ev-Edir)/pi; 1: Lb= mathematical average luminance without glare sources; 2(not recommended): Lb=Ev/pi |
| 121 |
> |
.br |
| 122 |
> |
|
| 123 |
> |
\fB-r \fR\fIangle\fR |
| 124 |
> |
.br |
| 125 |
> |
search radius (angle in radians) between pixels, where \fBevalglare \fRtries to merge glare source pixels to the same glare source (default value: 0.2 radians) |
| 126 |
> |
.br |
| 127 |
> |
|
| 128 |
> |
\fB-s \fRenables smoothing function (default: disabled) |
| 129 |
> |
.br |
| 130 |
> |
|
| 131 |
> |
\fB-t \fR\fIxpos\fR \fIypos\fR \fIangle\fR |
| 132 |
> |
.br |
| 133 |
> |
definition of task position in x and y coordinates, and its opening angle in radians |
| 134 |
> |
.br |
| 135 |
> |
|
| 136 |
> |
\fB-T \fR\fIxpos\fR \fIypos\fR \fIangle\fR |
| 137 |
> |
.br |
| 138 |
> |
same as \fB-t\fR, except that the task area is colored bluish in the checkfile |
| 139 |
> |
.br |
| 140 |
> |
|
| 141 |
> |
\fB-u \fR\fIr\fR \fIg\fR \fIb\fR |
| 142 |
> |
.br |
| 143 |
> |
color glare sources unfiformly when writing check file (implies -c option). Color given in r g b. (in any range, values are normalized) |
| 144 |
> |
.br |
| 145 |
> |
|
| 146 |
> |
\fB-v \fRshow version of \fBevalglare \fRand exit |
| 147 |
> |
.br |
| 148 |
> |
|
| 149 |
> |
\fB-V \fRcalculate the vertical illuminance and exit |
| 150 |
> |
.br |
| 151 |
> |
|
| 152 |
> |
\fB-x \fRdisable peak extraction |
| 153 |
> |
.br |
| 154 |
> |
|
| 155 |
> |
\fB-y \fRenables peak extraction (default: enabled) |
| 156 |
> |
.br |
| 157 |
> |
|
| 158 |
> |
\fB-Y \fR\fIvalue\fR |
| 159 |
> |
.br |
| 160 |
> |
enables peak extraction with \fIvalue\fR (in cd/m2) as threshold for extracted peaks |
| 161 |
> |
.br |
| 162 |
> |
|
| 163 |
> |
In case, the view settings within the image are missing or are not valid (e.g. after the use of pcompos or pcomb), the view options can be set by command line options. As soon as view options are set within the command line, view options within the image are ignored. The view options are implemented according to the RADIANCE definition (please read man page of rpict for details): |
| 164 |
> |
.br |
| 165 |
> |
|
| 166 |
> |
\fB-vt\fR\fIt\fR Set view type to t (for fisheye views, please use \fB-vt\fR\fIa\fR or \fB-vt\fR\fIh\fR preferably) |
| 167 |
> |
.br |
| 168 |
> |
|
| 169 |
> |
\fB-vf \fR\fIviewfile\fR |
| 170 |
> |
.br |
| 171 |
> |
Get view parameters from file |
| 172 |
> |
.br |
| 173 |
> |
|
| 174 |
> |
\fB-vv \fR\fIval\fR |
| 175 |
> |
.br |
| 176 |
> |
Set the view vertical size to val |
| 177 |
> |
.br |
| 178 |
> |
|
| 179 |
> |
\fB-vh \fR\fIval\fR |
| 180 |
> |
.br |
| 181 |
> |
Set the view horizontal size to \fIval\fR |
| 182 |
> |
.br |
| 183 |
> |
|
| 184 |
> |
.SH "AUTHOR" |
| 185 |
|
Jan Wienold. |
| 186 |
+ |
.br |
| 187 |
+ |
|
| 188 |
+ |
.SH "SEE ALSO" |
| 189 |
+ |
The program is based on the studies by J. Christoffersen and J. Wienold (see "Evaluation methods and development of a new glare prediction model for daylight environments with the use of CCD cameras and RADIANCE," \fIEnergy\fR \fIand\fR \fIBuildings\fR \fI38\fR, 2006, pp. 743-757, doi:10.1016/j.enbuild.2006.03.017. More details can be also found in following dissertation: J. Wienold, \fIDaylight\fR \fIglare\fR \fIin\fR \fIoffices\fR, Fraunhofer IRB, 2010, available online at <http://publica.fraunhofer.de/dokumente/N-141457.html>. |
| 190 |
+ |
.br |
| 191 |
+ |
|
| 192 |
+ |
.SH "ACKNOWLEDGEMENTS" |
| 193 |
+ |
The evalglare program was originally developed by Jan Wienold at the Fraunhofer Institute for Solar Energy Systems in Freiburg, Germany. It is being further developed and maintained by the same author at EPFL, Lausanne, Switzerland. |
| 194 |
+ |
.br |
| 195 |
+ |
|
| 196 |
+ |
The author would like to thank C. Reetz for his generous help and his support of providing libraries for the program. The EU Commission supported this work as part of the EU project "Energy and Comfort Control for Building management systems" (ECCO-Build, Contract ENK6-CT-2002-00656). |
| 197 |
+ |
.br |
| 198 |
+ |
|
| 199 |
+ |
German Research Foundation (DFG) contract WI 1304/7-2 supported the research for the extension of evalglare for low light scenes. |
| 200 |
+ |
.br |
