Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

======================================= TSAM - Timbre Space Analyzer and Mapper


The Timbre Space Analyzer & Mapper (TSAM) is a collection of MAX patches and MATLAB functions for the analysis, modeling and malling of the timbre if siund synthesizers. The TSAM can be obtained at TSAM Copyright (C) 2016 Stefano Fasciani, University of Wollongong Inquiries:


============ REQUIREMENTS

The TSAM is implemented in Cycling '74 Max 7 and MATLAB (OSX only).

The TSAM has been developed and tested on the following platform: OSX 10.7.5 MAX 7.2.4 (32-bit) MATLAB 7.12.0 (R2011a)

The following Cycling '74 Max 7 libraries are required: (download the externals and include these in your Max path)

The following MATLAB libraries/toolboxes are required : (download the files.m and include these in your MATLAB path)

============ INSTRUCTIONS

The TSAM.maxpat and TSAM_3DOGL.maxpat are equivalent. The only difference is in the timbre space visualization. The TSAM.maxpat provides a 2D timbre space visualization, which is less CPU demanding. The TSAM_3DOGL.maxpat provides a 3D timbre space visualization (OpenGL), which is more CPU demanding. Both TSAM.maxpat and TSAM_3DOGL.maxpat provides 2D and 3D mapping capabilities.

Run the TSAM.maxpat (or TSAM_3DOGL.maxpat) and run the TSAM.m script in MATLAB. The TSAM.m script communicates with the TSAM.maxpat via OSC. To terminate the TSAM.m push the "Stop Engine" button in the TSAM.maxpat main tab. When TSAM.m is running "Engine Stopped" changes state to "Engine Running". The TSAM.maxpat request to the TSAM.m sctipt the mapping computation and scoe computation (only when pressing the buttons "Compute Mapping" and "Compute Score" in the TSAM.maxpat main tab. For any other operation the TSAM.maxpat do not require the TSAM.m to run in background (e.g. for analysis or real time mapping).

In MATLAB you can compile the TSAM.m into a matlab executable and run it from the terminal. To compile in MATLAB use the command below.

mcc -m -v -I full_path_to_TSAM_MATLAB_folder -o compiled full_path_to_TSAM_MATLAB_folder/TSAM.m

Matlab will generate automatically a shell script, then you can run the TSAM.m runing sudo from the terminal (you need superuser credentials)


Timbre Space Analyzer & Mapper







No releases published


No packages published