Commit 36c5d655 authored by roebel's avatar roebel

Updated for ISiS 1.2.7 release.

parent 4048d666
......@@ -47,7 +47,7 @@ and type (where the > character represents the shell prompt and should not be ty
If all went well, you should receive the isis version displayed on the terminal.
```
ISiS version::1.2.3
ISiS version::1.2.7
```
In case you receive an error message that means that at least one of the steps
......@@ -78,7 +78,7 @@ As a first trial please run the command
> isis.sh -o defsong.wav
```
After a about 30 seconds (the time depends on the power of your computer) and a long list of cryptic
After a about 20 seconds (the time depends on the power of your computer) and a long list of cryptic
output the command prompt will reappear. The last lines should display
```
......
......@@ -50,28 +50,28 @@ First steps
.. code:: bash
> isis.sh -v
> isis.sh -v
If all went well, you should receive the isis version displayed on the
terminal.
::
ISiS version::1.2.3
ISiS version::1.2.7
In case you receive an error message that means that at least one of the
steps described so far have not been performed correctly. please check
all of them, and if you don't find the problem please contact IRCAM
all of them, and if you dont find the problem please contact IRCAM
Forum support, sending the following pieces of information
1. The error message you received
2. The content of the .bashrc, .bash\_profile, .tcshrc, and .cshrc files
2. The content of the .bashrc, .bash_profile, .tcshrc, and .cshrc files
you modified
3. The output you receive when you type
.. code:: bash
> echo $SHELL
> echo $SHELL
in your terminal.
......@@ -87,33 +87,33 @@ As a first trial please run the command
::
> isis.sh -o defsong.wav
> isis.sh -o defsong.wav
After a about 30 seconds (the time depends on the power of your
After a about 20 seconds (the time depends on the power of your
computer) and a long list of cryptic output the command prompt will
reappear. The last lines should display
::
#################################################
PaN voiced synthesis
#################################################
#################################################
PaN unvoiced synthesis
#################################################
#################################################
apply post-processing treatments
#################################################
Create: defsong.wav using wav format!
=======================================
computed in 28.277118921279907s
#################################################
PaN voiced synthesis
#################################################
#################################################
PaN unvoiced synthesis
#################################################
#################################################
apply post-processing treatments
#################################################
Create: defsong.wav using wav format!
=======================================
computed in 28.277118921279907s
Which means all went well and you can now listen to the song by means of
running
::
> open defsong.wav
> open defsong.wav
in the terminal. This will open the default application for wav snd
files allowing you to listen to the result. In case you installed MS as
......@@ -146,13 +146,13 @@ For MS the database is recorded in 315Hz (approx midi note 63) which is
slightly below the average note frequency of the default song. For RT
the database is recorded at 150Hz (approx. midi note 50) and to adapt
the average note pitch to the voice you can use the command line flag
--global\_transp which transposes the melody by the given number of half
–global_transp which transposes the melody by the given number of half
tone steps. For RT you get good results by means of lowering the melody
by 13 half tones as follows
::
> isis.sh --global_transp -13 -o defsong_RT.wav
> isis.sh --global_transp -13 -o defsong_RT.wav
which will produce the singing as
......@@ -178,7 +178,7 @@ half tones
::
> isis.sh --global_transp 2 -o defsong_EL.wav
> isis.sh --global_transp 2 -o defsong_EL.wav
which results in
......@@ -198,14 +198,14 @@ which results in
</audio>
In case you have established the ISIS\_CORPORA environment variable you
In case you have established the ISIS_CORPORA environment variable you
can select the singing voice simply by means of selecting the sub
directory in the ISIS\_CORPOPA folder. To select the MS voice you would
directory in the ISIS_CORPOPA folder. To select the MS voice you would
simply run the synthesis as follows:
.. code:: bash
> isis.sh -sv MS -o defsong_MS.wav
> isis.sh -sv MS -o defsong_MS.wav
Automagically open synthesized sounds
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
......@@ -218,7 +218,7 @@ If you add the -a flag to the command line
.. code:: bash
> isis.sh -sv MS -o defsong_MS.wav -a
> isis.sh -sv MS -o defsong_MS.wav -a
the synthesised snd will be loaded into the AudioSculpt application,
together with the target pitch contours and the phoneme locations in the
......@@ -229,13 +229,13 @@ synthesized snd creating the following AudioSculpt window
MS default song displayed in AudioSculpt
If you don't have the AudioSculpt application installed you can use the
If you dont have the AudioSculpt application installed you can use the
-O flag with a similar purpose, it opens the synthesized sound file in
the default application you use, for playing sound files.
.. code:: bash
> isis.sh -sv EL -o defsong_EL.wav -O
> isis.sh -sv EL -o defsong_EL.wav -O
All command line arguments
~~~~~~~~~~~~~~~~~~~~~~~~~~
......
.. _ISiS\_databases:
.. _ISiS_databases:
ISiS Databases
==============
ISiS singing voices are distributed via the `ISiS
page <http://forumnet.ircam.fr/product/isis/>`__ of the `IRCAM
page <https://forum.ircam.fr/projects/detail/isis/>`__ of the `IRCAM
Forum <http://forumnet.ircam.fr>`__. Each voice comes as an independent
dmg/tar containing all sound parameters of a single voice. Additionally,
each voice arcive contains a small application that can be used to
configure a voice as ISiS default voice.
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:
(`MacOS <http://forumnet.ircam.fr/fileadmin/RT.dmg>`__,
`Linux <http://forumnet.ircam.fr/fileadmin/RT.tar.bz2>`__), and
(`download <https://forum.ircam.fr/asset/44/RT_1.0.2.tar.bz2>`__),
and
2. **MS**: a female mezzo-soprano pop singer
(`MacOS <http://forumnet.ircam.fr/fileadmin/MS.dmg>`__,
`Linux <http://forumnet.ircam.fr/fileadmin/MS.tar.bz2>`__), and
(`download <https://forum.ircam.fr/asset/45/MS_1.0.2.tar.bz2>`__),
and
3. **EL**: a female soprano lyrical singer
(`MacOS <http://forumnet.ircam.fr/fileadmin/EL.dmg>`__,
`Linux <http://forumnet.ircam.fr/fileadmin/MS.tar.bz2>`__).
(`download <https://forum.ircam.fr/asset/46/EL_1.0.2.tar.bz2>`__).
.. _install-voice-database:
......@@ -30,10 +29,10 @@ 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
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
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,
......@@ -42,9 +41,9 @@ 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 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
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
......@@ -86,29 +85,29 @@ policies of Mac OS X the following instructions differ slightly for
**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 `<return>`.
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 `<return>`.
**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.
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
~/Library/Application\ Support/Ircam/ISiS_init_voice_rc.cfg
for Linux it is located under
::
~/.local/AppSupport/Ircam/ISiS_init_voice_rc.cfg
~/.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
......@@ -118,11 +117,11 @@ voice as your default voice.
::
medcomp: (~) 5001> /Data/ISiS_DB/Use_as_ISiS_default_voice.sh
==========================================================================================
ISiS configuration updated to use </Data/ISiS_DB> as root dir of ISiS voices
and </Data/ISiS_DB/RT> as default voice.
==========================================================================================
medcomp: (~) 5001> /Data/ISiS_DB/Use_as_ISiS_default_voice.sh
==========================================================================================
ISiS configuration updated to use </Data/ISiS_DB> as root dir of ISiS voices
and </Data/ISiS_DB/RT> as default voice.
==========================================================================================
Manual voice configuration
^^^^^^^^^^^^^^^^^^^^^^^^^^
......@@ -134,13 +133,13 @@ For MacOSX the exact location of the file is
::
~/Library/Application\ Support/Ircam/ISiS_init_voice_rc.cfg
~/Library/Application\ Support/Ircam/ISiS_init_voice_rc.cfg
for Linux it is located under
::
~/.local/AppSupport/Ircam/ISiS_init_voice_rc.cfg
~/.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
......@@ -150,11 +149,11 @@ content
::
[ISIS_VOICE_CONFIG]
# root directory of ISiS voices
ISIS_CORPORA: /Data/ISiS_DB
# default voice sub directory
ISIS_VOICE: /Data/ISiS_DB/RT
[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
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
......@@ -173,18 +172,18 @@ switch the voice configuration without changing the config file.
.. code:: bash
export ISIS_CORPORA='/Data/ISiS_DB'
export ISIS_VOICE='RT'
export ISIS_CORPORA='/Data/ISiS_DB'
export ISIS_VOICE='RT'
You can set only the ISIS\_VOICE variable if you want to change the
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
unset ISIS_CORPORA
unset ISIS_VOICE
If you don't use bash please look into the documentation of your shell
If you dont use bash please look into the documentation of your shell
to find how you can set envrionment variables.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment