detailed error messages, updated documentation, updated visualization, fixed linkage