man/man1/genssky.1

.\" RCSid $Id$
.TH "GENSSKY" "1" "8/31/24" "RADIANCE" ""
.SH "NAME"
genssky - generates a RADIANCE description of the spectral daylight sources
.br

.SH "SYNOPSIS"
\fBgenssky month day hour [-y year] [-d AOD] [-c cloud_cover] [-l file] [-p dir] [-g grefl] [-n nproc] [-r res] [-f outname]\fR
.br

.SH "DESCRIPTION"
\fIGenssky\fR produces a RADIANCE scene description of spectral sky and ground using the precomputed atmospheric scattering method (Bruneton et al). For a given atmospheric condition, a set of Radiance data files are pre-computed and reused for other solar positions. A "atmos_data" directory will be created in the current working directory to store the precomputed atmospheric data. This directory can be created elsewhere using the \fI-p\fR flag. Precomputation can be sped up using multithreading with the \fI-n\fR flag. Extraterestrial solar radiation are spectrally resolved from 380-780nm at 20nm interval and constant regardless of location and time. The resulting sky source is in the same spectra range written to stdout. The sky and ground hyperspectral map are written to files {prefix}_sky.hsr, {prefix}_ground.hsr. The default prefix is "out" and can be changed using \fI-f\fR flag. The two .hsr files stores the fisheye spectral image of the sky and ground, with a default resolution of 128x128, which can be changed using \fI-r\fR flag.

.br

Genssky models the mie scattering differently from the original implementation.  Instead of assuming exponential decay uniformly across the spectral range, the mie scattering coefficients, as a functinon of the altitude, are computed into a lookup table using libradtran radiative transfer solver and interpolated directly during precomputation. The default mie scattering profile is OPAC continental average, and can be overridden using the \fI-l\fR flag. The overall aerosol profile can also be scaled linearly by applying a broadband aerosol depth value using the \fI-d\fR flag.

.br

Rayleigh scattering as a function of altitude is assumed to be exponential decay. The Rayleigh scattering coefficients at sea level are taken from Anderson et al (1986). There are a total of five sets of Rayleigh scattering data: mid-latitude summer, mid-latitude winter, sub-arctic summer, sub-arctic winter, and tropical. Latitudes are divided at 23.5 and 62.5 deg and summer is from month [4-9]. The scale-height of each Rayleigh scattering profile are tuned to fit the corresponding results from a libradtran calculation.

.br

Non-clear conditions are modeled by linearly interpolating between clear sky and CIE overcast sky.  The resulting sky is the weighted (cloud cover) average of clear and overcast sky. The overcast sky has a CCT of 6415K, from which the daylight spectra was computed.

.br

\fIgenssky\fR can be used with the following input parameters.

.br

\fB-a        Latitude in degree, north positive. Used along with datetime to determine solar angle and Rayleigh scattering profile.
.br

\fB-c        Total cloud cover, value ranging from 0(clear)-1(overcast), default=0.
.br

\fB-d        Broadband aerosol optical depth, default: 0.115. This parameter linearlly scales the overall aerosol scattering, default=0.115.
.br

\fB-f        Output sky map file name prefix, default="out"
.br

\fB-g        Average ground reflectance, default=0.2
.br

\fB-l        Custom Mie scattering profile file
.br

\fB-m        Standard meridian, west positive. For example, UTC-8:00 = 120. Used to calculated solar angle.
.br

\fB-n        Number of threads for precomputation, no benefits beyond 16 threads
.br

\fB-o        Longitude in degree, west positive. Used to calculated solar angle.
.br

\fB-p        Set directory to store the hyperspectral image and precomputed atmopsheric data directory, default=current working directory.
.br

\fB-r        Sky hyperspectral image x resolution. default=128. y resolution is half of x resolution.
.br

\fB-y        Set year to invoke a more accurate algorithm to calculate solar angles, default=0.
.br


.SH "EXAMPLES"
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:
.br

  genssky 3 2 15.25 -a 42 -o 108 -m 110 -n 8

.br

For the same sky but with 100 percent total cloud cover:
.br

  genssky 3 2 15.25 -a 42 -o 108 -m 110 -n 8 -c 1

.br


.SH "FILES"
/usr/local/lib/ray/mie_ca.dat
.br

.SH "AUTHOR"
Taoning Wang
.br

.SH "SEE ALSO"
gensky(1), rcomb(1), rcontrib(1), rpict(1), rtpict(1),
rtrace(1), xform(1)
.br
Revision:	1.3
Committed:	Fri Aug 2 18:47:25 2024 UTC (9 months ago) by greg
Branch:	MAIN
Changes since 1.2:	+2 -2 lines
Log Message:	feat(gensdaymtx,epw2wea,genssky): Taoning added new gensdaymtx and updated others
#	User	Rev	Content
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	greg	1.2	.br
6
7	greg	1.1	.SH "SYNOPSIS"
8	greg	1.2	\fBgenssky month day hour [-y year] [-d AOD] [-c cloud_cover] [-l file] [-p dir] [-g grefl] [-n nproc] [-r res] [-f outname]\fR
9			.br
10
11	greg	1.1	.SH "DESCRIPTION"
12	greg	1.2	\fIGenssky\fR produces a RADIANCE scene description of spectral sky and ground using the precomputed atmospheric scattering method (Bruneton et al). For a given atmospheric condition, a set of Radiance data files are pre-computed and reused for other solar positions. A "atmos_data" directory will be created in the current working directory to store the precomputed atmospheric data. This directory can be created elsewhere using the \fI-p\fR flag. Precomputation can be sped up using multithreading with the \fI-n\fR flag. Extraterestrial solar radiation are spectrally resolved from 380-780nm at 20nm interval and constant regardless of location and time. The resulting sky source is in the same spectra range written to stdout. The sky and ground hyperspectral map are written to files {prefix}_sky.hsr, {prefix}_ground.hsr. The default prefix is "out" and can be changed using \fI-f\fR flag. The two .hsr files stores the fisheye spectral image of the sky and ground, with a default resolution of 128x128, which can be changed using \fI-r\fR flag.
13
14			.br
15
16			Genssky models the mie scattering differently from the original implementation. Instead of assuming exponential decay uniformly across the spectral range, the mie scattering coefficients, as a functinon of the altitude, are computed into a lookup table using libradtran radiative transfer solver and interpolated directly during precomputation. The default mie scattering profile is OPAC continental average, and can be overridden using the \fI-l\fR flag. The overall aerosol profile can also be scaled linearly by applying a broadband aerosol depth value using the \fI-d\fR flag.
17
18			.br
19
20			Rayleigh scattering as a function of altitude is assumed to be exponential decay. The Rayleigh scattering coefficients at sea level are taken from Anderson et al (1986). There are a total of five sets of Rayleigh scattering data: mid-latitude summer, mid-latitude winter, sub-arctic summer, sub-arctic winter, and tropical. Latitudes are divided at 23.5 and 62.5 deg and summer is from month [4-9]. The scale-height of each Rayleigh scattering profile are tuned to fit the corresponding results from a libradtran calculation.
21
22			.br
23
24			Non-clear conditions are modeled by linearly interpolating between clear sky and CIE overcast sky. The resulting sky is the weighted (cloud cover) average of clear and overcast sky. The overcast sky has a CCT of 6415K, from which the daylight spectra was computed.
25
26			.br
27
28	greg	1.1	\fIgenssky\fR can be used with the following input parameters.
29	greg	1.2
30			.br
31
32	greg	1.1	\fB-a Latitude in degree, north positive. Used along with datetime to determine solar angle and Rayleigh scattering profile.
33			.br
34
35			\fB-c Total cloud cover, value ranging from 0(clear)-1(overcast), default=0.
36			.br
37
38			\fB-d Broadband aerosol optical depth, default: 0.115. This parameter linearlly scales the overall aerosol scattering, default=0.115.
39			.br
40
41	greg	1.2	\fB-f Output sky map file name prefix, default="out"
42	greg	1.1	.br
43
44			\fB-g Average ground reflectance, default=0.2
45			.br
46
47			\fB-l Custom Mie scattering profile file
48			.br
49
50			\fB-m Standard meridian, west positive. For example, UTC-8:00 = 120. Used to calculated solar angle.
51			.br
52
53			\fB-n Number of threads for precomputation, no benefits beyond 16 threads
54			.br
55
56			\fB-o Longitude in degree, west positive. Used to calculated solar angle.
57			.br
58
59	greg	1.3	\fB-p Set directory to store the hyperspectral image and precomputed atmopsheric data directory, default=current working directory.
60	greg	1.2	.br
61
62	greg	1.3	\fB-r Sky hyperspectral image x resolution. default=128. y resolution is half of x resolution.
63	greg	1.1	.br
64
65	greg	1.2	\fB-y Set year to invoke a more accurate algorithm to calculate solar angles, default=0.
66			.br
67
68	greg	1.1
69			.SH "EXAMPLES"
70			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:
71			.br
72
73			genssky 3 2 15.25 -a 42 -o 108 -m 110 -n 8
74
75			.br
76
77			For the same sky but with 100 percent total cloud cover:
78			.br
79
80			genssky 3 2 15.25 -a 42 -o 108 -m 110 -n 8 -c 1
81
82			.br
83
84
85			.SH "FILES"
86			/usr/local/lib/ray/mie_ca.dat
87			.br
88
89			.SH "AUTHOR"
90			Taoning Wang
91			.br
92
93			.SH "SEE ALSO"
94	greg	1.2	gensky(1), rcomb(1), rcontrib(1), rpict(1), rtpict(1),
95	greg	1.1	rtrace(1), xform(1)
96			.br