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

From KDE TechBase
< Projects‎ | Edu‎ | KStars
Line 381: Line 381:


==== 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="#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="#0000AA">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="#0000AA">The Close button closes the window.</font>


=== Details window ===
=== Details window ===

Revision as of 09:40, 30 June 2016

 
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
INDI Control panel
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]

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 five tabs: General, Position, Links, Advanced and Log.
  • The window is divided into five tabs: 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 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.
  • Attach/Remove Label.
  • Add/Remove from Observing List.
  • 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

INDI

Ekos

Configuration window

Sky Projections

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



Discovered issues:

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

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

A: Will bring in Marble Widget eventually