Updated methods and examples, added docstrings to Print and Plot classes

[sam-grant]

Tidied up the methods and added the functionality to pass user defined axes to the plotting functions for improved flexibility.

I also added docstrings to the functions in the Print and Plot classes, which can be accessed as follows:

>>> import pyplot as plot
>>> plotter = plot.Plot()
>>> help(plotter.Plot1D)

Help on method Plot1D in module pyplot:

Plot1D(array, nbins=100, xmin=-1.0, xmax=1.0, weights=None, title=None, xlabel=None, ylabel=None, col='black', leg_pos='best', out_path=None, dpi=300, log_x=False, log_y=False, under_over=False, stat_box=True, stat_box_errors=False, error_bars=False, ax=None, show=True) method of pyplot.Plot instance
    Create a 1D histogram from an array of values.

    Args:
      array (np.ndarray): Input data array
      weights (np.ndarray, optional): Weights for each value
      nbins (int, optional): Number of bins. Defaults to 100
      xmin (float, optional): Minimum x-axis value. Defaults to -1.0
      xmax (float, optional): Maximum x-axis value. Defaults to 1.0
      title (str, optional): Plot title
      xlabel (str, optional): X-axis label
      ylabel (str, optional): Y-axis label
      col (str, optional): Histogram color. Defaults to 'black'
      leg_pos (str, optional): Legend position. Defaults to 'best'
      out_path (str, optional): Path to save the plot
      dpi (int, optional): DPI for saved plot. Defaults to 300
      log_x (bool, optional): Use log scale for x-axis. Defaults to False
      log_y (bool, optional): Use log scale for y-axis. Defaults to False
      under_over (bool, optional): Show overflow/underflow stats. Defaults to False
      stat_box (bool, optional): Show statistics box. Defaults to True
      stat_box_errors (bool, optional): Show errors in stats box. Defaults to False
      error_bars (bool, optional): Show error bars on bins. Defaults to False
      ax (plt.Axes, optional): External custom axes
      show (bool, optional): Display the plot, defaults to True

    Raises:
      ValueError: If array is empty or None

Finally, I updated the example script example_plotting.py.

[sophiemiddleton]

thanks Sam, I'm going to open this asa PR on the main branch since it looks like we've made some good progress