Projects/Edu/KStars/QA List 2.6.0

 

Under Construction
This is a new page, currently under construction!

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 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)
• [<,>] Advance clock forward/backward by one time step (clock will be paused if it isn't already)

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]
• Run script [Ctrl+R]
• 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

• Help button displays KStars hand book.
• Next/Back buttons work.
• Listed telescopes reflect system + user added telescopes.
• Setting Time and Location open the appropriate dialog boxes and perform the correct time or location updates.
• Setting port name initiate a scan for that specific port, whereas leaving the port empty initiates a complete auto port scan. Both actions can be canceled at any time.
• Automatic port scan.

Telescope properties

• Telescope list reflect system & user added telescope.
• Selecting a telescope update all property fields.
• Removing a telescope shows a confirmation box.
• Saving updated properties works.

Device manager

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

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 observation session can be saved using Save/Save as buttons..
• 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 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 satellites
• Show constellation lines
• Show constellation names
• Show constellation art (BETA)
• 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
• Show Device Manager

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 catalog, Ephemerides, Messier catalog thumbnails, Thumbnails for details window, updated DST rules)
• Each item gets downloaded and installed correctly

FITS viewer

• File open dialog displays only FITS files.
• FITS image is opened and displayed properly.
• Image coordinates, pixel value, image dimensions, and zoom value are displayed in status bar.
• Undo/Redo work
• Zoom in/out, Default zoom
• Statistics
• FITS header
• Closing without save issues a warning dialog
• Save and Save As work

Histogram tool

• Range of pixel values can be updated with edit boxes or by dragging the blue/red symbols: red symbol not draggable in initial position

Save sky image

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

Run script

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

Print

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

Set time

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

Set focus manually

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

Find object

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

Zoom to angular size

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

FOV symbol editor

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

Geographic location

• Set the location by highlighting a city from this list.
• Use the City Filter to make searches easier.
• Use the Province Filter to make searches easier.
• Use the Country Filter to make searches easier.
• Use the City 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.

Image viewer (from popup menu)

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

Popup menu

• 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)
• Show SDSS Image.
• Show DSS Image.

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

Observing List

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

Altitude vs. time

• Find Object
• Plot
• Clear Fields
• Clear List (clear the entire plot)
• Zoom in
• Zoom out
• Pan in every direction keeping the limitations
• Zoom out limitation for current most dominant curve
• Compute Altitude for desired Local Time
• Mark Rise/Set/Transit time

What's up tonight

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

Script builder

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

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 recentered with the arrow keys, or by double-clicking anywhere in the window with the mouse.
• The display can be also centered on a planet with the 0–9 keys (0 is the Sun; 9 is Pluto).
• 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 time displayed at the center of the window can be changed with the [ and ] keys.
• The Close button closes the window.

Details window

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

Thumbnail Picker

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

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 + button and then Save button. The user can remove a profile using the - 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.

Sky Projections

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

---

Discovered issues:

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

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

A: Will bring in Marble Widget eventually

---