# A Quick Tour of &kstars;

This chapter presents a guided tour of &kstars;, introducing many of its important features.

Here is a screenshot of the &kstars; main window:
Main Window

The above screenshot shows a typical view of the KStars program. You can see the sky display centered on Betelgeuse, the brightest star in the constellation Orion. Orion has just risen above the eastern horizon. Stars are displayed with realistic colors and relative brightnesses. M 42, the Orion Nebula, is visible on the right side of the screen, just above the horizon. If you look closely, you can also see the Sun and the planet Mercury in the upper left. In three corners of the sky display, there are on-screen text labels displaying data on the current time (LT: 06:44:58 20 June 2004), the current Geographic Location (Tucson, Arizona, USA), and the current object in the center of the display (Focused on: Betelgeuse (alpha Orionis)). Above the sky display, there are two toolbars. The main toolbar contains shortcuts for menu functions, as well as a time-step widget which controls how fast the simulation clock runs. The view toolbar contains buttons that toggle the display of different kinds of objects in the sky. At the bottom of the window, there is a status bar which displays the name of any object you click on, and the sky coordinates (both Right Ascension/Declination and Azimuth/Altitude) of the mouse cursor.

## The Setup Wizard

The first time you run KStars, you will be presented with a Setup Wizard, which allows you to easily set your geographic location and download some extra data files. You can press the Finish button at any time to exit the Setup Wizard.

The first page of the Setup Wizard allows you to choose the starting geographic location, by selecting from the list of the 2500+ known locations on the right side of the window. The list of locations can be filtered to match the text you enter in the City, Province, and Country edit boxes. If your desired location is not present in the list, you can select a nearby city instead for now. Later on, you can add your precise location manually using the Set Geographic Location tool. Once you have selected a starting location, press the Next button.

The second page of the Setup Wizard allows you to download extra data that are not included with the standard distribution of &kstars;. Simply press the Download Extra Data button to open the Get New Stuff tool. When you are all done, press the Finish button in the Setup Wizard to start exploring &kstars;.

The Download Extra Data tool is only available if you have KDE 3.3.x installed.

## Have a Look Around

Now that we have the time and location set, let us have a look around. You can pan the display using the arrow keys. If you hold down the &Shift; key before panning, the scrolling speed is doubled. The display can also be panned by clicking and dragging with the mouse. Note that while the display is scrolling, not all objects are displayed. This is done to cut down on the CPU load of recomputing object positions, which makes the scrolling smoother (you can configure what gets hidden while scrolling in the Configure &kstars; window). There are seven ways to change the magnification (or Zoom level) of the display:

1. Use the + and - keys

2. Press the Zoom In/Zoom Out buttons in the toolbar

3. Select Zoom In/Zoom Out from the View menu

4. Select Zoom to Angular Size... from the View menu. This allows you to specify the the field-of-view angle for the display, in degrees.

5. Use the scroll wheel on your mouse

6. Drag the mouse up and down with the &MMB; pressed.

7. Hold down &Ctrl; while dragging the mouse. This will allow you to define a rectangle in the map. When you release the mouse button, the display will zoom to match the rectangle.

Notice that as you zoom in, you can see fainter stars than at lower zoom settings.

Zoom out until you can see a green curve; this represents your local horizon. If you have not adjusted the default &kstars; configuration, the display will be solid green below the horizon, representing the solid ground of the Earth. There is also a white curve, which represents the celestial equator, and a tan curve, which represents the Ecliptic, the path that the Sun appears to follow across the sky over the course of a year. The Sun is always found somewhere along the Ecliptic, and the planets are never far from it.

## Objects in the Sky

&kstars; displays thousands of celestial objects: stars, planets, comets, asteroids, clusters, nebulae and galaxies. You can interact with displayed objects to perform actions on them or obtain more information about them. Clicking on an object will identify it in the status bar, and simply hovering the mouse cursor on an object will label it temporarily in the map. Double-clicking will re-centre the display on the object and begin tracking it (so that it will remain centred as time passes). Right clicking an object opens the object's popup menu, which provides more options.

### The Popup Menu

Here is an example of the right click popup menu, for the Orion Nebula:

Popup Menu for M 42
Popup Menu for M 42

The appearance of the popup menu depends somewhat on the kind of object you right-click on, but the basic structure is listed below. You can get more detailed information about the popup menu.

The top section contains information labels (which are not selectable). The top one to three labels display the object's name(s) and object type. The next three labels show the object's rise, transit and set times. If the rise and set times say "circumpolar", it means that the object is always above the horizon for the present location.

The middle section contains items for performing actions on the object, such as Center and Track, Angular Distance To... (which enters the Angular Distance Mode, allowing you to measure the angle between objects in the sky), Details... (which opens the object's Object Details window), Attach Label and Add/Remove Trail (only available for Solar System bodies).

The bottom section contains links to images and/or informative webpages about the selected object. If you know of an additional &URL; with information or an image of the object, you can add a custom link to the object's popup menu using the Add Link... item.

### Finding Objects

You can search for named objects using the Find Object tool, which can be opened by clicking on the search icon in the toolbar, by selecting Find Object... from the Pointing menu, or by pressing &Ctrl;F. The Find Object window is shown below: Find Object Window Find Object Window

The window contains a list of all the named objects that &kstars; is aware of. Many of the objects only have a numeric catalogue name (for example, NGC 3077), but some objects have a common name as well (for example, Whirlpool Galaxy). You can filter the list by name and by object type. To filter by name, enter a string in the edit box at the top of the window; the list will then only contain names which start with that string. To filter by type, select a type from the combo box at the bottom of the window.

To centre the display on an object, highlight the desired object in the list, and press Ok. Note that if the object is below the horizon, the program will warn you that you may not see anything except the ground (you can make the ground invisible in the Display Options window, or by pressing the Ground button in the View toolbar).

&kstars; will automatically begin tracking on an object whenever one is centred in the display, either by using the Find Object window, by double-clicking on it, or by selecting Center and Track from its right-click popup menu. You can disengage tracking by panning the display, pressing the Lock icon in the Main toolbar, or selecting Track Object from the Pointing menu.

When tracking on a Solar System body, &kstars; will automatically attach an orbit trail, showing the path of the body across the sky. You will likely need to change the clock's timestep to a large value (such as 1 day) to see the trail.

This concludes the tour of &kstars;, although we have only scratched the surface of the available features. &kstars; includes many useful astronomy tools, it can directly control your telescope, and it offers a wide variety of configuration and customization options. In addition, this Handbook includes the AstroInfo Project, a series of short, interlinked articles explaining some of the celestial and astrophysical concepts behind &kstars;.