Code and docs cleanup for OPF mod

[simonbowly]

• Various updates to the OPF documentation
• Add data validation unit tests
• Handle case where no feasible solution is found (raise an exception instead of returning a 'success' flag)