https://github.com/jonathanstowe/euclideanrhythm

Implementation of the algorithm described in http://cgm.cs.mcgill.ca/~godfried/publications/banff.pdf
https://github.com/jonathanstowe/euclideanrhythm

algorithm euclid music raku

Last synced: 18 days ago
JSON representation

Implementation of the algorithm described in http://cgm.cs.mcgill.ca/~godfried/publications/banff.pdf

• Host: GitHub
• URL: https://github.com/jonathanstowe/euclideanrhythm
• Owner: jonathanstowe
• License: artistic-2.0
• Created: 2016-04-09T21:52:49.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2022-08-07T08:44:17.000Z (over 2 years ago)
• Last Synced: 2023-04-22T17:06:59.651Z (over 1 year ago)
• Topics: algorithm, euclid, music, raku
• Language: Raku
• Homepage:
• Size: 16.6 KB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes

Awesome Lists containing this project

README

        
# EuclideanRhythm

Implementation of the algorithm described in http://cgm.cs.mcgill.ca/~godfried/publications/banff.pdf

![Build Status](https://github.com/jonathanstowe/EuclideanRhythm/workflows/CI/badge.svg)

## Synopsis

```raku

    use EuclideanRhythm;

    my $r = EuclideanRhythm.new(slots => 16, fills => 7);

    for $r.list {

        # do something if the value is True

    }

```

## Description

This provides an implementation of the algorithm described in

[http://cgm.cs.mcgill.ca/~godfried/publications/banff.pdf](http://cgm.cs.mcgill.ca/~godfried/publications/banff.pdf)

which is in turn derived from a Euclidean algorithm. Simply put it

provides a simple method to distribute a certain number of "fills"

(hits, beats, notes or whatever you want to call them,) as evenly as

possibly among a number of "slots". The linked paper describes how, using

this method, you can approximate any number of common rhythmic patterns

(as well as not so common ones.)

You could of course use it for something other than generating musical

rhythms: any requirement where a number of events need to be distributed

over a fixed number of slots may find this useful.

## Installation

Assuming you have a working installation of Rakudo then you should be able to install this with *zef*:

	zef install EuclideanRhythm

or if you have a local copy of this repository:

	zef install .

in the directory you found this file.

## Support

This is a fairly simple module such that the scope for any

egregious bugs is quite limited, however if you have any

suggestions, patches or comment the feel free to leave a post at

https://github.com/jonathanstowe/EuclideanRhythm/issues.

Because it is quite simple in both scope and implementation I would

anticipate that any higher level functionality (such as providing timing,)

would be implemented in another module.

## Licence and Copyright

This is free software. Please see the [LICENCE](LICENCE) file in the distribution.

© Jonathan Stowe 2016 - 2021