documented methods added to class Brain for outsider use