net.idrnd.voicesdk.media

Class SNRComputer

java.lang.Object

net.idrnd.voicesdk.common.VoiceSdkNativePeer

net.idrnd.voicesdk.media.SNRComputer

All Implemented Interfaces:

java.lang.AutoCloseable

public class SNRComputer
extends VoiceSdkNativePeer

Calculates average Signal-to-Noise ratio, dB in the specified audio data.

This class serves as gateway to native Voice SDK implementation and allocates resources on native heap. To release the allocated memory, AutoCloseable.close() method should be invoked when the instance is no longer needed.

Any method that delegates to native call may throw VoiceSdkEngineException

Field Summary

Fields inherited from class net.idrnd.voicesdk.common.VoiceSdkNativePeer

nativeId

Constructor Summary

Constructors

Constructor and Description
SNRComputer(java.lang.String initPath) Initializes the instance.

Method Summary

Modifier and Type	Method and Description
float	compute(byte[] pcm16Bytes, int sampleRate) Calculates SNR over the specified audio buffer provided as an array of PCM16 samples.
float	compute(float[] floatSamples, int sampleRate) Calculates SNR over the specified audio buffer provided as an array of normalized float values.
float	compute(short[] pcm16Samples, int sampleRate) Calculates SNR over the specified audio buffer provided as an array of PCM16 samples.
float	compute(java.lang.String audioFile) Calculates SNR over the specified audio record.
protected float	compute1(byte[] pcm16Bytes, int sampleRate)
protected float	compute2(short[] pcm16Samples, int sampleRate)
protected float	compute3(float[] floatSamples, int sampleRate)
protected float	compute4(java.lang.String audioFile)
protected static long	init(java.lang.String initPath)
protected void	release() This method should release resources on native layer (indirectly using nativeId)

Methods inherited from class net.idrnd.voicesdk.common.VoiceSdkNativePeer

close, equals, finalize, hashCode

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SNRComputer

public SNRComputer(java.lang.String initPath)

Initializes the instance.

Parameters:

initPath - exactly the same as for SpeechSummaryEngine

Throws:

VoiceSdkEngineException - wraps native exceptions

Method Detail

compute

public float compute(byte[] pcm16Bytes,
                     int sampleRate)

Calculates SNR over the specified audio buffer provided as an array of PCM16 samples.

Parameters:

pcm16Bytes - Array of little-endian PCM16 audio bytes

sampleRate - audio stream sampling rate, Hz

Returns:

average SNR, dB

Throws:

VoiceSdkEngineException - wraps native exceptions

compute

public float compute(short[] pcm16Samples,
                     int sampleRate)

Calculates SNR over the specified audio buffer provided as an array of PCM16 samples.

Parameters:

pcm16Samples - Array of PCM16 audio samples

sampleRate - audio stream sampling rate, Hz

Returns:

average SNR, dB

Throws:

VoiceSdkEngineException - wraps native exceptions

compute

public float compute(float[] floatSamples,
                     int sampleRate)

Calculates SNR over the specified audio buffer provided as an array of normalized float values.

Parameters:

floatSamples - Array of float audio samples (in [-1, 1] range)

sampleRate - audio stream sampling rate, Hz

Returns:

average SNR, dB

Throws:

VoiceSdkEngineException - wraps native exceptions

compute

public float compute(java.lang.String audioFile)

Calculates SNR over the specified audio record.

Parameters:

audioFile - Path to the audio file

Returns:

average SNR, dB

Throws:

VoiceSdkEngineException - wraps native exceptions

init

protected static long init(java.lang.String initPath)

release

protected void release()

Description copied from class: VoiceSdkNativePeer

This method should release resources on native layer (indirectly using nativeId)

Specified by:

release in class VoiceSdkNativePeer

compute1

protected float compute1(byte[] pcm16Bytes,
                         int sampleRate)

compute2

protected float compute2(short[] pcm16Samples,
                         int sampleRate)

compute3

protected float compute3(float[] floatSamples,
                         int sampleRate)

compute4

protected float compute4(java.lang.String audioFile)