misc javadoc and comments, and doing type coercion on sensor lookups where needed