harmony-ts
[](https://johnameyer.github.io/harmony-ts)
[](https://github.com/johnameyer/harmony-ts/actions)
[](https://badge.fury.io/js/harmony-ts)
This project is an engine for generating and analyzing four-part textures (and eventually other forms) in the style of Bach and the classical era. Currently, it allows one to pass a series of constraints, such as chord/type/inversion and voice parts, and it will produce the complete texture using the settings provided. It also gives many useful basic music theory functions like intervals and chords.
## Getting Started
### Installing
```
npm install harmony-ts
```
### Using the Library
To use the harmonizer, first set up the constraints you wish to use. This might consist of particular notes or a [roman numeral](https://en.wikipedia.org/wiki/Roman_numeral_analysis) in a scale. The incomplete chord struct is meant to represent a vertical slice and single chord that is to be harmonized.
```ts
const sopranoNotes = ['E5', 'E5', 'D5', 'D5', 'C5', 'C5', 'B4', 'C5'];
const constraints = sopranoNotes.map(soprano => new IncompleteChord({voices: [soprano, undefined, undefined, undefined]}));
```
Then initialize the part-writer with your choice of parameters (see documentation for options)
```ts
const partWriter = new PartWriter();
```
Then select the scale to harmonize within and pass the constraints to the part-writer.
```ts
const scale = Scale.Major.notes;
const results = flattenResults(partWriter.voiceAll(constraints, scale));
const bestResult = results.next().value;
```
It is also possible to just generate the chords that could go with a melody or bass-line, or perform voice-leading checks on a provided set of chords.
### Demo
[Part Writing Demo](https://johnameyer.github.io/harmony-ts-demo)
### Code Examples
[Library Demo Source](https://github/johnameyer/harmony-ts-demo)
[Unit Tests](https://github.com/search?q=repo%3Ajohnameyer%2Fharmony-ts+path%3Asrc+filename%3Atest.ts+language%3ATypeScript&type=Code&ref=advsearch&l=TypeScript)
[Package Import Tests](https://github.com/johnameyer/harmony-ts/tree/master/test)
### Documentation
[Typedoc](https://johnameyer.github.io/harmony-ts)
## Versioning
We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/johnameyer/harmony-ts/tags).
## Authors
* **John Meyer** - *Initial work* - [johnameyer](https://github.com/johnameyer)
See also the list of [contributors](https://github.com/your/project/contributors) who participated in this project.