The SVAPI class provides a means for applications to find and connect to engines. Generic helper functions are also implemented in this class. The SVAPI class can also be run as a Java program to implement the engine registry for remote engine access.
See Also: Engine, EngineProperties, EnginePropertiesList
public static EnginePropertiesList availableVerificationEngines(Properties Props)
Returns an EnginePropertiesList containing the EngineProperties objects for all verification engines that match all the properties in Props.
Parameters:
See Also: VerificationEngine, createVerificationEngine
public static EnginePropertiesList availableIdentificationEngines(Properties Props)
Returns an EnginePropertiesList containing the EngineProperties objects for all identification engines that match all the properties in Props.
Parameters:
See Also: IdentificationEngine, createIdentificationEngine
public static EnginePropertiesList availableClassificationEngines(Properties Props)
Returns an EnginePropertiesList containing the EngineProperties objects for all classification engines that match all the properties in Props.
Parameters:
See Also: ClassificationEngine, createClassificationEngine
public static VerificationEngine createVerificationEngine(Properties Prop, EngineNotify Notify)
Creates a new verification engine defined by an EngineProperties description.
Exceptions:
public static IdentificationEngine createIdentificationEngine(Properties Prop, EngineNotify Notify)
Creates a new identification engine defined by an EngineProperties description.
Exceptions:
public static ClassificationEngine createClassificationEngine(Properties Prop, EngineNotify Notify)
Creates a new classification engine defined by an EngineProperties description.
Exceptions:
public static double[] generateHistogram(VerificationEngine Engine, ModelUtterancePair Data[])
Returns a histogram of raw scores for an engine. Each ModelUtterancePair specifies an utterance to verify against a model. This function returns an array of scalar raw scores, sorted in ascending order.
Parameters:
Exceptions:
See Also: getConfidenceData, verify, Score
public static ConfidenceMapping[] getConfidenceData(VerificationEngine Engine, double Data[], boolean ImpostorData)
Returns statistically generated confidence information for an engine. This function is useful for generating the curves that map raw scores to confidence levels. The confidence curve is generated from a histogram which might have been created by generateHistogram. This function returns an array of ConfidenceMapping classes, sorted in order of increasing raw score. The data in this array describes the confidence curve.
Parameters:
Exceptions:
See Also: generateHistogram, verify, Score
public static ConfidenceMapping[] getConfidenceData(VerificationEngine Engine, ModelUtterancePair Data[], boolean ImpostorData)
Returns statistically generated confidence information for an engine. This function is useful for generating the curves that map raw scores to confidence levels. The confidence curve is generated from verifying utterances against models. Each ModelUtterancePair generates a point on the curve. This function returns an array of ConfidenceMapping classes, sorted in order of increasing raw score. The data in this array describes the confidence curve.
Parameters:
Exceptions:
See Also: generateHistogram, verify, Score
public static void main(String args[])
This function allows this class to be run as a stand-alone program. The program creates a new engine registry and makes it available via an rmi registry. The engine registry is a remote object which allows engines to register themselves and applications to find remote engines. If there is no engine registry running, engine's can be registered with any rmi registry, but applications will not be able to query to find what remote engines are available. Management of the engine registry is automatic: no special action need be taken by applications or engines, but an engine registry does need to be started somewhere. This program can also be used to start up various transport objects for communicating with non-rmi (native) engines and applications. Valid command line options are:
-port N: looks for the rmi registry to bind to on port N
-server host: looks for the rmi registry to bind to on server host
-create: creates an rmi registry, rather than looking for an existing one
-transport: classname[;argument] starts the transport in class classname with an optional argument