fix the determination of the dimension. closes #44
adjust some javadoc
apply fix for duplicate identical FOI in the same response. closes #43