Multi-dimensional images episode

[K-Meech]

Closes https://github.com/HealthBioscienceIDEAS/microscopy-novice/issues/19

This adds a first draft of the multi-dimensional images episode. This aims to introduce how images with 2 or more dimensions are handled by Napari + an intro to RGB images

It's probably best to build this branch locally so you can see all the images + text together with the proper formatting.

[github-actions[bot]]

Thank you!

Thank you for your pull request :smiley:

:robot: This automated message can help you check the rendered files in your submission for clarity. If you have any questions, please feel free to open an issue in {sandpaper}.

If you have files that automatically render output (e.g. R Markdown), then you should check for the following:

• :dart: correct output
• :framed_picture: correct figures
• :question: new warnings
• :bangbang: new errors

Rendered Changes

:mag: Inspect the changes: https://github.com/HealthBioscienceIDEAS/microscopy-novice/compare/md-outputs..md-outputs-PR-31

The following changes were observed in the rendered markdown documents:

 config.yaml (new)                              |  83 ++++
 fig/2d-3d-arrays.png (new)                     | Bin 0 -> 55869 bytes
 fig/3d-4d-arrays.png (new)                     | Bin 0 -> 121127 bytes
 fig/brain-napari.png (new)                     | Bin 0 -> 76000 bytes
 fig/cells-time-napari.png (new)                | Bin 0 -> 192709 bytes
 fig/channel-arrays.png (new)                   | Bin 0 -> 80975 bytes
 fig/colorwheel-napari.png (new)                | Bin 0 -> 175207 bytes
 fig/introduction-rendered-pyramid-1.png (gone) | Bin 4841 -> 0 bytes
 fig/rgb-exercise.png (new)                     | Bin 0 -> 41392 bytes
 fig/rgb-histogram.png (new)                    | Bin 0 -> 20570 bytes
 fig/rgb-values.png (new)                       | Bin 0 -> 549116 bytes
 fig/skin-napari.png (new)                      | Bin 0 -> 886959 bytes
 fig/tyx-array.png (new)                        | Bin 0 -> 39871 bytes
 md5sum.txt                                     |   6 +-
 multi-dimensional-images.md (new)              | 634 +++++++++++++++++++++++++
 15 files changed, 720 insertions(+), 3 deletions(-)

What does this mean?

If you have source files that require output and figures to be generated (e.g. R Markdown), then it is important to make sure the generated figures and output are reproducible. This output provides a way for you to inspect the output in a diff-friendly manner so that it's easy to see the changes that occur due to new software versions or randomisation.

:stopwatch: Updated at 2023-12-20 12:11:13 +0000

[K-Meech]

Thanks for the comments @thompson318 ! I'll make sure to incorporate these into a new version of the episode. For the histogram part, this episode is after the 'image display' episode. This introduces napari-matplotlib + how to install and use it. I'll make sure to link directly to this episode rather than just saying 'last episode' to be clearer. For reference, the learning objectives and order of lessons for day 1 are here: https://github.com/HealthBioscienceIDEAS/microscopy-novice/issues/8#issuecomment-1792729467

[K-Meech]

@thompson318 @davecash75 - I've made a new version incorporating your suggestions. Could you take a look through and either approve it or suggest more changes?

I re-arranged the channels section quite a bit - so hopefully this gives more clarity on layers vs channels now. I added an extra diagram too and gave a few extra examples.