[Kstars-devel] QA list for 3.5
Jason Harris
kstars at 30doradus.org
Tue Sep 6 02:02:41 CEST 2005
Hello,
Better late than never: I have attached the KStars QA list for 3.5. It's
almost identical to the 3.4 list, with just a few additions for the new
features. If you recall, I didn't have time to complete this list for the
3.4 release, so I have left those items which were marked broken or only
partially functional are still marked that way.
I will be attempting to go through the list this week, fixing issues as I find
them. I invite you to join me. 3.5-beta1 is to be tagged next weekend.
regards,
Jason
--
KStars: KDE Planetarium
http://edu.kde.org/kstars
-------------- next part --------------
List of tests for KStars for KDE 3.3:
======================================
C = Correct behavior
B = Bug associated with this function (mostly works)
X = Does not work
U = Usability issue
N = Not applicable (or Nevermind)
_ = not tested yet
(o): This feature is optional; active and disabled states
should be tested
======================================
I. Mouse Navigation.
_ Moving mouse shows the current sky coordinates of the mouse
cursor in the status bar.
_ Click with mouse identifies nearby object in statusbar.
_ The object's Long Name is shown.
_ If more than one object is nearby, selection priority is based on
object catalog or type:
Solar system > Messier > NGC > IC > Star
_ (o) Hovering the mouse attaches a temporary label to the nearest
object. This only happens when the sky is not slewing.
_ (o) Double-click attaches a label to the nearest object, centers
it in the display, and engages tracking. The label uses the
object's Primary Name. The label is temporary, and is removed
when object is no longer centered.
_ Click and drag moves the skymap such that the position of the
cursor on the sky remains roughly constant. Doing this
disengages tracking.
_ Dragging the sky up to a pole does not result in the display
getting "stuck" or otherwise behaving oddly.
_ Click-and-drag with Ctrl pressed draws a rectangle on the map
that defines the new area to be displayed when the LMB is
released.
_ Click-and-drag with MMB zooms in and out according to the
vertical motion of the mouse.
_ Right-click opens a context-sensitive popup menu (see below).
_ Scrolling the mouse wheel zooms the display in and out.
II. Keyboard Commands (excluding menu items)
_ Arrow keys: Scroll the display.
_ Holding Shift increases the scroll speed by 10x.
_ The numbers 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).
Object Action keys:
N C: Track object
[N: this feature is missing; can't add until feature thaw]
_ D: Open the Details window
_ L: Attach/Remove label
_ O: Add object to observing list
_ T: Attach/remove trail (solar system only)
_ </>: Advance clock forward/backward one timestep
(these keys will pause the clock if not already paused)
III. Menu Functions (check keyboard shortcuts as well)
Here we just check basic functionality; if an item launches a window,
the window's function is tested elsewhere, just make sure it opens
correctly here
File Menu:
_ New Window: open secondary KStars window [Ctrl+N]
_ Close Window: close current KStars window [Ctrl+W]
_ Download Data...: open Get New Stuff tool (see Dialogs) [Ctrl+D]
_ Open FITS Image...: open the FITSViewer tool (see Dialogs) [Ctrl+O]
_ Save Sky Image...: export current sky image to disk [Ctrl+I]
_ Run Script...: execute a DCOP script [Ctrl+R]
_ Print: Print the current skymap [Ctrl+P]
_ Quit: Exit application [Ctrl+Q]
Time Menu:
_ Set Time to Now [Ctrl+E]
_ Set Time... (see Dialogs) [Ctrl+S]
_ Start/Stop Clock [toggle]
Pointing Menu:
_ Zenith/North/East/South/West [Z/N/E/S/W]
_ Set Focus Manually... (see Dialogs) [Ctrl+M]
_ Find Object... (see Dialogs) [Ctrl+F]
_ Track Object [toggle] [Ctrl+T]
View Menu:
_ Zoom In [+; Ctrl++]
_ Zoom Out [-; Ctrl+-]
_ Default Zoom [Ctrl+Z]
_ Zoom to Angular size... [Ctrl+Shift+Z]
_ - dialog is preloaded with current angular size value
_ - dialog does not accept out-of-range values
_ Full Screen Mode [Ctrl+Shift+F]
_ Equatorial/Horizontal Coordinates [Space] [toggle]
Devices Menu (see Devices):
_ Telescope Wizard...
_ Device Manager...
_ INDI Control Panel...
_ Capture Image Sequence...
_ Configure INDI...
Tools:
_ Calculator (see Dialogs) [Ctrl+C]
_ Observing List (see Dialogs) [Ctrl+L]
_ AAVSO Light Curve Generator (see Dialogs) [Ctrl+V]
_ Altitude vs. Time (see Dialogs) [Ctrl+A]
_ What's Up Tonight? (see Dialogs) [Ctrl+U]
_ Script Builder (see Dialogs) [Ctrl+B]
_ Solar System Viewer (see Dialogs) [Ctrl+Y]
_ Jupiter Moons Tool (see Dialogs) [Ctrl+J]
Settings Menu:
InfoBoxes:
_ Show Infoboxes [toggle]
_ Show TimeBox [toggle]
_ Show GeoBox [toggle]
_ Show FocusBox [toggle]
Toolbars:
_ Show Main Toolbar [toggle]
_ Show View Toolbar [toggle]
Statusbar:
_ Show Statusbar [toggle]
_ Show Az/Alt Field [toggle]
_ Show RA/Dec Field [toggle]
Color Schemes:
_ shows all available schemes, predefined and custom
_ All color-settings change properly upon selecting new scheme
_ All color-settings persistent on reload
_ Schemes appear in menu upon creation in options dialog
_ Schemes are removed from menu upon removal in options dialog
FOV Symbols:
_ None/7x35 Binos/One Degree/HST present by default,
but may be removed by user
_ Checkbox drawn by current selection
_ Edit FOV Symbols... launches tool (see Dialogs)
_ Set Geographic Location... (see Dialogs) [Ctrl+G]
_ Configure KStars... (see Dialogs)
_ Startup Wizard... (see Dialogs)
Help:
_ HandBook [F1]
_ Tip of the Day
_ Report Bug...
_ About KStars
_ About KDE
IV. Toolbars
Main Toolbar:
_ Fullscreen, Zoom In, Zoom Out, Default Zoom, Track, Find,
GeoLocation, Configure, Set Time, Start/Stop Clock
_ TimeStep widget adjusts time step
_ First pair of buttons cycles through every timestep
_ Second pair of buttons cycles through even-unit timesteps
_ Cannot set value outside allowed range
_ Entering a value manually does nothing
_ Zoom buttons disabled when at limit of zoom range
X Track button is auto-toggled whenever an object is centered
View Toolbar:
_ Stars, Deep sky, Solar system, CLines, CNames, CBounds,
Milky Way, Grid, Ground/Horizon: toggle display of appropriate
objects
_ Some are "meta-options", these should interact properly
with the individual options
V. Center and Track
_ Center on Object
_ Center on Nothing
_ Track on Object
_ Track on Nothing
_ Ask to confirm if new position is below horizon
_ Ask for reposition if startup position is below horizon
_ Coordinates in Focus InfoBox update correctly under all tracking conditions
VI. InfoBoxes
_ Highlight on click
_ Shade on double click
_ Move on drag
_ collision detection is robust
B edge sticking is robust
[B: right-edge sometimes becomes unstuck]
_ remember positions and shade states on restart
VII. Dialogs
Print:
X Prints image of the current skymap (without infoboxes or FOV symbols)
[X: generated postscript not valid!]
_ Asks to reset color scheme if sky color is not white.
_ Color scheme properly reset after printing
_ The printed image is reasonably similar to the screen image
Get New Stuff:
_ Displays list of available files and indicates which have
been installed
_ Download, install, and incorporate selected data
FITS Viewer:
_ File Dialog displays only FITS images
_ Opens FITS files properly; display image size in statusbar
_ moving mouse shows X,Y and pixel value in status bar
_ Undo/Redo
_ Zoom in/Zoom out/Zoom default
_ Toolbar fcns: Brightness/Contrast, Histogram, Image statistics,
FITS header, Image reduction
_ Image reduction tool works
_ Closing window with unsaved changes opens warning dialog
Image Viewer (from popup menu)
_ Image displays correctly
B Credits line in statusbar
[B: DSS image credit line does not indicate public domain]
_ Close/Save buttons work
Set Time:
_ Time set correctly
B It is not possible to enter an invalid date/time
[B: Using the year arrow buttons, it is possible to go beyond
the year limits (-50000 to +50000)]
Find Object:
_ Filtering by name and/or object-type works
_ Warning message if selected object is below horizon
_ center and track on selected object
_ No action if no valid object selected
_ invalid object shows message box, does not close window
Set Focus Manually:
_ Resets focus to given coordinates
_ Tracking engaged for Equatorial coords, not for Horizontal
_ Both RA/Dec and Alt/Az modes work
_ Epoch box works in RA/Dec mode
B Fails gracefully on invalid coordinates
[B: RA coordinate is wrapped]
Set Geographic Location:
_ Sets location to highlighted city in listbox
_ red cross on map at position of selected city
_ Map pins highlighted for cities which match filters
_ The three name filters work as expected
_ clicking in map selects nearby cities
_ data for selected city is presented at bottom
U "Explain DST rules" launches window listing DST rules
[U: the window should have a larger minimum size]
_ "Clear fields" clears the data fields
_ When data fields are modified and both city and country fields
are filled, the "Add to List" button is activated, and
correctly adds the custom location to the list.
_ Newly added custom location is selected in the list
_ Custom locations loaded on subsequent restarts.
Configure KStars:
B In general: Changes are applied when "Apply" is pressed, and
revert if "Cancel" is selected
[B: Cancel button doesn't really work and hasn't for a while]
+ Catalogs:
_ checkboxes toggle display of catalogs (stars/Messier/NGC/IC)
_ Faint limits for stars work
_ Max zoom-out faint limit restricted to zoom-in limit value
U Star-name faint limit and name/mag checkboxes for stars work
[U: Should update when changed, like draw faint limit does]
_ When Star Catalog unchecked, related options are disabled
N Faint limits for deep-sky work
N Max zoom-out faint limit restricted to zoom-in limit value
_ Add custom catalog opens a window to specify name of a
custom catalog file, and name for the catalog.
_ Custom catalog tool parses data file as expected, skips lines
that cannot be parsed
_ Inform user of any lines in custom catalog that could not be parsed
_ Do not add catalog if no lines could be parsed
_ Custom catalog objects added properly
_ Custom catalog can be removed
+ Solar System:
_ checkboxes toggle display of bodies
(sun/moon/planets/comets/asteroids)
_ Select All/Select None buttons work
_ "use name labels"/"use images" checkboxes work
_ asteroid faint limits works (1: display; 2: names)
_ comet radial limit for names works
_ planet trail checkboxes work
_ "Remove all trails" button works
Guides
_ checkboxes toggle display
(CLines/CNames/MW/Grid/Equat.
/Eclip./Horz./Ground)
_ Select constellation-name style
(Latin/Localized/Abbreviated)
_ The CName button group is disabled when constell.
name is unchecked
_ Fill MW works, and is disabled when MW checkbox
is unchecked
Colors
_ Selectable colors present for all customizable
items in the skymap.
_ Update a color by clicking on it in the list
_ Star color mode combobox works
_ star color intensity spinbox works
B selecting a color scheme sets colors in the map,
and in the "Current Colors" listbox
[B: After removing a custom color scheme, other
custom schemes do not get applied from options
window, and "Remove" button not activated;
restarting KStars resolves it]
_ "Save Current Colors" asks for a name for the
new scheme, then adds it to the list of
schemes. Also added to Settings|Color
schemes submenu
_ "Remove color scheme" only activated if a custom
scheme is highlighted
Advanced
_ Checkboxes work as expected
_ The "minimum timescale to hide" timeBox works
_ When "Hide Objects" is unchecked, child options
are disabled
_ Hide Object timescale widget works
Startup Wizard:
_ Set geographic location
_ Download extra data
Calculator:
All modules behave as expected:
_ Angular distance
_ Apparent coordinates
_ Ecliptic coordinates
_ Equatorial/Galactic
_ Horizontal coordinates
_ Precession
_ Geodetic coordinates
_ Planet coordinates
_ Day duration
_ Equinoxes & Solstices
_ Julian day
_ Sidereal time
Batch modes work as expected:
_ Angular distance
_ Apparent coordinates
_ Ecliptic coordinates
_ Equatorial/Galactic
_ Horizontal coordinates
_ Precession
_ Geodetic
_ Planet coordinates
_ Equinoxes & Solstices
_ Sidereal time
Observing List:
_ Window is non-Modal
_ Adding objects to the list: "O" key, popup menu
_ Click column header to sort objects
_ Action buttons disabled when no object selected
_ "Center", "Scope", "Details" buttons disabled when
multiple objects selected
_ "Center" button centers and tracks on selected object
_ "Scope" button moves telescope to selected object
_ "Details" button opens the Details window for selected object
_ "Alt vs Time" shows AVT tool with selected object(s) shown
_ "Remove" button removes object from the list box and the
internal observing list.
_ Modified notes saved to disk and loaded/displayed properly
_ Objects in the Observing list are highlighted in the map
_ Observing lists can be saved and loaded
AASVO Light Curves:
_ Selecting a name auto-selects the designation
(and vice versa)
_ Selecting custom Start/end dates works
_ Fails gracefully if start date is after end date
_ plot average days works
_ checkboxes work as expected
_ update function works
Altitude vs. Time:
_ Entering an object name plots its curve
B Pressing "Enter" in name box adds the named object
if it exists in database; otherwise, the
input focus moves to the RA field.
[B: unnamed object does not advance focus on Enter]
B Entering a non-matching name and RA and Dec coords
adds custom object curve
[B: object added with J2000 coords, but display precesses them
to present epoch]
_ Can add an object to the list by pressing Enter key or "Plot" button"
X Fails gracefully if RA or Dec are invalid
(does not add object)
[X: Object is added with wrapped coordinates]
_ "Find Object" button launches Find Object window; selection
is plotted (and selection's coords displayed below)
_ "Clear Fields" button works
_ "Clear List" button works
X Does not add the same object twice
[X: due to precession problem above]
_ Highlighting item in listbox highlights its curve in
the plot, and displays that object's data in
the Sources tab
_ Resetting Date and/or Location updates the curves and
redraws the plot
_ Dragging mouse in plot window shows crosshairs at mouse position
What's Up Tonight:
_ Shows summary of all objects visible on the night of
the current simulation date from the current
location.
_ Evening/Morning/All Night combobox works
_ "Change Date" / "Change Location" work
_ Almanac data is correct (sun/moon rise/set times; moon phase)
_ Category selection works
_ Selecting an object shows its name, and rise/transit/set times
in the lower right panel
_ "Center Object" button centers the object in the main display
_ "Object Details" button opens Details window for selected
object
B: Make it non-modal
Details:
_ General Tab: object data properly displayed
_ Displays the user's thumbnail image, if one has been assigned
_ Clicking on the thumbnail opens the Thumbnail browser, which loads
images from the net into a listbox
_ Clicking on the edit button allows the selected image to be cropped
and/or recentered
_ The selected thumbnail is correctly assigned to the object's Details window
_ Rise/Set times match those in PopupMenu
_ Links Tab: attached links displayed; view/add/edit/remove
link buttons work
_ Advanced Tab: access to online databases works as
expected
_ Log Tab: attaching text to an object works, is
persistent across restarts
Script Builder:
_ Function Browser lists all available DCOP functions
(check w/kdcop)
_ Highlighting function in browser shows docu in lower panel
_ Add a function to the working script with dble-click or
left-arrow button
_ Highlighting function in current script box shows its
arg. widget below
_ arg widget values preserved when changing functions
_ remove function from working script with right-arrow button
_ copy function in working script with circle-arrow
("reload") button
_ move function in working script with up/down arrow buttons
_ File operation buttons (New/Open/Save/SaveAs) work
_ "Test Script" button works
_ Saved script can be executed from command line
_ Saved script can be executed with File|Run Script action
_ Attempt to close window with unsaved changes triggers warning
Solar System Viewer:
_ Displays position of planets for the current simulation
time/date
_ Planet labels present
_ +/- keys zoom in/out
_ Drag with mouse recenters
_ 0-9 recenters on planet
_ time widget works
_ set date works
Jupiter Moons Tool:
_ Plotted moon positions relative to Jupiter match display
_ Check positions against similar charts (e.g., by Sky & Telescope)
_ Name labels correct
_ +/- keys stretch timescale
_ [/] keys move central date
Edit FOV Symbols Tool:
_ Current FOV symbol preselected in listbox
_ Selected FOV is displayed in preview pane
_ New button launches dialog with clean edits
_ Edit button launches dialog with edits set
_ If new params accepted (Ok), new name appended to
listbox and is selected
_ If params are rejected (Cancel), no changes made
_ Any Symbol can be edited or deleted, even preset defaults
_ When symbol is removed, the adjacent symbol is selected.
_ If all symbols removed, then default set restored on
next startup
VIII. INDI
_ make sure it works ;)
_ Telescope wizard
_ Device Manager...
_ INDI Control Panel...
_ Capture Image Sequence...
_ Configure INDI...
_ CCD Preview tool
IX. Popup Menu
_ Contexts work: nothing, star (named/unnamed), solar system, skyobject
_ Name(s) display properly
_ Moon's phase description correct; matches Details window
_ Rise/Set/Transit times (check for circumpolar/never_rises too)
_ Center & Track (on nothing, on object)
_ Angular Distance tool
_ Add to Observing List
_ Details
_ Add/Remove Label (to named object only)
_ Attach Trail (to solar system object only)
_ ImageViewer (check save function)
_ Add custom URL
X. Error handling and Warning Messages
Missing data files:
_ critical file: exit program with error message
_ non-critical file: show error message, continue loading
Invalid entry data:
_ try to enter invalid data whenever possible to make sure it fails
gracefully
XI. DCOP functions
_ Use kdcop to test the dcop functions
Notes:
====================
More information about the Kstars-devel
mailing list