src/gen/gensky.c

/* Copyright (c) 1992 Regents of the University of California */

#ifndef lint
static char SCCSid[] = "$SunId$ LBL";
#endif

/*
 *  gensky.c - program to generate sky functions.
 *              Our zenith is along the Z-axis, the X-axis
 *              points east, and the Y-axis points north.
 *              Radiance is in watts/steradian/sq. meter.
 *
 *     3/26/86
 */

#include  <stdio.h>

#include  <math.h>

#include  "color.h"

extern char  *strcpy(), *strcat(), *malloc();
extern double  stadj(), sdec(), sazi(), salt();

#define  PI             3.141592654

#define  DOT(v1,v2)     (v1[0]*v2[0]+v1[1]*v2[1]+v1[2]*v2[2])

double  normsc();
                                        /* sun calculation constants */
extern double  s_latitude;
extern double  s_longitude;
extern double  s_meridian;
                                        /* required values */
int  month, day;                                /* date */
double  hour;                                   /* time */
int  tsolar;                                    /* 0=standard, 1=solar */
double  altitude, azimuth;                      /* or solar angles */
                                        /* default values */
int  cloudy = 0;                                /* 1=standard, 2=uniform */
int  dosun = 1;
double  zenithbr = -1.0;
double  turbidity = 2.75;
double  gprefl = 0.2;
                                        /* computed values */
double  sundir[3];
double  groundbr;
double  F2;
double  solarbr = -1.0;

char  *progname;
char  errmsg[128];


main(argc, argv)
int  argc;
char  *argv[];
{
        int  i;

        progname = argv[0];
        if (argc == 2 && !strcmp(argv[1], "-defaults")) {
                printdefaults();
                exit(0);
        }
        if (argc < 4)
                userror("arg count");
        if (!strcmp(argv[1], "-ang")) {
                altitude = atof(argv[2]) * (PI/180);
                azimuth = atof(argv[3]) * (PI/180);
                month = 0;
        } else {
                month = atoi(argv[1]);
                if (month < 1 || month > 12)
                        userror("bad month");
                day = atoi(argv[2]);
                if (day < 1 || day > 31)
                        userror("bad day");
                hour = atof(argv[3]);
                if (hour < 0 || hour >= 24)
                        userror("bad hour");
                tsolar = argv[3][0] == '+';
        }
        for (i = 4; i < argc; i++)
                if (argv[i][0] == '-' || argv[i][0] == '+')
                        switch (argv[i][1]) {
                        case 's':
                                cloudy = 0;
                                dosun = argv[i][0] == '+';
                                break;
                        case 'r':
                                solarbr = atof(argv[++i]);
                                break;
                        case 'c':
                                cloudy = argv[i][0] == '+' ? 2 : 1;
                                dosun = 0;
                                break;
                        case 't':
                                turbidity = atof(argv[++i]);
                                break;
                        case 'b':
                                zenithbr = atof(argv[++i]);
                                break;
                        case 'g':
                                gprefl = atof(argv[++i]);
                                break;
                        case 'a':
                                s_latitude = atof(argv[++i]) * (PI/180);
                                break;
                        case 'o':
                                s_longitude = atof(argv[++i]) * (PI/180);
                                break;
                        case 'm':
                                s_meridian = atof(argv[++i]) * (PI/180);
                                break;
                        default:
                                sprintf(errmsg, "unknown option: %s", argv[i]);
                                userror(errmsg);
                        }
                else
                        userror("bad option");

        if (fabs(s_meridian-s_longitude) > 30*PI/180)
                fprintf(stderr,
        "%s: warning: %.1f hours btwn. standard meridian and longitude\n",
                        progname, (s_longitude-s_meridian)*12/PI);

        printhead(argc, argv);

        computesky();
        printsky();
}


computesky()                    /* compute sky parameters */
{
                                        /* compute solar direction */
        if (month) {                    /* from date and time */
                int  jd;
                double  sd, st;

                jd = jdate(month, day);         /* Julian date */
                sd = sdec(jd);                  /* solar declination */
                if (tsolar)                     /* solar time */
                        st = hour;
                else
                        st = hour + stadj(jd);
                altitude = salt(sd, st);
                azimuth = sazi(sd, st);
                printf("# Solar altitude and azimuth: %f %f\n",
                                180./PI*altitude, 180./PI*azimuth);
        }
        if (!cloudy && altitude > 87.*PI/180.) {
                fprintf(stderr,
"%s: warning - sun too close to zenith, reducing altitude to 87 degrees\n",
                                progname);
                printf(
"# warning - sun too close to zenith, reducing altitude to 87 degrees\n");
                altitude = 87.*PI/180.;
        }
        sundir[0] = -sin(azimuth)*cos(altitude);
        sundir[1] = -cos(azimuth)*cos(altitude);
        sundir[2] = sin(altitude);

                                        /* Compute zenith brightness */
        if (zenithbr <= 0.0)
                if (cloudy) {
                        zenithbr = 8.6*sundir[2] + .123;
                        zenithbr *= 1000.0/WHTEFFICACY;
                } else {
                        zenithbr = (1.376*turbidity-1.81)*tan(altitude)+0.38;
                        zenithbr *= 1000.0/SKYEFFICACY;
                }
        if (zenithbr < 0.0)
                zenithbr = 0.0;
                                        /* Compute horizontal radiance */
        if (cloudy) {
                if (cloudy == 2)
                        groundbr = zenithbr;
                else
                        groundbr = zenithbr*0.777778;
                printf("# Ground ambient level: %f\n", groundbr);
        } else {
                F2 = 0.274*(0.91 + 10.0*exp(-3.0*(PI/2.0-altitude)) +
                                0.45*sundir[2]*sundir[2]);
                groundbr = zenithbr*normsc(altitude)/F2/PI;
                printf("# Ground ambient level: %f\n", groundbr);
                if (sundir[2] > 0.0 && solarbr != 0.0) {
                        if (solarbr < 0.0)
                                solarbr = 1.5e9/SUNEFFICACY *
                                (1.147 - .147/(sundir[2]>.16?sundir[2]:.16));
                        groundbr += solarbr*6e-5*sundir[2]/PI;
                } else
                        dosun = 0;
        }
        groundbr *= gprefl;
}


printsky()                      /* print out sky */
{
        if (dosun) {
                printf("\nvoid light solar\n");
                printf("0\n0\n");
                printf("3 %.2e %.2e %.2e\n", solarbr, solarbr, solarbr);
                printf("\nsolar source sun\n");
                printf("0\n0\n");
                printf("4 %f %f %f 0.5\n", sundir[0], sundir[1], sundir[2]);
        }
        
        printf("\nvoid brightfunc skyfunc\n");
        printf("2 skybright skybright.cal\n");
        printf("0\n");
        if (cloudy)
                printf("3 %d %.2e %.2e\n", cloudy, zenithbr, groundbr);
        else
                printf("7 -1 %.2e %.2e %.2e %f %f %f\n", zenithbr, groundbr,
                                F2, sundir[0], sundir[1], sundir[2]);
}


printdefaults()                 /* print default values */
{
        if (cloudy == 1)
                printf("-c\t\t\t\t# Cloudy sky\n");
        else if (cloudy == 2)
                printf("+c\t\t\t\t# Uniform cloudy sky\n");
        else if (dosun)
                printf("+s\t\t\t\t# Sunny sky with sun\n");
        else
                printf("-s\t\t\t\t# Sunny sky without sun\n");
        printf("-g %f\t\t\t# Ground plane reflectance\n", gprefl);
        if (zenithbr > 0.0)
                printf("-b %f\t\t\t# Zenith radiance (watts/ster/m2\n", zenithbr);
        else
                printf("-t %f\t\t\t# Atmospheric turbidity\n", turbidity);
        printf("-a %f\t\t\t# Site latitude (degrees)\n", s_latitude*(180/PI));
        printf("-o %f\t\t\t# Site longitude (degrees)\n", s_longitude*(180/PI));
        printf("-m %f\t\t\t# Standard meridian (degrees)\n", s_meridian*(180/PI));
}


userror(msg)                    /* print usage error and quit */
char  *msg;
{
        if (msg != NULL)
                fprintf(stderr, "%s: Use error - %s\n", progname, msg);
        fprintf(stderr, "Usage: %s month day hour [options]\n", progname);
        fprintf(stderr, "   Or: %s -ang altitude azimuth [options]\n", progname);
        fprintf(stderr, "   Or: %s -defaults\n", progname);
        exit(1);
}


double
normsc(theta)                   /* compute normalization factor (E0*F2/L0) */
double  theta;
{
        static double  nf[5] = {2.766521, 0.547665,
                                -0.369832, 0.009237, 0.059229};
        double  x, nsc;
        register int  i;
                                        /* polynomial approximation */
        x = (theta - PI/4.0)/(PI/4.0);
        nsc = nf[4];
        for (i = 3; i >= 0; i--)
                nsc = nsc*x + nf[i];

        return(nsc);
}


printhead(ac, av)               /* print command header */
register int  ac;
register char  **av;
{
        putchar('#');
        while (ac--) {
                putchar(' ');
                fputs(*av++, stdout);
        }
        putchar('\n');
}
Revision:	2.11
Committed:	Mon Jun 7 14:51:22 1993 UTC (30 years, 10 months ago) by greg
Content type:	text/plain
Branch:	MAIN
Changes since 2.10:	+2 -0 lines
Log Message:	added comment output regarding solar altitude and azimuth
#	User	Rev	Content
1	greg	2.9	/* Copyright (c) 1992 Regents of the University of California */
2	greg	1.1
3			#ifndef lint
4			static char SCCSid[] = "$SunId$ LBL";
5			#endif
6
7			/*
8			* gensky.c - program to generate sky functions.
9			* Our zenith is along the Z-axis, the X-axis
10			* points east, and the Y-axis points north.
11			* Radiance is in watts/steradian/sq. meter.
12			*
13			* 3/26/86
14			*/
15
16			#include <stdio.h>
17
18			#include <math.h>
19
20	greg	1.6	#include "color.h"
21	greg	1.1
22			extern char strcpy(), strcat(), *malloc();
23			extern double stadj(), sdec(), sazi(), salt();
24
25			#define PI 3.141592654
26
27			#define DOT(v1,v2) (v1[0]v2[0]+v1[1]v2[1]+v1[2]*v2[2])
28
29			double normsc();
30			/* sun calculation constants */
31			extern double s_latitude;
32			extern double s_longitude;
33			extern double s_meridian;
34			/* required values */
35	greg	2.3	int month, day; /* date */
36	greg	2.5	double hour; /* time */
37			int tsolar; /* 0=standard, 1=solar */
38	greg	2.3	double altitude, azimuth; /* or solar angles */
39	greg	1.1	/* default values */
40	greg	2.4	int cloudy = 0; /* 1=standard, 2=uniform */
41	greg	1.1	int dosun = 1;
42			double zenithbr = -1.0;
43			double turbidity = 2.75;
44			double gprefl = 0.2;
45			/* computed values */
46			double sundir[3];
47			double groundbr;
48			double F2;
49	greg	2.8	double solarbr = -1.0;
50	greg	1.1
51			char *progname;
52			char errmsg[128];
53
54
55			main(argc, argv)
56			int argc;
57			char *argv[];
58			{
59			int i;
60
61			progname = argv[0];
62			if (argc == 2 && !strcmp(argv[1], "-defaults")) {
63			printdefaults();
64			exit(0);
65			}
66			if (argc < 4)
67			userror("arg count");
68	greg	2.3	if (!strcmp(argv[1], "-ang")) {
69			altitude = atof(argv[2]) * (PI/180);
70			azimuth = atof(argv[3]) * (PI/180);
71			month = 0;
72			} else {
73			month = atoi(argv[1]);
74	greg	2.6	if (month < 1 \|\| month > 12)
75			userror("bad month");
76	greg	2.3	day = atoi(argv[2]);
77	greg	2.6	if (day < 1 \|\| day > 31)
78			userror("bad day");
79	greg	2.3	hour = atof(argv[3]);
80	greg	2.6	if (hour < 0 \|\| hour >= 24)
81			userror("bad hour");
82	greg	2.5	tsolar = argv[3][0] == '+';
83	greg	2.3	}
84	greg	1.1	for (i = 4; i < argc; i++)
85			if (argv[i][0] == '-' \|\| argv[i][0] == '+')
86			switch (argv[i][1]) {
87			case 's':
88			cloudy = 0;
89			dosun = argv[i][0] == '+';
90			break;
91	greg	2.8	case 'r':
92			solarbr = atof(argv[++i]);
93			break;
94	greg	1.1	case 'c':
95	greg	2.4	cloudy = argv[i][0] == '+' ? 2 : 1;
96	greg	1.1	dosun = 0;
97			break;
98			case 't':
99			turbidity = atof(argv[++i]);
100			break;
101			case 'b':
102			zenithbr = atof(argv[++i]);
103			break;
104			case 'g':
105			gprefl = atof(argv[++i]);
106			break;
107			case 'a':
108			s_latitude = atof(argv[++i]) * (PI/180);
109			break;
110			case 'o':
111			s_longitude = atof(argv[++i]) * (PI/180);
112			break;
113			case 'm':
114			s_meridian = atof(argv[++i]) * (PI/180);
115			break;
116			default:
117			sprintf(errmsg, "unknown option: %s", argv[i]);
118			userror(errmsg);
119			}
120			else
121			userror("bad option");
122	greg	1.5
123			if (fabs(s_meridian-s_longitude) > 30*PI/180)
124			fprintf(stderr,
125			"%s: warning: %.1f hours btwn. standard meridian and longitude\n",
126			progname, (s_longitude-s_meridian)*12/PI);
127	greg	1.1
128			printhead(argc, argv);
129
130			computesky();
131			printsky();
132			}
133
134
135			computesky() /* compute sky parameters */
136			{
137			/* compute solar direction */
138	greg	2.3	if (month) { /* from date and time */
139			int jd;
140			double sd, st;
141
142			jd = jdate(month, day); /* Julian date */
143			sd = sdec(jd); /* solar declination */
144	greg	2.5	if (tsolar) /* solar time */
145			st = hour;
146			else
147			st = hour + stadj(jd);
148	greg	2.3	altitude = salt(sd, st);
149			azimuth = sazi(sd, st);
150	greg	2.11	printf("# Solar altitude and azimuth: %f %f\n",
151			180./PIaltitude, 180./PIazimuth);
152	greg	2.9	}
153			if (!cloudy && altitude > 87.*PI/180.) {
154			fprintf(stderr,
155			"%s: warning - sun too close to zenith, reducing altitude to 87 degrees\n",
156			progname);
157			printf(
158			"# warning - sun too close to zenith, reducing altitude to 87 degrees\n");
159			altitude = 87.*PI/180.;
160	greg	2.3	}
161	greg	1.1	sundir[0] = -sin(azimuth)*cos(altitude);
162			sundir[1] = -cos(azimuth)*cos(altitude);
163			sundir[2] = sin(altitude);
164
165			/* Compute zenith brightness */
166			if (zenithbr <= 0.0)
167			if (cloudy) {
168			zenithbr = 8.6*sundir[2] + .123;
169	greg	2.6	zenithbr *= 1000.0/WHTEFFICACY;
170	greg	1.1	} else {
171			zenithbr = (1.376turbidity-1.81)tan(altitude)+0.38;
172	greg	1.6	zenithbr *= 1000.0/SKYEFFICACY;
173	greg	1.1	}
174	greg	1.2	if (zenithbr < 0.0)
175			zenithbr = 0.0;
176	greg	1.1	/* Compute horizontal radiance */
177			if (cloudy) {
178	greg	2.4	if (cloudy == 2)
179			groundbr = zenithbr;
180			else
181			groundbr = zenithbr*0.777778;
182	greg	1.1	printf("# Ground ambient level: %f\n", groundbr);
183			} else {
184			F2 = 0.274(0.91 + 10.0exp(-3.0*(PI/2.0-altitude)) +
185			0.45sundir[2]sundir[2]);
186	greg	2.6	groundbr = zenithbr*normsc(altitude)/F2/PI;
187	greg	1.1	printf("# Ground ambient level: %f\n", groundbr);
188	greg	2.8	if (sundir[2] > 0.0 && solarbr != 0.0) {
189			if (solarbr < 0.0)
190			solarbr = 1.5e9/SUNEFFICACY *
191			(1.147 - .147/(sundir[2]>.16?sundir[2]:.16));
192	greg	1.1	groundbr += solarbr6e-5sundir[2]/PI;
193			} else
194			dosun = 0;
195			}
196			groundbr *= gprefl;
197			}
198
199
200			printsky() /* print out sky */
201			{
202			if (dosun) {
203			printf("\nvoid light solar\n");
204			printf("0\n0\n");
205	greg	1.6	printf("3 %.2e %.2e %.2e\n", solarbr, solarbr, solarbr);
206	greg	1.1	printf("\nsolar source sun\n");
207			printf("0\n0\n");
208			printf("4 %f %f %f 0.5\n", sundir[0], sundir[1], sundir[2]);
209			}
210
211			printf("\nvoid brightfunc skyfunc\n");
212			printf("2 skybright skybright.cal\n");
213			printf("0\n");
214			if (cloudy)
215	greg	2.4	printf("3 %d %.2e %.2e\n", cloudy, zenithbr, groundbr);
216	greg	1.1	else
217	greg	1.6	printf("7 -1 %.2e %.2e %.2e %f %f %f\n", zenithbr, groundbr,
218			F2, sundir[0], sundir[1], sundir[2]);
219	greg	1.1	}
220
221
222			printdefaults() /* print default values */
223			{
224	greg	2.4	if (cloudy == 1)
225	greg	1.1	printf("-c\t\t\t\t# Cloudy sky\n");
226	greg	2.4	else if (cloudy == 2)
227			printf("+c\t\t\t\t# Uniform cloudy sky\n");
228	greg	1.1	else if (dosun)
229			printf("+s\t\t\t\t# Sunny sky with sun\n");
230			else
231			printf("-s\t\t\t\t# Sunny sky without sun\n");
232			printf("-g %f\t\t\t# Ground plane reflectance\n", gprefl);
233			if (zenithbr > 0.0)
234			printf("-b %f\t\t\t# Zenith radiance (watts/ster/m2\n", zenithbr);
235			else
236			printf("-t %f\t\t\t# Atmospheric turbidity\n", turbidity);
237			printf("-a %f\t\t\t# Site latitude (degrees)\n", s_latitude*(180/PI));
238			printf("-o %f\t\t\t# Site longitude (degrees)\n", s_longitude*(180/PI));
239			printf("-m %f\t\t\t# Standard meridian (degrees)\n", s_meridian*(180/PI));
240			}
241
242
243			userror(msg) /* print usage error and quit */
244			char *msg;
245			{
246			if (msg != NULL)
247			fprintf(stderr, "%s: Use error - %s\n", progname, msg);
248			fprintf(stderr, "Usage: %s month day hour [options]\n", progname);
249	greg	2.3	fprintf(stderr, " Or: %s -ang altitude azimuth [options]\n", progname);
250	greg	1.1	fprintf(stderr, " Or: %s -defaults\n", progname);
251			exit(1);
252			}
253
254
255			double
256			normsc(theta) /* compute normalization factor (E0F2/L0) /
257			double theta;
258			{
259			static double nf[5] = {2.766521, 0.547665,
260			-0.369832, 0.009237, 0.059229};
261			double x, nsc;
262			register int i;
263			/* polynomial approximation */
264			x = (theta - PI/4.0)/(PI/4.0);
265			nsc = nf[4];
266			for (i = 3; i >= 0; i--)
267			nsc = nsc*x + nf[i];
268
269			return(nsc);
270			}
271
272
273			printhead(ac, av) /* print command header */
274			register int ac;
275			register char **av;
276			{
277			putchar('#');
278			while (ac--) {
279			putchar(' ');
280			fputs(*av++, stdout);
281			}
282			putchar('\n');
283			}