5.1.3 positions

5.1.3.1 What is this node for?

It is an element for describing a set of positions within an XML file.

5.1.3.2 Attributes

It has 3 attributes.

type

Mandatory. It is used to specify the kind of positions. Currently, there are 5 classifications of the type attribute.

  • noise: Noise position

  • microphone: Microphone positions

  • source: Localized sound source positions

  • tsp: Positions of TSP recording files

  • impulse: Positions of impulse response files

coordinate

Mandatory. It describes the position’s coordinate system. The value must be cartesian for Cartesian coordinate, or polar for Polar coordinate

frame

Optional. It is used when the position corresponds to a frame number.

5.1.3.3 Child Elements

The value of each position should be greater than or equal to zero. The attributes are mandatory and should have a fixed value.

id

: A unique number that signifies a position.

path

: The path of the file that corresponds to the position.

The coordinate attribute below depends on the position attribute settings of the root element.

If coordinate = "cartesian"

The attributes that represents the coordinate are x, y, and z. The unit is [mm].

If coordinate = "polar"

The attributes that represents the coordinate are azimuth, elevation, and radius. The unit is degree for both azimuth and elevation, and mm for radius.