DYCI2 library

Release

This release contains:

• The Python DYCI2 library, defining models and tools for creative generation of sequences (and in particular musical sequences) from models of sequences. It implements several models, generative heuristics, time management strategies, and architectures of interactive agents. Each class is associated with a tutorial (see the tutorials in the Python_library directory).

• The Max DYCI2 library of musical agents interfacing with the Python library. (See the tutorials in the directory Max_library/_Tutorials_ and the Readme file to download sound examples).

---

Configuration and installation

1. Download and install the last version of Python 2 (https://www.python.org/downloads).

2. Use your terminal in the directory Dyci2Lib to install the dependencies:

   $ pip install -r requirements.txt

(If pip is not installed: sudo easy-install pip, or try curl https://bootstrap.pypa.io/get-pip.py | python)

3. Make sure that the path of the directory Max_library is set in the file preferences in Max.

4. The reactive listening modules (Tutorials "B...") require the Mubu for Max package. In Max 7:

• File / Show Package Manager
• Search "Mubu for Max"
• Install

---

Using the tutorials

To use the Max tutorials in "MaxPatches/_Tutorials_", insert the tutorial audio files downloaded at http://repmus.ircam.fr/nika/dyci2_library in "MaxPatches/_Tutorials_/_ExamplesCorpus_".

To use you own annotated musical memories use the Max tutorial "A5" or

1. Create a .csv / .txt annotation file with the following format
   start_date_event_1_in_ms ; label_1_1 ... label_1_j
   ...
   start_date_event_i_in_ms ; label_i_1 ... label_i_j
   date_end_file_in_ms ; X

See the example of Female-Voice-singing.csv --> Female-Voice-singing.json (annotation for Female-Voice-singing.aiff)

2. Use the script FromTextToDYCI2json_script (/!\ No "." or " "in the whole path of the file (except extension) /!), for example :

   $ python FromTextToDYCI2json_script.py [absolute path to the .csv/.txt file]

3. Move the .json file and your .aif sound file in /MaxPatches/Tutorials/ExamplesCorpus

N.B. Some playing modes (scenarios of descriptors and reactive listening) do not require annotated files since they perform analysis and clustering automatically (see Max tutorials "B").