Metadata-Version: 2.1
Name: sms-tools
Version: 0.914
Summary: tools for sound analysis/synthesis
Home-page: https://github.com/MTG/sms-tools
Author: Music Technology Group
Author-email: mtg-info@upf.edu
License: UNKNOWN
Description: sms-tools
        ========= 
        
        
        Sound analysis/synthesis tools for music applications written in python (with a bit of C) plus complementary teaching materials.
        
        How to use
        ----------
        
        In order to use these tools you have to install python (recommended 3.7.x) and the following modules: ipython, numpy, matplotlib, scipy, and cython. 
        
        In Ubuntu (which we strongly recommend) in order to install all these modules it is as simple as typing in the Terminal:
        
        <code>$ sudo apt-get install python-dev ipython python-numpy python-matplotlib python-scipy cython</code>
        
        In OSX (which we do not support but that should work) you install these modules by typing in the Terminal:
        
        <code>$ pip install ipython numpy matplotlib scipy cython</code>
        
        then, for using the tools, after downloading the whole package, you need to compile some C functions. For that you should go to the directory <code>software/models/utilFunctions_C</code> and type:</p>
        
        <code>$ python compileModule.py build_ext --inplace </code>
        
        The basic sound analysis/synthesis functions, or models, are in the directory <code>software/models</code> and there is a graphical interface and individual example functions in <code>software/models_interface</code>. To execute the models GUI you have to go to the directory <code>software/models_interface</code> and type: 
        
        <code>$ python models_GUI.py </code>
        
        To execute the transformations GUI that calls various sound transformation functions go to the directory <code>software/transformations_interface</code> and type: 
        
        <code>$ python transformations_GUI.py </code>
        
        To modify the existing code, or to create your own using some of the functions, we recommend to use the <code>workspace</code> directory. Typically you would copy a file from <code>software/models_interface</code> or from <code>software/transformations_interface</code> to that directory, modify the code, and execute it from there (you will have to change some of the paths inside the files). 
        
        Jupyter Notebook instructions
        -------
        
        The exercises, in the <code>exercises</code> directory, are jupyter notebooks. To read them and do them, Install Jupyter Notebook according to it's instructions https://jupyter.org/install
        
        Start up jupyter notebook
        
        <code>$ jupyter notebook</code> 
        
        
        Content
        -------
        
        All the code is in the <code> software </code> directory, with subdirectories for the models, the transformations, and the interfaces. The lecture materials are in the <code>lectures</code> directory, the exercises related to the lectures in the  <code>exercises</code> directory, and the sounds used for the examples and coming from <code>http://freesound.org</code> are in the <code>sounds</code> directory.
        
        License
        -------
        All the software is distributed with the Affero GPL license (http://www.gnu.org/licenses/agpl-3.0.en.html), the lecture slides are distributed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 (CC BY-NC-SA 4.0) license (http://creativecommons.org/licenses/by-nc-sa/4.0/) and the sounds in this repository are released under Creative Commons Attribution 4.0 (CC BY 4.0) license (http://creativecommons.org/licenses/by/4.0/)
        
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
