Remove from ideal_tube cyclical dependence.

Take off from ideal_tube the constructIdealTubeFromRealTube in order to
remove dependency on tube_calib and tube_calib_fit_params.

use numpy instead of math

re #7387
Conforming documentation to rest

small changes to conform documentation to rest.

For tube_calib_fit_params add an attribute that allows the fitting steps to
guess the best parameters (automatic).

re #7387
Extension for the tube_calib module

It implements the described automatically guess for the fit parameters in
the getPoints method.

Reimplement getPoints method.

Implement getCalibratedPixelPositions using vectorial mathematics.

Conform the documentation to the rest

Change some of the parameters of getCalibration:

 * It does not deal with PeakFile but with PeakTable
 * Make PlotTube a list of values instead of a single one.
 * Remove some checkings, because it will be done at tube module.
 * Add the constructIdealTubeFromRealTube, previously in ideal_tube.

re #7387
Provide a new interface for the calibration framework

This module will be the interface for the calibration framework.
It provides internal documentation that will be make available on #7387.

It also provides a new interface with different arguments for the calibration,
in order to not require any special knowlegde of internal objects to interact
with the calibration.

So, now, it is possible to calibrate an instrument just providing the workspace,
the name of the tubes to calibrate and the expected positions.

re #7387
Translate some examples and improve documentation

Translate these examples to the new interface of calibration framework.
It extends the previous example, providing the techiniques to explore the
framework to calibrate, with a nice output, the three instruments MAPS, MERLIN, WISH.

re #7387
Simple translation of the previous example to the new interface

re #7387
Configure sphinx to parse the tube calibration

re #7437
Improve the connection of the parameters and its usage

re #7437
Merge remote-tracking branch 'origin/master' into feature/7437_doc_calibration
Merge remote-tracking branch 'origin/master' into feature/7437_doc_calibration

Conflicts:
	Code/Mantid/scripts/Calibration/tube.py

It was necessary to merge master into 7437 to solve conflicts.

re #7437
Merge remote-tracking branch 'origin/feature/7437_doc_calibration'