--- ray/doc/man/man1/rsensor.1	2008/04/22 02:08:02	1.2
+++ ray/doc/man/man1/rsensor.1	2015/06/09 21:34:14	1.6
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: rsensor.1,v 1.2 2008/04/22 02:08:02 greg Exp $"
+.\" RCSid "$Id: rsensor.1,v 1.6 2015/06/09 21:34:14 greg Exp $"
 .TH RSENSOR 1 4/11/2008 RADIANCE
 .SH NAME
 rsensor - compute sensor signal from a RADIANCE scene
@@ -29,6 +29,20 @@ rsensor - compute sensor signal from a RADIANCE scene
 }
 .B octree
 .br
+.B rsensor
+[
+.B -h
+]
+{
+[
+.B -rd nrays
+][
+.B sensor_view
+]
+.B sensor_file ..
+}
+.B "."
+.br
 .B "rsensor [ options ] \-defaults"
 .SH DESCRIPTION
 .I Rsensor
@@ -38,7 +52,12 @@ sensors into the RADIANCE scene given by
 sending the computed sensor value to the standard output.
 (The octree may be given as the output of a command enclosed in quotes
 and preceded by a `!'.)\0
-In the second form, the default values
+In the second form, a single period ('.') is given in place of an
+octree, and the origin and directions of the specified
+number of rays will be printed on the standard output.
+If these rays are later traced and added together, the results
+will sum to a signal proportional to the given sensor distribution.
+In the third form, the default values
 for the options (modified by those options present)
 are printed with a brief explanation.
 .PP
@@ -63,15 +82,21 @@ vector will determine the zero azimuthal direction of 
 The fore clipping distance may be used as well, but other view
 options will be ignored.
 (See
-.I rpict\.1
+.I rpict(1)
 for details on how to specify a view.)\0
 The actual data contained in the sensor file corresponds to the
 .I SPOT
 tab-separated matrix specification, where the
 column header has "degrees" in the leftmost column, followed
 by evenly-spaced azimuthal angles.
+Azimuth angles must start at 0 and proceed to at least 270 degrees.
+No symmetry is applied to missing values.
 Each row begins with the polar angle, and is followed by the
 relative sensitivity values for each direction.
+Polar angles must start from 0 and continue to the edge of
+the sensor's view.
+Polar angles above the last row listed are assumed to have
+zero sensitivity.
 A low-resolution example of a sensor file is given below:
 .sp
 .nf
@@ -86,7 +111,7 @@ sensors, where the
 .I \-rd
 option controls the number of ray samples sent at random, and the
 .I \-dn
-option controls the number of rays sent to light sources per sensor.
+option controls the number of rays sent to each light source per sensor.
 .PP
 The
 .I \-h
@@ -96,7 +121,7 @@ The
 option may be used to specify multiple calculation processes on
 systems with more than one CPU.
 For additional options, consult the
-.I rtrace\.1
+.I rtrace(1)
 man page.
 The final
 .I octree
@@ -106,9 +131,14 @@ standard input.
 To compute values for the same sensor with two different positions:
 .IP "" .2i
 rsensor -ab 2 -vf posA.vf mysens.dat -vf posB.vf mysens.dat scene.oct
+.PP
+To generate a set of rays corresponding to a given sensor and compute
+the resulting signal with rtrace:
+.IP "" .2i
+rsensor -h -vf posC.vf mysens.dat . | rtrace -h scene.oct | total -m
 .SH ENVIRONMENT
 RAYPATH		the directories to check for auxiliary files.
 .SH AUTHOR
 Greg Ward for Architectural Energy Corporation
 .SH "SEE ALSO"
-oconv(1), rpict(1), rtcontrib(1), rtrace(1)
+oconv(1), rpict(1), rcontrib(1), rtrace(1)