z-surface restraints scripts

[VGPReys]

You are about to submit a new Pull Request. Before continuing make sure you read the contributing guidelines and that you comply with the following criteria:

• [x] You have sticked to Python. Please talk to us before adding other programming languages to HADDOCK3
• [ ] Your PR is about CNS
• [x] Your code is well documented: proper docstrings and explanatory comments for those tricky parts
• [x] You structured the code into small functions as much as possible. You can use classes if there is a (state) purpose
• [x] Your code follows our coding style
• [x] You wrote tests for the new code
• [x] tox tests pass. Run tox command inside the repository folder
• [x] -test.cfg examples execute without errors. Inside examples/ run python run_tests.py -b
• [x] PR does not add any dependencies, unless permission granted by the HADDOCK team
• [x] PR does not break licensing
• [ ] Your PR is about writing documentation for already existing code :fire:
• [ ] Your PR is about writing tests for already existing code :godmode:

---

Closes #834 by adding a new subcommand z-surface-restraints to the haddock3-restraints CLI.

haddock3-restraints z-surface-restraints
  --pdb my_structure.pdb
  --residues 1,2,3 7,8,9
  --spacing 40
  --x-size 200
  --y-size 200
  --output my_Zrestraints

Selected residues sets (in the above example 1,2,3 and 7,8,9), will define two plans with x-dim --x-size and y-dim --y-size placing beads every --spacing angstroms. Also, corresponding restraints are generated, resulting in the generation of both:

• a beads.pdb file containing the coordinates of the shape beads
• a restraints.tbl file containing specific restraints to each plans.

A series of examples are also provided, in examples/docking-protein-surface

TODO LIST

• [x] Generate bead plans
• [x] Generate restraints to plans
• [x] Have proper tests
• [ ] Benchmark