update usage example of 1d transform
update example of 3D transform

Use the new transform API and also generate the various figures at
docs compile time.
make 3d directionality example be built at docs compile time
Merge pull request #82 from rjw57/fix-issue-78

move examples into docs directory and update usage examples