September 13-14-15, 2013
1pm-5pm
CNMAT, Center for New Music and Audio Technologies, UC Berkeley.

http://cnmat.berkeley.edu/event/2013/09/13/openmusic_workshop

Download and install the current OM version (6.6.2) from Ircam ForumNet website.

I recommend participants to create a ForumNet account (it's free) before the workshop and email me your user name. Subscribed participants will be granted access for the external IRCAM-licenced tools we may use during the workshop.
⇒ Once you have a Forumnet account you can also subscribe to the OpenMusic users group.
⇒ You can also subscribe (even non-Forum members) to the OM mailing list to get support, advices and share your experience and problems with the OM user community and developers.

For Mac users:

• If this is your first installation, you will need to install MidiShare. MidiShare is the library used by OM to manage MIDI data and rendering.
  Depending on your OS configuration, Midishare 1.92 may be required instead of 1.93 (latest).
• You mant want to be an OM pioneer use the new 6.6.3 update, or a beta release of OM 6.7 (several OM versions can coexist on your computer).
  They are both temporarily available for download HERE (Mac versions only).

If you wish to explore OM by yourself, you may find help at the following different places:

• The online user manual (also accessible in OM from the Help menu) is a relatively complete documentation about all features and programming concepts of the OM environment.
  Note that this manual does not include external libraries ⇒ check this page out for the libraries.
• The function and class reference is accessible in OM from the Help menu and provides a basic documentation of all referenced objects and functions. Type 'd' in an OM patch to access directly the reference page corresponding to a selected box.
• In patch and other OM editors, the Editor command keys in the help menu (also accessible with 'H' keyboard shortcut), can be a useful reminder of the principal actions and shortcuts.
• See the Common Lisp specs. and reference for the Lisp tools and functions.
• Check/ask questions to the OM mailing list and/or the ForumNet OpenMusic disciussion group.

Errors in OM can be raised by mistakes in your patches or Lisp code or bugs of the environment. OM tries to handle an report errors as much as possible, but can fail in certain situations (external library crashes, memory issues, etc.)

• A system Terminal pop-up is not necessarily dangerous. It happens when an error was not "catched" correctly in OM and can be useful to track the origin of this error. Try to type :b to know more/report the error, or :top to return to the top level and get the control back on the OM user interface. Do not forget to save your work. Consider a fresh restart.
• When a box can not draw anymore because of a wrong input and a message errors appears every time you click or redisplay: hide the "miniview", by selecting the window and typing upper case 'M' (show/hide all front window miniviews). Delete the box and create a new one, just to be sure..
• When an evaluation seems never to end (Listener printing "Running" forever): Try to abort the process (Listener window, menu Lisp/Abort or CMD+'A').

• Getting ready: Installation, sound tests, etc.
• Basics of the environment: the main OM windows and concepts: workspace, packages, documents, preferences…
• Patching basics: creating and evaluating a visual program
• Introduction to basic OM objects: note, chord, chord-seq, BPF…
• Score and BPF editors
• Evaluation modes: lock, eval once (local state), lambda (higher-order functions)
• Using the basic OM functions to create musical data (om-random, om-scale, om-sample, om+, om-round, x→dx/dx→x, etc.)
• Iterations: mapcar
• Iterations: omloop
• Interpolations
• Abstractions: local (red) / global (blue)

• Click to enlarge the pictures
• See how to import patches in your workspace in the online user manual.

Basic visual program including note, chord, chord-seq, multi-seq objects; om-random, dx→x and use of box states… Download the patch: cnmat-patch-1.omp
Using (rescaleing, resampling…) BPFs (break point functions) Download the patch: cnmat-bpf-1.omp
Definition of a simple abstraction and application in iterative processes using MAPCAR or OMLOOP. Download the patch: cnmat-bpf-iterations.omp
.. more advanced use of MAPCAR and of lambda functions as tests/keys in higher-order functions. See also the OM User Manual for more details on higher-order functions in OM Download the patch: cnmat-mapcar-2.omp
Interpolations … and how to access list elements, display in BPFs, use BPF-Libs, extend to chord interpolation. Download the patch: cnmat-interpolation.omp

• Voices and rhythic trees, quantification
• Curves and "spatial" objects: BPC, 3DC…
• Sounds
• Install / load external libraries [⇒ see also in the OM User Manual]

Download the libraries on the ForumNet website (subscription required – granted for free to the workshop participants).
Import the libraries tutorial patch from the Help/Import Tutorials menu of the Workspace window.

Understanding the SDIF will be useful here..
⇒ Read more on the SDIF format and use in OM in the online user manual. ⇒ See the SDIF documentation, standard types, etc.

We will create SDIF files using the sound analysis libraries, but you can also generate them and import them for other software, such as:

• AudioSculpt (ForumNet subscription required).
  
• Spear (by M. Klingbeil) – alternative software and GUI for phase vocoder analysis.

Here are some example files you may use in the following patches (put the files in your in-files folder as set in the preferences, or anywhere on your computer):

• sounds
• SDIF analyses

⇒ See also the documentation of SuperVP and PM2 analyses in AudioSculpt (apply to OM-SuperVP and OM-pm2 operators).