6.7.32 SourceSelectorBySourceInfo

6.7.32.1 Outline of the node

A filtering node which filters the sound source localization results given as the input to obtain the result that satisfy the conditions specified by parameters based on the information (ID, power, azimuth angle, or elevation angle). Regarding ID or power of a sound source, output the sound source whose ID or power is the minimum, the maximum, or within a certain range specified. Regarding the direction of the sound source, output the sound source whose direction is in the nearest to the specified angle, or angle within a certain range specified.

6.7.32.2 Necessary file

No files are required.

6.7.32.3 Usage

When to use

This node is used to obtain the sound source localization results when the information on ID, power, or direction of the sound source is available, for instance, when it is known that there is no sound source expect in front. Alternatively, this node can be used to remove the sound source localization results when information on a sound source to be removed is known.

Typical connection

Figure 6.135 shows a connection example. Mainly connect sound source localization results obtained with ConstantLocalization , LoadSourceLocation , LocalizeMUSIC , etc.

\includegraphics[width=\linewidth ]{fig/modules/SourceSelectorBySourceInfo}
Figure 6.135: Connection example of SourceSelectorBySourceInfo is an Iterator  subnetwork

6.7.32.4 Input-output and property of the node

Input

SOURCES

: Vector<ObjectRef>  type. The sound source localization results. The ObjectRef refers to data in the Source type indicating the sound source information with an ID.

Output

OUTPUT

: Vector<ObjectRef>  type. The sound source localization results after filtering. The ObjectRef refers to data in the Source type indicating the sound source information with an ID.

Parameter

Table 6.133: Parameter list of SourceSelectorBySourceInfo 

Parameter list

Type

Default value

Unit

Description

SELECTION_TYPE

string 

ID

 

The filter condition for outputting data. Select ALL,ID,POWER,DIRECTION_AZIMUTH, or DIRECTION_ELEVATION.

ID_SELECTION_TYPE

string 

LATEST

 

The type of the sound source ID. Select LATEST。、OLDEST, or BETWEEN.

ID_RANGE_MIN

int 

0

 

The lower limit of the range for the sound source ID.

ID_RANGE_MAX

int 

0

 

The upper limit of the range for the sound source ID.

POWER_SELECTION_TYPE

string 

HIGHEST

 

The type of the sound source power. Select HIGHEST, LOWEST, or BETWEEN.

POWER_RANGE_MIN

float 

0

 

The lower limit of the range for the sound source power.

POWER_RANGE_MAX

float 

40.0

 

The upper limit of the range for the sound source power.

AZIMUTH_SELECTION_TYPE

string 

BETWEEN

 

The type of the azimuth of a sound source. Select NEAREST or BETWEEN.

AZIMUTH

float 

0

[deg]

The azimuth angle.

AZIMUTH_RANGE_MIN

float 

0

[deg]

The lower limit of the range for the azimuth angle of a sound source.

AZIMUTH_RANGE_MAX

float 

360.0

[deg]

The upper limit of the range for the azimuth angle of a sound source.

ELEVATION_SELECTION_TYPE

string 

BETWEEN

 

The type of the elevation of a sound source. Select NEAREST or BETWEEN.

ELEVATION

float 

0

[deg]

The elevation angle.

ELEVATION_RANGE_MIN

float 

0

[deg]

The lower limit of the range for the elevation angle of a sound source.

ELEVATION_RANGE_MAX

float 

90.0

[deg]

The upper limit of the range for the elevation angle of a sound source.

SELECTION_TYPE

: string  type. The filter condition for outputting data. Select ALL, ID, POWER, DIRECTION_AZIMUTH, or DIRECTION_ELEVATION. Selecting ALL outputs all results unconditionally. When selecting ID, POWER, or DIRECTION_AZIMUTH/DIRECTION_ELEVATION, output results that satisfy the conditions specified by the subsequent parameters for the sound source ID, the sound source power, or the sound source direction, respectively.

ID_SELECTION_TYPE

: string  type. The type of the sound source ID available when ID is selected in the SELECTION_TYPE parameter. Select LATEST, OLDEST, or BETWEEN. Selecting LATEST or OLDEST outputs the results of the sound source with the latest ID or the oldest ID. Selecting BETWEEN outputs the results of which ID are in between the values specified in ID_RANGE_MIN and ID_RANGE_MAX parameters. When multiple sound sources satisfy the condition, output the results of the multiple sound sources.

ID_RANGE_MIN

: int  type. The lower limit of the range for the sound source ID available when BETWEEN is selected in the ID_SELECTION_TYPE parameter.

ID_RANGE_MAX

: int  type. The upper limit of the range for the sound source ID available when BETWEEN is selected in the ID_SELECTION_TYPE parameter.

POWER_SELECTION_TYPE

: string  type. The type of the sound source power available when POWER is selected in the SELECTION_TYPE parameter. Select HIGHEST, LOWEST, or BETWEEN. Selecting HIGHEST or LOWEST outputs the results of the sound source with the highest power or the lowest power. Selecting BETWEEN outputs the results whose power is in between the values specified in POWER_RANGE_MIN and POWER_RANGE_MAX parameters. When multiple sound sources satisfy the condition, output the results of multiple sound sources.

POWER_RANGE_MIN

: float  type. The lower limit of the range for the sound source power available when BETWEEN is selected in the POWER_SELECTION_TYPE parameter.

POWER_RANGE_MAX

: float  type. The upper limit of the range for the sound source power available when BETWEEN is selected in the POWER_SELECTION_TYPE parameter.

AZIMUTH_SELECTION_TYPE

: string  type. The type of the azimuth of a sound source available when DIRECTION_AZIMUTH is selected in the SELECTION_TYPE parameter. Select NEAREST or BETWEEN. Selecting NEAREST outputs the result whose azimuth is located the nearest to the azimuth specified in the AZIMUTH parameter. Selecting BETWEEN outputs the results whose azimuth is in between the specific values specified in AZIMUTH_RANGE_MIN and AZIMUTH_RANGE_MAX parameters. When multiple sound sources satisfy the condition, output the results of multiple sound sources.

AZIMUTH

: float  type. The azimuth angle available when NEAREST is selected in the AZIMUTH_SELECTION_TYPE parameter.

AZIMUTH_RANGE_MIN

: float  type. The lower limit of the range for the azimuth angle of a sound source available when BETWEEN is selected in the AZIMUTH_SELECTION_TYPE parameter.

AZIMUTH_RANGE_MAX

: float  type. The upper limit of the range for the azimuth angle of a sound source available when BETWEEN is selected in the AZIMUTH_SELECTION_TYPE parameter.

ELEVATION_SELECTION_TYPE

: string  type. The type of the elevation of a sound source available when DIRECTION_ELEVATION is selected in the SELECTION_TYPE parameter. Select NEAREST or BETWEEN. Selecting NEAREST outputs the result whose elevation is located in the nearest to the elevation specified in the ELEVATION parameter. Selecting BETWEEN outputs the results whose elevation is in between the values specified in ELEVATION_RANGE_MIN and ELEVATION_RANGE_MAX parameters. When multiple sound sources satisfy the condition, output the results of multiple sound sources.

ELEVATION

: float  type. The elevation angle available when NEAREST is selected in the ELEVATION_SELECTION_TYPE.

ELEVATION_RANGE_MIN

: float  type. The lower limit of the range for the elevation angle of a sound source available when BETWEEN is selected in the ELEVATION_SELECTION_TYPE.

ELEVATION_RANGE_MAX

: float  type. The upper limit of the range for the elevation angle of a sound source available when BETWEEN is selected in the ELEVATION_SELECTION_TYPE.