improved error message
added documentation
created another example using the table as a calculation input