| 1 |
greg |
1.1 |
.\" RCSid $Id$ |
| 2 |
|
|
.TH "GENSSKY" "1" "8/31/24" "RADIANCE" "" |
| 3 |
|
|
.SH "NAME" |
| 4 |
|
|
genssky - generates a RADIANCE description of the spectral daylight sources |
| 5 |
|
|
.SH "SYNOPSIS" |
| 6 |
|
|
\fBgenssky month day hour [-y year] [-d AOD] [-c cloud_cover] [-l file] [-g grefl] [-n nproc] [-r res] [-f out]\fR |
| 7 |
|
|
.SH "DESCRIPTION" |
| 8 |
|
|
\fIGenssky\fR produces a RADIANCE scene description of spectral sky |
| 9 |
|
|
and ground using the precomputed atmospheric scattering method |
| 10 |
|
|
(Bruneton et al). For a given atmospheric condition, a set of |
| 11 |
|
|
Radiance data files are pre-computed and reused for other solar |
| 12 |
|
|
positions. Precomputation can be sped up using multithreading with |
| 13 |
|
|
the \fI-n\fR flag. Extraterestrial solar radiation are spectrally |
| 14 |
|
|
resolved from 380-780nm at 20nm interval and constant regardless |
| 15 |
|
|
of location and time. The resulting sky source is in the same spectra |
| 16 |
|
|
range. The output are three files defaults to {prefix}.rad, |
| 17 |
|
|
{prefix}_sky.hsr, {prefix}_ground.hsr. The default prefix is "out" |
| 18 |
|
|
and can be changed using \fI-f\fR flag. The two .hsr files stores |
| 19 |
|
|
the fisheye spectral image of the sky and ground, with a default |
| 20 |
|
|
resolution of 128x128, which can be changed using \fI-r\fR flag. |
| 21 |
|
|
.PP |
| 22 |
|
|
Non-clear conditions are modeled by linearly interpolating between |
| 23 |
|
|
clear sky and CIE overcast sky. The resulting sky is the weight |
| 24 |
|
|
(cloud cover) average of clear and overcast sky. The overcast sky |
| 25 |
|
|
has a CCT of 6415K, from which the daylight spectra was computed. |
| 26 |
|
|
.PP |
| 27 |
|
|
Genssky models the Mie scattering differently from the original |
| 28 |
|
|
implementation. Instead of assuming exponential decay uniformly |
| 29 |
|
|
across the spectral range, the Mie scattering coefficients, as a |
| 30 |
|
|
functinon of the altitude, are computed into a lookup table using |
| 31 |
|
|
libradtran radiative transfer solver and interpolated directly |
| 32 |
|
|
during precomputation. The default Mie scattering profile is OPAC |
| 33 |
|
|
continental average, and can be overridden using the \fI-l\fR flag. |
| 34 |
|
|
The overall aerosol profile can also be scaled linearly by applying |
| 35 |
|
|
a broadband aerosol depth value using the \fI-d\fR flag. |
| 36 |
|
|
.PP |
| 37 |
|
|
Rayleigh scattering as a function of altitude is assumed to be |
| 38 |
|
|
exponential decay. The Rayleigh scattering coefficients at sea level |
| 39 |
|
|
are taken from Anderson et al (1986). There are a total of five |
| 40 |
|
|
sets of Rayleigh scattering data: mid-latitude summer, mid-latitude |
| 41 |
|
|
winter, sub-arctic summer, sub-arctic winter, and tropical. Latitudes |
| 42 |
|
|
are divided at 23.5 and 62.5 deg and summer is from month [4-9]. |
| 43 |
|
|
The scale-height of each Rayleigh scattering profile are tuned to |
| 44 |
|
|
fit the corresponding results from a libradtran calculation. |
| 45 |
|
|
.PP |
| 46 |
|
|
\fIgenssky\fR can be used with the following input parameters. |
| 47 |
|
|
.PP |
| 48 |
|
|
\fB-a Latitude in degree, north positive. Used along with datetime to determine solar angle and Rayleigh scattering profile. |
| 49 |
|
|
.br |
| 50 |
|
|
|
| 51 |
|
|
\fB-c Total cloud cover, value ranging from 0(clear)-1(overcast), default=0. |
| 52 |
|
|
.br |
| 53 |
|
|
|
| 54 |
|
|
\fB-d Broadband aerosol optical depth, default: 0.115. This parameter linearlly scales the overall aerosol scattering, default=0.115. |
| 55 |
|
|
.br |
| 56 |
|
|
|
| 57 |
|
|
\fB-f Output file name, default="out" |
| 58 |
|
|
.br |
| 59 |
|
|
|
| 60 |
|
|
\fB-g Average ground reflectance, default=0.2 |
| 61 |
|
|
.br |
| 62 |
|
|
|
| 63 |
|
|
\fB-l Custom Mie scattering profile file |
| 64 |
|
|
.br |
| 65 |
|
|
|
| 66 |
|
|
\fB-m Standard meridian, west positive. For example, UTC-8:00 = 120. Used to calculated solar angle. |
| 67 |
|
|
.br |
| 68 |
|
|
|
| 69 |
|
|
\fB-n Number of threads for precomputation, no benefits beyond 16 threads |
| 70 |
|
|
.br |
| 71 |
|
|
|
| 72 |
|
|
\fB-o Longitude in degree, west positive. Used to calculated solar angle. |
| 73 |
|
|
.br |
| 74 |
|
|
|
| 75 |
|
|
\fB-r Sky and ground hyperspectral image resolution. default=128. Increase this value to reduce artifacts at horizon. |
| 76 |
|
|
.br |
| 77 |
|
|
|
| 78 |
|
|
|
| 79 |
|
|
.SH "EXAMPLES" |
| 80 |
|
|
To generate a clear sky for March 2th at 3:15pm standard time at a site latitude of 42 degrees, 108 degrees west longitude, and a 110 degrees standard meridian, using 8 threads: |
| 81 |
|
|
.br |
| 82 |
|
|
|
| 83 |
|
|
genssky 3 2 15.25 -a 42 -o 108 -m 110 -n 8 |
| 84 |
|
|
|
| 85 |
|
|
.br |
| 86 |
|
|
|
| 87 |
|
|
For the same sky but with 100 percent total cloud cover: |
| 88 |
|
|
.br |
| 89 |
|
|
|
| 90 |
|
|
genssky 3 2 15.25 -a 42 -o 108 -m 110 -n 8 -c 1 |
| 91 |
|
|
|
| 92 |
|
|
.br |
| 93 |
|
|
|
| 94 |
|
|
|
| 95 |
|
|
.SH "FILES" |
| 96 |
|
|
/usr/local/lib/ray/mie_ca.dat |
| 97 |
|
|
.br |
| 98 |
|
|
|
| 99 |
|
|
.SH "AUTHOR" |
| 100 |
|
|
Taoning Wang |
| 101 |
|
|
.br |
| 102 |
|
|
|
| 103 |
|
|
.SH "SEE ALSO" |
| 104 |
|
|
gensky(1), gensky(1), rcomb(1), rcontrib(1), rpict(1), rtpict(1), |
| 105 |
|
|
rtrace(1), xform(1) |
| 106 |
|
|
.br |
