stable alpha with basic simulation functions and documentation added