now part of the `nr` namespace, updated code

updated README, code and examples