ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/src/util/cieskyscan.cal
Revision: 2.2
Committed: Fri Nov 14 23:51:42 2025 UTC (45 hours, 30 minutes ago) by greg
Branch: MAIN
CVS Tags: HEAD
Changes since 2.1: +18 -11 lines
Log Message:
feat(rfluxmtx,rxfluxmtx): Added bin sample jittering for smoother visual results

File Contents

# User Rev Content
1 greg 2.2 { RCSid $Id: cieskyscan.cal,v 2.1 2024/02/08 02:26:01 greg Exp $ }
2 greg 2.1 {
3     Compute CIE standard sky scanner bin (cbin)
4     Different azimuth origin, alignment, and winding than Tregenza/Reinhart
5    
6 greg 2.2 RHS - right-handed system?
7     JTR - bin jitter/mixing amount
8 greg 2.1 Dx,Dy,Dz - Incident direction (normalized, towards surface face)
9     rNx,rNy,rNz - Surface normal (normalized, away from surface)
10     Ux,Uy,Uz - Up direction vector (does not need to be normalized)
11    
12     Modified from reinhartb.cal
13    
14     Feburary 2024 G. Ward
15     }
16     { Useful factors and functions }
17 greg 2.2 DEGREE` : PI/180;
18     mod`(n,d) : n - floor(n/d)*d;
19 greg 2.1 Asin(x) : if(x-1, PI/2, if(-1-x, -PI/2, asin(x))) / DEGREE;
20 greg 2.2 Atan2(y,x) : mod( atan2(y,x)/DEGREE, 360);
21 greg 2.1 { Set to -1 for left-handed coordinate system }
22     RHS = 1;
23 greg 2.2 { Sharp bin boundaries by default }
24     JTR = 0;
25 greg 2.1 { Default axis orientation (+Y == north) }
26     rNx = 0; rNy = 0; rNz = -1;
27     Ux = 0; Uy = 1; Uz = 0;
28     { Compute oriented axis angles }
29     inc_dz = -Dx*rNx-Dy*rNy-Dz*rNz;
30     inc_rx = -RHS*(Dx*(Uy*rNz-Uz*rNy) + Dy*(Uz*rNx-Ux*rNz) + Dz*(Ux*rNy-Uy*rNx));
31     inc_ry = Dx*Ux+Dy*Uy+Dz*Uz + inc_dz*(rNx*Ux+rNy*Uy+rNz*Uz);
32    
33     r_alt = Asin(inc_dz);
34     c_azi = Atan2(-inc_rx,-inc_ry);
35    
36     calpha : 90/7.5; { Separation between rows in degrees }
37     { Number of patches per row }
38     cnaz(r) : select(r+1, 30, 30, 24, 24, 18, 12, 6, 1);
39 greg 2.2 CNR : cnaz(-1);
40 greg 2.1
41     caccum(r) : if(r-.5, cnaz(r-1) + caccum(r-1), 0);
42 greg 2.2 { Random perturbation for final bin # }
43     jtr1 = JTR*(.5 - rand(1.958*Dx - 5.386*Dy - 3.772*Dz));
44     jtr2 = JTR*(.5 - rand(-6.334*Dx - 2.165*Dy + 7.953*Dz));
45 greg 2.1
46 greg 2.2 c_row = if(JTR, min(max(0,floor(r_alt/calpha + jtr1)),CNR-1),
47     floor(r_alt/calpha));
48 greg 2.1
49     c_inc = 360/cnaz(c_row);
50    
51 greg 2.2 c_aznf = floor( mod(c_azi+if(JTR,jtr2*c_inc,0), 360) / c_inc );
52    
53 greg 2.1 fwd_row = floor(c_row/2+1.25) - c_row/2 - .75;
54    
55 greg 2.2 c_azn = if(fwd_row, c_aznf, cnaz(c_row)-1 - c_aznf);
56 greg 2.1
57     { Final bin value, -1 for "ground" }
58     cbin = if (r_alt, caccum(c_row) + c_azn, -1);
59    
60 greg 2.2 Ncbins : caccum(CNR); { total number of bins }