Image display episode

[K-Meech]

For https://github.com/HealthBioscienceIDEAS/microscopy-novice/issues/18

This adds a first draft of the image display episode. This aims to introduce how an image array is converted to the final image display e.g. colormaps, brightness + contrast, histograms...

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-27

The following changes were observed in the rendered markdown documents:

 fig/coins-histogram.png (new)                      | Bin 0 -> 13035 bytes
 fig/colorbar-comparison.png (new)                  | Bin 0 -> 775160 bytes
 fig/contrast-comparison-0-255.png (new)            | Bin 0 -> 508701 bytes
 fig/contrast-comparison-150-200.png (new)          | Bin 0 -> 352684 bytes
 fig/contrast-comparison-150-255.png (new)          | Bin 0 -> 291486 bytes
 fig/diff-array-same-display.png (new)              | Bin 0 -> 75345 bytes
 fig/exercise-hist-images.png (new)                 | Bin 0 -> 71019 bytes
 fig/exercise-histograms.png (new)                  | Bin 0 -> 81441 bytes
 fig/gray-colorbar.png (new)                        | Bin 0 -> 7013 bytes
 fig/mitosis-histogram.png (new)                    | Bin 0 -> 13295 bytes
 fig/napari-hub-activity.png (new)                  | Bin 0 -> 54055 bytes
 fig/napari-hub.png (new)                           | Bin 0 -> 33782 bytes
 fig/plugin-installation.png (new)                  | Bin 0 -> 19673 bytes
 fig/same-array-diff-display.png (new)              | Bin 0 -> 51014 bytes
 .../brightness_comparison.py (new)                 |  89 +++++
 .../colormap_comparison.py (new)                   |  66 ++++
 .../histogram_exercise.py (new)                    |  73 ++++
 image-display.md (new)                             | 378 +++++++++++++++++++++
 md5sum.txt                                         |  27 +-
 19 files changed, 620 insertions(+), 13 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-14 17:09:42 +0000

[K-Meech]

@davecash75 @dpshelio - I've made a new version of this episode incorporating your suggestions. Could you take a look and approve or suggest changes? You'll see that I also added some python scripts into the episodes/files/image-display-plots directory. These are the scripts used to generate the histograms/images in this episode with matplotlib. I thought it would be a good idea to keep these in the repository, so it's easier to generate new ones if anything needs changing in future.