Large restructuring of package; see details

I have remove paradox_pe_sim.cpp and get_pe.cpp since these are
now replaced by the one function that does both.

I have also renamed paradox_pe_sim to paradox_sim to be a little
less verbose.

I have added documentation and an example to paradox_sim and
re-run the documenation making for all files.