Debian Codegraph @

docs/source/manual/The_Image_plot_panel.rst

raw
1 The Image plot panel
2 ====================
3
4 **WARNING:** The manual is current several versions out of date. While it may
5 still be useful for some users, please refer to the tutorial for the most
6 up-to-date information.
7
8 .. _imageplotpanel:
9
10 The Image plot panel displays any detector image that RAW is able to read. The image name
11 is shown at the top of the plot, while the x and y axes are in dimensions of pixels. There
12 is no right click menu for this plot, but scrolling with a mouse scroll wheel will zoom in
13 and out. It is possible to display regions where there is no image data, these will show up
14 as a white background (for example, if you zoom out and show negative pixel ranges.
15
16 In addition to the plot toolbar buttons :ref:`shared by all of the plots <navbar>`,
17 the Image plot has the following buttons:
18
19 |100002010000001800000018B603AD208545D77F_png|
20
21 Displays the image header. This does not display any information from separate header files,
22 only what is in the image itself.
23
24 |1000020100000018000000187E6D3770EAA7994B_png|
25
26 Opens the image display settings dialog described in below.
27
28 |10000201000000500000001EACBFAAFAC41D2CC1_png|
29
30 Shows the previous/next image in the same directory as the current image (as sorted by filename, A-Z).
31
32
33 The Image Display Settings dialog
34 ---------------------------------
35
36 The Image Display Settings dialog lets you change how the image is displayed on the screen.
37 It has three sections, Image parameters, Image scaling, and Colormaps.
38
39 *Image parameters*
40
41 There are three slider bars here. The Upper and Lower limit sliders let you set what pixel
42 values in the image correspond to the most extreme values of the color scale chosen. The
43 Brightness color bar does not work at the moment. By default, the upper and lower limit
44 values are automatically set each time an image is loaded into the Image plot panel.
45 However, checking the Lock values checkbox will prevent the current set values from
46 changing. This allows you to scroll through images maintaining constant upper and lower limits.
47
48 *Image scaling*
49
50 Image scaling allows you to use a linear or logarithmic (base 10) color scale. The logarithmic
51 scale uses the matplotlib.colors.SymLogNorm function (more available here:
52 `https://matplotlib.org/api/colors_api.html <https://matplotlib.org/api/colors_api.html>`_),
53 with a linear threshold set at 1. So the image is logarithmic in color display above 1, and
54 linear in color display below 1 (this is so 0 and negative value pixels can be handled).
55
56 *Colormaps*
57
58 The colormaps option allows you to change the color scale used to display intensity values
59 in the Image plot. The color maps are those available through matplotlib (
60 `https://matplotlib.org/users/colormaps.html <https://matplotlib.org/users/colormaps.html>`_),
61 a limited selection of which are available in RAW: Gray, Heat, Rainbow, Jet (default), Spectral.
62
63 **Note:**
64 Currently there is also a brightness setting, but it does not work properly.
65
66 .. |1000020100000018000000187E6D3770EAA7994B_png| image:: images/1000020100000018000000187E6D3770EAA7994B.png
67
68
69 .. |10000201000000500000001EACBFAAFAC41D2CC1_png| image:: images/10000201000000500000001EACBFAAFAC41D2CC1.png
70
71
72 .. |100002010000001800000018B603AD208545D77F_png| image:: images/100002010000001800000018B603AD208545D77F.png
73