# `Mx.Notation`
[🔗](https://github.com/mx-music/mx/blob/main/lib/mx/notation.ex#L1)

Small helpers a song's functions use to choose and tune notes: stepping through a list, drawing seeded random numbers, and intervals in cents or ratios.

# `between`

A number from `low` up to `high`, rounded to two decimals, from the seeded random numbers.

# `cents`

An interval in cents as semitones, rounded to two decimals, so `cents(386)` is 3.86.

# `chance`

True about `probability` times in 1, from the seeded random numbers.

# `clamp`

A number kept from `low` up to `high`.

# `pick`

One item of a list or a range, from the seeded random numbers.

# `ratio`

The interval of a frequency ratio in semitones, rounded to two decimals, so `ratio(5 / 4)` is 3.86 and `ratio(2)` is 12.

# `ring`

The item of a list at an index, wrapping round, so `ring(list, pass)` steps one item per pass.

---

*Consult [api-reference.md](api-reference.md) for complete listing*