Move from 2d to 3d array operations

[PinkShnack]

About

We should allow stacks of 2D arrays as inputs. This will likely speed up processing of large datasets, and certainly will when we add Cupy as an FFTFilter (#10). Several things to note:

• Allowed formats e.g. RGB, 2d, 3d (see below)
• What should be returned to the user: currently, a 3d array with the shape (z, y, x), with z being the number of images in the stack.
  • We can provide convenience functions for users to convert between formats. I think we should limit this as a "per image" basis. In other words, the functions should handle image input, not qpretrieve classes. We could f course have some nice methods that do the conversion within the class, and return the image to the user.
  • Important to have a method that returns the original and current image formats.

To do

• FFTFilter Base class work with 3D arrays
• QLSI init - fix the instanciation - allow user to set FFTFilter
• run_pipeline steps for OAH and QLSI should also work with 3D arrays.
• Benchmark single 2d array prcessed n times against stack of n images all processed at once. Put in docs. See test test_fft_comparison_data_input_fmt
• Image formats. The following formats should continue to work.
  • 2D images (y, x) should be converted internally to (z, y, x)
  • 3D images (image stacks) (z, y, x) will work with above
  • 2D RGB images (y, x, 3) or RGBA (y, x, 4). The data will be assumed to be greyscale, and each channel equal. The first channel will be taken and converted as in the 2D images case above.
    • A warning should be passed to the user.
  • The shape of the returned field will be 3D, and we will provide convenience functions for conversion back to the original format.
    • tests for each data format and each data_attr
• docs
  • compare old (3d input -> 3d output) and new versions (2d input -> 3d output)
  • sphinx not collecting get_array_with_input_layout in code reference
  • show image format conversion
  • base class data argument should be documented clearly
  • show benchmark for 2d vs 3d.
  • Clearly describe what data shapes are handled internally, and what is not (yet) handled e.g. stack of rgb: (20, 128, 128, 3).
  • add type hints
• tests:
  • data array layouts from 3d (test_data_array_layout_to_3d.py)
  • hologram fixture not inputting size argument Solution was to use "request" as hologram size param for the fixture. This is required as learned here.
    • Make PR on pytest describing this
  • compare 2d and 3d FFT algorithms, ensure consistency
• cicd passed
• update changelog

[codecov-commenter]

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

Thanks for integrating Codecov - We've got you covered ☂️

[PinkShnack]

Hey @paulmueller, when you get a chance please go through this PR. I added docs which you should look through. Main things left are "QLSI init - fix the instanciation" and updating the changelog.

[paulmueller]

I only have a few comments. It's not yet waterproof, but it's almost there.
Thanks!

[paulmueller]

Just one question about removed asserts in a test. Otherwise I would consider this complete.