Add test/notebook for matching projected to experimental patterns

[hakonanes]

Signed-off-by: Håkon Wiik Ånes hwaanes@gmail.com

Description of the change

• Add test to pass simulated patterns obtained from EBSDMasterPattern.get_patterns() directly to EBSD.match_patterns()
• Add pattern matching notebook

Progress of the PR

• Docstrings for all functions
• Unit tests with pytest for all lines
• Clean style in as per black
• Flesh out pattern matching user guide with more detailed explanations

Minimal example of the bug fix or new feature

The notebook basically does

>>> import hyperspy.api as hs
>>> from orix import sampling
>>> import kikuchipy as kp
>>> s = kp.data.nickel_ebsd_small()
>>> s.remove_static_background()
>>> s.remove_dynamic_background()
>>> mp = kp.data.nickel_ebsd_master_pattern_small(projection="lambert")
>>> ni = mp.phase
>>> r = sampling.get_sample_fundamental(
...     resolution=5, space_group=ni.space_group.number
... )
>>> detector = kp.detectors.EBSDDetector(
...    shape=s.axes_manager.signal_shape[::-1],
...    pc=[0.421, 0.7794, 0.5049],
...    sample_tilt=70,
...    convention="tsl",
... )
>>> sim = mp.get_patterns(rotations=r, detector=detector, energy=20)
>>> xmap = s.match_patterns(sim, n_slices=10, keep_n=10)
>>> ncc = xmap.get_map_data(xmap.scores[:, 0])
>>> best_patterns = sim.data[xmap.simulation_indices[:, 0]].reshape(s.data.shape)
>>> s_sim = kp.signals.EBSD(best_patterns.compute())
>>> hs.plot.plot_signals([s, s_sim], navigator=hs.signals.Signal2D(ncc))

For reviewers

• Check that the PR title is short, concise, and will make sense 1 year
  later.
• Check that new functions are imported in corresponding __init__.py.
• Check that new features, API changes, and deprecations are mentioned in
  the unreleased section in doc/changelog.rst.