[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kstars-devel
Subject:    [Kstars-devel] KStars 3.3 QA checklist
From:       Jason Harris <kstars () 30doradus ! org>
Date:       2004-07-24 17:54:36
Message-ID: 200407251052.58969.kstars () 30doradus ! org
[Download RAW message or body]

Hello,

Since we're in feature freeze prior to the KDE 3.3 release, it's time 
once again for a QA checklist.  This is just a list of all the things 
KStars is supposed to do.  The idea is that we go through the list, 
carefully testing each feature.  Much of the list may seem very 
obvious, but I've found this is a good way to discover bugs, and I have 
often been suprised where they are found lurking!

So, if you have time, it would be great if you could test some of these 
items, and report back here any bugs or misbehaviors you might find.

The list is attached.

thanks,
Jason
-- 
KStars: A KDE Planetarium
http://edu.kde.org/kstars

["KStars-3.3-QA-List" (text/plain)]

 List of tests for KStars for KDE 3.3:
======================================
C = Correct behavior
B = Bug associated with this function (mostly works)
X = Does not work
_ = 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

_       Mouse events outside of the valid mapping region are ignored.

_       (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 Navigation
_       Arrow keys scroll the display.
_       Holding Shift increases the scroll speed by 10x.

_       Pressing N,S,E,W keys centers the display on the cardinal points
        of the horizon.  Pressing Z centers on the Zenith.

_       +/- Zooms the display in and out.

_       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).

III. Menu Functions (check keyboard shortcuts as well)
Here we just check basic functionality; if an item launches a window,
the window 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)
_               AAVSO Light Curve Generator (see Dialogs)
_               Altitude vs. Time (see Dialogs)
_               What's Up Tonight? (see Dialogs)
_               Script Builder (see Dialogs)
_               Solar System Viewer (see Dialogs)
_               Jupiter Moons Tool (see Dialogs)

        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
X                       Checkbox drawn by current selection
_                       Edit FOV Symbols... launches tool (see Dialogs)

_               Set Geographic Location... (see Dialogs)
_               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
_               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
_       edge sticking is robust
_       remember positions and shade states on restart

VII. Dialogs
        Print:
_               Prints image of the current skymap (without infoboxes or FOV symbols)
_               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
_               Credits line in statusbar
_               Close/Save buttons work

        Set Time:
_               Time set correctly
_               It is not possible to enter an invalid date/time

        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
_               Fails gracefully on invalid coordinates

        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
_               "Explain DST rules" launches window listing DST rules
_               "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:
_               In general: Changes are applied when "Apply" is pressed, and
                        revert if "Cancel" is selected

                + 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
_                       Star-name faint limit and name/mag checkboxes for stars work
_                       When Star Catalog unchecked, related options are disable
_                       Faint limits for deep-sky work
_                       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.
_                       Warn user if any lines in custom catalog 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
_                       "Clear 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
_                       selecting a color scheme sets colors in the map,
                                and in the "Current Colors" listbox
_                       "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

        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
_               Pressing "Enter" in name box adds the named object
                        if it exists in database; otherwise, the
                        input focus moves to the RA field.
_               "Browse" button launches Find Object window; selection
                        is plotted (and selection's coords displayed below)
_               Entering a non-matching name and RA and Dec coords
                        adds custom object curve
_               Fails gracefully if RA or Dec are invalid
                        (does not add object)
_               "Clear Fields" button works
_               "Clear List" button works
_               Does not add the same object twice
_               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

        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
_               Sun and Moon rise/set times match those in popup menu
_               "More Information" launches Details window for selected
                        object
_               Moon's illumination fraction and phase description are
                        correct

        Details:
_               General Tab: object data properly displayed
_               Rise/Set times match those in PopupMenu
_               Links Tab: attached links displayed; 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

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


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
_       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:
====================



_______________________________________________
Kstars-devel mailing list
Kstars-devel@kde.org
https://mail.kde.org/mailman/listinfo/kstars-devel


[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic