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

From KDE TechBase
< Projects‎ | Edu‎ | KStars
 
(232 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Construction}}
== List of expected behaviors for KStars 2.6.0 ==
== List of expected behaviors for KStars 2.6.0 ==


Line 16: Line 15:


* <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>  
* <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="#00AA00">Double-clicking attaches a label to the nearest object, centers it in the display, and engages tracking. </font>  
* <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>
* <font color="#00AA00">Dragging the sky disengages tracking</font>
* <font color="#00AA00">Dragging the sky disengages tracking.</font>
* <font color="#00AA00">Dragging the sky to one of the poles does not cause odd behavior</font>
* <font color="#00AA00">Dragging the sky to one of the poles does not cause odd behavior.</font>
* <font color="#000000">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</font>  
* <font color="#00CCCC">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.</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>
{{Remember|2=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|1=KStars can behave incorrectly if the rectangle extends sufficiently into the "blank" region outside the map. }}
* <font color="#000000">Scrolling the mouse wheel zooms in and out.</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="#000000">Scrolling the mouse wheel while holding down Shift / Ctrl decreases the amount of zooming in / out.</font>
* <font color="#00AA00">Scrolling the mouse wheel zooms in and out.</font>
* <font color="#00AA00">Scrolling the mouse wheel while holding down Shift / Ctrl decreases the amount of zooming in / out.</font>
* <font color="#00AA00">Right-click opens a context-sensitive popup menu for the object nearest the mouse cursor.</font>
* <font color="#00AA00">Right-click opens a context-sensitive popup menu for the object nearest the mouse cursor.</font>


=== Keyboard commands ===
=== Keyboard commands ===


* <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="#000000">[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="#CCCC00">[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="#000000">[<,>] Advance clock forward/backward by one time step (clock will be paused if it isn't already)</font>  
{{Remember|2=[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)|1="9" key does nothing, instead of centering the Sky Map on Pluto - same in Linux. }}
* <font color="#CC8800">[<,>] Advance clock forward/backward by one time step (clock will be paused if it isn't already).</font>  
{{Remember|2=Advance clock forward/backward by one time step (clock will be paused if it isn't already)|1="<" and ">" keys do nothing - same in Linux. }}


==== Object Actions: ====
==== Object Actions: ====
Line 43: Line 45:
* <font color="#00AA00">O: Add object to Observing List</font>
* <font color="#00AA00">O: Add object to Observing List</font>
* <font color="#00AA00">T: Attach/remove trail (solar system only)</font>
* <font color="#00AA00">T: Attach/remove trail (solar system only)</font>
* <font color="#00AA00">Pressing Shift targets action on the focused object, rather than the clicked object</font>
* <font color="#00AA00">Pressing Shift targets action on the focused object, rather than the clicked object.</font>


=== Menu functions and keyboard shortcuts ===
=== Menu functions and keyboard shortcuts ===
Line 50: Line 52:


==== File Menu ====
==== File Menu ====
* <font color="#00AA00">Open a FITS image in the FITS Viewer tool [Ctrl+O]</font>
* <font color="#00AA00">Open a FITS image in the FITS Viewer tool [Ctrl+O].</font>
* <font color="#000000">Save Sky image [Ctrl+I]</font>
* <font color="#CC8800">Save Sky image [Ctrl+I].</font>  
* Run script [Ctrl+R]
{{Remember|2=Save Sky image [Ctrl+I]|1=Saving does not work at all in KStars. The path to the saved file seems to be wrong (Windows uses backslash (\) but KStars is trying to save using the Linux slash (/) symbol; see http://raphaelcojocaru.xyz/save_image.PNG ). }}
* <font color="#CC8800">Run script [Ctrl+R].</font>
{{Remember|2=Run script [Ctrl+R]|1=KStars doesn't run the script. It seems to be stuck with the "Running script" message. }}
* <font color="#00AA00">Printing Wizard</font>
* <font color="#00AA00">Printing Wizard</font>
* <font color="#00AA00">Print [Ctrl+P] (print dialog opens)</font>
* <font color="#00AA00">Print [Ctrl+P] (print dialog opens)</font>
* <font color="#000000">Quit [Ctrl+Q]</font>
* <font color="#00AA00">Quit [Ctrl+Q]</font>


==== Time Menu ====
==== Time Menu ====
Line 72: Line 76:
* <font color="#00AA00">Set focus manually [Ctrl+M]</font>
* <font color="#00AA00">Set focus manually [Ctrl+M]</font>
* <font color="#00AA00">Find object [Ctrl+F]</font>
* <font color="#00AA00">Find object [Ctrl+F]</font>
* <font color="#000000">Engage/Stop tracking [Ctrl+T]</font>
* <font color="#00AA00">Engage/Stop tracking [Ctrl+T]</font>


==== View Menu ====
==== View Menu ====
Line 78: Line 82:
* <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="#000000">Zoom to angular size [Ctrl+Shift+Z]</font>  
* <font color="#00AA00">Zoom to angular size [Ctrl+Shift+Z]</font>  
* <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 88: Line 92:


===== Telescope wizard =====
===== Telescope wizard =====
* Help button displays KStars hand book.
{{Remember|2=Telescope wizard |1=Telescope wizard is missing. }}
* Next/Back buttons work.
* <font color="#CC8800">Help button displays KStars hand book.</font>
* Listed telescopes reflect system + user added telescopes.
* <font color="#CC8800">Next/Back buttons work.</font>
* Setting Time and Location open the appropriate dialog boxes and perform the correct time or location updates.
* <font color="#CC8800">Listed telescopes reflect system + user added telescopes.</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="#CC8800">Setting Time and Location open the appropriate dialog boxes and perform the correct time or location updates.</font>
* Automatic port scan.
* <font color="#CC8800">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>
 
* <font color="#CC8800">Automatic port scan.</font>
===== 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 =====
===== Device manager =====
* <font color="#0000AA">Device manager allows the user to start/shutdown device drivers and connect to remote INDI servers.</font>
{{Remember|2= Device manager|1=The devices list from the Local/Server is disabled. You can not select any device from the list. }}
* <font color="#0000AA">Device manager has a list of devices, containing device name, status and mode.</font>
* <font color="#CC8800">Device manager allows the user to start/shutdown device drivers and connect to remote INDI servers.</font>
* <font color="#0000AA">Device manager has a Server Log box that contains information for every running device.</font>
* <font color="#CC8800">Device manager has a list of devices, containing device name, status and mode.</font>
* <font color="#0000AA">Starting in Local mode creates an INDI server and connects to it.</font>
* <font color="#CC8800">Device manager has a Server Log box that contains information for every running device.</font>
* <font color="#0000AA">Starting in Server mode only creates a server, KStars does not connect to it.</font>
* <font color="#CC8800">Starting in Local mode creates an INDI server and connects to it.</font>
* <font color="#0000AA">Starting one driver in Local mode works.</font>
* <font color="#CC8800">Starting in Server mode only creates a server, KStars does not connect to it.</font>
* <font color="#0000AA">Starting multiple drivers in Local mode works.</font>
* <font color="#CC8800">Starting one driver in Local mode works.</font>
* <font color="#0000AA">Stopping one driver does not stop server.</font>
* <font color="#CC8800">Starting multiple drivers in Local mode works.</font>
* <font color="#0000AA">Stopping multiple drivers does not stop server.</font>
* <font color="#CC8800">Stopping one driver does not stop server.</font>
* <font color="#0000AA">The Run Service button enables the user to run selected device.</font>
* <font color="#CC8800">Stopping multiple drivers does not stop server.</font>
* <font color="#0000AA">The Stop Service button enables the user to stop selected device.</font>
* <font color="#CC8800">The Run Service button enables the user to run selected device.</font>
* <font color="#0000AA">The Close button enables the user to close Device Manager windows.</font>
* <font color="#CC8800">The Stop Service button enables the user to stop selected device.</font>
* <font color="#0000AA">In the Client tab, the user can Add/Modify/Remove a host.</font>
* <font color="#00AA00">The Close button enables the user to close Device Manager windows.</font>
* <font color="#0000AA">In the Client tab, the user can establish/stop a connection by pressing the Connect/Disconnect buttons.</font>
* <font color="#00AA00">In the Client tab, the user can Add/Modify/Remove a host.</font>
* <font color="#CC8800">In the Client tab, the user can establish/stop a connection by pressing the Connect/Disconnect buttons.</font>


===== INDI Control panel =====
===== INDI Control panel =====
* <font color="#0000AA">INDI Control Panel allows users to control all the features supported by a device.</font>
* <font color="#00AA00">INDI Control Panel allows users to control all the features supported by a device.</font>


===== Configure INDI =====
===== Configure INDI =====


==== Tools Menu (test opening tools only here) ====
==== Tools Menu (test opening tools only here) ====
* Calculator [Ctrl+C]
* <font color="#00AA00">Calculator [Ctrl+C]</font>
* <font color="#0000AA">Devices</font>
* <font color="#00AA00">Devices</font>
* <font color="#0000AA">Sky Calendar</font>
* <font color="#00AA00">Sky Calendar</font>
* Altitude vs. Time [Ctrl+A]
* <font color="#00AA00">Altitude vs. Time [Ctrl+A]</font>
* What's Up Tonight [Ctrl+U]
* <font color="#00AA00">What's Up Tonight [Ctrl+U]</font>
* <font color="#0000AA">What's Interesting [Ctrl+W]</font>
* <font color="#00AA00">What's Interesting [Ctrl+W]</font>
* Script Builder [Ctrl+B]
* <font color="#00AA00">Script Builder [Ctrl+B]</font>
* Solar System [Ctrl+Y]
* <font color="#00AA00"> Solar System [Ctrl+Y]</font>
* <font color="#0000AA">Ekos [Ctrl+K]</font>
* <font color="#00AA00">Ekos [Ctrl+K]</font>
* Jupiter's Moons [Ctrl+J]
* <font color="#00AA00"> Jupiter's Moons [Ctrl+J]</font>
* <font color="#0000AA">Flags</font>
* <font color="#00AA00">Flags</font>


==== Observation Menu ====
==== Observation Menu ====
* <font color="#0000AA">Observation Planner [Ctrl+L]</font>
* <font color="#00AA00">Observation Planner [Ctrl+L]</font>
* <font color="#0000AA">Execute the session Plan [Ctrl+2]</font>
* <font color="#00AA00">Execute the session Plan [Ctrl+2]</font>


==== Observation Planner [Ctrl+L] ====
==== Observation Planner [Ctrl+L] ====
* <font color="#0000AA">The user can open an observation session list.</font>
* <font color="#CC8800">The user can open an observation session list.</font>  
* <font color="#0000AA">The user can open the Observing List Wizard.</font>
{{Remember|2=The user can open an observation session list|1=KStars can't open an observation session list. It seems that the path to the file is wrong (Windows uses backslash (\) but KStars is trying to open a file using the Linux slash (/) symbol). }}
* <font color="#0000AA">The observation session can be saved using Save/Save as buttons..</font>
* <font color="#00AA00">The user can open the Observing List Wizard.</font>
* <font color="#0000AA">The user can easily set up the current Location and Date.</font>
* <font color="#CC8800">The observation session can be saved using Save/Save as buttons.</font>  
* <font color="#0000AA">More objects can be added to the list by using the Find Object or What's up Tonight tool.</font>
{{Remember|2=The observation session can be saved using Save/Save as buttons|1=Saving does not work at all in KStars. The path to the saved file seems to be wrong (Windows uses backslash (\) but KStars is trying to save using the Linux slash (/) symbol; see http://raphaelcojocaru.xyz/save_image.PNG ). }}
* <font color="#0000AA">An image can be added to an object by pressing the Find Image button on the right .</font>
* <font color="#00AA00">The user can easily set up the current Location and Date.</font>
* <font color="#0000AA">Within the Find Image window, the user can open an image from his hard drive.</font>
* <font color="#00AA00">More objects can be added to the list by using the Find Object or What's up Tonight tool.</font>
* <font color="#0000AA">The Download all Images button downloads the SDSS/DSS images of all the objects in the current list.</font>
* <font color="#00AA00">An image can be added to an object by pressing the Find Image button on the right .</font>
* <font color="#0000AA">The Delete all Images button deletes the stored DSS/SDSS images.</font>
* <font color="#00AA00">Within the Find Image window, the user can open an image from his hard drive.</font>
* <font color="#0000AA">The Delete button deletes the current set image.</font>
* <font color="#00AA00">The Download all Images button downloads the SDSS/DSS images of all the objects in the current list.</font>
* <font color="#0000AA">The Make window small button shrinks the size of the Observation Planner window.</font>
* <font color="#00AA00">The Delete all Images button deletes the stored DSS/SDSS images.</font>
* <font color="#00AA00">The Delete button deletes the current set image.</font>
* <font color="#00AA00">The Make window small button shrinks the size of the Observation Planner window.</font>


==== Execute the session Plan [Ctrl+2] ====
==== Execute the session Plan [Ctrl+2] ====
* <font color="#0000AA">The user is able to see some information about the selected object and also to add observing notes.</font>
* <font color="#00AA00">The user is able to see some information about the selected object and also to add observing notes.</font>
* <font color="#0000AA">The user is able to add new objects to the list using Add new object to list button.</font>
* <font color="#00AA00">The user is able to add new objects to the list using Add new object to list button.</font>
* <font color="#0000AA">The user is able to remove the selected object from the list by pressing Remove object from list button.</font>
* <font color="#00AA00">The user is able to remove the selected object from the list by pressing Remove object from list button.</font>
* <font color="#0000AA">The user is able to enter and set session detailsː Location, Begin time of the session, Weather, Equipment, Comments and Language.</font>
* <font color="#00AA00">The user is able to enter and set session detailsː Location, Begin time of the session, Weather, Equipment, Comments and Language.</font>
* <font color="#0000AA">By pressing the Next Page button the user will access the second page of Session Plan, that contains information about equipment.</font>
* <font color="#00AA00">By pressing the Next Page button the user will access the second page of Session Plan, that contains information about equipment.</font>
* <font color="#0000AA">Pressing the Next Target button will cause the Execute Session to open the first window again for the next object.</font>
* <font color="#00AA00">Pressing the Next Target button will cause the Execute Session to open the first window again for the next object.</font>
* <font color="#0000AA">By pressing the End Session button, the user will save and end the current session.</font>
* <font color="#CC8800">By pressing the End Session button, the user will save and end the current session.</font>  
* <font color="#0000AA">By pressing the Close button, the Execute Session window will be closed.</font>
{{Remember|2=By pressing the End Session button, the user will save and end the current session|1=Saving does not work at all in KStars. The path to the saved file seems to be wrong (Windows uses backslash (\) but KStars is trying to save using the Linux slash (/) symbol; see http://raphaelcojocaru.xyz/save_image.PNG ). }}
* <font color="#00AA00">By pressing the Close button, the Execute Session window will be closed.</font>


==== Settings Menu ====
==== Settings Menu ====
* <font color="#000000>Infoboxes Display toggles</font>
* <font color="#00AA00>Infoboxes Display toggles</font>
* <font color="#000000">Toolbar display toggles</font>  
* <font color="#00AA00">Toolbar display toggles</font>  
* <font color="#000000">Toolbar customization</font>  
* <font color="#00AA00">Toolbar customization</font>  
* <font color="#000000">Statusbar display toggles</font>
* <font color="#00AA00">Statusbar display toggles</font>
* <font color="#000000">Color scheme toggles</font>
* <font color="#00AA00">Color scheme toggles</font>
* <font color="#000000">Field-of-view (FOV) Symbol selector</font>
* <font color="#00AA00">Field-of-view (FOV) Symbol selector</font>
* <font color="#000000">FOV Editor</font>
* <font color="#00AA00">FOV Editor</font>
* <font color="#0000AA">Artificial Horizon</font>
* <font color="#00AA00">Artificial Horizon</font>
* <font color="#000000">Configure Observation Logging</font>
* <font color="#00AA00">Configure Observation Logging</font>
* <font color="#000000">Geographic Location [Ctrl+G]</font>
* <font color="#00AA00">Geographic Location [Ctrl+G]</font>
* <font color="#0000AA">Configure Shortcuts</font>  
* <font color="#00AA00">Configure Shortcuts</font>  
* <font color="#0000AA">Configure Toolbars</font>  
* <font color="#00AA00">Configure Toolbars</font>  
* <font color="#000000">Configure KStars</font>  
* <font color="#00AA00">Configure KStars</font>  
* <font color="#000000">Startup Wizard</font>
* <font color="#00AA00">Startup Wizard</font>


==== Configure Observation Logging ====
==== Configure Observation Logging ====
* <font color="#0000AA>List your Equipment [Ctrl+0]</font>
* <font color="#00AA00>List your Equipment [Ctrl+0]</font>
* <font color="#0000AA>Manage Observer [Ctrl+1]</font>
* <font color="#00AA00>Manage Observer [Ctrl+1]</font>


==== Help Menu ====
==== Help Menu ====
* <font color="#000000">KStars Handbook [F1]</font>
* <font color="#00AA00">KStars Handbook [F1]</font>
* <font color="#0000AA>Tip of the Day</font>
* <font color="#00AA00>Tip of the Day</font>
* <font color="#0000AA">What's this? [Shift+F1]</font>  
* <font color="#00AA00">What's this? [Shift+F1]</font>  
* <font color="#000000">Report Bug</font>
* <font color="#00AA00">Report Bug</font>
* <font color="#000000">About KStars</font>
* <font color="#00AA00">About KStars</font>
* <font color="#000000">About KDE</font>
* <font color="#00AA00">About KDE</font>


=== Toolbars ===
=== Toolbars ===
==== Main toolbar ====
==== Main toolbar ====
* <font color="#000000">Zoom in/out</font>
* <font color="#00AA00">Zoom in/out</font>
* <font color="#000000">Find object...</font>
* <font color="#00AA00">Find object...</font>
* <font color="#0000AA>Geographic</font>
* <font color="#00AA00>Geographic</font>
* <font color="#0000AA>Set Time</font>
* <font color="#00AA00>Set Time</font>
* <font color="#0000AA>Advance one step backward in time</font>
* <font color="#00AA00>Advance one step backward in time</font>
* <font color="#000000">Stop/Start clock</font>  
* <font color="#00AA00">Stop/Start clock</font>  
* <font color="#0000AA>Advance one step forward in time</font>
* <font color="#00AA00>Advance one step forward in time</font>
* <font color="#0000AA">Set Timestep widget</font>
* <font color="#00AA00">Set Timestep widget</font>


==== View toolbar ====
==== View toolbar ====
* <font color="#000000">Show stars</font>
* <font color="#00AA00">Show stars</font>
* <font color="#0000AA">Show deep-sky objects</font>  
* <font color="#00AA00">Show deep-sky objects</font>  
* <font color="#0000AA">Show Solar system objects</font>
* <font color="#00AA00">Show Solar system objects</font>
* <font color="#0000AA">Show supernovae</font>
* <font color="#CC8800">Show supernovae</font>  
* <font color="#0000AA">Show satellites</font>
{{Remember|2=Show supernovae|1=They are not drawn on the Sky Map. }}
* <font color="#000000">Show constellation lines</font>
* <font color="#CC8800">Show satellites</font>
* <font color="#000000">Show constellation names</font>
{{Remember|2=Show satellites|1=They are not drawn on the Sky Map. }}
* <font color="#0000AA">Show constellation art (BETA)</font>
* <font color="#00AA00">Show constellation lines</font>
* <font color="#000000">Show constellation boundaries</font>
* <font color="#00AA00">Show constellation names</font>
* <font color="#000000">Show Milky Way</font>
* <font color="#CC8800">Show constellation art (BETA)</font>  
* <font color="#0000AA">Show equatorial coordinate grid</font>
{{Remember|2=Show constellation art (BETA)|1=Constellation art is not drawn on the Sky Map. }}
* <font color="#0000AA">Show horizontal coordinate grid</font>
* <font color="#00AA00">Show constellation boundaries</font>
* <font color="#000000">Show opaque ground</font>
* <font color="#00AA00">Show Milky Way</font>
* <font color="#00AA00">Show equatorial coordinate grid</font>
* <font color="#00AA00">Show horizontal coordinate grid</font>
* <font color="#00AA00">Show opaque ground</font>


==== INDI toolbar ====
==== INDI toolbar ====
* <font color="#0000AA">Show Ekos</font>
* <font color="#00AA00">Show Ekos</font>
* <font color="#0000AA">Show INDI Control Panel</font>  
* <font color="#00AA00">Show INDI Control Panel</font>  
* <font color="#0000AA">Show FITS Viewer</font>
* <font color="#00AA00">Show FITS Viewer</font>
* <font color="#0000AA">Show Device Manager</font>


=== Centering and tracking ===
=== Centering and tracking ===
* <font color="#000000">Center+Track on object (double-click, popup menu, click then press "C")</font>
* <font color="#00AA00">Center+Track on object (double-click, popup menu, click then press "C")</font>
* <font color="#000000">Center+Track on empty sky (double-click, popup menu)</font>
* <font color="#00AA00">Center+Track on empty sky (double-click, popup menu)</font>
* <font color="#000000">If requested position moves display below horizon, confirm dialog is shown</font>
* <font color="#00AA00">If requested position moves display below horizon, confirm dialog is shown.</font>
* <font color="#000000">If startup position is below horizon, recenter dialog is shown</font>
* <font color="#00AA00">If startup position is below horizon, recenter dialog is shown.</font>
* <font color="#000000">Information in "Focus" InfoBox updates correctly when recentering</font>
* <font color="#00AA00">Information in "Focus" InfoBox updates correctly when recentering.</font>


=== Info boxes ===
=== Info boxes ===
* <font color="#000000">Displayed with semi-transparent backgound</font>
* <font color="#00AA00">Displayed with semi-transparent backgound.</font>
* <font color="#000000">Highlight color on click</font>
* <font color="#00AA00">Highlight color on click.</font>
* <font color="#000000">"Shade" on double-click</font>
* <font color="#00AA000">"Shade" on double-click.</font>
* <font color="#000000">Move on drag</font>
* <font color="#00AA00">Move on drag.</font>
* <font color="#000000">Collision avoidance works</font>
* <font color="#00AA00">Collision avoidance works.</font>
* <font color="#000000">"Stick" to screen edges</font>
* <font color="#00AA00">"Stick" to screen edges.</font>
* <font color="#000000">Remember position and shade-state on restart</font>
* <font color="#00AA00">Remember position and shade-state on restart.</font>


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


=== Dialogs ===
=== Dialogs ===
==== Download new data ====
==== Download new data ====
* <font color="#0000AA">Dialog displays all available download items (Steinicke NGC/IC catalog, Abell Planetary Nebulae Catalog, Sharpless HII region Catalog, Hickson Compact Groups, Tycho-2 Star Catalog, USNO NOMAD Catalog, Inline thumbnail images, Thumbnails for details window)</font>
* <font color="#00AA00">Dialog displays all available download items (Steinicke NGC/IC catalog, Abell Planetary Nebulae Catalog, Sharpless HII region Catalog, Hickson Compact Groups, Tycho-2 Star Catalog, USNO NOMAD Catalog, Inline thumbnail images, Thumbnails for details window).</font>
* Each item gets downloaded and installed correctly
* <font color="#00AA00">Each item gets downloaded and installed correctly.</font>
* <font color="#0000AA">For each item, the details window is opened by pressing the Details button.</font>
* <font color="#00AA00">For each item, the details window is opened by pressing the Details button.</font>
* <font color="#0000AA">By clicking on the author's name, the default email client will be opened enabling the user to easily send an email to the author.</font>
* <font color="#00AA00">By clicking on the author's name, the default email client will be opened enabling the user to easily send an email to the author.</font>
* <font color="#0000AA">Each item gets uninstalled correctly</font>
* <font color="#CCCC00">Each item gets uninstalled correctly.</font>  
* <font color="#0000AA">The add-ons list can be ordered byː Newest, Rating, Most downloads or Installed </font>
{{Remember|2=Each item gets uninstalled correctly|1=Uninstalling an add-on catalog does not remove it from the Catalogs list. Thus, its objects will remain drawn on the Sky Map, even though it has been already uninstalled. }}
* <font color="#0000AA">The search method works correctly</font>
* <font color="#00AA00">The add-ons list can be ordered byː Newest, Rating, Most downloads or Installed.</font>
* <font color="#00AA00">The search method works correctly.</font>


==== FITS viewer ====
==== FITS viewer ====
* File open dialog displays only FITS files.
* <font color="#00AA00">File open dialog displays only FITS files.</font>
* FITS image is opened and displayed properly.
* <font color="#00AA00">FITS image is opened and displayed properly.</font>
* Image coordinates, pixel value, image dimensions, and zoom value are displayed in status bar.
* <font color="#00AA00">Image coordinates, pixel value, image dimensions, and zoom value are displayed in status bar.</font>
* Undo/Redo work
* <font color="#00AA00">Undo/Redo work.</font>
* Zoom in/out, Default zoom
* <font color="#00AA00">Zoom in/out, Default zoom</font>
* <font color="#0000AA">Rotate Right</font>
* <font color="#00AA00">Rotate Right</font>
* <font color="#0000AA">Rotate Left</font>
* <font color="#00AA00">Rotate Left</font>
* <font color="#0000AA">Flip Horizontal</font>
* <font color="#00AA00">Flip Horizontal</font>
* <font color="#0000AA">Flip Vertical</font>
* <font color="#00AA00">Flip Vertical</font>
* <font color="#0000AA">Mark/Unmark Stars works</font>
* <font color="#00AA00">Mark/Unmark Stars works.</font>
* Statistics
* <font color="#00AA00">Statistics</font>
* <font color="#0000AA">Auto stretch</font>
* <font color="#00AA00">Auto stretch</font>
* FITS header
* <font color="#00AA00">FITS header</font>
* Closing without save issues a warning dialog
* <font color="#CC8800">Closing without save issues a warning dialog.</font>
* Save and Save As work
{{Remember|2=Closing without save issues a warning dialog|1=No warning dialog is displayed if the window is closed without save - same in Linux. }}
* <font color="#0000AA">All shortcuts work (i.e. Ctrl+H for opening the FITS Header window)</font>
* <font color="#CC8800">Save and Save As work.</font>
{{Remember|2=Save and Save As work|1=Saving does not work at all in KStars. The path to the saved file seems to be wrong (Windows uses backslash (\) but KStars is trying to save using the Linux slash (/) symbol; see http://raphaelcojocaru.xyz/save_image.PNG ). }}
* <font color="#CCCC00">All shortcuts work (i.e. Ctrl+H for opening the FITS Header window).</font>  
{{Remember|2=All shortcuts work (i.e. Ctrl+H for opening the FITS Header window) |1="Ctrl+H" shortcut for opening the FITS Header window does not work because it is ambiguous. }}


===== Histogram tool =====
===== 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
* <font color="#00AA00">Range of pixel values can be updated with edit boxes or by dragging the blue/red symbols: red symbol not draggable in initial position.</font>


==== Save sky image ====
==== Save sky image ====
* Saves image to file: Doesn't seem to save GIF
* <font color="#CC8800">Saves image to file.</font>
* Image matches screen display (without FOV or infobox overlays)
{{Remember|2=Saves image to file |1=Saving does not work at all in KStars. The path to the saved file seems to be wrong (Windows uses backslash (\) but KStars is trying to save using the Linux slash (/) symbol; see http://raphaelcojocaru.xyz/save_image.PNG ). }}
* <font color="#000000">Image matches screen display (without FOV or infobox overlays).</font>


==== Run script ====
==== Run script ====
* Executes the selected script.
* <font color="#CC8800">Executes the selected script.</font>
* Statusbar messages indicate script is running/finished.
{{Remember|2=Executes the selected script |1=KStars doesn't run the script. It seems to be stuck with the "Running script" message. }}
* <font color="00AA00">Statusbar messages indicate script is running/finished.</font>


==== Print ====
==== Print ====
* Prints image of current skymap (without infoboxes or FOV symbols)
* <font color="00AA00">Prints image of current skymap (without infoboxes or FOV symbols).</font>
* Ask to reset color scheme if background is not white
* <font color="00AA00">Ask to reset color scheme if background is not white.</font>
* Color scheme is properly reset for printing, and reverted afterward
* <font color="00AA00">Color scheme is properly reset for printing, and reverted afterward.</font>


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


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


==== Find object ====  
==== Find object ====  
* Filter by name works
* <font color="#00AA00">Filter by name works.</font>
* Filter by type works
* <font color="#00AA00">Filter by type works.</font>
* Highlighted object is centered in map when user hits return or presses Ok
* <font color="#CCCC00">Highlighted object is centered in map when user hits return or presses Ok.</font>
* Dialog message when a match fails; window does not close
{{Remember|2=Highlighted object is centered in map when user hits return or presses Ok |1=Pressing the Return key does nothing. }}
* Up/Down arrow keys navigate the list of objects
* <font color="#00AA00">Dialog message when a match fails; window does not close.</font>
* <font color="#0000AA">The Object Details window is opened by clicking on Details button</font>
* <font color="#00AA00">Up/Down arrow keys navigate the list of objects.</font>
* <font color="#00AA00">The Object Details window is opened by clicking on Details button.</font>


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


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


==== Artificial Horizon Manager ====
==== Artificial Horizon Manager ====
* <font color="#0000AA">User can draw a region by defining a list of points that encompasses the blocked area.</font>
* <font color="#00AA00">User can draw a region by defining a list of points that encompasses the blocked area.</font>
* <font color="#0000AA">User can add points manually, or by selecting them from the Sky Map.</font>
* <font color="#00AA00">User can add points manually, or by selecting them from the Sky Map.</font>
* <font color="#0000AA">Add Region button works.</font>
* <font color="#00AA00">Add Region button works.</font>
* <font color="#0000AA">Remove Region button works.</font>
* <font color="#00AA00">Remove Region button works.</font>
* <font color="#0000AA">Save Regions button works.</font>
* <font color="#00AA00">Save Regions button works.</font>
* <font color="#0000AA">A region's name can be changed by double clicking on its name.</font>
* <font color="#00AA00">A region's name can be changed by double clicking on its name.</font>
* <font color="#0000AA">The default regions names are likeː Region 1, Region 2 and so on.</font>
* <font color="#00AA00">The default regions names are likeː Region 1, Region 2 and so on.</font>
* <font color="#0000AA">Add Point button works.</font>
* <font color="#00AA00">Add Point button works.</font>
* <font color="#0000AA">Add Point button works.</font>
* <font color="#00AA00">Remove Point button works.</font>
* <font color="#0000AA">Clear all points button works.</font>
* <font color="#00AA00">Clear all points button works.</font>
* <font color="#0000AA">Select Points button works.</font>
* <font color="#00AA00">Select points from the sky map button works.</font>


==== Geographic location ====
==== Geographic location ====
* <font color="#0000AA">Set the location by highlighting a city from the list.</font>
* <font color="#00AA00">Set the location by highlighting a city from the list.</font>
* <font color="#0000AA">The red crosshair's position on the map will be updated by highlighting a city from the list.</font>
* <font color="#CCCC00">The red crosshair's position on the map will be updated by highlighting a city from the list.</font>  
* <font color="#0000AA">Use the City Filter to make searches easier.</font>
{{Remember|2=The red crosshair's position on the map will be updated by highlighting a city from the list|1=The map from Set Geographic Location window is missing (see http://raphaelcojocaru.xyz/missing_map.PNG ). }}
* <font color="#0000AA">Use the Province Filter to make searches easier.</font>
* <font color="#00AA00">Use the City Filter to make searches easier.</font>
* <font color="#0000AA">Use the Country Filter to make searches easier.</font>
* <font color="#00AA00">Use the Province Filter to make searches easier.</font>
* <font color="#0000AA">Define a completely new location by pressing the Clear Fields button, and entering the data for the new location.</font>
* <font color="#00AA00">Use the Country Filter to make searches easier.</font>
* <font color="#0000AA"> Use the Add City to List button to record a new custom version of some location.</font>
* <font color="#00AA00">Define a completely new location by pressing the Clear Fields button, and entering the data for the new location.</font>
* <font color="#0000AA"> Use the Remove City from List button to remove the selected location from the list.</font>
* <font color="#00AA00"> Use the Add City to List button to record a new custom version of some location.</font>
* <font color="#0000AA"> Latitude, longitude and UT offset values for a given location must be correct.</font>
* <font color="#00AA00"> Use the Remove City from List button to remove the selected location from the list.</font>
* <font color="#00AA00"> Latitude, longitude and UT offset values for a given location must be correct.</font>


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


==== Object Details (from popup menu) ====
==== Object Details (from popup menu) ====
* <font color="#0000AA">The window is divided into a number of tabs depending on the selected object: General, Position, Links, Advanced and Log.</font>
* <font color="#00AA00">The window is divided into a number of tabs depending on the selected object: General, Position, Links, Advanced and Log.</font>
* <font color="#0000AA">General tab contains names and catalog designations, object type, and magnitude (brightness).</font>
* <font color="#00AA00">General tab contains names and catalog designations, object type, and magnitude (brightness).</font>
* <font color="#0000AA">Using the General tab, the current object can be added to Observing List.</font>
* <font color="#00AA00">Using the General tab, the current object can be added to Observing List.</font>
* <font color="#0000AA">Using the General tab, the current object can be centered in Map.</font>
* <font color="#00AA00">Using the General tab, the current object can be centered in Map.</font>
* <font color="#0000AA">Using the General tab, the current object can be centered in Telescope.</font>
* <font color="#00AA00">Using the General tab, the current object can be centered in Telescope.</font>
* <font color="#0000AA">Position tab contains object's Equatorial and Horizontal coordinates, as well as its rise, set and transit times.</font>
* <font color="#00AA00">Position tab contains object's Equatorial and Horizontal coordinates, as well as its rise, set and transit times.</font>
* <font color="#0000AA">In the Links tab, the internet links associated with this object can be managed.</font>
* <font color="#00AA00">In the Links tab, the internet links associated with this object can be managed.</font>
* <font color="#0000AA">Add custom links to the object using the Add Link button.</font>
* <font color="#00AA00">Add custom links to the object using the Add Link button.</font>
* <font color="#0000AA">Modify or remove any link using the Edit Link and Remove Link buttons.</font>
* <font color="#00AA00">Modify or remove any link using the Edit Link and Remove Link buttons.</font>
* <font color="#0000AA">Query professional astronomical databases on the internet using The Advanced Tab.</font>
* <font color="#00AA00">Query professional astronomical databases on the internet using The Advanced Tab.</font>
* <font color="#0000AA">Using the Log Tab, type in some text that will remain associated with this object's Details window.</font>
* <font color="#00AA00">Using the Log Tab, type in some text that will remain associated with this object's Details window.</font>
* <font color="#0000AA">User's notes are saved correctly such that they can be used next time in KStars.</font>
* <font color="#00AA00">User's notes are saved correctly such that they can be used next time in KStars.</font>


==== Image viewer (from popup menu) ====
==== Image viewer (from popup menu) ====
* Selected image is shown; window is sized to fit image
* <font color="#00AA00">Selected image is shown; window is sized to fit image.</font>
* Authorship and copyright in statusbar
* <font color="#00AA00">Authorship and copyright in statusbar.</font>
* Save button works
* <font color="#CC8800">Save button works.</font>
{{Remember|2=Save button works |1=Saving does not work at all in KStars. The path to the saved file seems to be wrong (Windows uses backslash (\) but KStars is trying to save using the Linux slash (/) symbol; see http://raphaelcojocaru.xyz/save_image.PNG ). }}


=== Popup menu ===
=== Popup menu ===
* <font color="#0000AA">The right click popup menu is context-sensitive, meaning its content varies depending on what kind of object you click on.</font>
* <font color="#00AA00">The right click popup menu is context-sensitive, meaning its content varies depending on what kind of object you click on.</font>
* <font color="#0000AA">The name(s) of the object, and its type.</font>
* <font color="#00AA00">The name(s) of the object, and its type.</font>
* <font color="#0000AA">Rise, Transit, and Set times for the object.</font>
* <font color="#00AA00">Rise, Transit, and Set times for the object.</font>
* <font color="#0000AA">Center & Track: Center the display on this location, and engage tracking. Equivalent to double-clicking.</font>
* <font color="#00AA00">Center & Track: Center the display on this location, and engage tracking. Equivalent to double-clicking.</font>
* <font color="#0000AA">Add flag.</font>
* <font color="#00AA00">Add flag.</font>
* <font color="#0000AA">Angular Distance To: compute the angular distance between two selected objects.</font>
* <font color="#00AA00">Angular Distance To: compute the angular distance between two selected objects.</font>
* <font color="#0000AA">Details: Open the Object Details window for this object. (not available for all objects)</font>
* <font color="#00AA00">Details: Open the Object Details window for this object. (not available for all objects)</font>
* <font color="#0000AA">Attach/Remove Label.</font>
* <font color="#00AA00">Attach/Remove Label.</font>
* <font color="#0000AA">Add/Remove from Observing List. (not available for all objects)</font>
* <font color="#00AA00">Add/Remove from Observing List. (not available for all objects)</font>
* <font color="#0000AA">Add/Remove Trail. (not available for all objects)</font>
* <font color="#00AA00">Add/Remove Trail. (not available for all objects)</font>
* <font color="#0000AA">Simulate eyepiece view,</font>
* <font color="#00AA00">Simulate eyepiece view,</font>
* <font color="#0000AA">Give image resources. (not available for all objects)</font>
* <font color="#00AA00">Give image resources. (not available for all objects)</font>
* <font color="#0000AA">Give information resources. (not available for all objects)</font>
* <font color="#00AA00">Give information resources. (not available for all objects)</font>
* <font color="#0000AA">Show SDSS Image. (not available for all objects)</font>
* <font color="#00AA00">Show SDSS Image. (not available for all objects)</font>
* <font color="#0000AA">Show DSS Image. (not available for all objects)</font>
* <font color="#00AA00">Show DSS Image. (not available for all objects)</font>


=== Tools ===
=== Tools ===
==== 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.
* Julian Day calculator works correctly, both ways.
* <font color="#00AA00">Julian Day calculator works correctly, both ways.</font>
* Sidereal Time Calculator works correctly, both ways.
* <font color="#00AA00">Sidereal Time Calculator works correctly, both ways.</font>
* Information displayed in the Almanac seems correct.
* <font color="#00AA00">Information displayed in the Almanac seems correct.</font>
* Equinoxes and Solstices displayed are correct
* <font color="#00AA00">Equinoxes and Solstices displayed are correct.</font>
* Equatorial to Galactic Coords conversion works
* <font color="#00AA00">Equatorial to Galactic Coords conversion works.</font>
* Conversion from Equatorial to Horizontal coordinates is accurate
* <font color="#00AA00">Conversion from Equatorial to Horizontal coordinates is accurate.</font>
* Horizontal Coordinates UI
* <font color="#00AA00">Horizontal Coordinates UI.</font>
* Ecliptic Coordinates tool UI
* <font color="#00AA00">Ecliptic Coordinates tool UI.</font>
* Data shown in the ecliptic coordinates tool seems accurate
* <font color="#00AA00">Data shown in the ecliptic coordinates tool seems accurate.</font>
* Angular distance tool UI works as expected
* <font color="#00AA00">Angular distance tool UI works as expected.</font>
* Angular distances reported seem accurate
* <font color="#00AA00">Angular distances reported seem accurate.</font>
* Geodetic coordinates UI works as expected
* <font color="#00AA00">Geodetic coordinates UI works as expected.</font>
* Data displayed by Geodetic coordinates tool seems correct
* <font color="#00AA00">Data displayed by Geodetic coordinates tool seems correct.</font>
* LSR Velocity tool UI works as expected
* <font color="#00AA00">LSR Velocity tool UI works as expected.</font>
* LSR Velocity tool seems to produce correct results
* <font color="#00AA00">LSR Velocity tool seems to produce correct results.</font>
* Planet Coordinates tool UI behaves as expected
* <font color="#00AA00">Planet Coordinates tool UI behaves as expected.</font>
* Planet coordinates shown seem accurate
* <font color="#00AA00">Planet coordinates shown seem accurate.</font>
* Conjunctions tool UI behaves as expected
* <font color="#00AA00">Conjunctions tool UI behaves as expected.</font>
* Conjunctions tool reports all conjunctions correctly
* <font color="#00AA00">Conjunctions tool reports all conjunctions correctly.</font>
 
==== Observing List ====
* Removing an object named "star"
* Selecting by magnitude in wizard [count not updated properly]


==== Altitude vs. time ====
==== Altitude vs. time ====
* <font color="#0000AA">Find Object works</font>
* <font color="#00AA00">Find Object works.</font>
* <font color="#0000AA">Using the Plot button, an object's altitude curve is drawn smoothly and correctly.</font>
* <font color="#00AA00">Using the Plot button, an object's altitude curve is drawn smoothly and correctly.</font>
* <font color="#0000AA">Clear Fields button clears the Name, RA, Dec and Equinox text boxes.</font>
* <font color="#00AA00">Clear Fields button clears the Name, RA, Dec and Equinox text boxes.</font>
* <font color="#0000AA">Clear List button clears the entire plot.</font>
* <font color="#00AA00">Clear List button clears the entire plot.</font>
* <font color="#0000AA">The format for RA coordinate isː hh mm ss.s</font>
* <font color="#00AA00">The format for RA coordinate isː hh mm ss.s</font>
* <font color="#0000AA">The format for Dec coordinate isː dd mm ss.s</font>
* <font color="#00AA00">The format for Dec coordinate isː dd mm ss.s</font>
* <font color="#0000AA">Zoom in works correctly.</font>
* <font color="#00AA00">Zoom in works correctly.</font>
* <font color="#0000AA">Zoom out works correctly.</font>
* <font color="#00AA00">Zoom out works correctly.</font>
* <font color="#0000AA">The plot can be smoothly panned using the mouse movement, keeping the limitations on the plot sides.</font>
* <font color="#00AA00">The plot can be smoothly panned using the mouse movement, keeping the limitations on the plot sides.</font>
* <font color="#0000AA">There should exist a zoom out limitation for the most dominant curve. The plot cannot be zoomed out pass today's curve.</font>
* <font color="#00AA00">There should exist a zoom out limitation for the most dominant curve. The plot cannot be zoomed out pass today's curve.</font>
* <font color="#0000AA">Compute button will calculate the correct altitude for an object using a certain Local Time.</font>
* <font color="#00AA00">Compute button will calculate the correct altitude for an object using a certain Local Time.</font>
* <font color="#0000AA">The Local Time can be set using the spin box or by entering manually the value. </font>
* <font color="#00AA00">The Local Time can be set using the spin box or by entering manually the value. </font>
* <font color="#0000AA">The Local Time value must be correct. In example, you can't use an hour bigger than 23ː59. </font>
* <font color="#00AA00">The Local Time value must be correct. In example, you can't use an hour bigger than 23ː59. </font>
* <font color="#0000AA">The Rise/Set/Transit markers are drawn at the correct position on the curve. </font>
* <font color="#00AA00">The Rise/Set/Transit markers are drawn at the correct position on the curve. </font>
* <font color="#0000AA">The colors used for Rise/Set/Transit markers must match the colors marked on the buttonsː red for Rise, blue for Set and green for Transit time.</font>
* <font color="#00AA00">The colors used for Rise/Set/Transit markers must match the colors marked on the buttonsː red for Rise, blue for Set and green for Transit time.</font>
* <font color="#0000AA">The opaque green ground must start at 0 degrees altitude.</font>
* <font color="#00AA00">The opaque green ground must start at 0 degrees altitude.</font>
* <font color="#0000AA">The dashed line must indicate the correct time and must be drawn at the right position on the plot.</font>
* <font color="#00AA00">The dashed line must indicate the correct time and must be drawn at the right position on the plot.</font>
* <font color="#0000AA">The curve of the current highlighted object from the list must be drawn with a thicker, white line, while the others curves must be drawn with a thinner, red line.</font>
* <font color="#00AA00">The curve of the current highlighted object from the list must be drawn with a thicker, white line, while the others curves must be drawn with a thinner, red line.</font>
* <font color="#0000AA">The Rise/Set/Transit markers must be drawn above the altitude curves.</font>
* <font color="#00AA00">The Rise/Set/Transit markers must be drawn above the altitude curves.</font>
* <font color="#0000AA">The date and location can be updated using the Date & Location tab.</font>
* <font color="#00AA00">The date and location can be updated using the Date & Location tab.</font>
* <font color="#0000AA">By hovering the mouse above a curve, a black tool tip will appear, displaying the name of the object, the local sidereal time, the local time and the altitude value for that position.</font>
* <font color="#00AA00">By hovering the mouse above a curve, a black tool tip will appear, displaying the name of the object, the local sidereal time, the local time and the altitude value for that position.</font>
* <font color="#00AA00">Print button works.</font>


==== What's up tonight ====
==== What's up tonight ====
* <font color="#0000AA">The date and location are correct</font>
* <font color="#00AA00">The date and location are correct.</font>
* Almanac data are correct
* <font color="#00AA00">Almanac data are correct..</font>
* Displays objects that are visible on the given date, from the given location
* <font color="#00AA00">Displays objects that are visible on the given date, from the given location.</font>
* Changing the Date works, and updates the list of objects and almanac
* <font color="#00AA00">Changing the Date works, and updates the list of objects and almanac.</font>
* Changing the Location works, and updates the list of objects and almanac
* <font color="#00AA00">Changing the Location works, and updates the list of objects and almanac.</font>
* Selecting Evening/Morning/All Night works, and updates the list of objects
* <font color="#00AA00">Selecting Evening/Morning/All Night works, and updates the list of objects.</font>
* <font color="#0000AA">Selecting the minimum magnitude works, and updates the list of object</font>
* <font color="#00AA00">Selecting the minimum magnitude works, and updates the list of object.</font>
* Selected object is displayed in right panel correctly
* <font color="#00AA00">Selected object is displayed in right panel correctly.</font>
* The Rise/Set/Transit data are correct
* <font color="#00AA00">The Rise/Set/Transit data are correct.</font>
* Center Object button works
* <font color="#00AA00">Center Object button works.</font>
* Details button works
* <font color="#00AA00">Details button works.</font>
* <font color="#0000AA">Add to List button adds the selected object to the Observing list</font>
* <font color="#00AA00">Add to List button adds the selected object to the Observing list.</font>


==== What's Interesting ====
==== What's Interesting ====
* <font color="#0000AA">User can rate how light-polluted is the night-sky.</font>
* <font color="#00AA00">User can rate how light-polluted is the night-sky.</font>
* <font color="#0000AA">A rating can have values in range 1 to 9.</font>
* <font color="#00AA00">A rating can have values in range 1 to 9.</font>
* <font color="#0000AA">Clicking on the Wikipedia link will open the Bortle dark-sky scale in the default web browser.</font>
* <font color="#00AA00">Clicking on the Wikipedia link will open the Bortle dark-sky scale in the default web browser.</font>
* <font color="#0000AA">The Defaults button will reset the rating value to 4, which is the default value.</font>
* <font color="#00AA00">The Defaults button will reset the rating value to 4, which is the default value.</font>
* <font color="#0000AA">User can set the equipment settingsː equipment type and parameters.</font>
* <font color="#00AA00">User can set the equipment settingsː equipment type and parameters.</font>
* <font color="#0000AA">The Telescope and Binoculars check boxes work.</font>
* <font color="#00AA00">The Telescope and Binoculars check boxes work.</font>
* <font color="#0000AA">User can add a new telescope by pressing the Add new telescope button, which will open the Configure Equipment window.</font>
* <font color="#00AA00">User can add a new telescope by pressing the Add new telescope button, which will open the Configure Equipment window.</font>
* <font color="#0000AA">In the Configure Equipment window, user can save or remove an equipment from the list.</font>
* <font color="#00AA00">In the Configure Equipment window, user can save or remove an equipment from the list.</font>
* <font color="#0000AA">In the Configure Equipment window are four tabs (Telescope, Eyepiece, Lens and Filter) and each tab contains specific parameters for current equipment type.</font>
* <font color="#00AA00">In the Configure Equipment window are four tabs (Telescope, Eyepiece, Lens and Filter) and each tab contains specific parameters for current equipment type.</font>
* <font color="#0000AA">The Defaults button works.</font>
* <font color="#00AA00">The Defaults button works.</font>


==== Script builder ====
==== Script builder ====
* <font color="#0000AA">Short documentation for the function highlighted in the Function Browser is correct.</font>
* <font color="#00AA00">Short documentation for the function highlighted in the Function Browser is correct.</font>
* <font color="#0000AA">When a function is highlighted in the Current Script box, the Function Arguments panel will contain items for specifying values for any arguments that the highlighted function requires.</font>
* <font color="#00AA00">When a function is highlighted in the Current Script box, the Function Arguments panel will contain items for specifying values for any arguments that the highlighted function requires.</font>
* <font color="#0000AA">New Script button creates a new empty script.</font>
* <font color="#00AA00">New Script button creates a new empty script.</font>
* <font color="#0000AA">Open Script button enables the user to use a script that already exists in the system.</font>
* <font color="#00AA00">Open Script button enables the user to use a script that already exists in the system.</font>
* <font color="#0000AA">Save Script/Save Script As buttons are correctly saving the current script, letting the user to choose the desired location of the saving.</font>
* <font color="#00AA00">Save Script/Save Script As buttons are correctly saving the current script, letting the user to choose the desired location of the saving.</font>
* <font color="#0000AA">Pressing Test Script will correctly run the current script in the main KStars window.</font>
* <font color="#CC8800">Pressing Test Script will correctly run the current script in the main KStars window.</font>  
* <font color="#0000AA">Add Function button adds the currently-highlighted function in the Function Browser to the Current Script box (you can also add a function by double-clicking on it).</font>
{{Remember|2=Pressing Test Script will correctly run the current script in the main KStars window|1=KStars doesn't run the script. It seems to be stuck with the "Running script" message. }}
* <font color="#0000AA">Remove Function button removes the currently-highlighted function from the Current Script box.</font>
* <font color="#00AA00">Add Function button adds the currently-highlighted function in the Function Browser to the Current Script box (you can also add a function by double-clicking on it).</font>
* <font color="#0000AA">Copy Function button duplicates the currently-highlighted function from the Current Script box.</font>
* <font color="#00AA00">Remove Function button removes the currently-highlighted function from the Current Script box.</font>
* <font color="#0000AA">Move Up/Move Down buttons enable the user to set the desired running order of the functions.</font>
* <font color="#00AA00">Copy Function button duplicates the currently-highlighted function from the Current Script box.</font>
* <font color="#0000AA">A warning dialog will pop-up if the New Script button is pressed and the current script has unsaved changes.</font>
* <font color="#00AA00">Move Up/Move Down buttons enable the user to set the desired running order of the functions.</font>
* <font color="#00AA00">A warning dialog will pop-up if the New Script button is pressed and the current script has unsaved changes.</font>


==== Solar system ====
==== Solar system ====
* <font color="#0000AA">Solar System Viewer displays a model of our solar system as seen from above.</font>
* <font color="#00AA00">Solar System Viewer displays a model of our solar system as seen from above.</font>
* <font color="#0000AA"> The display can be zoomed in and out with the + and - keys or by using the mouse scroll.</font>
* <font color="#00AA00"> The display can be zoomed in and out with the + and - keys or by using the mouse scroll.</font>
* <font color="#0000AA">The display can be recentered with the arrow keys, or by double-clicking anywhere in the window with the mouse.</font>
* <font color="#AA0000">The display can be centered with the arrow keys, or by double-clicking anywhere in the window with the mouse.</font>  
* <font color="#0000AA">The display can be also centered on a planet with the 0–9 keys (0 is the Sun; 9 is Pluto).</font>
{{Remember|2=The display can be centered with the arrow keys, or by double-clicking anywhere in the window with the mouse |1=Double click will make KStars to crash - same in Linux. }}
* <font color="#0000AA">The timestep can be adjusted.</font>
* <font color="#AA0000">The display can be also centered on a planet with the 0–9 keys (0 is the Sun; 9 is Pluto).</font>  
* <font color="#0000AA">The Today button reset the display to its default state.</font>
{{Remember|2=The display can be also centered on a planet with the 0–9 keys (0 is the Sun; 9 is Pluto) |1=Pressing 9 does nothing and pressing 8 will make KStars to crash - Same on Linux }}
* <font color="#0000AA">The Stop/Run button enables the user to stop/continue the simulation.</font>
* <font color="#00AA00">The timestep can be adjusted.</font>
* <font color="#00AA00">The Today button reset the display to its default state.</font>
* <font color="#00AA00">The Stop/Run button enables the user to stop/continue the simulation.</font>


==== Jupiter's moons ====
==== Jupiter's moons ====
* <font color="#0000AA">This tool displays the positions of Jupiter's four largest moons (Io, Europa, Ganymede, and Callisto) relative to Jupiter, as a function of time.</font>
* <font color="#00AA00">This tool displays the positions of Jupiter's four largest moons (Io, Europa, Ganymede, and Callisto) relative to Jupiter, as a function of time.</font>
* <font color="#0000AA">Each track is assigned a different color to distinguish it from the others; the name labels at the top of the window indicate the color used by each moon.</font>
* <font color="#00AA00">Each track is assigned a different color to distinguish it from the others; the name labels at the top of the window indicate the color used by each moon.</font>
* <font color="#0000AA">The time axis can be expanded or compressed using the + and - keys.</font>
* <font color="#00AA00">The time axis can be expanded or compressed using the + and - keys.</font>
* <font color="#0000AA">The time displayed at the center of the window can be changed with the [ and ] keys.</font>
* <font color="#00AA00">The graph can be moved up or down by pressing the [ and ] keys.</font>
* <font color="#0000AA">The Close button closes the window.</font>
* <font color="#00AA00">The Close button closes the window.</font>


==== Flags ====
==== Flags ====
* <font color="#0000AA">Flags manager allows the user to mark flags on the map by giving the RA/Dec coordinates.</font>
* <font color="#00AA00">Flags manager allows the user to mark flags on the map by giving the RA/Dec coordinates.</font>
* <font color="#0000AA">Add button works.</font>
* <font color="#00AA00">Add button works.</font>
* <font color="#0000AA">Save changes button works.</font>
* <font color="#00AA00">Save changes button works.</font>
* <font color="#0000AA">The user can set a custom label, a label color and an icon for a flag.</font>
* <font color="#00AA00">The user can set a custom label, a label color and an icon for a flag.</font>
* <font color="#0000AA">The Flag manager window contains documentation for how to add custom icons in KStars.</font>
* <font color="#00AA00">The Flag manager window contains documentation for how to add custom icons in KStars.</font>
* <font color="#0000AA">Delete button will remove the highlighted flag from the list and from KStars Sky-Map.</font>
* <font color="#00AA00">Delete button will remove the highlighted flag from the list and from KStars Sky-Map.</font>
* <font color="#0000AA">Centre in Map button works.</font>
* <font color="#00AA00">Centre in Map button works.</font>
* <font color="#0000AA">Centre in Telescope button works.</font>
* <font color="#00AA00">Centre in Telescope button works.</font>
* <font color="#0000AA">If KStars did not find any active telescopes, then a warning dialog will pop up.</font>
* <font color="#00AA00">If KStars did not find any active telescopes, then a warning dialog will pop up.</font>


=== Details window ===
=== Details window ===
* Displays object information
* <font color="#00AA00">Displays object information.</font>
* <font color="#0000AA">Add to Observing List works.</font>
* <font color="#00AA00">Add to Observing List works.</font>
* <font color="#0000AA">Centre in Map button works.</font>
* <font color="#00AA00">Centre in Map button works.</font>
* <font color="#0000AA">Centre in Telescope button works.</font>
* <font color="#00AA00">Centre in Telescope button works.</font>
* <font color="#0000AA">If KStars did not find any active telescopes, then a warning dialog will pop up.</font>
* <font color="#00AA00">If KStars did not find any active telescopes, then a warning dialog will pop up.</font>
* Testing Resource links works
* <font color="#00AA00">Testing Resource links works.</font>
* Editing Resource links works
* <font color="#00AA00">Editing Resource links works.</font>
* Removing resource links works
* <font color="#00AA00">Removing resource links works.</font>
* Interacting with online databases works
* <font color="#00AA00">Interacting with online databases works.</font>
* <font color="#0000AA">User can record any observation logs.</font>
* <font color="#00AA00">User can record any observation logs.</font>
* <font color="#0000AA">The observation logs are saved, such that they can be used next time when KStars is opened.</font>
* <font color="#00AA00">The observation logs are saved, such that they can be used next time when KStars is opened.</font>


==== Thumbnail Picker ====
==== Thumbnail Picker ====
* Displays list of images found via Google image search
* <font color="#00AA00">Displays list of images found via Google image search.</font>
* Selecting an image from the list displays it in the viewer
* <font color="#00AA00">Selecting an image from the list displays it in the viewer.</font>
* Editing the image works
* <font color="#00AA00">Editing the image works.</font>
* Closing the window places the selected image in the Details window
* <font color="#00AA00">Closing the window places the selected image in the Details window.</font>
* KIO jobs are terminated in the console after quitting KStars
* <font color="#00AA00">Loading an image from the computer works.</font>
* <font color="#00AA00">Unset Image button works.</font>
* <font color="#CC8800">KIO jobs are terminated in the console after quitting KStars.</font>
{{Remember|2=KIO jobs are terminated in the console after quitting KStars|1=KIO jobs are not terminated in the console after quitting KStars. }}


=== INDI ===
=== INDI ===
Line 520: Line 537:


=== Ekos ===
=== Ekos ===
* <font color="#0000AA">By default, Ekos uses Simulators profile.</font>
* <font color="#00AA00">By default, Ekos uses Simulators profile.</font>
* <font color="#0000AA">The Simulators profile can not be removed from the Profile list.</font>
* <font color="#00AA00">The Simulators profile can not be removed from the Profile list.</font>
* <font color="#0000AA">The user can add a new device profile using the + button and then Save button.</font>
* <font color="#00AA00">The user can add a new device profile using the Add profile button and then Save button.</font>
* <font color="#0000AA">The user can remove a profile using the - button.</font>
* <font color="#00AA00">The user can remove a profile using the Remove profile button.</font>
* <font color="#0000AA">The new profiles that has been added are kept when a new KStars' instance is opened.</font>
* <font color="#00AA00">The new profiles that has been added are kept when a new KStars instance is opened.</font>
* <font color="#0000AA">The profiles that has been removed from the lists will not come back when a new KStars' instance is opened.</font>
* <font color="#00AA00">The profiles that has been removed from the lists will not come back when a new KStars instance is opened.</font>
* <font color="#0000AA">The Edit profile button opens the Profile Editor, enabling the user to modify the current profile.</font>
* <font color="#00AA00">The Edit profile button opens the Profile Editor, enabling the user to modify the current profile.</font>
* <font color="#0000AA">INDI starts by pressing Start INDI button.</font>
* <font color="#00AA00">INDI starts by pressing Start INDI button.</font>
* <font color="#0000AA">The device can be connected using Connect button. </font>
* <font color="#00AA00">The device can be connected using Connect button. </font>
* <font color="#0000AA">The device can be disconnected using Disconnect button. </font>
* <font color="#00AA00">The device can be disconnected using Disconnect button. </font>
* <font color="#0000AA">Once a device is connected, a number of tabs will come up: Mount, CCD, Focus, Align and Guide. </font>
* <font color="#00AA00">Once a device is connected, a number of tabs will come up: Mount, CCD, Focus, Align and Guide. </font>
* <font color="#0000AA">Test the Scheduler, Mount, CCD, Focus, Align and Guide tabs.</font>
* <font color="#000000">Test the Scheduler, Mount, CCD, Focus, Align and Guide tabs.</font>


=== Configuration window ===
=== Configuration window ===
Line 537: Line 554:


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




Line 554: Line 571:
A: Will bring in Marble Widget eventually
A: Will bring in Marble Widget eventually


* kstars.exe remains opened in console.


----
----

Latest revision as of 13:07, 16 August 2016

List of expected behaviors for KStars 2.6.0

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.
  • 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.
  • 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 Ctrl pressed draws a rectangle in the map that defines a new area to be displayed when the mouse button is released
KStars can behave incorrectly if the rectangle extends sufficiently into the "blank" region outside the map.
  • 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.

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).
 
[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)
"9" key does nothing, instead of centering the Sky Map on Pluto - same in Linux.
  • [<,>] Advance clock forward/backward by one time step (clock will be paused if it isn't already).
 
Advance clock forward/backward by one time step (clock will be paused if it isn't already)
"<" and ">" keys do nothing - same in Linux.


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

  • Open a FITS image in the FITS Viewer tool [Ctrl+O].
  • Save Sky image [Ctrl+I].
 
Save Sky image [Ctrl+I]
Saving does not work at all in KStars. The path to the saved file seems to be wrong (Windows uses backslash (\) but KStars is trying to save using the Linux slash (/) symbol; see http://raphaelcojocaru.xyz/save_image.PNG ).
  • Run script [Ctrl+R].
 
Run script [Ctrl+R]
KStars doesn't run the script. It seems to be stuck with the "Running script" message.
  • Printing Wizard
  • Print [Ctrl+P] (print dialog opens)
  • Quit [Ctrl+Q]

Time Menu

  • Set time to now [Ctrl+E]
  • Set time [Ctrl+S]
  • Advance one step backward in time
  • Start/Stop clock
  • Advance one step forward in time

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]
  • 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
 
Telescope wizard
Telescope wizard is missing.
  • 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.
Device manager
 
Device manager
The devices list from the Local/Server is disabled. You can not select any device from the list.
  • Device manager allows the user to start/shutdown device drivers and connect to remote INDI servers.
  • Device manager has a list of devices, containing device name, status and mode.
  • Device manager has a Server Log box that contains information for every running device.
  • Starting in Local mode creates an INDI server and connects to it.
  • Starting in Server mode only creates a server, KStars does not connect to it.
  • Starting one driver in Local mode works.
  • Starting multiple drivers in Local mode works.
  • Stopping one driver does not stop server.
  • Stopping multiple drivers does not stop server.
  • The Run Service button enables the user to run selected device.
  • The Stop Service button enables the user to stop selected device.
  • The Close button enables the user to close Device Manager windows.
  • In the Client tab, the user can Add/Modify/Remove a host.
  • In the Client tab, the user can establish/stop a connection by pressing the Connect/Disconnect buttons.
INDI Control panel
  • INDI Control Panel allows users to control all the features supported by a device.
Configure INDI

Tools Menu (test opening tools only here)

  • Calculator [Ctrl+C]
  • Devices
  • Sky Calendar
  • Altitude vs. Time [Ctrl+A]
  • What's Up Tonight [Ctrl+U]
  • What's Interesting [Ctrl+W]
  • Script Builder [Ctrl+B]
  • Solar System [Ctrl+Y]
  • Ekos [Ctrl+K]
  • Jupiter's Moons [Ctrl+J]
  • Flags

Observation Menu

  • Observation Planner [Ctrl+L]
  • Execute the session Plan [Ctrl+2]

Observation Planner [Ctrl+L]

  • The user can open an observation session list.
 
The user can open an observation session list
KStars can't open an observation session list. It seems that the path to the file is wrong (Windows uses backslash (\) but KStars is trying to open a file using the Linux slash (/) symbol).
  • The user can open the Observing List Wizard.
  • The observation session can be saved using Save/Save as buttons.
 
The observation session can be saved using Save/Save as buttons
Saving does not work at all in KStars. The path to the saved file seems to be wrong (Windows uses backslash (\) but KStars is trying to save using the Linux slash (/) symbol; see http://raphaelcojocaru.xyz/save_image.PNG ).
  • The user can easily set up the current Location and Date.
  • More objects can be added to the list by using the Find Object or What's up Tonight tool.
  • An image can be added to an object by pressing the Find Image button on the right .
  • Within the Find Image window, the user can open an image from his hard drive.
  • The Download all Images button downloads the SDSS/DSS images of all the objects in the current list.
  • The Delete all Images button deletes the stored DSS/SDSS images.
  • The Delete button deletes the current set image.
  • The Make window small button shrinks the size of the Observation Planner window.

Execute the session Plan [Ctrl+2]

  • The user is able to see some information about the selected object and also to add observing notes.
  • The user is able to add new objects to the list using Add new object to list button.
  • The user is able to remove the selected object from the list by pressing Remove object from list button.
  • The user is able to enter and set session detailsː Location, Begin time of the session, Weather, Equipment, Comments and Language.
  • By pressing the Next Page button the user will access the second page of Session Plan, that contains information about equipment.
  • Pressing the Next Target button will cause the Execute Session to open the first window again for the next object.
  • By pressing the End Session button, the user will save and end the current session.
 
By pressing the End Session button, the user will save and end the current session
Saving does not work at all in KStars. The path to the saved file seems to be wrong (Windows uses backslash (\) but KStars is trying to save using the Linux slash (/) symbol; see http://raphaelcojocaru.xyz/save_image.PNG ).
  • By pressing the Close button, the Execute Session window will be closed.

Settings Menu

  • Infoboxes Display toggles
  • Toolbar display toggles
  • Toolbar customization
  • Statusbar display toggles
  • Color scheme toggles
  • Field-of-view (FOV) Symbol selector
  • FOV Editor
  • Artificial Horizon
  • Configure Observation Logging
  • Geographic Location [Ctrl+G]
  • Configure Shortcuts
  • Configure Toolbars
  • Configure KStars
  • Startup Wizard

Configure Observation Logging

  • List your Equipment [Ctrl+0]
  • Manage Observer [Ctrl+1]

Help Menu

  • KStars Handbook [F1]
  • Tip of the Day
  • What's this? [Shift+F1]
  • Report Bug
  • About KStars
  • About KDE

Toolbars

Main toolbar

  • Zoom in/out
  • Find object...
  • Geographic
  • Set Time
  • Advance one step backward in time
  • Stop/Start clock
  • Advance one step forward in time
  • Set Timestep widget

View toolbar

  • Show stars
  • Show deep-sky objects
  • Show Solar system objects
  • Show supernovae
 
Show supernovae
They are not drawn on the Sky Map.
  • Show satellites
 
Show satellites
They are not drawn on the Sky Map.
  • Show constellation lines
  • Show constellation names
  • Show constellation art (BETA)
 
Show constellation art (BETA)
Constellation art is not drawn on the Sky Map.
  • Show constellation boundaries
  • Show Milky Way
  • Show equatorial coordinate grid
  • Show horizontal coordinate grid
  • Show opaque ground

INDI toolbar

  • Show Ekos
  • Show INDI Control Panel
  • Show FITS Viewer

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.
  • 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/IC catalog, Abell Planetary Nebulae Catalog, Sharpless HII region Catalog, Hickson Compact Groups, Tycho-2 Star Catalog, USNO NOMAD Catalog, Inline thumbnail images, Thumbnails for details window).
  • Each item gets downloaded and installed correctly.
  • For each item, the details window is opened by pressing the Details button.
  • By clicking on the author's name, the default email client will be opened enabling the user to easily send an email to the author.
  • Each item gets uninstalled correctly.
 
Each item gets uninstalled correctly
Uninstalling an add-on catalog does not remove it from the Catalogs list. Thus, its objects will remain drawn on the Sky Map, even though it has been already uninstalled.
  • The add-ons list can be ordered byː Newest, Rating, Most downloads or Installed.
  • The search method works 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.
  • Zoom in/out, Default zoom
  • Rotate Right
  • Rotate Left
  • Flip Horizontal
  • Flip Vertical
  • Mark/Unmark Stars works.
  • Statistics
  • Auto stretch
  • FITS header
  • Closing without save issues a warning dialog.
 
Closing without save issues a warning dialog
No warning dialog is displayed if the window is closed without save - same in Linux.
  • Save and Save As work.
 
Save and Save As work
Saving does not work at all in KStars. The path to the saved file seems to be wrong (Windows uses backslash (\) but KStars is trying to save using the Linux slash (/) symbol; see http://raphaelcojocaru.xyz/save_image.PNG ).
  • All shortcuts work (i.e. Ctrl+H for opening the FITS Header window).
 
All shortcuts work (i.e. Ctrl+H for opening the FITS Header window)
"Ctrl+H" shortcut for opening the FITS Header window does not work because it is ambiguous.


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.
 
Saves image to file
Saving does not work at all in KStars. The path to the saved file seems to be wrong (Windows uses backslash (\) but KStars is trying to save using the Linux slash (/) symbol; see http://raphaelcojocaru.xyz/save_image.PNG ).
  • Image matches screen display (without FOV or infobox overlays).

Run script

  • Executes the selected script.
 
Executes the selected script
KStars doesn't run the script. It seems to be stuck with the "Running script" message.
  • 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.
 
Highlighted object is centered in map when user hits return or presses Ok
Pressing the Return key does nothing.
  • Dialog message when a match fails; window does not close.
  • Up/Down arrow keys navigate the list of objects.
  • The Object Details window is opened by clicking on Details button.

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.

Artificial Horizon Manager

  • User can draw a region by defining a list of points that encompasses the blocked area.
  • User can add points manually, or by selecting them from the Sky Map.
  • Add Region button works.
  • Remove Region button works.
  • Save Regions button works.
  • A region's name can be changed by double clicking on its name.
  • The default regions names are likeː Region 1, Region 2 and so on.
  • Add Point button works.
  • Remove Point button works.
  • Clear all points button works.
  • Select points from the sky map button works.

Geographic location

  • Set the location by highlighting a city from the list.
  • The red crosshair's position on the map will be updated by highlighting a city from the list.
 
The red crosshair's position on the map will be updated by highlighting a city from the list
The map from Set Geographic Location window is missing (see http://raphaelcojocaru.xyz/missing_map.PNG ).
  • Use the City Filter to make searches easier.
  • Use the Province Filter to make searches easier.
  • Use the Country Filter to make searches easier.
  • Define a completely new location by pressing the Clear Fields button, and entering the data for the new location.
  • Use the Add City to List button to record a new custom version of some location.
  • Use the Remove City from List button to remove the selected location from the list.
  • Latitude, longitude and UT offset values for a given location must be correct.

Startup Wizard

  • Set Geographic location works.
  • Download Extra Data works.

Object Details (from popup menu)

  • The window is divided into a number of tabs depending on the selected object: General, Position, Links, Advanced and Log.
  • General tab contains names and catalog designations, object type, and magnitude (brightness).
  • Using the General tab, the current object can be added to Observing List.
  • Using the General tab, the current object can be centered in Map.
  • Using the General tab, the current object can be centered in Telescope.
  • Position tab contains object's Equatorial and Horizontal coordinates, as well as its rise, set and transit times.
  • In the Links tab, the internet links associated with this object can be managed.
  • Add custom links to the object using the Add Link button.
  • Modify or remove any link using the Edit Link and Remove Link buttons.
  • Query professional astronomical databases on the internet using The Advanced Tab.
  • Using the Log Tab, type in some text that will remain associated with this object's Details window.
  • User's notes are saved correctly such that they can be used next time in KStars.

Image viewer (from popup menu)

  • Selected image is shown; window is sized to fit image.
  • Authorship and copyright in statusbar.
  • Save button works.
 
Save button works
Saving does not work at all in KStars. The path to the saved file seems to be wrong (Windows uses backslash (\) but KStars is trying to save using the Linux slash (/) symbol; see http://raphaelcojocaru.xyz/save_image.PNG ).


Popup menu

  • The right click popup menu is context-sensitive, meaning its content varies depending on what kind of object you click on.
  • The name(s) of the object, and its type.
  • Rise, Transit, and Set times for the object.
  • Center & Track: Center the display on this location, and engage tracking. Equivalent to double-clicking.
  • Add flag.
  • Angular Distance To: compute the angular distance between two selected objects.
  • Details: Open the Object Details window for this object. (not available for all objects)
  • Attach/Remove Label.
  • Add/Remove from Observing List. (not available for all objects)
  • Add/Remove Trail. (not available for all objects)
  • Simulate eyepiece view,
  • Give image resources. (not available for all objects)
  • Give information resources. (not available for all objects)
  • Show SDSS Image. (not available for all objects)
  • Show DSS Image. (not available for all objects)

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.
  • 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.

Altitude vs. time

  • Find Object works.
  • Using the Plot button, an object's altitude curve is drawn smoothly and correctly.
  • Clear Fields button clears the Name, RA, Dec and Equinox text boxes.
  • Clear List button clears the entire plot.
  • The format for RA coordinate isː hh mm ss.s
  • The format for Dec coordinate isː dd mm ss.s
  • Zoom in works correctly.
  • Zoom out works correctly.
  • The plot can be smoothly panned using the mouse movement, keeping the limitations on the plot sides.
  • There should exist a zoom out limitation for the most dominant curve. The plot cannot be zoomed out pass today's curve.
  • Compute button will calculate the correct altitude for an object using a certain Local Time.
  • The Local Time can be set using the spin box or by entering manually the value.
  • The Local Time value must be correct. In example, you can't use an hour bigger than 23ː59.
  • The Rise/Set/Transit markers are drawn at the correct position on the curve.
  • The colors used for Rise/Set/Transit markers must match the colors marked on the buttonsː red for Rise, blue for Set and green for Transit time.
  • The opaque green ground must start at 0 degrees altitude.
  • The dashed line must indicate the correct time and must be drawn at the right position on the plot.
  • The curve of the current highlighted object from the list must be drawn with a thicker, white line, while the others curves must be drawn with a thinner, red line.
  • The Rise/Set/Transit markers must be drawn above the altitude curves.
  • The date and location can be updated using the Date & Location tab.
  • By hovering the mouse above a curve, a black tool tip will appear, displaying the name of the object, the local sidereal time, the local time and the altitude value for that position.
  • Print button works.

What's up tonight

  • The date and location are correct.
  • 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.
  • Selecting the minimum magnitude works, and updates the list of object.
  • Selected object is displayed in right panel correctly.
  • The Rise/Set/Transit data are correct.
  • Center Object button works.
  • Details button works.
  • Add to List button adds the selected object to the Observing list.

What's Interesting

  • User can rate how light-polluted is the night-sky.
  • A rating can have values in range 1 to 9.
  • Clicking on the Wikipedia link will open the Bortle dark-sky scale in the default web browser.
  • The Defaults button will reset the rating value to 4, which is the default value.
  • User can set the equipment settingsː equipment type and parameters.
  • The Telescope and Binoculars check boxes work.
  • User can add a new telescope by pressing the Add new telescope button, which will open the Configure Equipment window.
  • In the Configure Equipment window, user can save or remove an equipment from the list.
  • In the Configure Equipment window are four tabs (Telescope, Eyepiece, Lens and Filter) and each tab contains specific parameters for current equipment type.
  • The Defaults button works.

Script builder

  • Short documentation for the function highlighted in the Function Browser is correct.
  • When a function is highlighted in the Current Script box, the Function Arguments panel will contain items for specifying values for any arguments that the highlighted function requires.
  • New Script button creates a new empty script.
  • Open Script button enables the user to use a script that already exists in the system.
  • Save Script/Save Script As buttons are correctly saving the current script, letting the user to choose the desired location of the saving.
  • Pressing Test Script will correctly run the current script in the main KStars window.
 
Pressing Test Script will correctly run the current script in the main KStars window
KStars doesn't run the script. It seems to be stuck with the "Running script" message.
  • Add Function button adds the currently-highlighted function in the Function Browser to the Current Script box (you can also add a function by double-clicking on it).
  • Remove Function button removes the currently-highlighted function from the Current Script box.
  • Copy Function button duplicates the currently-highlighted function from the Current Script box.
  • Move Up/Move Down buttons enable the user to set the desired running order of the functions.
  • A warning dialog will pop-up if the New Script button is pressed and the current script has unsaved changes.

Solar system

  • Solar System Viewer displays a model of our solar system as seen from above.
  • The display can be zoomed in and out with the + and - keys or by using the mouse scroll.
  • The display can be centered with the arrow keys, or by double-clicking anywhere in the window with the mouse.
 
The display can be centered with the arrow keys, or by double-clicking anywhere in the window with the mouse
Double click will make KStars to crash - same in Linux.
  • The display can be also centered on a planet with the 0–9 keys (0 is the Sun; 9 is Pluto).
 
The display can be also centered on a planet with the 0–9 keys (0 is the Sun; 9 is Pluto)
Pressing 9 does nothing and pressing 8 will make KStars to crash - Same on Linux
  • The timestep can be adjusted.
  • The Today button reset the display to its default state.
  • The Stop/Run button enables the user to stop/continue the simulation.

Jupiter's moons

  • This tool displays the positions of Jupiter's four largest moons (Io, Europa, Ganymede, and Callisto) relative to Jupiter, as a function of time.
  • Each track is assigned a different color to distinguish it from the others; the name labels at the top of the window indicate the color used by each moon.
  • The time axis can be expanded or compressed using the + and - keys.
  • The graph can be moved up or down by pressing the [ and ] keys.
  • The Close button closes the window.

Flags

  • Flags manager allows the user to mark flags on the map by giving the RA/Dec coordinates.
  • Add button works.
  • Save changes button works.
  • The user can set a custom label, a label color and an icon for a flag.
  • The Flag manager window contains documentation for how to add custom icons in KStars.
  • Delete button will remove the highlighted flag from the list and from KStars Sky-Map.
  • Centre in Map button works.
  • Centre in Telescope button works.
  • If KStars did not find any active telescopes, then a warning dialog will pop up.

Details window

  • Displays object information.
  • Add to Observing List works.
  • Centre in Map button works.
  • Centre in Telescope button works.
  • If KStars did not find any active telescopes, then a warning dialog will pop up.
  • Testing Resource links works.
  • Editing Resource links works.
  • Removing resource links works.
  • Interacting with online databases works.
  • User can record any observation logs.
  • The observation logs are saved, such that they can be used next time when KStars is opened.

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.
  • Loading an image from the computer works.
  • Unset Image button works.
  • KIO jobs are terminated in the console after quitting KStars.
 
KIO jobs are terminated in the console after quitting KStars
KIO jobs are not terminated in the console after quitting KStars.


INDI

Ekos

  • By default, Ekos uses Simulators profile.
  • The Simulators profile can not be removed from the Profile list.
  • The user can add a new device profile using the Add profile button and then Save button.
  • The user can remove a profile using the Remove profile button.
  • The new profiles that has been added are kept when a new KStars instance is opened.
  • The profiles that has been removed from the lists will not come back when a new KStars instance is opened.
  • The Edit profile button opens the Profile Editor, enabling the user to modify the current profile.
  • INDI starts by pressing Start INDI button.
  • The device can be connected using Connect button.
  • The device can be disconnected using Disconnect button.
  • Once a device is connected, a number of tabs will come up: Mount, CCD, Focus, Align and Guide.
  • Test the Scheduler, Mount, CCD, Focus, Align and Guide tabs.

Configuration window

Sky Projections

  • Lambert Azimuthal Equal Area
  • Azimuthal Equidistant
  • Orthographic
  • Equirectangular
  • Streographic
  • Gnomonic



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

  • kstars.exe remains opened in console.