Skip to content

Releases: DYCI2/Dicy2

Dicy2 3.0: Dicy2 for Max & Ableton Live !

12 Dec 22:28
e2d09cb
Compare
Choose a tag to compare

Brand new version of Dicy2 for Max implemented as a modular library !

Dicy2 for Max (formerly DYCI2) is a Max package implementing interactive agents using machine-learning to generate musical sequences that can be integrated into musical situations ranging from the production of structured material within a compositional process to the design of autonomous agents for improvised interaction. Check also our plugin for Ableton Live !

Dicy2 for Max

To discuss Dicy2 for Max features, use the Forum discussion groups at https://discussion.forum.ircam.fr/c/dicy2/


Getting Started

Requirements

  • Mac OS >= High Sierra
  • Max 8

Standard installation

RELEASE NOTE: The current release of Dicy2 has been tested with MuBu v1.10.5 which can be found here in case of hypothetical problems with a later version installed from the Package Manager. Dicy2 will of course be tested and updated along with the various MuBu releases.


Quick Start

  • See the "Dyci2 for Max user guide" that comes with the library.
  • Have a look at "extras/Dicy2_Overview.maxpat"
  • Tutorials and examples are in "examples" and "examples/Performance Strategies"
  • Video tutorial on Ircam's Youtube channel

About Dicy2

Some references

If using Dicy2, please quote:
Nika, J., Muller, A., Borg, J., Ostrowski, M., & Assayag, G. (2022, December). Dicy2 for Max. Ircam. 2022 or Nika, J., Déguernel, K., Chemla, A., Vincent, E., & Assayag, G. (2017, October). Dyci2 agents: merging the" free"," reactive", and" scenario-based" music generation paradigms. In International Computer Music Conference. (Article).

Artistic collaborations

Dicy2 integrates scientific and musical research results accumulated through productions and experiments with Rémi Fox, Steve Lehman, the Orchestre National de Jazz, Alexandros Markeas, Pascal Dusapin, Le Fresnoy - Studio National des Arts Contemporains, Vir Andres Hera, Gaëtan Robillard, Benoît Delbecq, Jozef Dumoulin, Ashley Slater, Hervé Sellin, Rodolphe Burger, Marta Gentilucci... After having evolved research prototypes crystallizing the contributions of these various projects for several years, a collaborative work carried out during the year 2022 has led to the finalization of a release of Dicy2 as a plugin for Ableton Live and a library for Max.

Dicy2 tutorials and examples

This distribution includes agents and sound files from past productions with our friends and collaborating musicians and composers who helped bring Dicy2 to life (courtesy of the artists). Please do not use these agents and files in any context other than these tutorials to respect their work and generosity.

"Doublebass_Perrot_Fox.wav, Guitar_Caillou_Fox.wav, and Voice_Daumergue_Fox.wav" were respectively recorded by Alex Perrot, Thomas Caillou, and Manu Daumergue during Rémi Fox's residency at Ircam for the concerts and first album of "C'est pour ça".
"Balafon_Lehman_ExMachina.wav" and "SaxPlayingMode_Lehman_ExMachina.wav" were recorded by Steve Lehman for "Ex Machina" with Orchestre National de Jazz.
"Texture_Maurin_ExMachina.wav" was recorded by Fred Maurin for "Ex Machina" with Orchestre National de Jazz.
"Piano_Markeas_Music-Of-Choices.wav" was recorded by Alexandros Markeas for "Music of Choices".
"Soprano_Gentilucci.wav" was recorded by Marta Gentilucci during her residency "Female Singing Voice's Vibrato and Tremolo: Analysis, Mapping and Improvisation" at Ircam.
"Fox_Sax_1/2/3.aif" comes from a performance of "C'est pour ça" at Ircam.
"Nox3_LucidDreams.wav" comes from the song "Lucid Dreams" by Nox3.


Authors

Dicy2 is a library of the Ircam Musical Representations team, designed and developed by Jérôme Nika, Augustin Muller (Max library), Joakim Borg (Python generative engine / Gig RepMus API), and Matthew Ostrowski (tutorial patchers and videos, abstractions) in the framework of the projects ANR-DYCI2, ANR-MERCI, ERC-REACH directed by Gérard Assayag, and the UPI-CompAI Ircam project.
The audio use cases have been designed and developed with Diemo Schwarz and Riccardo Borghesi, and use the MuBu and CataRT environments of the ISMM team of Ircam. Max4Live plugin by Manuel Poletti.
Contributions / thanks : Serge Lemouton, Jean Bresson, Thibaut Carpentier, Georges Bloch, Mikhaïl Malt, Axel Chemla--Romeu-Santos, Tristan Carsault, Vincent Cusson, Tommy Davis, Dionysios Papanicolaou, Greg Beller, Markus Noisternig.


More

Contact us

Please write to jerome.nika@ircam.fr and augustin.muller@ircam.fr for any question, or to share with us your projects using Dicy2 !

License

GPL v3

DYCI2 1.0 --> This release is not a release.

25 Oct 09:41
Compare
Choose a tag to compare

Brand new version coming very soon !

This upload brings minor fixes to the previous release...

... but we rather recommend you to be patient because a brand new version of DYCI2 will be released within a month!

Real modular library, tutorials, videos, and Max4Live device... Stay tuned!


DYCI2_library

The DYCI2 library contains a collection of generative agents and tools for human-machine live interaction. It integrates the results of the DYCI2 project and shapes a next-generation software with regard to OMax.

If using the library, please quote: Nika, J., Déguernel, K., Chemla, A., Vincent, E., & Assayag, G. (2017, October). Dyci2 agents: merging the" free"," reactive", and" scenario-based" music generation paradigms. In International Computer Music Conference. (Article).

Some videos of artistic productions using DYCI2 or its previous versions: https://www.youtube.com/channel/UCAKZIW0mMWCrX80yS96ZxAw.

A recent presentation about the DYCI2 library (20 min in english): https://youtu.be/RXKJbpJb8w4?t=1530

Author: Jérôme Nika (IRCAM STMS LAB) ; Contributors: Joakim Borg (IRCAM STMS LAB), Ken Déguernel (IRCAM STMS LAB / Inria Nancy - Grand Est), Axel Chemla--Romeu-Santos (IRCAM STMS LAB), Georges Bloch (UniStra), Diemo Schwarz (IRCAM STMS LAB); DYCI2 research project : Gérard Assayag (Ircam, PI), Emmanuel Vincent (Inria Nancy, WP leader), Jérôme Nika (Ircam, WP coordinator), Marc Chemillier (EHESS, associate researcher).

This folder contains a release version of DYCI2lib ready to be used as a Max library (the corresponding development repository and the Python code are available here: https://github.com/DYCI2/Dyci2Lib).

Check also om-dyci2, the "offline" compositional declination of this project, a framework for interactive generation of musical sequences combining generative agents and computer-assisted composition tools.


Release

NEW:

  • Application built from the Python code --> No need to use Python anymore (see below: one version for OS >= High Sierra and < Catalina, one version for OS >= Catalina)
  • New tutos
  • Control patch in tutorial 8
  • Fixes

This release contains:

  • Tutorials with complete standard DYCI2 functionalities. These self-contained Max applications and can be used as such by users who are not interested in building new patches.

  • The Max DYCI2 library of musical agents interfacing with the generation engine developped in Python and now built as an application

  • The Python DYCI2 library is also included for expert users, "hackers", or when getting troubles using the app version.


Getting started

See the 'quick start' pdf guide, follow the instructions below, then explore the tutorials in "Max_library/Tutorials/" !

Installation

  • Download the .dmg file corresponding to your OS (see below: one version for OS >= High Sierra and < Catalina, one version for OS >= Catalina).
  • Drag the DYCI2lib directory wherever you want (but not in Max packages / libraries !) and add its path into Max's search path (in Max: Options/File preferences... then add the path WITH THE SUBFOLDERS). /!\ The path of this folder must not contain any whitespace. /!\
  • Insert the media files downloaded at http://repmus.ircam.fr/nika/dyci2_library in "MaxLibrary/Tutorials/_ExamplesCorpus_". /!\ The sampling rate of Max MUST be the same as that of the audio file(s) used in the memory(/ies). /!\
  • On MacOS versions >= Catalina, the very first time you open the library, you will have to authorize the execution of the two DYCI2 externals (mubu, and shell) from the "Security & Privacy" menu in "System preference" of your computer. All this is explained in the pdf "DYCI2 start guide". Once this is done, you will never have to do it again.

(Open the "System preference / Security & Privacy" menu of your computer. Launch one of the Tutorial patchers. On the popup messages click on "Open" if possible, "Cancel" if not. In "System preference / Security & Privacy" click on "Open anyway" as soon as this option appears. When there are no more error messages quit Max. Launch one of the Tutorial patchers again, and repeat the operation until there are no more popup messages when opening a tutorial. You may have to quit and restart Max several times, but once this is done, you will never have to do it again.)

Requirements

It you encounter some troubles after these steps, try to run DYCI2 from the Python code as detailed below.


Bonus: running DYCI2lib from the Python code instead of the app

(For expert users, "hackers", or when getting troubles using the app version).

This release also 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.

Advanced users and developpers can use the Python library autonomously. See the tutorials corresponding to the different modulesHtml doc: http://repmus.ircam.fr/downloads/docs/DYCI2_library/. PDF doc: in DYCI2lib/Python_library.
NB: When launching the DYCI2 core using the python library and not the compiled app, the default command is "python3". Expert users can modify this command in the script located here: Dyci2Lib/Max_library/app/launch_dyci2_agents.sh

Configuration

  • Download and install the last version of Python 3 (https://www.python.org/downloads).
  • Open Terminal to install the dependencies: cd [DRAG_AND_DROP_THE_DIRECTORY_Dyci2lib], enter, pip3 install -r requirements.txt --user, enter.

Troubleshooting

Please write to jerome.nika@ircam.fr for any question, or to share with us your projects using DYCI2 !

License

GPL v3

DYCI2lib 0.91 --> Built application

30 Dec 15:00
Compare
Choose a tag to compare

DYCI2_library

The DYCI2 library contains a collection of generative agents and tools for human-machine live interaction. It integrates the results of the DYCI2 project and shapes a next-generation software with regard to OMax.

If using the library, please quote: Nika, J., Déguernel, K., Chemla, A., Vincent, E., & Assayag, G. (2017, October). Dyci2 agents: merging the" free"," reactive", and" scenario-based" music generation paradigms. In International Computer Music Conference. (Article).

Some videos of artistic productions using DYCI2 or its previous versions: https://www.youtube.com/channel/UCAKZIW0mMWCrX80yS96ZxAw.

A recent presentation about the DYCI2 library (20 min in english): https://youtu.be/RXKJbpJb8w4?t=1530

Author: Jérôme Nika (IRCAM STMS LAB) ; Contributors: Joakim Borg (IRCAM STMS LAB), Ken Déguernel (IRCAM STMS LAB / Inria Nancy - Grand Est), Axel Chemla--Romeu-Santos (IRCAM STMS LAB), Georges Bloch (UniStra), Diemo Schwarz (IRCAM STMS LAB); DYCI2 research project : Gérard Assayag (Ircam, PI), Emmanuel Vincent (Inria Nancy, WP leader), Jérôme Nika (Ircam, WP coordinator), Marc Chemillier (EHESS, associate researcher).

This folder contains a release version of DYCI2lib ready to be used as a Max library (the corresponding development repository and the Python code are available here: https://github.com/DYCI2/Dyci2Lib).

Check also om-dyci2, the "offline" compositional declination of this project, a framework for interactive generation of musical sequences combining generative agents and computer-assisted composition tools.


Release

NEW:

  • Application built from the Python code --> No need to use Python anymore (see below: one version for OS >= High Sierra and < Catalina, one version for OS >= Catalina)
  • New tutos
  • Control patch in tutorial 8
  • Fixes

This release contains:

  • Tutorials with complete standard DYCI2 functionalities. These self-contained Max applications and can be used as such by users who are not interested in building new patches.

  • The Max DYCI2 library of musical agents interfacing with the generation engine developped in Python and now built as an application

  • The Python DYCI2 library is also included for expert users, "hackers", or when getting troubles using the app version.


Getting started

See the 'quick start' pdf guide, follow the instructions below, then explore the tutorials in "Max_library/Tutorials/" !

Installation

  • Download the .dmg file corresponding to your OS (see below: one version for OS >= High Sierra and < Catalina, one version for OS >= Catalina).
  • Drag the DYCI2lib directory wherever you want (but not in Max packages / libraries !) and add its path into Max's search path (in Max: Options/File preferences... then add the path WITH THE SUBFOLDERS). /!\ The path of this folder must not contain any whitespace. /!\
  • Insert the media files downloaded at http://repmus.ircam.fr/nika/dyci2_library in "MaxLibrary/Tutorials/_ExamplesCorpus_". /!\ The sampling rate of Max MUST be the same as that of the audio file(s) used in the memory(/ies). /!\
  • On MacOS versions >= Catalina, the very first time you open the library, you will have to authorize the execution of the two DYCI2 externals (mubu, and shell) from the "Security & Privacy" menu in "System preference" of your computer. All this is explained in the pdf "DYCI2 start guide". Once this is done, you will never have to do it again.

(Open the "System preference / Security & Privacy" menu of your computer. Launch one of the Tutorial patchers. On the popup messages click on "Open" if possible, "Cancel" if not. In "System preference / Security & Privacy" click on "Open anyway" as soon as this option appears. When there are no more error messages quit Max. Launch one of the Tutorial patchers again, and repeat the operation until there are no more popup messages when opening a tutorial. You may have to quit and restart Max several times, but once this is done, you will never have to do it again.)

Requirements

It you encounter some troubles after these steps, try to run DYCI2 from the Python code as detailed below.


Bonus: running DYCI2lib from the Python code instead of the app

(For expert users, "hackers", or when getting troubles using the app version).

This release also 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.

Advanced users and developpers can use the Python library autonomously. See the tutorials corresponding to the different modulesHtml doc: http://repmus.ircam.fr/downloads/docs/DYCI2_library/. PDF doc: in DYCI2lib/Python_library.
NB: When launching the DYCI2 core using the python library and not the compiled app, the default command is "python3". Expert users can modify this command in the script located here: Dyci2Lib/Max_library/app/launch_dyci2_agents.sh

Configuration

  • Download and install the last version of Python 3 (https://www.python.org/downloads).
  • Open Terminal to install the dependencies: cd [DRAG_AND_DROP_THE_DIRECTORY_Dyci2lib], enter, pip3 install -r requirements.txt --user, enter.

Troubleshooting

Please write to jerome.nika@ircam.fr for any question, or to share with us your projects using DYCI2 !

License

GPL v3

DYCI2Lib 0.9 --> Python 3

19 Mar 01:01
Compare
Choose a tag to compare

DYCI2_library

The DYCI2 library contains a collection of generative agents and tools for smart composition and human-machine co-improvisation.
It integrates the results of the DYCI2 project and shapes a next-generation software with regard to OMax.

A conference paper about the DYCI2 library can be downloaded here.

A recent presentation about the DYCI2 library (20 min in english): https://youtu.be/RXKJbpJb8w4?t=1530

Some videos of collaborations with musicians using DYCI2 or its previous versions: https://www.youtube.com/channel/UCAKZIW0mMWCrX80yS96ZxAw.

Author: Jérôme Nika (IRCAM STMS LAB) ; Contributors: Joakim Borg (IRCAM STMS LAB), Ken Déguernel (IRCAM STMS LAB / Inria Nancy - Grand Est), Axel Chemla--Romeu-Santos (IRCAM STMS LAB), Georges Bloch (UniStra), Diemo Schwarz (IRCAM STMS LAB); DYCI2 research project : Gérard Assayag (Ircam, PI), Emmanuel Vincent (Inria Nancy, WP leader), Jérôme Nika (Ircam, WP coordinator), Marc Chemillier (EHESS, associate researcher).


Release

NEW:

  • Python 3
  • New interface
  • New tutos

This release contains:

  • Tutorials with complete standard DYCI2 functionalities. These self-contained Max applications and can be used as such by users who are not interested in building new patches.

  • The Max DYCI2 library of musical agents interfacing with the generation engine developped in Python.

  • 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.

Advanced users and developpers can use the Python library autonomously. See the tutorials corresponding to the different modulesHtml doc: http://repmus.ircam.fr/downloads/docs/DYCI2_library/. PDF doc: in DYCI2lib/Python_library.
NB: When launching the DYCI2 core using the python library and not the compiled app, the default command is "python3". Expert users can modify this command in the script located here: Dyci2Lib/Max_library/app/launch_dyci2_agents.sh


Requirements

Installation

  • Drag the DYCI2lib directory wherever you want (but not in Max packages / libraries !) and add its path into Max's search path (in Max: Options/File preferences... then add the path WITH THE SUBFOLDERS). /!\ The path of this folder must not contain any whitespace. /!\
  • Insert the media files downloaded at http://repmus.ircam.fr/nika/dyci2_library in "MaxPatches/Tutorials/_ExamplesCorpus_". /!\ The sampling rate of Max MUST be the same as that of the audio file(s) used in the memory(/ies). /!\

Python configuration

  • Download and install the last version of Python 3 (https://www.python.org/downloads).
  • Open Terminal to install the dependencies: cd [DRAG_AND_DROP_THE_DIRECTORY_Dyci2lib], enter, pip3 install -r requirements.txt --user, enter.

Troubleshooting

Please write to jerome.nika@ircam.fr for any question, or to share with us your projects using DYCI2 !

License

GPL v3

DYCI2Lib 0.7 --> new interface + self contained applications + new playing modes + new tutos

17 Nov 17:33
Compare
Choose a tag to compare

__A little patience until March 20th 2020 and the next release will be very different from this one! (Core in python3, no need to install python anymore, new tutorials, etc. __

Tutorials

Download the Dyci2Lib-v07.zip archive below and read the following instructions:

Release

This release contains:

  • Tutorials that are actual self-contained applications and can be used as such by users who are not interested in building new patches.

  • 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).

  • 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).

NEW:

  • New interface
  • New playing modes and categories : Listen, Match, Develop, Accompany, Augment, Guide
  • New self contained applications
  • New tutos

COMING SOON - DYCI2Lib 1.0 !:

  • Python 3
  • Application (no need to install Python etc.)
  • Standalone

Installation

  1. Download and install the last version of Python 2 (https://www.python.org/downloads). Python 2.7 <= required version < Python 3 (DYCI2 for Python 3 coming soon...)

  2. Open Terminal to install the dependencies:

    cd [DRAG_AND_DROP_THE_DIRECTORY_Dyci2lib]

    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)

  1. Download Mubu for Max, in Max:

    • File / Show Package Manager
    • Search "Mubu for Max"
    • Install
  2. Finally move the whole directory wherever you want, and make sure that the path of the directory Dyci2lib/Max_library is set in the file preferences in Max. Then explore the tutorials !


DYCI2 tutorials

The DYCI2 library offers different processes depending on the way the "musical memory" of your agent is created, and a range of generative strategies adapted to different types of interaction. The tutorials in Dyci2lib/Max_library_/Tutorials_ give an overview that should be sufficient to be able to build new setups.
Start with DYCI2_Tutorials_Read_me_first.maxpat to go through the tutorials.

Download the sound database for the tutorials. See Below: Download-Instructions-DYCI2-Tutoriel-Soundfiles.txt]. _
(Other sources: https://github.com/DYCI2/Dyci2Lib/releases or http://repmus.ircam.fr/nika/dyci2_library)

Before using the tutorials, make sure you followed the installation procedure above, and insert the files downloaded at the previous step in "DYCI2Lib/MaxPatches/Tutorials/_ExamplesCorpus_".

(!! If you already have a python distribution installed and that the shell command "python" calls Python 3, please replace the "DYCI2_Python_lib" objects in the patches by "DYCI2_Python2_lib" objects. !!)

Download-Instructions-DYCI2-Tutoriel-Soundfiles.txt


Videos of productions and artistic collaborations using DYCI2lib: https://www.youtube.com/playlist?list=PL-C_JLZNFAGfGwtMPrRz9gOD3LnAMnHkO
Associated IRCAM / Repmus project: http://repmus.ircam.fr/dyci2/home
Associated research: https://jeromenika.com/research-designing-generative-agents/dyci2lib/

DYCI2Lib 0.6 --> multi-agent reactive listening + new tutos

21 May 17:12
Compare
Choose a tag to compare

Download the Dyci2Lib-v06.zip archive below and read the following instructions:

Release

This release contains:

  • 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).

  • 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).

NEW:

  • New implementation of the generative agents based on reactive listening.
  • Possibility to have several "reactive listening" agents.
  • New presets patches for memory & type of listening and reaction to the live inputs.
  • New tutorials.
    See in particular Tuto-AM3--3agents_reactive_listening.
  • New guide DYCI2_Tutorials_Read_me_first.maxpat to go through the tutorials.
  • Fixes

Installation

  1. Download and install the last version of Python 2 (https://www.python.org/downloads). Python 2.7 <= required version < Python 3 (DYCI2 for Python 3 coming soon...)

  2. Open Terminal to install the dependencies:

    cd [DRAG_AND_DROP_THE_DIRECTORY_Dyci2lib]

    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)

  1. Download Mubu for Max, in Max:

    • File / Show Package Manager
    • Search "Mubu for Max"
    • Install
  2. Finally move the whole directory wherever you want, and make sure that the path of the directory Dyci2lib/Max_library is set in the file preferences in Max. Then explore the tutorials !


DYCI2 tutorials

The DYCI2 library offers different processes depending on the way the "musical memory" of your agent is created, and a range of generative strategies adapted to different types of interaction. The tutorials in Dyci2lib/Max_library_/Tutorials_ give an overview that should be sufficient to be able to build new setups.
Start with DYCI2_Tutorials_Read_me_first.maxpat to go through the tutorials.

Before using the tutorials, make sure you followed the installation procedure above, and insert the files downloaded at http://repmus.ircam.fr/nika/dyci2_library in "MaxPatches/Tutorials/_ExamplesCorpus_".

DYCI2Lib 0.5 --> reactive listening ++

25 May 17:04
Compare
Choose a tag to compare

Download the Dyci2Lib-v05.zip archive below and read the following instructions:

Release

This release contains:

  • 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).

  • 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).

NEW:

  • New implementation of the generative agents based on reactive listening.
    See in particular Tuto-AM2--1agent_reactive_listening_1.maxpat.
  • New tutorials.
  • New guide DYCI2_Tutorials_Read_me_first.maxpat to go through the tutorials.
  • More ergonomics.

Installation

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

  2. Open Terminal to install the dependencies:

    cd [DRAG_AND_DROP_THE_DIRECTORY_Dyci2lib]

    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)

  1. Download Mubu for Max, in Max:

    • File / Show Package Manager
    • Search "Mubu for Max"
    • Install
  2. Finally move the whole directory wherever you want, and make sure that the path of the directory Dyci2lib/Max_library is set in the file preferences in Max. Then explore the tutorials !


DYCI2 tutorials

The DYCI2 library offers different processes depending on the way the "musical memory" of your agent is created, and a range of generative strategies adapted to different types of interaction. The tutorials in Dyci2lib/Max_library_/Tutorials_ give an overview that should be sufficient to be able to build new setups.
Start with DYCI2_Tutorials_Read_me_first.maxpat to go through the tutorials.

Before using the tutorials, make sure you followed the installation procedure above, and insert the files downloaded at http://repmus.ircam.fr/nika/dyci2_library in "MaxPatches/Tutorials/_ExamplesCorpus_".

DYCI2 library

22 Mar 12:04
Compare
Choose a tag to compare

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)

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

  2. 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)

  1. 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]

  2. 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").