RayBin

model.result().dataset().create(<dtag>,"RayBin");

model.result().dataset(<dtag>).set(property, <value>);

model.result().dataset().create(<dtag>,"RayBin") creates a ray bin dataset. This dataset evaluates an expression over all rays and then groups them into subintervals, or bins, based on which rays return similar values. If this dataset is then used in any other ray plot or evaluation, each bin produces a single ray having position and other properties equal to the average over rays in the bin.

The following properties are available:

Table 7-117: Valid Property/Value Pairs for Ray Bin Datasets
Name	Value	Default	Description
data	none \| dataset name	First ray dataset	The ray dataset this feature refers to.
distribution	equalnumber \| equalwidth	equalnumber	Distribution of ray bins. Active when method is set to number.
limits	String		String listing the limits of all bins. Active when method is set to limits.
method	limits \| number \| tolerance	limits	The method used to define the limits of the ray bins.
number	positive integer	10	Number of ray bins. Active when method is set to number.
tolerance	String		Maximum difference between expression values such that rays are placed in the same bin. Active when method is set to tolerance.