1. improves handling of parameter values. current implementation was too
   picky and failed when filenames began with numbers, for example.

2. updating rotation rules to use `RotateWXYZ` API instead of individual
   axes rotations.

3. improved error reporting and made it easier to generate debugging
   log.