| 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 |
| 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 |
| 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) |
