The KStars Handbook

Jason Harris

Core Developer: Jasem Mutlaq
Core Developer: James Bowlin
Core Developer: Heiko Evermann
Core Developer: Thomas Kabelmann
Core Developer: Pablo de Vicente
Core Developer: Carsten Niehaus
Core Developer: Mark Holloman
Revision 2.3.0 (Applications 15.04) (2015-01-28)

KStars is free, open source, cross-platform Astronomy Software. It provides an accurate graphical simulation of the night sky, from any location on Earth, at any date and time. The display includes up to 100 million stars, 13,000 deep-sky objects,all 8 planets, the Sun and Moon, and thousands of comets, asteroids, supernovae, and satellites. For students and teachers, it supports adjustable simulation speeds in order to view phenomena that happen over long timescales, the KStars Astrocalculator to predict conjunctions, and many common astronomical calculations. For the amateur astronomer, it provides an observation planner, a sky calendar tool, and an FOV editor to calculate field of view of equipment and display them. Find out interesting objects in the "What's up Tonight" tool, plot altitude vs. time graphs for any object, print high-quality sky charts, and gain access to lots of information and resources to help you explore the universe! Included with KStars is Ekos astrophotography suite, a complete astrophotography solution that can control all INDI devices including numerous telescopes, CCDs, DSLRs, focusers, filters, and a lot more. Ekos supports highly accurate tracking using online and offline astrometry solver, autofocus and autoguiding capabilities, and capture of single or multiple images using the powerful built in sequence manager.

Table of Contents

1. Introduction
2. A Quick Tour of KStars
The Setup Wizard
Have a Look Around
Objects in the Sky
The Popup Menu
Finding Objects
Centering and Tracking
Keyboard Actions
End of the Tour
3. Configuring KStars
Setting the Geographic Location
Setting the Time
The Configure KStars Window
Solar System
Customizing the Display
4. Command Reference
Menu Commands
File Menu
Time Menu
Pointing Menu
View Menu
Tools Menu
Data Menu
Observation Menu
Settings Menu
Help Menu
Popup Menu
Keyboard Commands
Navigation Keys
Menu Shortcuts
Actions for the Selected Object
Tools Shortcuts
Mouse Commands
5. The AstroInfo Project
AstroInfo: Table of Contents
Celestial Coordinate Systems
The Equatorial Coordinate System
The Horizontal Coordinate System
The Ecliptic Coordinate System
The Galactic Coordinate System
The Celestial Equator
The Celestial Poles
The Celestial Sphere
The Ecliptic
The Equinoxes
Geographic Coordinates
Great Circles
The Horizon
Hour Angle
The Local Meridian
The Zenith
Julian Day
Leap Years
Sidereal Time
Time Zones
Universal Time
Aperture and Focal Ratio
Field of View
Types of Telescopes
Optical Telescopes
Observations in Other Wavelengths
Space-Based Observations
Blackbody Radiation
Dark Matter
Retrograde Motion
Elliptical Galaxies
Spiral Galaxies
Magnitude Scale
Stars: An Introductory FAQ
Star Colors and Temperatures
Cosmic Distance Ladder
Direct measurements
Standard candles
Other methods
6. KStars Tools
Object Details Window
The Astrocalculator
Angular Distance module
Apparent Coordinates module
Ecliptic Coordinates module
Equatorial/Galactic Coordinates module
Horizontal Coordinates module
Geodetic Coordinates module
Planet Coordinates module
Day Duration module
Equinoxes and Solstices module
Julian Day module
Sidereal Time module
Altitude vs. Time Tool
What's Up Tonight? Tool
The Script Builder Tool
Introduction to the Script Builder
Using the Script Builder
Solar System Viewer
Jupiter Moons Tool
Observation Planner
FITS Viewer Tool
7. Command-Line mode for Image Generation
8. Astronomical Device Control with INDI
INDI Setup
Telescope Setup
CCD and Video-Capture Setup
Configure INDI
INDI Concepts
Remote Device Control
Running an INDI server from the command line
Secure Remote Operation
INDI Frequently Asked Questions
9. Questions and Answers
10. Credits and License
A. Installation
How to obtain KStars
Compilation and Installation