tweak the call signature. add example.py

Plan takes a Partition object; flags can be overriden.