add error checks, unit tests, documentation for real-valued systems

add error checks, unit tests, documentation for real-valued systems #876