# @strudel/tonal

This package adds tonal / harmonic functions to strudel Patterns.

## Install

```sh
npm i @strudel/tonal --save
```

## Example

```js
import { sequence } from '@strudel/core';
import '@strudel/tonal';

const pattern = sequence(0, [1, 2]).scale('C major');

const events = pattern.firstCycle().map((e) => e.show());
```

yields:

```js
(0/1 -> 1/2, 0/1 -> 1/2, C3)
(1/2 -> 3/4, 1/2 -> 3/4, D3)
(3/4 -> 1/1, 3/4 -> 1/1, E3)
```

[play with @strudel/tonal codesandbox](https://codesandbox.io/s/strudel-tonal-example-rgc5if?file=/src/index.js)

## Tonal API

See "Tonal API" in the [Strudel Tutorial](https://strudel.cc/learn/tonal)