Open topic with navigation

# Package Templates

You can use a set of individual speaker template files during identification by supplying a list file that specifies the templates to use. However, it might be convenient to package these templates into a single speaker set file.

Using a speaker set file has several advantages:

- A single file simplifies the usage and distribution of the template set.
- The background model that is used during speaker training is packaged with the speaker templates, removing any chance of model mismatches if the base background model is subsequently updated.

You can use standard IDOL Speech Server tasks to add templates to an audio template set file (`.ivs`), remove templates from a set file, modify the threshold of a single template stored within an audio template set file, or to return information on the contents of a set file or an individual template file.

To add templates to an audio template set file

The `IvSpkIdSetAdd` task takes one or more audio template files, and adds them to an audio template set file. If the set file already exists prior to running the task, IDOL Speech Server adds the templates to the existing set.

- - Send an `AddTask` action to IDOL Speech Server, and set the following parameters:

  `Type` | The task name. Set to `IvSpkIdSetAdd`.
  `TemplateList` | A list file that specifies the templates to use, along with the name associated with each template.
  `TemplateSet` | The name of the template set file.

For example:

    http://localhost:15000/action=AddTask&Type=IvSpkIdSetAdd&TemplateList=ListManager/speakers&TemplateSet=speakers.ivs

This action uses port `15000` to instruct IDOL Speech Server, which is located on the local machine, to create the `speakers.ivs` template set file containing the templates listed by the `Listmanager/speakers` list file.

You can set additional parameters. For details of the optional parameters, see the IDOL Speech Server Reference.

This action returns a token. You can use the token to:

- Check the task status. See Check the Status of a Task.
- Retrieve the speaker template set file.

To remove a template from an audio template set file

This task removes the named template from the audio template set. If the template named is not found within the set, a task error is given.

- - Send an `AddTask` action to IDOL Speech Server, and set the following parameters:

  `Type` | The task name. Set to `IvSpkIdSetDelete`.
  `TemplateName` | The name associated with the template to remove.
  `TemplateSet` | The template set file from which to remove the template.

  For example:

      http://localhost:15000/action=AddTask&Type=IvSpkIdSetDelete&TemplateName=Brown&TemplateSet=speakers.ivs

  This action uses port `15000` to instruct IDOL Speech Server, which is located on the local machine, to remove the template associated with the name `Brown` from the `speakers.ivs` template set.

  You can set additional parameters. For details of the optional parameters, see the IDOL Speech Server Reference.

  This action returns a token. You can use the token to:

  - Check the task status. See Check the Status of a Task.
  - Retrieve the speaker template set file.

  To modify the threshold of a single template in an audio template set file

  You can use the `IvSpkIdEditThresh` task to modify the threshold of a single template in an audio template set file.

  - Send an `AddTask` action to IDOL Speech Server, and set the following parameters:

  `Type` | The task name. Set to `IvSpkIdEditThresh`.
  `TemplateName` | The name of the template to modify.
  `TemplateSet` | The template set file to modify.
  `Thresh` | The value to use for the threshold.

  For example:

  `http://localhost:15000/action=AddTask&Type=IvSpkIdEditThresh&TemplateName=Brown&TemplateSet=speakers.ivs&Thresh=0.5`

  This action uses port `15000` to instruct IDOL Speech Server, which is located on the local machine, to set the threshold of the template associated with the name `Brown` in the `speakers.ivs` template set file to `0.5`.

  You can set additional parameters. For details of the optional parameters, see the IDOL Speech Server Reference.

  This action returns a token. You can use the token to:

  - Check the task status. See Check the Status of a Task.
  - Retrieve the log file.

To retrieve information on an audio template set file

This task produces a log file that lists the contents of the specified audio template set file.

- - Send an `AddTask` action to IDOL Speech Server, and set the following parameters:

  `Type` | The task name. Set to `IvSpkIdInfo`.
  `TemplateSet` | The template set file to retrieve information for.
  `Log` | The log file to write the information to.

  For example:

  `http://localhost:15000/action=AddTask&Type=IvSpkIdInfo&TemplateSet=speakers.ivs&Log=speakers.log`

  This action uses port `15000` to instruct IDOL Speech Server, which is located on the local machine, to write information on the `speakers.ivs` template set file to the log file `speakers.log`.

  You can set additional parameters. For details of the optional parameters, see the IDOL Speech Server Reference.

  This action returns a token. You can use the token to:

  - Check the task status. See Check the Status of a Task.
  - Retrieve the log file.

  Log File Example

      <COMPSELECT> 20 </COMPSELECT>
      <NTEMPLATES> 3 </NTEMPLATES>
      <TEMPLATES>
        <TEMPLATE_0>
          <NAME> Brown </NAME>
          <THRESH_ENABLED> Yes </THRESH_ENABLED>
          <THRESH_VALUE> 35.8945 </THRESH_VALUE>
        </TEMPLATE>
        <TEMPLATE_1>
          <NAME> Cameron </NAME>
          <THRESH_ENABLED> Yes </THRESH_ENABLED>
          <THRESH_VALUE> 36.25 </THRESH_VALUE>
        </TEMPLATE>
        <TEMPLATE_2>
          <NAME> Clegg </NAME>
          <THRESH_ENABLED> Yes </THRESH_ENABLED>
          <THRESH_VALUE> 36.5571 </THRESH_VALUE>
        </TEMPLATE>
      </TEMPLATES>

  This file shows some information about how the templates were trained and optimized, along with information about each template stored in the set. The log file includes the following fields:

  `<COMPSELECT>` | How many base model components are used when generating the iVectors.
  `<NTEMPLATES>` | The number of templates in the set.
  `<TEMPLATE_0>` | The start of information on template 0, and so on.
  `<NAME>` | The name associated with the template.
  `<THRESH_ENABLED>` | Whether a score threshold is enabled for this template.
  `<THRESH_VALUE>` | The score threshold that has been estimated for this template.

© 2015-2018 EntIT Software LLC, a Micro Focus company | Send documentation feedback to Micro Focus Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm