Rename module to Chaotic Modulations and add README

Author: ljwall

README.md

@@ -0,0 +1,5 @@
+# Custom units for the ER-301
+
+Unless otherwise stated these units are for v0.6 firmware.
+
+* [Chaotic Mods](./chaoticmods)

modulations/LogisticMap.cpp renamed to chaoticmods/LogisticMap.cpp

@@ -1,4 +1,4 @@
-local modulations = require "modulations.libmodulations"
+local chaos = require "chaoticmods.libchaoticmods"
 
 local Class = require "Base.Class"
 local GainBias = require "Unit.ViewControl.GainBias"
@@ -18,7 +18,7 @@ function LogisticMapUnit:onLoadGraph(channelCount)
   local clockComparator = self:addObject("clockComparator", app.Comparator())
   clockComparator:setTriggerMode()
 
-  local logisticMap = self:addObject("logisticMap", modulations.LogisticMap())
+  local logisticMap = self:addObject("logisticMap", chaos.LogisticMap())
 
   connect(clockComparator, "Out", logisticMap, "Trigger")
   connect(logisticMap, "Out", self, "Out1")

modulations/LogisticMap.h renamed to chaoticmods/LogisticMap.h

@@ -1,4 +1,4 @@
-local modulations = require "modulations.libmodulations"
+local chaos = require "chaoticmods.libchaoticmods"
 
 local Class = require "Base.Class"
 local Encoder = require "Encoder"
@@ -16,7 +16,7 @@ function Lorenz:init(args)
 end
 
 function Lorenz:onLoadGraph(channelCount)
-  local lorenz = self:addObject("lorenz", modulations.Lorenz())
+  local lorenz = self:addObject("lorenz", chaos.Lorenz())
   local rate = self:addObject("rate", app.ParameterAdapter())
   local rho = self:addObject("rho", app.ParameterAdapter())
   local sigma = self:addObject("sigma", app.ParameterAdapter())

modulations/LogisticMap.lua renamed to chaoticmods/LogisticMap.lua

@@ -21,9 +21,9 @@
 # rather than auto-generated.
 
 # Override these defaults on the commandline:
-PKGNAME ?= modulations
+PKGNAME ?= chaoticmods
 PKGVERSION ?= 0.0.1
-LIBNAME ?= libmodulations
+LIBNAME ?= libchaoticmods
 PROFILE ?= testing
 SDKPATH ?= ../er-301
 

modulations/Lorenz.cpp renamed to chaoticmods/Lorenz.cpp

@@ -0,0 +1,23 @@
+# Chaotic Modulations
+
+Basic chaotic modulation source units.
+
+## Logistic Map
+
+A clocked modulation source modelling the basic [logistic map](https://en.wikipedia.org/wiki/Logistic_map) equation.
+
+<img src="./logisticmap.png">
+
+Other than the clock input, there is a single parameter `r`. With `r` in the range `[3.56995, 4]` the sequence is chaotic for most values of `r`. Smaller values of `r` in that range exhibit more periods of (approximately) periodic behaviour, before sudden changes. With `r` Below 3.56995 the sequence will converge towards oscillating between 1, 2, 4 , 8, or 16 fixed values.
+
+## Lorenz system
+
+This is a continuous modulation source.
+
+<img src="./lorenz.png">
+
+The [Lorenz system](https://en.wikipedia.org/wiki/Lorenz_system) is defined by a set of three ordinary differential equations.
+
+There other than the rate, there are three parameters in the differential equations that can be adjusted from their starting values of `ρ = 28`, `σ = 10`, and `β = 8/3`. Care must be taken: it's pretty easy to land on values where oscillation stops entirely.
+
+There are three options for the output corresponding to the the variables in the system of differential equations: `x`, `y`, and `z`. For many parameters `x` and `y` will exhibit quite similar behaviour, but not always.