Merged basic and shape-based partitioning files.
Functions ok with basic, shape-based without and with  flip. But still problems with shift.
Added comments/documentation.
Improved display of reproducible results + misc comments.
Edit documentation.
All methods+partitioning working.
Potential bug in code reported by P. Bucher.