diffrhythm.ai

A powerful Elixir library for generating and manipulating rhythmic patterns, inspired by and designed for integration with the diffrhythm.ai platform. This package provides functions for creating, transforming, and analyzing rhythmic sequences in a functional and composable manner.

Installation

To install diffrhythm.ai, add it as a dependency to your mix.exs file: elixir def deps do [

{:diffrhythm_ai, "~> 0.1.0"} # Replace with the latest version

] end

Then, run mix deps.get to fetch the dependency.

Usage Examples

Here are a few examples demonstrating how to use the diffrhythm.ai library:

1. Generating a basic rhythmic pattern: elixir alias DiffrhythmAi, as: DR

pattern = DR.generate(length: 8, density: 0.5) IO.puts(inspect(pattern))

Output: [true, false, true, false, false, false, true, false] (example)

2. Transforming a rhythmic pattern using pattern matching and pipes: elixir alias DiffrhythmAi, as: DR

pattern = [true, false, true, false, true, false, true, false]

transformed_pattern = pattern |> DR.rotate(2) # Rotate the pattern by 2 positions |> DR.invert() # Invert the pattern (true becomes false, false becomes true)

IO.puts(inspect(transformed_pattern))

Output: [true, false, true, false, false, true, false, true]

3. Analyzing rhythmic density: elixir alias DiffrhythmAi, as: DR

pattern = [true, false, true, true, false, false, true, true]

density = DR.density(pattern)

IO.puts("Density: #{density}")

Output: Density: 0.625

4. Combining two rhythmic patterns: elixir alias DiffrhythmAi, as: DR

pattern1 = [true, false, true, false] pattern2 = [false, true, false, true]

combined_pattern = DR.combine(pattern1, pattern2, :or) # Combine using logical OR

IO.puts(inspect(combined_pattern))

Output: [true, true, true, true]

5. Using DiffrhythmAi.euclidean/2 to generate a Euclidean rhythm: elixir alias DiffrhythmAi, as: DR

pattern = DR.euclidean(5, 8)

IO.puts(inspect(pattern))

Output: [true, false, true, false, true, false, true, false]

Feature Summary

• Rhythmic Pattern Generation: Generate rhythmic sequences based on specified length and density.
• Transformation Functions: Rotate, invert, and manipulate existing rhythmic patterns.
• Analysis Tools: Calculate rhythmic density and other relevant metrics.
• Combination Operators: Combine multiple rhythmic patterns using logical operations.
• Euclidean Rhythm Generation: Create Euclidean rhythms with specified pulses and steps.
• Functional Design: All functions are designed to be composable and pure, promoting predictable and maintainable code.
• Pattern Matching Friendly: Designed to work seamlessly with Elixir's powerful pattern matching capabilities.

License

MIT License

This package is part of the diffrhythm.ai ecosystem. For advanced features and enterprise-grade tools, visit: https://diffrhythm.ai/