bifurc2midi

This application generates midi bifurcation diagrams generated from generated logistic map data.

See instructions for installation on macOS for more detailed guide on getting started.

Installation

Install from PyPI:

pip3 install bifurc2midi

Usage

For help:

bifurc2midi --help

Run with default settings:

bifurc2midi

This will generate a midi file in the current working directory.

Sending midi output to a specific device:

bifurc2midi --midi-out-device device_name

Where device_name is the name of the midi device you want to send the output to. Use a device name of 'default' to use the first available device e.g.

bifurc2midi --midi-out-device 'device_name'

Enabling midi loopback driver on macOS (e.g. for use with DAWS):
1. Open 'Audio MIDI Setup.app'
2. Click 'Window' -> 'Show MIDI Studio'
3. Double click 'IAC Driver' device
4. Check 'Device is online' checkbox
5. Click 'Apply'
6. Make sure 'IAC Driver' enabled as a midi input device in your DAW

Installation from source

Prerequisites:
- Python 3
- pip

Make sure pip is up to date:

python3 -m pip install --upgrade pip

Install package from source code:

pip install .

Now you can run the application from the command line e.g.

bifurc2midi --version

Development

Pre-requisites:
- Python 3
- pip
- virtualenv
Use the Makefile for local development:

Activate a virtual environment:

make virtualenv

Activate the virtual environment (not strictly necessary, if using the Makefile only):

source venv/bin/activate

Install dependencies:

make install

Then you can:

Run the application:

make run

Extra arguments can be passed by providing EXTRA_ARGS variable e.g.

make run EXTRA_ARGS="--help"

Run tests:

make test

Run linter:

make lint

make fmt can be used to automatically fix some linting errors.

Other useful make targets are provided too, see the Makefile for details. Or run make/make help

TODO