improve input data validation

[open-risk]

for all functions test input values for validity and provide helpful error or warning messages as appropriate. Examples

• define acceptable type (ideally implement consistently type hinting across the library)
• define acceptable range (e.g. negative, maximum etc)