Receiver2D, Receiver3D

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

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

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

model.result().dataset().create(<dtag>,"Receiver2D") and model.result().dataset().create(<dtag>,"Receiver3D") create 2D and 3D receiver datasets, respectively. Use these datasets to collect the data necessary to visualize the impulse response for a Ray Acoustics simulation (of room acoustics, for example), using an Impulse Response plot. The Impulse Response plot uses the data from a Receiver dataset as input.

The following properties are available:

Table 7-119: Valid Property/Value Pairs for Receiver2D and Receiver3D Datasets
Name	Value	Default	Description
center	double array	{0, 0,} (2D); {0, 0, 0} (3D)	Center coordinates.
data	none \| dataset name	First ray dataset	The ray dataset this feature refers to.
directivity	omnidirectional \| user	omnidirectional	The directivity type: omnidirectional, or a user-defined expression (in dB),
directivityexpr	double	0	An expression for the directivity. Active when directivity is set to user.
dirvar	String	<dtag>dir	Variable for the directivity.
distance	double	0	Source-receiver distance. Active when radiusinput is set to expr.
distvar	String	<dtag>dist	Variable for the distance traveled.
extrasteps	all \| specifiedtimes \| proportional \| none	all	Specification of the maximum number of extra time steps rendered: all, as a specified number of times, as proportional to the number of solution times, or none.
firstvar	String	<dtag>first	Variable for the first ray arrival time.
interpolation	linear \| cubic	linear	Interpolation between time steps: linear or cubic.
nrays	integer	0	Number of rays. Active when radiusinput is set to expr.
numextrasteps	nonnegative integer	100	Maximum number of extra time steps. Active when extrasteps is set to specifiedtimes.
propextrasteps	nonnegative integer	1	Proportionality factor for extra time steps. Active when extrasteps is set to proportional.
radius	double	0	Radius. Active when radiusinput is set to user.
radiusinput	expr \| user	expr	Define the input for the radius using an expression or a user-defined radius.
volume	double	0	Room volume. Active when radiusinput is set to expr.
volvar	String	<dtag>vol	Variable for the volume.