| 7 |
|
[ |
| 8 |
|
.B -n nprocs |
| 9 |
|
][ |
| 10 |
< |
.B rtrace options |
| 10 |
> |
.B -h |
| 11 |
> |
][ |
| 12 |
> |
.B render options |
| 13 |
|
] |
| 14 |
|
[ |
| 15 |
|
.B $EVAR |
| 29 |
|
} |
| 30 |
|
.B octree |
| 31 |
|
.br |
| 32 |
+ |
.B rsensor |
| 33 |
+ |
[ |
| 34 |
+ |
.B -h |
| 35 |
+ |
] |
| 36 |
+ |
{ |
| 37 |
+ |
[ |
| 38 |
+ |
.B -rd nrays |
| 39 |
+ |
][ |
| 40 |
+ |
.B sensor_view |
| 41 |
+ |
] |
| 42 |
+ |
.B sensor_file .. |
| 43 |
+ |
} |
| 44 |
+ |
.B "." |
| 45 |
+ |
.br |
| 46 |
|
.B "rsensor [ options ] \-defaults" |
| 47 |
|
.SH DESCRIPTION |
| 48 |
|
.I Rsensor |
| 52 |
|
sending the computed sensor value to the standard output. |
| 53 |
|
(The octree may be given as the output of a command enclosed in quotes |
| 54 |
|
and preceded by a `!'.)\0 |
| 55 |
< |
In the second form, the default values |
| 55 |
> |
In the second form, a single period ('.') is given in place of an |
| 56 |
> |
octree, and the origin and directions of the specified |
| 57 |
> |
number of rays will be printed on the standard output. |
| 58 |
> |
If these rays are later traced and added together, the results |
| 59 |
> |
will sum to a signal proportional to the given sensor distribution. |
| 60 |
> |
In the third form, the default values |
| 61 |
|
for the options (modified by those options present) |
| 62 |
|
are printed with a brief explanation. |
| 63 |
|
.PP |
| 79 |
|
In this case, the view origin and direction will correspond to |
| 80 |
|
the position and orientation of the sensor, and the view up |
| 81 |
|
vector will determine the zero azimuthal direction of the sensor. |
| 82 |
+ |
The fore clipping distance may be used as well, but other view |
| 83 |
+ |
options will be ignored. |
| 84 |
|
(See |
| 85 |
< |
.I rpict\.1 |
| 85 |
> |
.I rpict(1) |
| 86 |
|
for details on how to specify a view.)\0 |
| 87 |
|
The actual data contained in the sensor file corresponds to the |
| 88 |
|
.I SPOT |
| 89 |
|
tab-separated matrix specification, where the |
| 90 |
|
column header has "degrees" in the leftmost column, followed |
| 91 |
|
by evenly-spaced azimuthal angles. |
| 92 |
+ |
Azimuth angles must start at 0 and proceed to at least 270 degrees. |
| 93 |
+ |
No symmetry is applied to missing values. |
| 94 |
|
Each row begins with the polar angle, and is followed by the |
| 95 |
|
relative sensitivity values for each direction. |
| 96 |
+ |
Polar angles must start from 0 and continue to the edge of |
| 97 |
+ |
the sensor's view. |
| 98 |
+ |
Polar angles above the last row listed are assumed to have |
| 99 |
+ |
zero sensitivity. |
| 100 |
|
A low-resolution example of a sensor file is given below: |
| 101 |
|
.sp |
| 102 |
|
.nf |
| 111 |
|
.I \-rd |
| 112 |
|
option controls the number of ray samples sent at random, and the |
| 113 |
|
.I \-dn |
| 114 |
< |
option controls the number of rays sent to light sources per sensor. |
| 114 |
> |
option controls the number of rays sent to each light source per sensor. |
| 115 |
|
.PP |
| 116 |
|
The |
| 117 |
+ |
.I \-h |
| 118 |
+ |
option toggles header output, which defaults to "on." |
| 119 |
+ |
The |
| 120 |
|
.I \-n |
| 121 |
|
option may be used to specify multiple calculation processes on |
| 122 |
|
systems with more than one CPU. |
| 123 |
|
For additional options, consult the |
| 124 |
< |
.I rtrace\.1 |
| 124 |
> |
.I rtrace(1) |
| 125 |
|
man page. |
| 126 |
|
The final |
| 127 |
|
.I octree |
| 131 |
|
To compute values for the same sensor with two different positions: |
| 132 |
|
.IP "" .2i |
| 133 |
|
rsensor -ab 2 -vf posA.vf mysens.dat -vf posB.vf mysens.dat scene.oct |
| 134 |
+ |
.PP |
| 135 |
+ |
To generate a set of rays corresponding to a given sensor and compute |
| 136 |
+ |
the resulting signal with rtrace: |
| 137 |
+ |
.IP "" .2i |
| 138 |
+ |
rsensor -h -vf posC.vf mysens.dat . | rtrace -h scene.oct | total -m |
| 139 |
|
.SH ENVIRONMENT |
| 140 |
|
RAYPATH the directories to check for auxiliary files. |
| 141 |
|
.SH AUTHOR |
| 142 |
|
Greg Ward for Architectural Energy Corporation |
| 143 |
|
.SH "SEE ALSO" |
| 144 |
< |
oconv(1), rpict(1), rtcontrib(1), rtrace(1) |
| 144 |
> |
oconv(1), rpict(1), rcontrib(1), rtrace(1) |
