Warning, /education/kstars/doc/fitsviewer.docbook is written in an unsupported language. File is not indexed.

0001 <chapter id="fitsviewer">
0002 <title><acronym>FITS</acronym> Viewer</title>
0003 <indexterm><primary>FITS Viewer</primary></indexterm>
0004 
0005 <para>FITS, or Flexible Image Transport System, is the standard format for representing images and data in Astronomy.  The &kstars; FITS Viewer is a tool to view those images. It is not designed for editing of FITS Images.</para>
0006 
0007 <para>The FITS Viewer can be automatically invoked for images received from the camera. It can also be invoked directly from the main &kstars; menu.
0008 To open a FITS file, select the <menuchoice><guimenu>File</guimenu>
0009 <guimenuitem>Open Image...</guimenuitem></menuchoice> menu item, or press 
0010 <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>.</para>
0011 
0012 <screenshot>
0013   <screeninfo>The FITS Viewer</screeninfo>
0014   <mediaobject>
0015     <imageobject>
0016       <imagedata fileref="fitsviewer1.png" format="PNG"/>
0017     </imageobject>
0018     <textobject>
0019       <phrase>FITS Viewer</phrase>
0020     </textobject>
0021   </mediaobject>
0022 </screenshot>
0023 
0024 <para>The above diagram illustrates the FITS Viewer main work area and window. There is also a hidden area that can be exposed by moving the mouse over the 6 small dots on the left side (about center of the image vertically) and pressing and holding the mouse, sliding it over to the right a bit.</para>
0025 
0026 <screenshot>
0027   <screeninfo>The FITS Viewer with sliding panel open</screeninfo>
0028   <mediaobject>
0029     <imageobject>
0030       <imagedata fileref="fitsviewer2.png" format="PNG"/>
0031     </imageobject>
0032     <textobject>
0033       <phrase>FITS Viewer with sliding panel open</phrase>
0034     </textobject>
0035   </mediaobject>
0036 </screenshot>
0037 
0038 <sect1 id="fits-viewer-main-controls">
0039     <title>Main Controls</title>
0040 
0041 <para>The various controls and displays for the FITS Viewer are shown below. The tool provides basic functions for image display.  While the tool adhere to the FITS standard, it does not support all possible FITS features:</para>
0042 <itemizedlist>
0043   <listitem><para>Support for only <emphasis>one</emphasis> image per file.</para></listitem>
0044   <listitem><para>Support for only 2D and 3D data. 1D data are discarded.</para></listitem>
0045 </itemizedlist>
0046 <para>The FITS Viewer window is divided into the following regions:</para>
0047 <orderedlist>
0048     <listitem><para>Main Menu</para>
0049         <itemizedlist>
0050             <listitem><para>File</para>
0051             <itemizedlist>
0052                 <listitem><para>Standard Open, Save, and Save As.</para></listitem>
0053                 <listitem><para>FITS Header: Display FITS header table data.</para></listitem>
0054                 <listitem><para>Debayer: Covert RAW image to RGB.</para></listitem>
0055             </itemizedlist>
0056             </listitem>
0057             <listitem><para>Edit</para>
0058             <itemizedlist>
0059                 <listitem><para>Undo: Undo last action.</para></listitem>
0060                 <listitem><para>Redo: Redo last action.</para></listitem>
0061                 <listitem><para>Copy: Copy image to clipboard.</para></listitem>
0062             </itemizedlist>
0063             </listitem>
0064             <listitem><para>View</para>
0065                 <itemizedlist>
0066                 <listitem><para>Zoom Controls: Zoom in, Zoom out, standard Zoom.</para></listitem>
0067                 <listitem><para>Filters: Auto Stretch, Contrast, High Pass, Rotate, Flip.</para></listitem>
0068                 <listitem><para>Mark Stars: Detect and mark stars in the image.</para></listitem>
0069                 <listitem><para>Show Clipping: Display in red which stars have pixels that appear to be clipped.</para></listitem>
0070             </itemizedlist>
0071             </listitem>
0072         </itemizedlist>
0073     </listitem>
0074     <listitem><para>Main Toolbar</para>
0075             <itemizedlist>
0076                 <listitem><para>Open File.</para></listitem>
0077                 <listitem><para>Save File: Save FITS data. Any filters applied to the image will be saved.</para></listitem>
0078                 <listitem><para>Save File As.</para></listitem>
0079                 <listitem><para>Undo last action.</para></listitem>
0080                 <listitem><para>Redo last action.</para></listitem>
0081                 <listitem><para>Zoom In: Zoom in up to a maximum of 400%. For large images this operation can be very memory intensive. Turn on Limited Resource Mode to save memory.</para></listitem>
0082                 <listitem><para>Zoom Out.</para></listitem>
0083                 <listitem><para>View in Actual Size.</para></listitem>
0084                 <listitem><para>Zoom to fit.</para></listitem>
0085                 <listitem><para>Rotate Right.</para></listitem>
0086                 <listitem><para>Rotate Left.</para></listitem>
0087                 <listitem><para>Flip Horizontal.</para></listitem>
0088                 <listitem><para>Flip Vertical.</para></listitem>
0089                 <listitem><para>Show Cross Hairs: Toggles crosshairs in the center of the image.</para></listitem>
0090                 <listitem><para>Show Pixel Gridlines: Toggles pixel grid.</para></listitem>
0091                 <listitem><para>Mark Stars: Detect and mark stars in the image.</para></listitem>
0092                 <listitem><para>Show Clipping: Display in red which stars have pixels that appear to be clipped.</para></listitem>
0093                 <listitem><para>Show Equatorial Gridlines: Toggles Equatorial Grid if FITS contains a valid WCS header.</para></listitem>
0094                 <listitem><para>Show Objects in Image: Identifies objects such as stars, galaxies, and nebulae within the image.</para></listitem>
0095                 <listitem><para>Center Telescope: Toggle Center Telescope mode. When active and if the image contains a valid WCS header, clicking anywhere in the image triggers the telescope slewing to the clicked point.</para></listitem>
0096                 <listitem><para>Histogram: Toggle histogram view in the side panel.</para></listitem>
0097                 <listitem><para>Statistics: Toggle FITS Statistic view in the side panel.</para></listitem>
0098                 <listitem><para>Auto Stretch: Apply Auto Stretch filter to the image.</para></listitem>
0099                 <listitem><para>Toggle Selection Rectangle: Toggle selection rectangle for statistics of a region of interest.</para></listitem>
0100             </itemizedlist>
0101     </listitem>
0102     <listitem><para>Side Panel: The side panel can be opened by dragging the separator to the right. When dragged to the left, the side panel can also be closed.</para>
0103             <itemizedlist>
0104                 <listitem><para>Statistics: Displays image statistics including Minimum, Maximum, Average, and Median values.</para></listitem>
0105                 <listitem><para>Plate Solving: A tool plate-solve the loaded image. This is useful to debug plate-solving issues.</para></listitem>
0106                 <listitem><para>Histogram: Displays image histogram with controls to adjust the minimum and maximum values for each channel. Both linear and logarithmic scalings are available to apply to the image. This is somewhat redundant with the below-image histogram and may be removed in the future.</para></listitem>
0107                 <listitem><para>FITS Header: Displays a table for FITS header keywords, values, and comments.</para></listitem>
0108                 <listitem><para>Recent Images: Displays recently opened images. Clicking on any image will load it.</para></listitem>
0109             </itemizedlist>
0110     </listitem>
0111     <listitem><para>Image Display Area.</para>
0112             <itemizedlist>
0113                 <listitem><para>Mouse: Hovering over the image will update the status bar values accordingly.</para></listitem>
0114                 <listitem><para>Mouse: Hovering over the image will move a cursor in the histogram display below the image, if that histogram is activated.</para></listitem>
0115                 <listitem><para>Control key: Holding down the control key and then moving the mouse will show a magnified portion of the image.</para>
0116 <screenshot>
0117   <screeninfo>The Magnifier in the FITS Viewer</screeninfo>
0118   <mediaobject>
0119     <imageobject>
0120       <imagedata fileref="fitsviewer-magnifier.png" format="PNG"/>
0121     </imageobject>
0122     <textobject>
0123       <phrase>The magnifier in the FITS Viewer</phrase>
0124     </textobject>
0125   </mediaobject>
0126 </screenshot>
0127                 </listitem>
0128                 <listitem><para>Statistics of region of interest</para>
0129                 <para>
0130                 Provides simple statistics average mean, average standard deviation and average median of the selected region by the user in a tooltip.
0131                 </para>
0132                 <screenshot>
0133                     <screeninfo>
0134                       FITSViewer 
0135                     </screeninfo>
0136                     <mediaobject>
0137                         <imageobject>
0138                             <imagedata fileref="fitsviewer_selstat.png" format="PNG"/>
0139                         </imageobject>
0140                         <textobject>
0141                             <phrase>Selection Statistics</phrase>
0142                         </textobject>
0143                     </mediaobject>
0144                 </screenshot>
0145                 <para>
0146                 The user can either set the selection region by <keycombo>&Shift;<keycap>Left Click</keycap></keycombo> dragging (when the selection statistics is activated) or by choosing an entry from the drop down menu of the Toggle Selection Rectangle button. In addition to this, the user can translate the region by simple <keycap>Left Click</keycap> drag of the mouse. The statistics of the region are shown as a tooltip once the cursor is brought over the selection region. For smaller images, the statistics are updated instantly, and for larger images, the statistics are updated once the user releases the <keycap>Left Click</keycap> button after modification of the region.
0147                 </para>
0148                 </listitem>
0149             </itemizedlist>
0150     </listitem>            
0151     <listitem><para>Stretching Controls</para>
0152 <screenshot>
0153   <screeninfo>The Stretch Controls in the FITS Viewer</screeninfo>
0154   <mediaobject>
0155     <imageobject>
0156       <imagedata fileref="fitsviewer-stretch.png" format="PNG"/>
0157     </imageobject>
0158     <textobject>
0159       <phrase>The Stretch Controls in the FITS Viewer</phrase>
0160     </textobject>
0161   </mediaobject>
0162 </screenshot>
0163 <para>Near the bottom of the window are controls for stretching the image and displaying its histogram. They are described below from left to right.</para>
0164             <itemizedlist>
0165                 <listitem><para>Enable Stretching: On the very left of this display is a button that enables or disables stretching.</para></listitem>
0166                 <listitem><para>Shadow Value: The value below which pixels are displayed as black can be manually entered (scale is 0 to 1.0, even for integer pixel values).</para></listitem>
0167                 <listitem><para>Midtones Value: The midtones value which controls the brightness of the image can be manually entered (scale is 0 to 1.0, even for integer pixel values).</para></listitem>
0168                 <listitem><para>Highlights Value: The value above which pixels are displayed as white can be manually entered (scale is 0 to 1.0, even for integer pixel values).</para></listitem>
0169                 <listitem><para>Show Histogram: A button that displays or hides the image histogram is to the right of the highlights number box.</para></listitem>
0170                 <listitem><para>Auto Stretch: A button (magic wand icon) that will automatically create a pleasing stretch is found on the right. It is disabled if the stretch is already at the automatically computed value.</para></listitem>
0171             </itemizedlist>
0172             <para>
0173               In addition, there are sliders that can be used to adjust the Shadow, Midtones and Highlights values. Adjusting them will change the values displayed. 
0174               </para>
0175             <para>
0176               The histogram, if it is enabled, may be zoomed by using the mouse's scroll wheel, and panned by dragging with the mouse. A cursor in the histogram shows the position of the pixel in the image under the mouse.
0177               </para>
0178     </listitem>
0179     <listitem><para>Status Bar</para>
0180 <screenshot>
0181   <screeninfo>The Status Display in the FITS Viewer</screeninfo>
0182   <mediaobject>
0183     <imageobject>
0184       <imagedata fileref="fitsviewer-status.png" format="PNG"/>
0185     </imageobject>
0186     <textobject>
0187       <phrase>The Status Display in the FITS Viewer</phrase>
0188     </textobject>
0189   </mediaobject>
0190 </screenshot>
0191 <para> From right to left, the following status indicators are available:</para>      
0192             <itemizedlist>
0193                 <listitem><para>Loading Indicator: The LED becomes yellow when an image is getting loaded and turns green after loading is successfully done. If there are problems with loading the image, it turns red.</para></listitem>
0194                 <listitem><para>Resolution: Image resolution in pixels. 4656x3520 in the screenshot above.</para></listitem>
0195                 <listitem><para>Zoom Percentage. 13% above.</para></listitem>
0196                 <listitem><para>Cartesian Coordinates: Displays and updates the current mouse position as you hover over the image. X:769 Y:3508 above.</para></listitem>
0197                 <listitem><para>Pixel Value: Value of the pixel under the mouse. 1,792 above.</para></listitem>
0198                 <listitem><para>Equatorial Coordinates: If the image contains a valid WCS header, the J2000 Right Ascension (RA) and declination (DE) values are displayed. 13h 14' 22" 42 37' 35" above.</para></listitem>
0199                 <listitem><para>Image Stats: Displays the HFR, Eccentricity and number of stars if computed. HFR:1.96 Ecc:0.43 143 stars above.</para></listitem>
0200                 <listitem><para>Clipped Stars: If Show Clipping is activated in the main toolbar, it displays the number of possibly clipped pixels. Clip:403 above.</para></listitem>
0201             </itemizedlist>                  
0202     </listitem>
0203 </orderedlist>
0204 <para>
0205     In addition to image display, the viewer can process World-Coordinate-System (WCS) header if present within the FITS file and provides useful information regarding the objects found within the image, equatorial grid overlay, popup menu, and the ability to slew the mount (if connected) to any point within the image.
0206 </para>
0207 <para>
0208     Several filters can be applied to enhance the image include auto stretch and high contrast. Depending on the image size, these operations can take a few seconds to complete. The bottom status bar displays the current pixel value and current X &amp; Y coordinates of the mouse pointer within the image. Furthermore, it includes the current zoom level and the image resolution.
0209 </para>
0210 <para>
0211     When loading a bayered image, the viewer can automatically debayer the image if <emphasis>Auto Debayer</emphasis> is checked in the FITS Settings. The debayering operation fetches the bayer pattern (&eg; RGGB) from the FITS header. If none exists, you can alter the debayering algorithm and pattern from the <guimenu>File</guimenu> menu or by using the <keycombo>&Ctrl; <keycap>D</keycap></keycombo> shortcut.
0212 </para>
0213 <para>
0214     Since operations such as auto debayering and auto WCS are computationally expensive and stress the processor on low-powered embedded devices, you can toggle their behavior in <link linkend="fits-configure">&kstars; Settings FITS page</link>.
0215 </para>
0216 <screenshot>
0217     <screeninfo>
0218         FITS Settings
0219     </screeninfo>
0220     <mediaobject>
0221         <imageobject>
0222             <imagedata fileref="fits_settings.png" format="PNG"/>
0223         </imageobject>
0224         <textobject>
0225             <phrase>FITS Settings</phrase>
0226         </textobject>
0227     </mediaobject>
0228 </screenshot>
0229 <para>
0230     Hovering over any option shall display a detailed tooltip that explains its function.
0231 </para>
0232 </sect1>
0233 <sect1 id="fits-viewer-features">
0234     <title>Features</title>
0235     <variablelist>
0236         <varlistentry>
0237             <term>Histogram</term>
0238             <listitem>
0239                 <screenshot>
0240                     <screeninfo>
0241                         Histogram
0242                     </screeninfo>
0243                     <mediaobject>
0244                         <imageobject>
0245                             <imagedata fileref="fitsviewer_histogram.png" format="PNG"/>
0246                         </imageobject>
0247                         <textobject>
0248                             <phrase>Histogram</phrase>
0249                         </textobject>
0250                     </mediaobject>
0251                 </screenshot>
0252                 <para>
0253                     Displays multi-channel FITS histogram. The user can rescale the image by optionally defining an upper and lower limit for the cutoff region. The rescaling operation (linear, logarithmic, or square-root) may then be applied to the region enclosed by the upper and lower limits.
0254                 </para>
0255             </listitem>
0256         </varlistentry>
0257         <varlistentry>
0258             <term>FITS Header</term>
0259             <listitem>
0260                 <para>
0261                     Displays a read-only table listing FITS header keywords and values.
0262                 </para>
0263             </listitem>
0264         </varlistentry>
0265         <varlistentry>
0266             <term>Statistics</term>
0267             <listitem>
0268                 <para>
0269                     Provides simple statistics for minimum and maximum pixel values and their respective locations. FITS depth, dimension, mean, and standard deviation.
0270                 </para>
0271             </listitem>
0272         </varlistentry>
0273     </variablelist>
0274 </sect1>
0275 
0276 <sect1 id="fits-viewer-solver">
0277     <title>FITS Viewer Solver</title>
0278     <screenshot>
0279         <screeninfo>
0280             FITS Viewer Solver
0281         </screeninfo>
0282         <mediaobject>
0283             <imageobject>
0284                 <imagedata fileref="fitsviewer-solver.png" format="PNG"/>
0285             </imageobject>
0286             <textobject>
0287                 <phrase>FITS Viewer Solver</phrase>
0288             </textobject>
0289         </mediaobject>
0290     </screenshot>
0291     <para>
0292       The FITS Viewer Solver is used to plate-solve the image loaded in the FITS Viewer's tab. It only works with the internal StellarSolver. You get the RA and DEC coordinates for the center of the image, the image's scale, the angle of rotation, and the number of stars detected in the image. Its main use case is debugging plate-solving issues in Ekos, though the information displayed can be generally useful. The controls and displays are described below.
0293     </para>
0294             <itemizedlist>
0295                 <listitem><para>Solve Button. Pressing this button starts plate solving. When the system is plate solving, the button becomes an abort button.</para></listitem>
0296                 <listitem><para>Scale: Checking the Use Scale checkbox constrains the solver to use approximately the pixel or image scale given. The scale is entered in the box and the units for the scale can be chosen from image width in degrees, image width in arc-minutes, and arc-seconds per pixel. When a solve successfully completes, it replaces the value in the box with solution's scale.</para></listitem>
0297                 <listitem><para>Position: Checking the Use Position checkbox constrains the solver to search near the RA and DEC coordinates given. The extent of the search is given by the user in the Radius box in degrees. Note that RA is input in hours-minutes-seconds, e.g. 13h, and DEC is input in degrees-minutes-seconds, e.g. 85. When a solve successfully completes, it replaces the value in the RA and DEC boxes with solution's coordinates. In addition it fills in the Angle field with the solutions angle value in degrees.</para></listitem>
0298                 <listitem><para>Use SkyMap Position: There is a button just below the Use Position checkbox that fills in RA and DEC boxes with the current center of the SkyMap display.</para></listitem>
0299                 <listitem><para>Profile: The Profile menu selects which StellarSolver preset, among those used in the Ekos Align module, should be used for plate solving. This is further discussed below.</para></listitem>
0300                 <listitem><para>Solution: The Solution section will display the number of stars found and the time taken to solve. The solution values for RA, DEC, Scale and Angle are displayed in those boxes above.</para></listitem>
0301                 <listitem><para>Image: For any image where stars were detected, if the Mark Stars button is activated above the image display, then the detected stars are circled in red.</para>
0302     <screenshot>
0303         <screeninfo>
0304             FITS Viewer Mark Stars Button
0305         </screeninfo>
0306         <mediaobject>
0307             <imageobject>
0308                 <imagedata fileref="fitsviewer-mark-stars.png" format="PNG"/>
0309             </imageobject>
0310             <textobject>
0311                 <phrase>FITS Viewer Mark Stars Button</phrase>
0312             </textobject>
0313         </mediaobject>
0314     </screenshot>
0315                 </listitem>
0316             </itemizedlist>
0317             <para>
0318               Using this tool the user can try and debug solving issues as follows.
0319               </para>
0320             <itemizedlist>
0321               <listitem><para>He/she might have the KStars -> Settings -> Developer -> <link linkend="developer">Save Failed Align Images checkbox</link> enabled.</para></listitem>
0322               <listitem><para>Then a difficult image (for whom alignment failed)  <link linkend="developer">could be located</link> and loaded into the fitsviewer.</para></listitem>
0323               <listitem><para>The image could be inspected to see if there were obvious visual issues.</para></listitem>
0324               <listitem><para>Clicking Solve in this tool for that image would show how many stars were detected, and the user could then decide if it is a star detection issue and experiment with adjusting the profile or star-detection parameters.
0325 </para></listitem>
0326               <listitem><para>The user could manually upload the image to astrometry.net to get scale and position values (or just see if it is a problematic image).
0327 </para></listitem>
0328               <listitem><para>The user could experiment with Use Position and Use Scale, using accurate values for those constraints (or disabling them) to see if those were the problem, or adjust the parameters in the align profile being used.</para></listitem>
0329             </itemizedlist>
0330             <para>
0331               To inspect or modify the profile, the user would open the align tab in Ekos, go to the Options menu, select the StellarSolver Options tab, make sure the right Options profile is selected, and click the pencil to view or edit that profile.
0332               </para>
0333 </sect1>
0334 
0335 <sect1 id="fits-viewer-embedded">
0336     <title>Embedded FITS Viewer</title>
0337     <screenshot>
0338         <screeninfo>
0339             FITS Viewer embedded
0340         </screeninfo>
0341         <mediaobject>
0342             <imageobject>
0343                 <imagedata fileref="fitsviewer_embedded.png" format="PNG"/>
0344             </imageobject>
0345             <textobject>
0346                 <phrase>FITS Viewer embedded</phrase>
0347             </textobject>
0348         </mediaobject>
0349     </screenshot>
0350     <para>
0351         In Ekos <link linkend="ekos-focus">Focus</link>, <link linkend="ekos-guide">Guide</link>, and <link linkend="ekos-align">Align</link> modules, captured images are displayed in the embedded FITS Viewer. The embedded viewer includes a <emphasis>floating bar</emphasis> that can be used to perform several functions:
0352     </para>
0353     <itemizedlist>
0354         <listitem>
0355             <para>
0356                 Zoom Out
0357             </para>
0358         </listitem>
0359         <listitem>
0360             <para>
0361                 Zoom In
0362             </para>
0363         </listitem>
0364         <listitem>
0365             <para>
0366                 Default Zoom
0367             </para>
0368         </listitem>
0369         <listitem>
0370             <para>
0371                 Zoom To Fit
0372             </para>
0373         </listitem>
0374         <listitem>
0375             <para>
0376                 Toggle Cross Hairs
0377             </para>
0378         </listitem>
0379         <listitem>
0380             <para>
0381                 Toggle Pixel Gridlines
0382             </para>
0383         </listitem>
0384         <listitem>
0385             <para>
0386                 Toggle Detected Stars: Highlight detected stars with red circles.
0387             </para>
0388         </listitem>
0389         <listitem>
0390             <para>
0391                 Star Profile: View detailed 3D star profile.
0392             </para>
0393         </listitem>
0394     </itemizedlist>
0395     <para>
0396         The floating bar is automatically hidden once the mouse leaves the embedded viewer area. You can use the mouse to pan and zoom just like the standalone FITS Viewer. The green tracking box can be used to select a specific star or region within the image, for example, to select a guide star.
0397     </para>
0398 </sect1>
0399 
0400 <sect1 id="fits-viewer-3d-star-profile">
0401 <title>3D Star Profile &amp; Data Visualization Tool</title>
0402 <screenshot>
0403         <screeninfo>
0404             Star Profile main page
0405         </screeninfo>
0406         <mediaobject>
0407             <imageobject>
0408                 <imagedata fileref="star_profile_main.png" format="PNG"/>
0409             </imageobject>
0410             <textobject>
0411                 <phrase>Star Profile main page</phrase>
0412             </textobject>
0413         </mediaobject>
0414     </screenshot>
0415     <para>
0416         The 3D data visualization tool can plot 3D graphs of the selected region of the image. This is particularly useful for astrophotographers who want to visualize the profile of a star they are considering focusing or guiding on. For scientists, it enables them to examine a cross-section of the data to understand the relative brightness of different objects in the image. Additionally, it empowers imagers who want to visually see what is going on in their data collection in a new way.
0417     </para>
0418     <para>
0419         To use the new feature, the user needs to select the <guiicon>View Star Profile</guiicon> icon in one of the Ekos Module Views, or in the FITS Viewer. Then, the region selected in the green tracking box will show up in the 3D graph as shown above. The user will then have one of the following toolbars at the bottom.
0420     </para>
0421     <screenshot>
0422         <screeninfo>
0423             Star Profile toolbar 1
0424         </screeninfo>
0425         <mediaobject>
0426             <imageobject>
0427                 <imagedata fileref="star_profile_toolbar1.png" format="PNG"/>
0428             </imageobject>
0429             <textobject>
0430                 <phrase>Star Profile toolbar 1</phrase>
0431             </textobject>
0432         </mediaobject>
0433     </screenshot>
0434     <screenshot>
0435         <screeninfo>
0436             Star Profile toolbar 2
0437         </screeninfo>
0438         <mediaobject>
0439             <imageobject>
0440                 <imagedata fileref="star_profile_toolbar2.png" format="PNG"/>
0441             </imageobject>
0442             <textobject>
0443                 <phrase>Star Profile toolbar 2</phrase>
0444             </textobject>
0445         </mediaobject>
0446     </screenshot>
0447     <para>
0448         At the far left, the sample size combo box will let the user select the size of the image crop shown in the graph. This option is only available in the <guilabel>Summary Screen</guilabel>, the <link linkend="ekos-align">Align Module</link>, and the FITS Viewer. The second combo box lets the user control whether they are selecting an individual item, or a row, or a column of pixels. The slice button will be enabled if the user selects <guimenuitem>Row</guimenuitem> or <guimenuitem>Column</guimenuitem>. It will put the graph in slice mode so that the user can see a cross-section view of the image. Third, is a checkbox that will open up two sliders that will let the user drag the slider to change the selection. This is extremely useful in the slide mode to change the selected point and to move the cross section around the graph. It is also useful in the normal view when in <guilabel>Explore Mode</guilabel> so that the user can zoom around the image examining the pixels.
0449     </para>
0450     <screenshot>
0451         <screeninfo>
0452             Star Profile, examine pixels
0453         </screeninfo>
0454         <mediaobject>
0455             <imageobject>
0456                 <imagedata fileref="star_profile_examine_pixels.png" format="PNG"/>
0457             </imageobject>
0458             <textobject>
0459                 <phrase>Star Profile, examine pixels</phrase>
0460             </textobject>
0461         </mediaobject>
0462     </screenshot>
0463     <para>
0464         Then the user has the <guilabel>Zoom To</guilabel> combo box, which the user can use to zoom the graph to different preset locations. Next is the combo box that lets the user select the color scheme of the graph. Then are the HFR and the Peak checkboxes, which will both turn on the HFR and Peak labels on each found star in the image, but will also display one of them at the bottom of the screen. And finally comes the Scaling checkbox, which enables the <guilabel>Scaling</guilabel> Side Panel. There are three sliders in that panel, one to control the minimum value displayed on the graph or <quote>black point</quote>, one to control the maximum value displayed in the graph or the <quote>white point</quote>, and a third that is disabled by default that lets the user control the cutoff value for data displayed on the graph.
0465     </para>
0466     <screenshot>
0467         <screeninfo>
0468             Star Profile vertical page
0469         </screeninfo>
0470         <mediaobject>
0471             <imageobject>
0472                 <imagedata fileref="star_profile_vertical.png" format="PNG"/>
0473             </imageobject>
0474             <textobject>
0475                 <phrase>Star Profile vertical</phrase>
0476             </textobject>
0477         </mediaobject>
0478     </screenshot>
0479     <para>
0480         This third slider is very useful to get really big peaks out of the way so you can study the finer details in the image. There is a checkbox at the top to enable/disable the cutoff slider. And finally at the bottom of the sliders is the <guibutton>Auto scale</guibutton> button. This will auto scale the sliders as you sample different areas in the image. It will not only optimize the display of the data but will also affect the minimum and maximum points of the slider. If you disable auto scale, then as you sample different parts of the image, they will be displayed at the same scale. A particularly useful way to use this is to select an area of your image using auto scale, tweak the min, max, and cutoff sliders to your liking, and then turn off the auto scale feature to explore other areas of the graph.
0481     </para>
0482     <screenshot>
0483         <screeninfo>
0484             Star Profile final page
0485         </screeninfo>
0486         <mediaobject>
0487             <imageobject>
0488                 <imagedata fileref="star_profile_final.png" format="PNG"/>
0489             </imageobject>
0490             <textobject>
0491                 <phrase>Star Profile final page</phrase>
0492             </textobject>
0493         </mediaobject>
0494     </screenshot>
0495 </sect1>
0496 </chapter>