.. _ISiS_databases:
ISiS Databases
==============
ISiS singing voices are distributed via the `ISiS
page `__ of the `IRCAM
Forum `__. Each voice comes as an independent
tar archive containing all sound parameters of a single voice.
Additionally, each voice arcive contains a small script that can be used
to configure a voice as ISiS default voice.
Currently there are three voices available (downloads are for Forum
members only):
1. **RT**: a tenor male pop singer:
(`download `__),
and
2. **MS**: a female mezzo-soprano pop singer
(`download `__),
and
3. **EL**: a female soprano lyrical singer
(`download `__).
.. _install-voice-database:
Install a new ISiS singing voice
--------------------------------
For the ISiS program to be able to find the singing databases all the
singing voices have to be gathered in a common root directory, which we
will call ISIS_CORPORA. In the following we will assume you want to use
the directory `/Data/ISiS_DB` to collect your ISiS voices, but you are
free to choose any other place that better fits your needs. To prepare
the installation of the voices you should create the ISIS_CORPORA
directory. You can do this either from the terminal using the command
mkdir, or from your GUI (Finder on MacOS and for example KDE/Dolphin or
Gnome/Nautilus on Linux. While this directory can be located anywhere,
the voices require in the order of 1GB per singing voice, so please be
sure that the disk that you select when creating the directory has at
least 3GB of space available.
To proceed with the installation of the singing voices please download
the different voices and unpack them into the ISIS_CORPORA directory.
The voice database archives are compatible with Linux and Mac OS. You
simply save the archive into the ISIS_CORPORA directory and unpack the
tar.bz2 file you just downloaded. On `MacOS` you can simply
double-click the file in the Finder. Under Linux the operation to be
performed depends on the file manager you use, in some environments you
can double-clicking the archive to open it in a dedicated application
that you may then use to extract the content to the target directory,
other filemanagers may allow right-clicking and selecting something like
`unpack here`.
Finally, on MacOS and Linux you can also use the terminal to unpack the
voices. For brevity we will not cover this process in detail here.
The name of the folder you create will depend on the software you use
for unpacking. For ease of use it is strongly recommended to rename the
unpacked voice folder using a short ideally two character long name. In
the following we will assume you use the names `RT`, `EL` and
`MS`.
Configuring ISiS voices environment
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
| The ISiS software uses two environment variables to find its voices.
These two variables can be defined manually or using an automatic
script that needs to be executed in the targeted shell environment.
| We will first describe the automatic configuration and in the
subsequent paragraph the automatic configuration.
.. _configure-isis-corpora-root-dir:
Automatic voice configuration
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The automatic voice configuration currently supports only `bash` (the
current default shell under `MacOS`) and `tcsh` shells. In case you
use other shells please see the manual configuration instructions below
and adapt those to the shell you use. Due to very restrictive security
policies of Mac OS X the following instructions differ slightly for
`MacOS` and `Linux`.
**Under Mac OS** please first double-click the folder containing the
data of the specific voice you would like to use as default voice to
open it in the Finder and then open a terminal window. Then back in the
window containing the ISiS_Vx.y.z folder locate the file
**Use_as_ISiS_default_voice.sh** and drag it onto the terminal window.
This will paste the complete path to the script into the terminal
command line Once you have copied the path to the terminal please click
on the terminal window and then simply hit ``.
**Under Linux** please first double-click the folder containing the
voice data to open it in your file and directory browser. You can then
simply double-click the **Use_as_ISiS_default_voice.sh** script which
will execute the script.
The script will place an ISIS voice config file under your HOME
directory. For MacOSX the exact location of the file is
::
~/Library/Application\ Support/Ircam/ISiS_init_voice_rc.cfg
for Linux it is located under
::
~/.local/AppSupport/Ircam/ISiS_init_voice_rc.cfg
In the following you find the output that is generated for user vox
installing the RT voice in the `/Data/ISiS_DB` directory as the
default voice. The two lines are confirming u that you are using the
`/Data/ISiS_DB` directory as voice root and the `/Data/ISiS_DB/RT`
voice as your default voice.
::
medcomp: (~) 5001> /Data/ISiS_DB/Use_as_ISiS_default_voice.sh
==========================================================================================
ISiS configuration updated to use as root dir of ISiS voices
and as default voice.
==========================================================================================
Manual voice configuration
^^^^^^^^^^^^^^^^^^^^^^^^^^
You can manually create or change the file that contains the ISiS voice
specifications.
For MacOSX the exact location of the file is
::
~/Library/Application\ Support/Ircam/ISiS_init_voice_rc.cfg
for Linux it is located under
::
~/.local/AppSupport/Ircam/ISiS_init_voice_rc.cfg
You can edit this file with arbirtrary text editors but need to save it
in text mode. Assuming that you placed your CORPORA under the
`/Data/ISiS_DB` directory and want to use the voice `RT` as your
default voice then you would need to create the file with the following
content
::
[ISIS_VOICE_CONFIG]
# root directory of ISiS voices
ISIS_CORPORA: /Data/ISiS_DB
# default voice sub directory
ISIS_VOICE: /Data/ISiS_DB/RT
Setting voice defaults via environment variables
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
YOu can temporarily overwrite the singing voice defaults using two
environment variables: the variable `ISIS_CORPORA` defines the root
directory containing all ISiS voices and the variable `ISIS_VOICE`
defines either the full path or the sub directory under `ISIS_CORPORA`
that contains the default voice.
If we assume as before that your voice root directory is
`/Data/ISiS_DB` and the voice directory containing the voice you want
to use as default is `/Data/ISiS_DB/RT`, and in case your shell is
`bash` then you can execute the following lines in our terminal to
switch the voice configuration without changing the config file.
.. code:: bash
export ISIS_CORPORA='/Data/ISiS_DB'
export ISIS_VOICE='RT'
You can set only the ISIS_VOICE variable if you want to change the
default voice without changing the voice root only. These changes will
are in effect for all subsequent runs of isis you perform in the
terminal where you issued these settings. To reset the change use
.. code:: bash
unset ISIS_CORPORA
unset ISIS_VOICE
If you don’t use bash please look into the documentation of your shell
to find how you can set envrionment variables.