This docstring might be an appropriate place to write out a full textual description of the process. I want to make sure that happens *somewhere*, as this is pretty complicated and somewhat magical