OM-DYCI2
OM-DYCI2 is a framework for interactive generation of musical sequences combining generative agents and computer-assisted composition tools. It enables guiding corpus-based generative processes through explicit specifications of temporal structures, or using another layer of generative models trained on a corpus of structures.
OM-DYCI2 is the compositional declination of the Max DYCI2 library dedicated to interaction developped in the OM#/OM6 visual programming and computer-aided composition environments.
If using the library, please quote: Nika, Jérôme, and Jean Bresson. "Composing Structured Music Generation Processes with Creative Agents." 2nd Joint Conference on AI Music Creativity (AIMC 2021). 2021 (Article) . The appendix of this article refers to multimedia resources extracted from recent creations using OM-DYCI2 (Pascal Dusapin, Steve Lehman, Rémi Fox, Le Fresnoy - Studio National des Arts Contemporains, etc.). Moreover, it is a good introduction to the use of the library since it details all the playing modes implemented in the tutorials.
This folder contains a release version of om-dyci2 ready to be included in your OM# or OM 6.13/6.14 libraries folder (the corresponding development repository is available here: https://github.com/DYCI2/om-dyci2).
Release
To be able to use all the features, we recommend for the moment to use OM# (the functionalities associated to Tutorials 1 to 3 will be ported to OM in a future release).
The release version of om-dyci2 provides all the required binaries, so there is no need to compile anything but the dependencies of the Python DYCI2 Library must be installed. om-dyci2 will instantiate a virtual Python interpreter and run DYCI2 in it, so the last version of Python 3 and the dependencies of DYCI2 library must also be installed on your computer :
-
Download and install the last version of Python 3 (https://www.python.org/downloads)
-
Use your terminal to install the dependencies:
$ pip install -r python-requirements.txt
(If pip is not installed: sudo easy-install pip.)
The other settings instructions can be found in the 'Quick start' pdf guide in this folder.
Getting started
See the 'quick start' pdf guide and the user manual page and examples in this project's wiki pages.
The om-dyci2/om-dyci2/patches directory includes basic example patches for OM# and OM6, and new advanced examples for OM# only (Tutorials 1 to 3) requiring the OM-SuperVP library.
OM-DYCI2 takes audio files with annotations (time markers and labels) as input. The library does not yet provide definitive tools for the segmentation and analysis of corpora, which must therefore be carried out by the user in the environment of his/her choice and have the format corresponding to the example annotation files that can be found in Tutorials 1 and 2.
On the other hand, OM-DYCI2 proposes manual segmentation interfaces (Tutorial 0), and a first draft (work in progress) of segmentation patches and automatic pitch and energy analysis (Tutorial 3).
Externals
The tutorials in the directories "2-advanced-tutorials-synchronyzing" and "3-tutorials-audio-analysis" require the OM-SuperVP library.
-
Get it from https://forum.ircam.fr/projects/detail/om-supervp/.
-
Move the superVP lib for instance in om-dyci2/dependencies/ and make sure that the path to this directory is in the search path.
-
This release includes SuperVP executables for macOS, Windows, Linux. These programs are protected and require an authorization through Ircam forum subscription.
See: https://www.ircam.fr/product/abonnement-premium-individuel-annuel/ (see *** note below) -
Then in OM#:
- windows/session window/external libraries then double click on om-supervp to load it
- preferences/libraries, in om-SuperVP :
- SuperVP exec --> path to supervp exec (for instance dependencies/om-supervp/resources/bin/mac/SuperVP/SuperVP.app/Contents/MacOS/supervp-2.103.2)
- Authorize --> path of the activation key if needed (for instance dependencies/om-supervp/resources/bin/mac/Ircam_Activation_key.txt)
Free-releases of the library (not including the binaries) are available at: https://github.com/openmusic-project/OM-SuperVP/releases.
You will still need the binaries (and then an Ircam forum subscription): get them from IRCAM ForumNet (https://forum.ircam.fr/projects/detail/analysissynthesis-command-line-tools/) and either put them in OM-SuperVP/resources/bin/{mac,win,linux}/, OR set the path to SuperVP (for instance in .../AudioSculpt/Kernels/) in the OM Preferences/Externals path (visible when the library is loaded).
Coming soon: Tutorials 1 to 3 compatible with OM6 (not only OM#), more documentation for Tutorials 1 to 3, new tutorials, new synchronisation possibilities, tools for automatic segmentation and annotation.