Projects/Edu/KStars/QA List 4.2: Difference between revisions

From KDE TechBase
< Projects‎ | Edu‎ | KStars
(New page: == List of expected behaviors for KStars 4.2. == Please test these behaviors, and indicate whether it works correctly or not. Once a behavior has been tested, attach one of the following...)
 
No edit summary
Line 14: Line 14:
=== Mouse Navigation ===
=== Mouse Navigation ===


* <font color="#00AA00">Moving the mouse shows the current sky coordinates of the mouse in the statusbar.</font>
* <font color="#00AA00">Moving the mouse shows the current sky coordinates of the mouse in the statusbar.</font> [1]
* <font color="#00AA00">Clicking the mouse identifies the nearest object in the statusbar; the object's "long name" is shown </font>
* <font color="#00AA00">Clicking the mouse identifies the nearest object in the statusbar; the object's "long name" is shown </font>
* <font color="#00AA00">Hovering the mouse attaches a temporary label to the nearest object.</font>
* <font color="#00AA00">Hovering the mouse attaches a temporary label to the nearest object.</font>
* <font color="#00AA00">Hover labels fade out when the mouse moves</font>
* <font color="#00AA00">Hover labels fade out when the mouse moves</font>
* <font color="#00AA00">Hover labels only appear when the map is not in motion</font>
* <font color="#00AA00">Hover labels only appear when the map is not in motion</font>
* <font color="#00AA00">Double-clicking attaches a label to the nearest object, centers it in the display, and engages tracking.</font>  
* <font color="#CCCC00">Double-clicking attaches a label to the nearest object, centers it in the display, and engages tracking. </font> [2]
* <font color="#00AA00">The double-click label is removed when the object is no longer centered</font>
* <font color="#00AA00">The double-click label is removed when the object is no longer centered</font>
* <font color="#00AA00">Click-and-drag moves the map such that the cursor remains roughly in the same place in the sky.  </font>
* <font color="#00AA00">Click-and-drag moves the map such that the cursor remains roughly in the same place in the sky.  </font>
Line 27: Line 27:
* <font color="#00AA00">Click-and-drag with the middle mouse button zooms in and out according to the vertical motion of the mouse</font>
* <font color="#00AA00">Click-and-drag with the middle mouse button zooms in and out according to the vertical motion of the mouse</font>
* <font color="#00AA00">Scrolling the mouse wheel zooms in and out.</font>
* <font color="#00AA00">Scrolling the mouse wheel zooms in and out.</font>
* <font color="#00AA00">Right-click opens a context-sensitive popup menu for the object nearest the mouse cursor.</font>
* <font color="#00AA00">Scrolling the mouse wheel while holding down Shift / Ctrl decreases the amount of zooming in / out.</font>
* <font color="#00CCCC">Right-click opens a context-sensitive popup menu for the object nearest the mouse cursor.</font> [1]


=== Keyboard commands ===
=== Keyboard commands ===
Line 33: Line 34:
* <font color="#00AA00">Arrow keys: scroll the display.  Holding Shift increases the speed</font>
* <font color="#00AA00">Arrow keys: scroll the display.  Holding Shift increases the speed</font>
* <font color="#00AA00">[0-9] center on a major solar system body (0 is the sun, 3 is the moon; the rest are planets in order from Mercury to Pluto)</font>
* <font color="#00AA00">[0-9] center on a major solar system body (0 is the sun, 3 is the moon; the rest are planets in order from Mercury to Pluto)</font>
* <font color="#00AA00">[<,>] Advance clock forward/backward by one time step (clock will be paused if it isn't already)</font>
* <font color="#CCCC00">[<,>] Advance clock forward/backward by one time step (clock will be paused if it isn't already)</font> [3]


==== Object Actions: ====
==== Object Actions: ====
Line 48: Line 49:


==== File Menu ====
==== File Menu ====
* New window [Ctrl+N] <<Disabled>>
* Close Window [Ctrl+W] <<Disabled>>
* <font color="#00AA00">Download new data [Ctrl+D]</font>
* <font color="#00AA00">Download new data [Ctrl+D]</font>
* <font color="#00AA00">Open FITS file [Ctrl+O]</font>
* <font color="#00AA00">Save Sky image [Ctrl+I]</font>
* <font color="#00AA00">Save Sky image [Ctrl+I]</font>
* <font color="#00AA00">Run script [Ctrl+R]</font>
* Run script [Ctrl+R]
* <font color="#00AA00">Print [Ctrl+P] (print dialog opens)</font>
* <font color="#00AA00">Print [Ctrl+P] (print dialog opens)</font>
* <font color="#00AA00">Quit [Ctrl+Q]</font>
* <font color="#00AA00">Quit [Ctrl+Q]</font>


==== Time Menu ====
==== Time Menu ====
* <font color="#00AA00">Set time to now [Ctrl+E]</font>  
* <font color="#00AA00">Set time to now [Ctrl+E] </font>
* <font color="#00AA00">Set time [Ctrl+S]</font>  
* <font color="#00AA00">Set time [Ctrl+S] </font>
* <font color="#00AA00">Start/Stop clock</font>
* <font color="#00AA00">Start/Stop clock</font>


Line 76: Line 74:
* <font color="#00AA00">Zoom out [Ctrl+-]</font>
* <font color="#00AA00">Zoom out [Ctrl+-]</font>
* <font color="#00AA00">Default zoom [Ctrl+Z]</font>
* <font color="#00AA00">Default zoom [Ctrl+Z]</font>
* <font color="#00AA00">Zoom to angular size [Ctrl+Shift+Z]</font>
* <font color="#00CCCC">Zoom to angular size [Ctrl+Shift+Z]</font> [4]
* <font color="#00AA00">Full-screen mode [Ctrl+Shift+F]</font>
* <font color="#00AA00">Full-screen mode [Ctrl+Shift+F]</font>
* <font color="#00AA00">Horizontal/Equatorial Coordinates [Space]</font>
* <font color="#00AA00">Horizontal/Equatorial Coordinates [Space]</font>
Line 82: Line 80:


==== Devices Menu ====
==== Devices Menu ====
[NOTE: These features require that KStars be compiled with INDI support]
===== Telescope wizard =====
===== Telescope wizard =====
* <font color="#000000">Help button displays KStars hand book.</font>
* Help button displays KStars hand book.
* <font color="#000000">Next/Back buttons work.</font>
* Next/Back buttons work.
* <font color="#000000">Listed telescopes reflect system + user added telescopes.</font>
* Listed telescopes reflect system + user added telescopes.
* <font color="#000000">Setting Time and Location open the appropriate dialog boxes and perform the correct time or location updates.</font>
* Setting Time and Location open the appropriate dialog boxes and perform the correct time or location updates.
* <font color="#000000">Setting port name initiate a scan for that specific port, whereas leaving the port empty initiates a complete auto port scan. Both actions can be canceled at any time.</font>
* Setting port name initiate a scan for that specific port, whereas leaving the port empty initiates a complete auto port scan. Both actions can be canceled at any time.
* <font color="#000000">Automatic port scan.</font>
* Automatic port scan.


===== Telescope properties =====
===== Telescope properties =====
* <font color="#000000">Telescope list reflect system & user added telescope.</font>
* Telescope list reflect system & user added telescope.
* <font color="#000000">Selecting a telescope update all property fields.</font>
* Selecting a telescope update all property fields.
* <font color="#000000">Removing a telescope shows a confirmation box.</font>
* Removing a telescope shows a confirmation box.
* <font color="#000000">Saving updated properties works.</font>
* Saving updated properties works.


===== Device manager =====
===== Device manager =====
Line 105: Line 106:


==== Tools Menu (test opening tools only here) ====
==== Tools Menu (test opening tools only here) ====
* <font color="#00AA00">Calculator [Ctrl+C]</font>
* Calculator [Ctrl+C]
* <font color="#00AA00">Observing List [Ctrl+L]</font>
* Observing List [Ctrl+L]
* <font color="#00AA00">AAVSO Light Curves [Ctrl+V]</font>
* AAVSO Light Curves [Ctrl+V]
* <font color="#00AA00">Altitude vs. Time [Ctrl+A]</font>
* Altitude vs. Time [Ctrl+A]
* <font color="#00AA00">What's Up Tonight [Ctrl+U]</font>
* What's Up Tonight [Ctrl+U]
* Glossary [Ctrl+K] <<disabled>>
* Glossary [Ctrl+K] <<disabled>>
* <font color="#00AA00">Script Builder [Ctrl+B]</font>
* Script Builder [Ctrl+B]
* <font color="#00AA00">Solar System [Ctrl+Y]</font>
* Solar System [Ctrl+Y]
* <font color="#00AA00">Jupiter's Moons [Ctrl+J]</font>
* Jupiter's Moons [Ctrl+J]


==== Settings Menu ====
==== Settings Menu ====
* <font color="#00AA00">Infoboxes Display toggles</font>
* <font color="#00AA00">Infoboxes Display toggles</font>
* <font color="#00AA00">Toolbar display toggles</font>
* <font color="#00CCCC">Toolbar display toggles</font> [5]
* <font color="#00AA00">Toolbar customization</font>
* <font color="#00CCCC">Toolbar customization</font> [6]
* <font color="#00AA00">Statusbar display toggles</font>
* <font color="#00AA00">Statusbar display toggles</font> [7]
* <font color="#00AA00">Color scheme toggles</font>
* <font color="#00AA00">Color scheme toggles</font>
* <font color="#00AA00">Field-of-view (FOV) Symbol selector</font>
* <font color="#00AA00">Field-of-view (FOV) Symbol selector</font>
* <font color="#00AA00">FOV Editor</font>
* <font color="#00AA00">FOV Editor</font>
* <font color="#00AA00">Geographic Location [Ctrl+G]</font>
* <font color="#00AA00">Geographic Location [Ctrl+G]</font>
* <font color="#00AA00">Configure KStars</font>
* <font color="#00CCCC">Configure KStars</font> [8]
* <font color="#00AA00">Startup Wizard</font>
* <font color="#00AA00">Startup Wizard</font>


==== Help Menu ====
==== Help Menu ====
* <font color="#00AA00">KStars Handbook [F1]</font>
* <font color="#00AA00">KStars Handbook [F1]</font>
* <font color="#00AA00">What's this?</font>
* <font color="#00CCCC">What's this?</font> [9]
* <font color="#00AA00">Report Bug</font>
* <font color="#00AA00">Report Bug</font>
* <font color="#00AA00">About KStars</font>
* <font color="#00AA00">About KStars</font>
Line 139: Line 140:
* <font color="#00AA00">Zoom in/out</font>
* <font color="#00AA00">Zoom in/out</font>
* <font color="#00AA00">Find object...</font>
* <font color="#00AA00">Find object...</font>
* <font color="#00AA00">Stop/Start clock</font>
* <font color="#CCCC00">Stop/Start clock</font> [3]
* <font color="#00AA00">Timestep widget</font>
* <font color="#00AA00">Timestep widget</font>


==== View toolbar ====
==== View toolbar ====
* <font color="#00AA00">Show stars</font>
* <font color="#00AA00">Show stars</font>
* <font color="#00AA00">Show deep-sky</font>
* <font color="#00CCCC">Show deep-sky</font> [10]
* <font color="#00AA00">Show solar system</font>
* <font color="#00AA00">Show solar system</font>
* <font color="#00AA00">Show constellation lines</font>
* <font color="#00AA00">Show constellation lines</font>
Line 151: Line 152:
* <font color="#00AA00">Show Milky Way</font>
* <font color="#00AA00">Show Milky Way</font>
* <font color="#00AA00">Show coordinate grid</font>
* <font color="#00AA00">Show coordinate grid</font>
* <font color="#00AA00">Show opaque ground</font>
* <font color="#CCCC00">Show opaque ground</font> [11]


=== Centering and tracking ===
=== Centering and tracking ===
Line 170: Line 171:


=== Color schemes ===
=== Color schemes ===
* <font color="#00AA00">Show all available schemes, incl. predefined and custom</font>
* Show all available schemes, incl. predefined and custom
* <font color="#00AA00">All color settings change upon selecting a new scheme</font>
* All color settings change upon selecting a new scheme
* <font color="#00AA00">Color settings persistent on reload</font>
* Color settings persistent on reload
* <font color="#00AA00">Custom scheme appears in menu after creating in in the Configure dialog</font
* Custom scheme appears in menu after creating in in the Configure dialog</font
* <font color="#00AA00">Custom scheme is removed from menu if it is removed in the Configure dialog</font>
* Custom scheme is removed from menu if it is removed in the Configure dialog


=== Dialogs ===
=== Dialogs ===
==== Download new data ====
==== Download new data ====
* <font color="#00AA00">Dialog displays all available download items (Steinicke NGC catalog, Ephemerides, Messier catalog thumbnails, Thumbnails for details window, updated DST rules)</font>
* Dialog displays all available download items (Steinicke NGC catalog, Ephemerides, Messier catalog thumbnails, Thumbnails for details window, updated DST rules)
* <font color="#00AA00">Each item gets downloaded and installed correctly</font>
* Each item gets downloaded and installed correctly


==== FITS viewer ====
==== FITS viewer ====
* <font color="#00CC00">File open dialog displays only FITS files.</font>
* File open dialog displays only FITS files.
* <font color="#00CC00">FITS image is opened and displayed properly.</font>
* FITS image is opened and displayed properly.
* <font color="#00CC00">Image coordinates, pixel value, image dimensions, and zoom value are displayed in status bar.</font>
* Image coordinates, pixel value, image dimensions, and zoom value are displayed in status bar.
* <font color="#00AA00">Undo/Redo work</font>[[#Footnotes|[3]]]
* Undo/Redo work[[#Footnotes|[3]]]
* <font color="#00CC00">Zoom in/out, Default zoom</font>
* Zoom in/out, Default zoom
* <font color="#00AA00">Statistics</font>
* Statistics
* <font color="#00AA00">FITS header</font>
* FITS header
* <font color="#00AA00">Closing without save issues a warning dialog</font>[[#Footnotes|[3]]]
* Closing without save issues a warning dialog[[#Footnotes|[3]]]
* <font color="#00AA00">Save and Save As work</font>
* Save and Save As work


===== Histogram tool =====
===== Histogram tool =====
* <font color="#CCCC00">Range of pixel values can be updated with edit boxes or by dragging the blue/red symbols</font>: red symbol not draggable in initial position
* Range of pixel values can be updated with edit boxes or by dragging the blue/red symbols: red symbol not draggable in initial position


==== Save sky image ====
==== Save sky image ====
* <font color="#CCCC00">Saves image to file</font>: Doesn't seem to save GIF
* Saves image to file: Doesn't seem to save GIF
* <font color="#00CC00">Image matches screen display (without FOV or infobox overlays)</font>
* Image matches screen display (without FOV or infobox overlays)


==== Run script ====
==== Run script ====
* <font color="#00AA00">Executes the selected script.</font>
* Executes the selected script.
* <font color="#00AA00">Statusbar messages indicate script is running/finished.</font>
* Statusbar messages indicate script is running/finished.


==== Print ====
==== Print ====
Line 209: Line 210:


==== Set time ====
==== Set time ====
* <font color="#00AA00">Simulation clock is set to selected time</font>
* Simulation clock is set to selected time
* <font color="#00AA00">Selected date displayed properly in calendar widget</font>
* Selected date displayed properly in calendar widget
* <font color="#00AA00">It is not possible to select an invalid date</font>
* It is not possible to select an invalid date


==== Set focus manually ====
==== Set focus manually ====
* <font color="#00AA00">Setting RA/Dec coordinates works</font>
* Setting RA/Dec coordinates works
* <font color="#00AA00">Setting Az/Alt coordinates works</font>
* Setting Az/Alt coordinates works


==== Find object ====  
==== Find object ====  
* <font color="#00AA00">Filter by name works</font>
* Filter by name works
* <font color="#00AA00">Filter by type works</font>
* Filter by type works
* <font color="#00AA00">Highlighted object is centered in map when user hits return or presses Ok</font>
* Highlighted object is centered in map when user hits return or presses Ok
* <font color="#00AA00">Dialog message when a match fails; window does not close</font>
* Dialog message when a match fails; window does not close
* <font color="#00AA00">Up/Down arrow keys navigate the list of objects</font>
* Up/Down arrow keys navigate the list of objects


==== Zoom to angular size ====
==== Zoom to angular size ====
* <font color="#00AA00">Zoom is set to display the angle entered</font>
* Zoom is set to display the angle entered
* <font color="#00AA00">Min/max values make sense</font>
* Min/max values make sense


==== FOV symbol editor ====
==== FOV symbol editor ====
* <font color="#00AA00">Selected symbol is shown in preview pane</font>
* Selected symbol is shown in preview pane
* <font color="#00AA00">Creating a new symbol works</font>
* Creating a new symbol works
* <font color="#00AA00">Editing an existing symbol works</font>
* Editing an existing symbol works
* <font color="#00CCCC">Removing a symbol works</font> (if this symbol is currently in use, what should happen?)
* Removing a symbol works (if this symbol is currently in use, what should happen?)


==== Geographic location ====
==== Geographic location ====


==== Startup Wizard ====
==== Startup Wizard ====
* <font color="#00AA00">Set Geographic location works</font>
* Set Geographic location works
* <font color="#00AA00">Download Extra Data works</font>
* Download Extra Data works


==== Object Details (from popup menu) ====
==== Object Details (from popup menu) ====
Line 252: Line 253:
==== Calculator ====
==== Calculator ====
Note: changes in the modules are not reflected until the widget loses input focus.  This may not be ideal, but doing immediate updates doesn't work.  Consider the JD module.  Let's say I want to clear the current number and enter a new one.  As soon as I delete the text, it would try to process the blank line as a date.  Then if I typed a "2", it would try to use that.  Basically, there needs to be a way to indicate that you are done editing.
Note: changes in the modules are not reflected until the widget loses input focus.  This may not be ideal, but doing immediate updates doesn't work.  Consider the JD module.  Let's say I want to clear the current number and enter a new one.  As soon as I delete the text, it would try to process the blank line as a date.  Then if I typed a "2", it would try to use that.  Basically, there needs to be a way to indicate that you are done editing.
* <font color="#00AA00">Julian Day calculator works correctly, both ways.</font>
* Julian Day calculator works correctly, both ways.
* <font color="#00CC00">Sidereal Time Calculator works correctly, both ways.</font>
* Sidereal Time Calculator works correctly, both ways.
* <font color="#00CC00">Information displayed in the Almanac seems correct.</font>
* Information displayed in the Almanac seems correct.
* Equinoxes and Solstices displayed are correct
* Equinoxes and Solstices displayed are correct
* <font color="#00CC00">Equatorial to Galactic Coords conversion works</font>
* Equatorial to Galactic Coords conversion works
* <font color="#00CC00">Conversion from Equatorial to Horizontal coordinates is accurate</font>[[#Footnotes|[2]]]
* Conversion from Equatorial to Horizontal coordinates is accurate[[#Footnotes|[2]]]
* <font color="#00AA00">Horizontal Coordinates UI</font>
* Horizontal Coordinates UI
* <font color="#00AA00">Ecliptic Coordinates tool UI</font>
* Ecliptic Coordinates tool UI
* <font color="#00CC00">Data shown in the ecliptic coordinates tool seems accurate</font>
* Data shown in the ecliptic coordinates tool seems accurate
* <font color="#00CC00">Angular distance tool UI works as expected</font>
* Angular distance tool UI works as expected
* <font color="#00CC00">Angular distances reported seem accurate</font>
* Angular distances reported seem accurate
* Geodetic coordinates UI works as expected
* Geodetic coordinates UI works as expected
* Data displayed by Geodetic coordinates tool seems correct
* Data displayed by Geodetic coordinates tool seems correct
* LSR Velocity tool UI works as expected
* LSR Velocity tool UI works as expected
* LSR Velocity tool seems to produce correct results
* LSR Velocity tool seems to produce correct results
* <font color="#00CC00">Planet Coordinates tool UI behaves as expected</font>
* Planet Coordinates tool UI behaves as expected
* Planet coordinates shown seem accurate
* Planet coordinates shown seem accurate
* Conjunctions tool UI behaves as expected
* Conjunctions tool UI behaves as expected
Line 273: Line 274:


==== Observing List ====
==== Observing List ====
* <font color="#000000">Removing an object named "star"</font>
* Removing an object named "star"
* <font color="#CCCC00">Selecting by magnitude in wizard</font> [count not updated properly]
* Selecting by magnitude in wizard [count not updated properly]


==== AAVSO light curves ====
==== AAVSO light curves ====
* <font color="#000000">Star name and designation lists are synchronized properly.</font>
* Star name and designation lists are synchronized properly.
* <font color="#000000">Downloading new list from AAVSO updates the stars lists.</font>
* Downloading new list from AAVSO updates the stars lists.
* Retrieve Curve buttons downloads and displays the light curve correctly.
* Retrieve Curve buttons downloads and displays the light curve correctly.


Line 284: Line 285:


==== What's up tonight ====
==== What's up tonight ====
* <font color="#000000">Almanac data are correct</font>
* Almanac data are correct
* <font color="#000000">Displays objects that are visible on the given date, from the given location</font>
* Displays objects that are visible on the given date, from the given location
* <font color="#CCCC00">Changing the Date works, and updates the list of objects and almanac</font>
* Changing the Date works, and updates the list of objects and almanac
* <font color="#000000">Changing the Location works, and updates the list of objects and almanac</font>
* Changing the Location works, and updates the list of objects and almanac
* <font color="#000000">Selecting Evening/Morning/All Night works, and updates the list of objects</font>
* Selecting Evening/Morning/All Night works, and updates the list of objects
* <font color="#000000">Selected object is displayed in right panel correctly</font>
* Selected object is displayed in right panel correctly
* <font color="#CCCC00">The Rise/Set/Transit data are correct</font>
* The Rise/Set/Transit data are correct
* <font color="#000000">Center Object button works</font>
* Center Object button works
* <font color="#000000">Details button works</font>
* Details button works


==== Script builder ====
==== Script builder ====
Line 301: Line 302:


=== Details window ===
=== Details window ===
* <font color="#000000">Displays object information</font>
* Displays object information
* <font color="#000000">Testing Resource links works</font>
* Testing Resource links works
* <font color="#000000">Editing Resource links works</font>
* Editing Resource links works
* <font color="#000000">Removing resource links works</font>
* Removing resource links works
* <font color="#000000">Interacting with online databases works</font>
* Interacting with online databases works


==== Thumbnail Picker ====
==== Thumbnail Picker ====
* <font color="#000000">Displays list of images found via Google image search</font>
* Displays list of images found via Google image search
* <font color="#000000">Selecting an image from the list displays it in the viewer</font>
* Selecting an image from the list displays it in the viewer
* <font color="#000000">Editing the image works</font>
* Editing the image works
* <font color="#000000">Closing the window places the selected image in the Details window</font>
* Closing the window places the selected image in the Details window
* <font color="#000000">KIO jobs are terminated in the console after quitting KStars</font>
* KIO jobs are terminated in the console after quitting KStars


=== INDI ===
=== INDI ===
Line 321: Line 322:


=== Sky Projections ===
=== Sky Projections ===
* <font color="#000000">Lambert Azimuthal Equal Area</font>
* Lambert Azimuthal Equal Area
* <font color="#000000">Azimuthal Equidistant</font>
* Azimuthal Equidistant
* <font color="#000000">Orthographic</font>
* Orthographic
* <font color="#CCCC00">Equirectangular</font> [mouse nav broken; arrow keys work]
* Equirectangular [mouse nav broken; arrow keys work]
* <font color="#000000">Streographic</font>
* Streographic
* <font color="#AA0000">Gnomonic</font> [cpu 100% at low zoom, eventually crashes]
* Gnomonic [cpu 100% at low zoom, eventually crashes]




Line 336: Line 337:


* KStars doesn't know my city's coordinates, while Marble does. Could not they share the a common datasheet with cities' positions?
* KStars doesn't know my city's coordinates, while Marble does. Could not they share the a common datasheet with cities' positions?
A: Will bring in Marble Widget eventually


* Need to fix DeepSkyComponent::init() so that downloaded ngcic??.dat files will be merged into one ngcic.dat file, as the 4.0 code now expects.


* Observing log data and user added links don't seem to be saved between restarts of KStars
----
----


Line 346: Line 346:
Add footnotes describing issues noted in the main list here.   
Add footnotes describing issues noted in the main list here.   


[2]: Horizontal Coordinates seem to take time zone of geographic location into account. Is this desirable? It would help if the timezone used is specified.
[1]: Does not work at high zoom when refraction corrections are enabled. Possibly because the RefractCorr1 array is not the exact "inverse" map of RefractCorr2 array. The bug is in objectNearest and thus other features are affected too.
 
[2]: Tracking at high zoom sometimes "shakes" the display periodically. This has nothing to do with atmospheric refraction.
 
[3]: The clock is paused if it is running, but the icon in the toolbar doesn't change state
 
[4]: The display in the status bar shows a different field of view (possibly the minor axis) from what is entered
 
[5]: Why are there 2 "Main Toolbar"s? Is this a bug that only I am experiencing?
 
[6]: What are those blank actions?
 
[7]: TODO: Check if the altitude / azimuth shown are the real altitude and azimuth and not the back-refracted ones.
 
[8]: Disable / don't show the faint magnitude zoomed in / zoomed out spin boxes under the catalogs tab
 
[9]: A lot of widgets have undefined what's this help.
 
[10]: Tracking doesn't lock on the location of a DSO (found using the find dialog) if DSOs are disabled.


[3]: Changes can be made in the histogram tool
[11]: Ground fills up even when show ground is disabled, or horizon polygon disappears when the horizon is close to the top of the screen in Gnomonic Projection

Revision as of 01:28, 16 December 2008

List of expected behaviors for KStars 4.2.

Please test these behaviors, and indicate whether it works correctly or not. Once a behavior has been tested, attach one of the following codes to the beginning of the line to indicate its status.

  • No symbol or Black: behavior not yet tested
  • * or Red: behavior causes KStars to crash
  • X or Orange: behavior is broken
  • B or Yellow: behavior sort-of works, or is buggy
  • U or Cyan: Usability issue
  • C or Green: behavior works correctly

Mouse Navigation

  • Moving the mouse shows the current sky coordinates of the mouse in the statusbar. [1]
  • Clicking the mouse identifies the nearest object in the statusbar; the object's "long name" is shown
  • Hovering the mouse attaches a temporary label to the nearest object.
  • Hover labels fade out when the mouse moves
  • Hover labels only appear when the map is not in motion
  • Double-clicking attaches a label to the nearest object, centers it in the display, and engages tracking. [2]
  • The double-click label is removed when the object is no longer centered
  • Click-and-drag moves the map such that the cursor remains roughly in the same place in the sky.
  • Dragging the sky disengages tracking
  • Dragging the sky to one of the poles does not cause odd behavior
  • Click-and-drag with Ctrl pressed draws a rectangle in the map that defines a new area to be displayed when the mouse button is released
  • Click-and-drag with the middle mouse button zooms in and out according to the vertical motion of the mouse
  • Scrolling the mouse wheel zooms in and out.
  • Scrolling the mouse wheel while holding down Shift / Ctrl decreases the amount of zooming in / out.
  • Right-click opens a context-sensitive popup menu for the object nearest the mouse cursor. [1]

Keyboard commands

  • Arrow keys: scroll the display. Holding Shift increases the speed
  • [0-9] center on a major solar system body (0 is the sun, 3 is the moon; the rest are planets in order from Mercury to Pluto)
  • [<,>] Advance clock forward/backward by one time step (clock will be paused if it isn't already) [3]

Object Actions:

  • C: Track object
  • D: Open the Details window
  • L: Attach/Remove the label
  • O: Add object to Observing List
  • T: Attach/remove trail (solar system only)
  • Pressing Shift targets action on the focused object, rather than the clicked object

Menu functions and keyboard shortcuts

If a menu action opens a window, the window's behavior is listed elsewhere. Just check to see if it opens here.

File Menu

  • Download new data [Ctrl+D]
  • Save Sky image [Ctrl+I]
  • Run script [Ctrl+R]
  • Print [Ctrl+P] (print dialog opens)
  • Quit [Ctrl+Q]

Time Menu

  • Set time to now [Ctrl+E]
  • Set time [Ctrl+S]
  • Start/Stop clock

Pointing Menu

  • Zenith [Z]
  • North [N]
  • East [E]
  • South [S]
  • West [W]
  • Set focus manually [Ctrl+M]
  • Find object [Ctrl+F]
  • Engage/Stop tracking [Ctrl+T]

View Menu

  • Zoom in [Ctrl++]
  • Zoom out [Ctrl+-]
  • Default zoom [Ctrl+Z]
  • Zoom to angular size [Ctrl+Shift+Z] [4]
  • Full-screen mode [Ctrl+Shift+F]
  • Horizontal/Equatorial Coordinates [Space]
  • Projections sub-menu (test switching only here)

Devices Menu

[NOTE: These features require that KStars be compiled with INDI support]

Telescope wizard
  • Help button displays KStars hand book.
  • Next/Back buttons work.
  • Listed telescopes reflect system + user added telescopes.
  • Setting Time and Location open the appropriate dialog boxes and perform the correct time or location updates.
  • Setting port name initiate a scan for that specific port, whereas leaving the port empty initiates a complete auto port scan. Both actions can be canceled at any time.
  • Automatic port scan.
Telescope properties
  • Telescope list reflect system & user added telescope.
  • Selecting a telescope update all property fields.
  • Removing a telescope shows a confirmation box.
  • Saving updated properties works.
Device manager
INDI Control panel
Capture image sequence
  • Capture image sequence is automatically enabled when a new capturing device is connected via INDI.
  • Prefix, count, and ISO time stamp is incorporated into the filename when selected.
  • Filter selection.
Configure INDI

Tools Menu (test opening tools only here)

  • Calculator [Ctrl+C]
  • Observing List [Ctrl+L]
  • AAVSO Light Curves [Ctrl+V]
  • Altitude vs. Time [Ctrl+A]
  • What's Up Tonight [Ctrl+U]
  • Glossary [Ctrl+K] <<disabled>>
  • Script Builder [Ctrl+B]
  • Solar System [Ctrl+Y]
  • Jupiter's Moons [Ctrl+J]

Settings Menu

  • Infoboxes Display toggles
  • Toolbar display toggles [5]
  • Toolbar customization [6]
  • Statusbar display toggles [7]
  • Color scheme toggles
  • Field-of-view (FOV) Symbol selector
  • FOV Editor
  • Geographic Location [Ctrl+G]
  • Configure KStars [8]
  • Startup Wizard

Help Menu

  • KStars Handbook [F1]
  • What's this? [9]
  • Report Bug
  • About KStars
  • About KDE

Toolbars

Main toolbar

  • Zoom in/out
  • Find object...
  • Stop/Start clock [3]
  • Timestep widget

View toolbar

  • Show stars
  • Show deep-sky [10]
  • Show solar system
  • Show constellation lines
  • Show constellation names
  • Show constellation boundaries
  • Show Milky Way
  • Show coordinate grid
  • Show opaque ground [11]

Centering and tracking

  • Center+Track on object (double-click, popup menu, click then press "C")
  • Center+Track on empty sky (double-click, popup menu)
  • If requested position moves display below horizon, confirm dialog is shown
  • If startup position is below horizon, recenter dialog is shown
  • Information in "Focus" InfoBox updates correctly when recentering

Info boxes

  • Displayed with semi-transparent backgound
  • Highlight color on click
  • "Shade" on double-click
  • Move on drag
  • Collision avoidance works
  • "Stick" to screen edges
  • Remember position and shade-state on restart

Color schemes

  • Show all available schemes, incl. predefined and custom
  • All color settings change upon selecting a new scheme
  • Color settings persistent on reload
  • Custom scheme appears in menu after creating in in the Configure dialog</font
  • Custom scheme is removed from menu if it is removed in the Configure dialog

Dialogs

Download new data

  • Dialog displays all available download items (Steinicke NGC catalog, Ephemerides, Messier catalog thumbnails, Thumbnails for details window, updated DST rules)
  • Each item gets downloaded and installed correctly

FITS viewer

  • File open dialog displays only FITS files.
  • FITS image is opened and displayed properly.
  • Image coordinates, pixel value, image dimensions, and zoom value are displayed in status bar.
  • Undo/Redo work[3]
  • Zoom in/out, Default zoom
  • Statistics
  • FITS header
  • Closing without save issues a warning dialog[3]
  • Save and Save As work
Histogram tool
  • Range of pixel values can be updated with edit boxes or by dragging the blue/red symbols: red symbol not draggable in initial position

Save sky image

  • Saves image to file: Doesn't seem to save GIF
  • Image matches screen display (without FOV or infobox overlays)

Run script

  • Executes the selected script.
  • Statusbar messages indicate script is running/finished.

Print

  • Prints image of current skymap (without infoboxes or FOV symbols)
  • Ask to reset color scheme if background is not white
  • Color scheme is properly reset for printing, and reverted afterward

Set time

  • Simulation clock is set to selected time
  • Selected date displayed properly in calendar widget
  • It is not possible to select an invalid date

Set focus manually

  • Setting RA/Dec coordinates works
  • Setting Az/Alt coordinates works

Find object

  • Filter by name works
  • Filter by type works
  • Highlighted object is centered in map when user hits return or presses Ok
  • Dialog message when a match fails; window does not close
  • Up/Down arrow keys navigate the list of objects

Zoom to angular size

  • Zoom is set to display the angle entered
  • Min/max values make sense

FOV symbol editor

  • Selected symbol is shown in preview pane
  • Creating a new symbol works
  • Editing an existing symbol works
  • Removing a symbol works (if this symbol is currently in use, what should happen?)

Geographic location

Startup Wizard

  • Set Geographic location works
  • Download Extra Data works

Object Details (from popup menu)

Image viewer (from popup menu)

  • Selected image is shown; window is sized to fit image
  • Authorship and copyright in statusbar
  • Save button works

Popup menu

Tools

Calculator

Note: changes in the modules are not reflected until the widget loses input focus. This may not be ideal, but doing immediate updates doesn't work. Consider the JD module. Let's say I want to clear the current number and enter a new one. As soon as I delete the text, it would try to process the blank line as a date. Then if I typed a "2", it would try to use that. Basically, there needs to be a way to indicate that you are done editing.

  • Julian Day calculator works correctly, both ways.
  • Sidereal Time Calculator works correctly, both ways.
  • Information displayed in the Almanac seems correct.
  • Equinoxes and Solstices displayed are correct
  • Equatorial to Galactic Coords conversion works
  • Conversion from Equatorial to Horizontal coordinates is accurate[2]
  • Horizontal Coordinates UI
  • Ecliptic Coordinates tool UI
  • Data shown in the ecliptic coordinates tool seems accurate
  • Angular distance tool UI works as expected
  • Angular distances reported seem accurate
  • Geodetic coordinates UI works as expected
  • Data displayed by Geodetic coordinates tool seems correct
  • LSR Velocity tool UI works as expected
  • LSR Velocity tool seems to produce correct results
  • Planet Coordinates tool UI behaves as expected
  • Planet coordinates shown seem accurate
  • Conjunctions tool UI behaves as expected
  • Conjunctions tool reports all conjunctions correctly

Observing List

  • Removing an object named "star"
  • Selecting by magnitude in wizard [count not updated properly]

AAVSO light curves

  • Star name and designation lists are synchronized properly.
  • Downloading new list from AAVSO updates the stars lists.
  • Retrieve Curve buttons downloads and displays the light curve correctly.

Altitude vs. time

What's up tonight

  • Almanac data are correct
  • Displays objects that are visible on the given date, from the given location
  • Changing the Date works, and updates the list of objects and almanac
  • Changing the Location works, and updates the list of objects and almanac
  • Selecting Evening/Morning/All Night works, and updates the list of objects
  • Selected object is displayed in right panel correctly
  • The Rise/Set/Transit data are correct
  • Center Object button works
  • Details button works

Script builder

Solar system

Jupiter's moons

Details window

  • Displays object information
  • Testing Resource links works
  • Editing Resource links works
  • Removing resource links works
  • Interacting with online databases works

Thumbnail Picker

  • Displays list of images found via Google image search
  • Selecting an image from the list displays it in the viewer
  • Editing the image works
  • Closing the window places the selected image in the Details window
  • KIO jobs are terminated in the console after quitting KStars

INDI

Configuration window

Sky Projections

  • Lambert Azimuthal Equal Area
  • Azimuthal Equidistant
  • Orthographic
  • Equirectangular [mouse nav broken; arrow keys work]
  • Streographic
  • Gnomonic [cpu 100% at low zoom, eventually crashes]



Discovered issues:

Use this section to add issues discovered while testing the program that are not listed above.

  • KStars doesn't know my city's coordinates, while Marble does. Could not they share the a common datasheet with cities' positions?

A: Will bring in Marble Widget eventually



Footnotes

Add footnotes describing issues noted in the main list here.

[1]: Does not work at high zoom when refraction corrections are enabled. Possibly because the RefractCorr1 array is not the exact "inverse" map of RefractCorr2 array. The bug is in objectNearest and thus other features are affected too.

[2]: Tracking at high zoom sometimes "shakes" the display periodically. This has nothing to do with atmospheric refraction.

[3]: The clock is paused if it is running, but the icon in the toolbar doesn't change state

[4]: The display in the status bar shows a different field of view (possibly the minor axis) from what is entered

[5]: Why are there 2 "Main Toolbar"s? Is this a bug that only I am experiencing?

[6]: What are those blank actions?

[7]: TODO: Check if the altitude / azimuth shown are the real altitude and azimuth and not the back-refracted ones.

[8]: Disable / don't show the faint magnitude zoomed in / zoomed out spin boxes under the catalogs tab

[9]: A lot of widgets have undefined what's this help.

[10]: Tracking doesn't lock on the location of a DSO (found using the find dialog) if DSOs are disabled.

[11]: Ground fills up even when show ground is disabled, or horizon polygon disappears when the horizon is close to the top of the screen in Gnomonic Projection