Planetarium Main Page
Technical Background

The DOGULEAN Planetarium 3.0
Quick Reference

Click the button above to toggle between "Basic" and "Advanced".

"Basic" describes only the items on the Control Panel that are visible by default. "Advanced" includes the items that appear when you click the "+" buttons beside the section headings on the Control Panel.

The instructions below assume that you have a standard 3-button mouse (two buttons and a mouse wheel) or a touch screen. If that is not what you have, there is a table of equivalents below, under Pointers.

Accessing the Control Panel

Note that the things you may do most can be controlled by clicking or dragging on the screen.
Control Panel
ShowRight mouse click or

Left mouse click on "Control" tab at middle left.

Hide"Hide" button or

Right mouse click

Restore All Defaults Reset all control settings to their original values, except for those under "Options".
Expand or shorten a sectionClick on +/− button.
Scroll up or downLeft mouse drag up or down on Control Panel.


Location consists of:
Location Change on Control Panel Change with Mouse Comments
Home Planet or Moon "Home" drop menu on control panel.

Will contain all planets plus moons of current planet.

Sun will stay in the same position (on or off screen) and new Home Planet will be in same position (on or off screen) as the old Home Planet was.
Click on another planet or moon ("jaunting"). After jaunting, the center of your old home planet will be at the place on screen where the center of your new home planet used to be.

The planet or moon you jaunt to will be the first one listed in the info bar unless that is your home planet. In that case, you will jaunt to the second planet listed, if there is one.

You cannot jaunt while tracking. (Tracking is defined below.)

In Free mode, your position and direction of view do not change when you select a home planet on the control panel or jaunt. In Free mode only, jaunting is allowed when tracking.
Longitude and latitude Left mouse drag on planet. Set altitude ≥ 1.1 first, or not much will happen. Longitude and latitude are those of point below you on your home planet. They are shown (Long. and Lat.) beside Location heading.
Altitude Slider or number box. The number box has up and down arrows when selected. Turn mouse wheel Distance from Home Planet's center. Unit is Home Planet's radius.
Floating or fixed position "Floating"/"Fixed" toggle button. "Fixed" means you stay over the same point on the planet.

"Floating" means that you don't go around with the planet as it turns. You still go with it as it orbits the Sun.

When "floating", your longitude will change continuously as time changes.

Floating, fixed, or free position Third choice for "Floating"/"Free"/"Fixed" toggle button.
Enabled under "Options"
In Free mode, you move freely in space. Your position is still expressed in latitude, longitude, and altitude on your home planet, but you do not move with the planet at all. If you change planets, your position in space does not change. You can fly toward your new planet by reducing altitude.
Long., Lat. Sliders and number boxes More accurate for setting location on planet than dragging on the planet.

Useful for stargazing if you want to view the sky from a specific place that is not where you are.

Location Decimals Slider and number box. Control the number of decimal places shows in the number boxes under Location.
Set From GPS Button (appears only when home planet is Earth) Sets current longitude and latitude to that provided by the computer.

User must grant permission for Planetarium to receive this information.


The View consists of: The trackball is the little grey ball at the upper left corner of the planetarium window. >
View Change on Control Panel Change with Mouse or Touch Comments
View Point
(Point at center of planetarium window)
Left mouse drag anywhere off of home planet and trackball.

Left drag on trackball will change it faster.

Equatorial coordinates of view point are shown on "View" line.
RA = "Right Ascension" = sky version of longitude
D = Dec = Declination = sky version of latitude
(Which way is up)
Left-drag the mouse along the very bottom of the Planetarium window.
(Screen Magnification)
Zoom slider and number box Turn mouse wheel with mouse anywhere off of home planet Increasing zoom increases screen refresh rate up to a max of 10 per second.
That causes the Planetarium to use more computational power.
Look At
(a planet)
"Look At" drop menu. Bring selected planet to center of Planetarium window, with its north pole pointing up.

The planet you are looking at may be behind your home planet!

(the stars or a planet)
"Track" drop menu. Tracking Stars keeps the same view point at the center of the screen as time passes.

Tracking a moon or planet or Sun keeps that object at the same point on or off screen.

You cannot jaunt while tracking.

If you change planets using the Planet drop menu on the Control Panel, the tracked planet, not the Sun, will stay in the same place on or off screen.

Track In Free mode, jaunting and ordinary planet change are the same, so you can jaunt while tracking.



Sliders and number boxes Pitch, yaw, and roll of the spacecraft you are flying.

In telescope terms, elevation and rotation are alt and azimuth.

May be useful if you are on the surface of a planet.

RA, Dec
Sliders and number boxes RA (Right Ascension) and Dec, or just D, (Declination) are the equatorial coordinates of the point in the sky you are looking at. They are planet specific – the same point will have different coordinates on different planets.

Bearing is the angle between "up" on the screen and north on your planet.

If you want to observe a particular star, say, a close double, and zoom way in on it, either track Stars or stop the clock, then set the equatorial coordinates you want.

View Decimals Slider and number box Control the number of decimal places shows in the number boxes under View.
Restore View Defaults Button Sets: Zoom = 1, Elevation = -89, Rotation = 0, Roll = 0, Tracking = None, View Decimals = 1, Can Roll = true.

Equatorial coordinates will depend on your Home Planet and Location on that planet.

Can Roll/No Roll Button Appears only when you are on or near the surface of a plane.

If you set No Roll, any movement will set Roll to 0, so that up onscreen will be up, the direction away from the center of your Home Planet.

Useful for stargazing.


How to get information about what you are seeing.

RA and D of a star or planet will depend on your Home Planet.

Information Change on Control Panel Change with Mouse or Touch Comments
Lines Lines button Planet's ecliptic (plane of its orbit around the Sun) is purple.

Equator and lines of longitude through the points where equator and ecliptic cross are gold.

Other lines of longitude and latitude are grey

Lines of declination (D or Dec) are spaced by 10°.

Lines of right ascension (RA) are spaced by 15° (the amount the Earth turns in one hour).

Star, Planet, and Constellation Labels No Labels/All Labels/Planet Labels button. Double-click cycles through labels. Star labels are color-coded by constellation. More labels will appear with zoom.

Planet labels are green. Moon labels are smaller and greenish.

Planet and moon labels decrease in size with distance and increase in size with zoom, but at a slower rate for both.

Planet and moon labels are meant to appear when they are needed. Planet labels should appear when you are too far away to recognize the planet and moon labels should disappear when the moon can no longer be distinguished from its planet.

Info Bar Mouseover star, planet, or moon Stars: name or number, constellation, position, brightness as magnitude (mag.) – smaller is brighter.

Planets: name, position, distance from viewer in AU or km.

1 AU = average distance of Earth from Sun.

Annotations On/Off Button If annotations are ON, a message will appear at lower left whenever you do something with a mouse button or with touch.

If you are making a video with the planetarium, that saves you from having to tell viewers about what you are doing that they can't see.

Date and Time

Date and Time always gives Earth dates and times. As anything else would be too hard to understand.
Date and Time Comments
Time settings Planetarium Date and Time. It should be obvious how to set most of these.
The up and down arrows to the right and left of the months select box will move forward or back through the months.
Use Real Time Set planetarium date and time from computer's date and time.
Does not change the timezone.
Toggle UTC Switch between timezone as set on computer (local) and UTC/GMT.
Time Rate Number of seconds of planetarium time that pass for each second of real time
UTC Offset
(UTC +)
In case you weant a timezone other than UTC or Local.

"Use Current Time" does not change this.

If this is nonzero, "Toggle UTC" will set local time.

Clock Running/Stopped Stopping the clock is useful if you have some setup that needs at or near a particular time.

"Use Current Time" will restart the clock.

Planet Max Magnification

This section mainly covers how much planets larger planets will appear than they should, in different situations.

There are two reasons why we need to magnify planets so we can see them well.

The magnification settings apply when a planet or moon is far away and there is no zoom. As we approach an object or zoom increases, its magnification is reduced until it reaches 1.0.

If you put the mouse on a planet or moon, the last item in the info bar shows how much it is being magnified now, not counting zoom.

Planet Max Magnification Comments
Planets All planets but the Sun, Home Planet, and Home Planets moons. Home planet always looks as big as it should.
Local Moons If Home Planet is a planet, "Local Moons" means its moons.

If Home Planet is a moon, local moons are the other moons of its parent planet.

Does not include Earth's moon.

Appears only when there are moons to which it applies.

Sun/Moon (and sometimes Earth) This is the maximum magnification for Sun and Moon. Earth should be magnified this much when it is viewed from the Moon without any Zoom. From farther away, Earth magnification will increase to that for planets, if that is bigger.
Sun Bright(ness) Affects how bright the planets look, not how bright the Sun looks.
Restore Planet Defaults Set Planet Magnification to 40, Local Moons to 1, Sun/Moon (and Earth) magnification to 5, Sun Brightness to 3.


There are settings for star brightness and color intensity. You probably won't want to use them very often, so they are "advanced".

On the surface of the Earth, stars color should be as it appears from Earth. In space stars appear bluer. The Earth's atmosphere absorbs about half of their blue light.

Stars Comment
Brightness Increasing this value makes dim stars brighter and bright stars bigger.
Color Level Intensity of star colors.

Try turning it up to 10 to see. At Color Level 1, stars are all white.

Restore Star Defaults Sets Brightness to 60 and Color Level to 5.


Options are permanent configuration settings that are not reset by pressing the "All Defaults" button.
Options Comment
Trackball On/Off Toggles the Trackball at upper left of the planetarium window.
NESW On/Off When you are on or near the surface of a planet, there can be markers for the 8 directions N, NE, E, SE, S, SW, W, NW.

This button turns them on or off.

Onscreen Controls (Yes/No/Maybe) "Yes" means the onscreen controls are always visible; "No", never visible; "Maybe" means that they are visible when the Control Panel is closed.
Free mode (Enabled/Disabled) When enabled, "Free" is added as an option to the "Fixed"/"Floating" toggle button.

Offscreen Controls

By default, when the control panel is closed, onscreen controls will appear at the upper right of the planetarium screen. The onscreen controls show the current home planet, buttons for (Use) Real Time and for Fixed or Floating position mode, and date-time components with arrows to adjust those components. These controls work about the same as the equivalent ones on the Control Panel, except that home planet is not a drop menu, it is just the name of the current home planet.

The idea of the Offscreen Controls is that they should be just enough to support a beatific meditative state when you close the control panel and go jaunting around the Solar System. Let me know if they are not, and say what else you really need.

If you would rather offscreen controls appear always or never, there is a setting for that under Options (Advanced settings).


Summary of how to use other pointer devices to get the same results as with a three-button mouse.
Three-button mouse Touch Buttonless Mouse Standard Touchpad Result Produced
Press left button One-finger touch Touch left side of mouse Press down with one finger

To left-drag, move mouse or finger while doing this.

With mousepad, can press with

one finger and drag with another.

Press right button Three-finger touch Touch right side of mouse Press down with two fingers Open or close Control Panel
Turn mouse wheel Pinch or spread two fingers Move a finger along middle of mouse Glide two fingers toward you or away Change Altitude or Zoom
Double click Double touch Double click Double click Cycle star and planet labels
Mouseover a star or planet (Brief!) One-finger touch Mouseover Mouseover Display info bar
Click on planet One-finger touch on planet and hold for 0.2 sec. Click Click Jaunt

The Greek Alphabet

Learn! Astound your friends!

The brighter stars in a constellation are usually given Greek letters. The order of the letters will be roughly the order of their brightness.

Α α Β β Γ γ Δ δ Ε ε Ζ ζ Η η Θ θ Ι ι Κ κ Λ λ
alpha beta gamma delta epsilon zeta eta theta iota kappa lambda
Μ μ Ν ν Ξ ξ Ο ο Π π Ρ ρ Σ σ Τ τ Υ υ Φ φ Χ χ Ψ ψ Ω ω
mu nu xi omicron pi rho sigma tau upsilon phi chi psi omega