Editing Orrery

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

Warning: This page is 33 kilobytes long; some browsers may have problems editing pages approaching or longer than 32kb. Please consider breaking the page into smaller sections.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
-
The orrery is a simple open-source application for [[Open development/Maemo roadmap/Fremantle|Maemo 5]] which displays the night (and day!) sky. It is nowhere near as elaborate as, for example, kstars, xephem or stellarium. It is intended to be a small, finger-friendly application, requiring no network connection. The current stable version is 3.8.x (the x just increments when bugs are fixed). The program version is shown on the "Symbol Key" page.
+
== Overview ==
-
The source code is hosted on [https://github.com/kenyoung/orrery this github repository]. The version there may not have gone through the Maemo Community QA testing. The most recent version which has been vetted by the community is available in the Maemo [[Extras]] catalog.  This wiki page describes the behavior of the version of the program available in the Extras Devel catalog.
+
'''Important note on upgrading to the 3.1.3-1 version'''. If you installed the original release of orrery (3.0), upgrading to version 3.1.3-1 will delete any location you have made to the orrery "Private Catalog". To prevent this, see "Preserving the private catalog" in the bugs section at the end of this page.
-
At this time, that version is also in the Extras catalog.
+
-
The star database was extracted from the [[:wikipedia:Hipparcos_catalog|Hipparcos catalog]]. To ease the computational load, the coordinates are not [[:wikipedia:Precession_(astronomy)#Astronomy|precessed]] or [[:wikipedia:Nutation#Of_the_Earth|nutated]] before being displayed. [[:wikipedia:Orbital_elements|Orbital elements]] are used, rather than [[:wikipedia:Ephemerides|ephemerides]], to calculate planet positions. Although this is less accurate, it dramatically reduces the memory footprint. The planet positions are accurate to a few arc minutes, from 3000 BC to 3000 AD. Since the scale on the default display is approximately 8 arc minutes per pixel, these small errors are imperceptible, unless a very large zoom factor is used.
+
The orrery is a simple open-source application for [[Open development/Maemo roadmap/Fremantle|Maemo 5]] which displays the night (and day!) sky. It is nowhere near as elaborate as, for example, kstars, xephem or stellarium. It is intended to be a small, finger-friendly application, requiring no network connection.  The current stable version is 3.1.x (the x just increments when bugs are fixed). The program version is shown on the "Symbol Key" page.
 +
 
 +
The most recent version of the program may be downloaded at
 +
[https://garage.maemo.org/projects/orrery/ from the garage project page]. The version there may not have gone through the Maemo Community QA testing. The most recent version which has been vetted by the community is available in the Maemo [[Extras]] catalog.
 +
 
 +
The star database was extracted from the [[:wikipedia:Hipparcos_catalog|Hipparcos catalog]]. To ease the computational load, the coordinates are not [[:wikipedia:Precession_(astronomy)#Astronomy|precessed]] or [[:wikipedia:Nutation#Of_the_Earth|nutated]] before being displayed. [[:wikipedia:Orbital_elements|Orbital elements]] are used, rather than [[:wikipedia:Ephemerides|ephemerides]], to calculate planet positions. Although this is less accurate, it dramatically reduces the memory footprint. The planet positions are accurate to a few arc minutes, from 3000 BC to 3000 AD. Since the scale on the default display is approximately 8 arc minutes per pixel, these small errors are imperceptible, unless a very large zoom factor is used.
== The Display ==
== The Display ==
-
[[Image:orreryDefaultPage_3.2.png|thumb|200px|alt=Screenshot of the Orrery default page|Orrery Default Page]]
+
[[Image:orreryDefaultPage.png|200px|Orrery Default Page]]
-
The image at right shows the default display - all stars visible to the unaided eye, with colors for the brightest ones. It's displayed with a [[:wikipedia:Transverse_Mercator|Transverse Mercator projection]] (similar to [[:wikipedia:Norton%27s_Star_Atlas|Norton's Star Atlas]]) which works well with the [[Nokia N900|N900]] in portrait mode. It's a [[:wikipedia:Conformal_transform|conformal transformation]], so the constellations have about the right shapes. The Sun, Moon and planets are plotted, and the Moon is shown with the proper phase. The Sun and Moon are plotted with a size about 3.5 times larger than their true angular size on the sky. That allows the phase of the moon to be shown.
+
The image above shows the default display - all stars visible to the unaided eye, with colors for the brightest ones. It's displayed with a [[:wikipedia:Transverse_Mercator|Transverse Mercator projection]] (similar to [[:wikipedia:Norton%27s_Star_Atlas|Norton's Star Atlas]]) which works well with the [[Nokia N900|N900]] in portrait mode. It's a [[:wikipedia:Conformal_transform|conformal transformation]], so the constellations have about the right shapes. The Sun, Moon and planets are plotted, and the Moon is shown with the proper phase. The Sun and Moon are plotted with a size about 3.5 times larger than their true angular size on the sky. That allows the phase of the moon to be shown.
-
At the top of the display is shown, from left to right, the [[:wikipedia:Universal_time|Universal Time]] (UT), the [[:wikipedia:Sidereal_Time|Local Sidereal Time]] (LST), and the location on the earth. The UT is essentially the same as the Greenwich Mean Time, and the date will also be displayed if it differs from the current date. The LST is a time based upon the position of the stars, rather than the position of the sun. The user may chose to have the program display the stars visible at the user's current location and at the current time, or at any other position on the earth, or any other time between 3000 BC and 3000 AD.
+
The user may chose to have the program display the stars visible at the user's location and at the current time, or at any other position on the earth, or any other time between 3000 BC and 3000 AD.
The blue line near the bottom of the display is the horizon. Nothing below that line is visible, but the program plots objects there anyway, because it is often useful to know which objects are just about to rise, and which ones have recently set.
The blue line near the bottom of the display is the horizon. Nothing below that line is visible, but the program plots objects there anyway, because it is often useful to know which objects are just about to rise, and which ones have recently set.
-
{{clear}}
 
=== The orrery as a compass ===
=== The orrery as a compass ===
Line 22: Line 25:
azimuth is the angle, measured along the horizon, from north through east. So the azimuth of due north is 0, east is 90, south is 180 and west is 270 degrees. By using these azimuth values, the orrery can be used as a celestial compass, if the sky above you is at least partially clear. Notice that the azimuth values are not exactly evenly spaced. This is caused by the distortion introduced by the Transverse Mercator projection.
azimuth is the angle, measured along the horizon, from north through east. So the azimuth of due north is 0, east is 90, south is 180 and west is 270 degrees. By using these azimuth values, the orrery can be used as a celestial compass, if the sky above you is at least partially clear. Notice that the azimuth values are not exactly evenly spaced. This is caused by the distortion introduced by the Transverse Mercator projection.
-
The azimuth compass which appears if you tap the bottom center of the default page shows the azimuth of the Sun and Moon, if they are currently above the horizon.
+
If either the sun or moon is visible, you can use the planet compass (under the opts menu) to quickly orient yourself with an accuracy of about 1 degree,
You can also use the "Planet Compass" to find directions. If the sun, moon or a planet is visible above the horizon, you can orient the azimuth portion of the planet compass with that object, and use the rest of the compass to find any other direction.
You can also use the "Planet Compass" to find directions. If the sun, moon or a planet is visible above the horizon, you can orient the azimuth portion of the planet compass with that object, and use the rest of the compass to find any other direction.
Line 28: Line 31:
=== Why does this program put my phone in portrait mode? ===
=== Why does this program put my phone in portrait mode? ===
-
The Transverse Mercator transformation works poorly when the phone is in landscape mode. As we all learned in school, Mercator maps of the earth become very distorted near the earth's poles. For the orrery program, that distortion is unacceptably large when the phone is in landscape mode, because the landscape aspect ratio results in too large a range of azimuth values being displayed. A future version of orrery will support landscape operation, using a different coordinate transformation for that display.
+
The Transverse Mercator transformation works poorly when the phone is in
 +
landscape mode. As we all learned in school, Mercator maps of the earth become very distorted near the earth's poles. For the orrery program, that distortion is unacceptably large when the phone is in landscape mode, because the landscape aspect ratio results in too large a range of azimuth values being displayed. A future version of orrery will support landscape operation, using a different coordinate transformation for that display.
 +
 
=== Constellations Display ===
=== Constellations Display ===
-
[[Image:orreryConstellations_3.2.png|thumb|200px|alt=Screenshot of Orrery constellation screen|Orrery Constellation Screen]]
+
There are two sky display screens defined. By default, one of them shows the display shown above, and the other shows the constellations, and symbolic representations of the solar system objects. Tapping the screen within the upper 4/5 of the display toggles in and out of the constellations page.
-
There are two sky display screens defined. By default, one of them shows the display shown at right, and the other shows the constellations, and symbolic representations of the solar system objects. Tapping the screen within the upper 4/5 of the display toggles in and out of the constellations page.
+
[[Image:orreryConstellations.png|200px|Orrery Constellation Screen]]
The constellations are plotted in three colors. The twelve [[:wikipedia:Zodiac|zodiac]]
The constellations are plotted in three colors. The twelve [[:wikipedia:Zodiac|zodiac]]
constellations are plotted in hot pink.The constellations plotted in gold are the classical Greek constellations, as listed in [[:wikipedia:Almagest|Ptolomy's Almagest]] (apart from the zodiac constellations, which are also in the Almagest). The only constellation from the Almagest which is not plotted is Argo Navis, which is not one of the official modern constellations (Argo Navis was broken up into the modern constellations Carina, Puppis and Vela). The remaining constellations, plotted in blue, were added during the last few hundred years.
constellations are plotted in hot pink.The constellations plotted in gold are the classical Greek constellations, as listed in [[:wikipedia:Almagest|Ptolomy's Almagest]] (apart from the zodiac constellations, which are also in the Almagest). The only constellation from the Almagest which is not plotted is Argo Navis, which is not one of the official modern constellations (Argo Navis was broken up into the modern constellations Carina, Puppis and Vela). The remaining constellations, plotted in blue, were added during the last few hundred years.
-
In addition to constellation names and figures, three great circles, the [[:wikipedia:Celestial_Equator|Celestial Equator]] (light yellow), [[:wikipedia:Ecliptic|Ecliptic]] (red) and [[:wikipedia:Galactic_plane|Galactic Plane]] (blue-green), are shown. Solar system objects are shown symbolically (see Mercury, Venus, the Moon and the Sun in the above image).
+
In addition to constellation names and figures, three great circles, the [[:wikipedia:Celestial_Equator|Celestial Equator]] (light yellow), [[:wikipedia:Ecliptic|Ecliptic]] (red) and [[:wikipedia:Galactic_plane|Galactic Plane]] (blue-green), are shown. Solar system objects are shown symbolically (see Mercury, Venus,
-
{{clear}}
+
the Moon and the Sun in the above image).
-
=== Displaying Asterisms ===
+
==== Displaying Asterisms ====
-
[[Image:OrreryAsterisms_3.2.png|thumb|200px|alt=Screenshot of Orrery northern asterisms view|Orrery Northern Asterisms]]
+
There are many [[:wikipedia:Asterism_(astronomy)|informal constellations]] which are widely known, such as the [[:wikipedia:Big_Dipper|Big Dipper]], the [[:wikipedia:Summer_Triangle|Summer Triangle]], etc. The user can choose to display some of these unofficial constellations by selecting "Use Asterisms" from the "Displayed Items" menu. If you know of some nice asterisms that the orrery does not yet display, please send them to orrery.moko@gmail.com, and I'll include them in a future release if I can. The image below shows the Big Dipper and Little Dipper asterisms.
-
There are many [[:wikipedia:Asterism_(astronomy)|informal constellations]] which are widely known, such as the [[:wikipedia:Big_Dipper|Big Dipper]], the [[:wikipedia:Summer_Triangle|Summer Triangle]], etc. The user can choose to display some of these unofficial constellations by selecting "Use Asterisms" from the "Displayed Items" menu. If you know of some nice asterisms that the orrery does not yet display, please send them to orrery.moko@gmail.com, and I'll include them in a future release if I can. The image on the right shows the Big Dipper and Little Dipper asterisms.
+
[[Image:OrreryAsterisms.png|200px|Orrery Northern Asterisms]]
-
 
+
-
{{clear}}
+
== Panning ==
== Panning ==
-
 
+
The image can be panned by tapping your finger in
-
The image can be panned by tapping your finger in the bottom 1/5 of the display (excluding menus). The size of the panning step is controlled by how close your finger is to the edge of the display. The program tries to center the azimuth value near where you tap. If you tap near the left or right edges, it pans by the maximum allowed amount, +-40 degrees. Pan steps are
+
the bottom 1/5 of the display (excluding menus).   The size of
 +
the panning step is controlled by how close your finger is
 +
to the edge of the display. The program tries to center
 +
the azimuth value near where you tap.   If you tap near the
 +
left or right edges, it
 +
pans by the maximum allowed amount, +-40 degrees.   Pan steps are
quantized in increments of 5 degrees.  
quantized in increments of 5 degrees.  
=== Selecting a New Center Azimuth ===
=== Selecting a New Center Azimuth ===
 +
Panning to a new central azimuth by panning 40 degrees at a time
 +
can be tedious.  To make a large change in the display's center
 +
azimuth you may use the azimuth compass.  To call up the azimuth
 +
compass, tap near the center of the finger-pan area (bottom 1/5 of
 +
the display)  The compass shown below will appear:
-
[[Image:OrreryAzCompass_3.2.png|thumb|200px|alt=Screenshot of the Orrery azimuth compass|Orrery Azimuth Compass]]
+
[[Image:OrreryAzCompass.png|200px|Orrery Azimuth Compass]]
-
 
+
-
Panning to a new central azimuth by panning 40 degrees at a time can be tedious. To make a large change in the display's center azimuth you may use the azimuth compass. To call up the azimuth compass, tap near the center of the finger-pan area (bottom 1/5 of the display). The compass shown at right will appear:
+
-
The locations of the Sun and Moon are shown if they are above the horizon (if they are too close together, only the Sun is shown). You may use your finger or stylus to select another center azimuth. Keep you finger pressed to the display as you select your new center azimuth - the selected azimuth will be shown by a white pointer on the inside of the compass circle. Once you release pressure on the screen, the compass will disappear, and the display will be redrawn.
+
You may use your finger or stylus to select another center
 +
azimuth.   Keep you finger pressed to the display as you select
 +
your new center azimuth - the selected azimuth will be shown by
 +
a white pointer on the inside of the compass circle.   Once you release pressure on the screen,
 +
the compass will disappear, and the display will be redrawn.
The azimuth compass cannot be accessed if the display is zoomed.
The azimuth compass cannot be accessed if the display is zoomed.
-
{{clear}}
 
== Main Menu ==
== Main Menu ==
-
[[Image:orreryMainMenu-3.3.png|thumb|200px|alt=Screenshot of Orrery main menu|Orrery Main Menu]]
+
[[Image:orreryMainMenu-3.3.png|200px|Orrery Main Menu]]
The main dropdown menu for the orrery has six options:
The main dropdown menu for the orrery has six options:
-
{{clear}}
 
=== Other Pages ===
=== Other Pages ===
-
[[Image:orreryOtherPagesMenu-3.1.png|thumb|200px|alt=Screenshot of Orrery other pages menu|Orrery Other Pages Menu]]
+
The "Other Pages" option takes you to a menu that allows you to
 +
display things other than the night sky.   With the exception of the flashlight pages, which are dismissed by tapping anywhere on the screen, the "Other Pages" are dismissed by curved arrow in the upper right hand corner.
-
The "Other Pages" option takes you to a menu that allows you to display things other than the night sky. With the exception of the flashlight pages, which are dismissed by tapping anywhere on the screen, the "Other Pages" are dismissed by curved arrow in the upper right hand corner.
+
[[Image:orreryOtherPagesMenu-3.1.png|200px|Orrery Other Pages Menu]]
-
{{clear}}
+
==== Flashlight Modes ====
==== Flashlight Modes ====
 +
The "White Flashlight" button paints the entire screen white, and the
 +
"Red Flashlight" button paints the entire screen red.  Both may
 +
be used as a flashlight, but the red one is best if you are trying
 +
to preserve your [http://en.wikipedia.org/wiki/Night_vision night vision].
-
The "White Flashlight" button paints the entire screen white, and the "Red Flashlight" button paints the entire screen red. Both may be used as a flashlight, but the red one is best if you are trying to preserve your [[:wikipedia:Night_vision|night vision]].
+
==== Sunrise and Moon ====
 +
The "Sun and Moon" button displays a page giving the
 +
sun and moon positions, rise and set times, phase etc for five
 +
days, centered on today:
-
==== Sun and Moon ====
+
[[Image:orrerySunAndMoon-3.1.png|200px|Sun and Moon Information page]]
-
[[Image:orrerySunAndMoon_3.2.png|thumb|200px|alt=Screenshot of sun and moon information|Sun and Moon Information page]]
+
The highlighted date is the current [http://en.wikipedia.org/wiki/Universal_time Universal Time] (UT) date (unless the time menu
 +
has been used to select a different time).  The highlighted
 +
rise and set times are the next ones which will occur at your
 +
location.  Of course, that may be on a different UT date (for
 +
example, during daylight hours, the next sunrise will be tomorrow).
 +
The times are shown as UT, which may annoy people.
 +
UT is used because the orrery allows you to select any location on the
 +
earth, and any time from 3000 BC until 3000 AD.  It would be very
 +
difficult to keep track of all the timezone, daylight savings change
 +
dates, etc for that time range!  So I have wimped out, and displayed
 +
UT, which is always reasonably well defined.
-
The "Sun and Moon" button displays a page giving the sun and moon positions, rise and set times, phase, etc. for five days, centered on today.
+
The current sun and moon positions shown are geocentric - no
 +
topocentric correction has been applied.  However topocentric
 +
corrections are applied when rise and set times are calculated,
 +
so they should be reasonably accurate for a specific location on earth.
-
The highlighted date is the current UT date (unless the time menu has been used to select a different time). The highlighted rise and set times are the next ones which will occur at your location. Of course, that may be on a different UT date (for example, during daylight hours, the next sunrise will be tomorrow). The times are shown as UT, which may annoy people. UT is used because the orrery allows you to select any location on the earth, and any time from 3000 BC until 3000 AD. It would be very difficult to keep track of all the timezone, daylight savings change dates, etc. for that time range! So I have wimped out, and displayed UT, which is always reasonably well defined.
+
The moon illumination percentage shown on the line with the
 +
rising and setting times is the value at [http://en.wikipedia.org/wiki/Astronomical_transit transit].   The
 +
illumination shown on the line that has the drawing of the
 +
moon phase is the illumination percentage at this moment.
-
The current sun and moon positions shown are geocentric - no topocentric correction has been applied. However topocentric corrections are applied when rise and set times are calculated, so they should be reasonably accurate for a specific location on earth.
+
This page also shows the UT date and time of the four major moon
-
 
+
phases ([http://en.wikipedia.org/wiki/Moon_phases#Names_of_lunar_phases New, First Quarter, Full and Last Quarter]) for a time span
-
The moon illumination percentage shown on the line with the rising and setting times is the value at [[:wikipedia:Astronomical_transit|transit]]. The illumination shown on the line that has the drawing of the moon phase is the illumination percentage at this moment.
+
of 17 [http://en.wikipedia.org/wiki/Lunar_month lunar months], centered on the current time (which of course
-
 
+
can be changed with the time menu).   The nearest time and date when
-
This page also shows the UT date and time of the four major moon phases ([[:wikipedia:Lunar_phases#Names_of_lunar_phases|New, First Quarter, Full and Last Quarter]]) for a time span of 10 [[:wikipedia:Lunar_month|lunar months]], centered on the current time (which of course can be changed with the time menu). The nearest time and date when each phase will occur is highlighted.
+
each phase will occur is highlighted.
-
 
+
-
===== Seasons =====
+
-
 
+
-
The Sun and Moon page also displays the precise times at which each of the four seasons begins (spring and autumn equinoxes, summer and winter solstices).
+
==== Symbol Key ====
==== Symbol Key ====
-
 
+
This button displays an annotated list of
-
This button displays an annotated list of all the symbols used on the orrery display.
+
all the symbols used on the orrery display.
==== Big Moon Calendar ====
==== Big Moon Calendar ====
 +
The Big Moon Calendar is a graphic display of the phase of the moon for
 +
each day from 10 months before the current month, until 10 months after
 +
the current month (roughly 640 days), as shown below:
-
[[Image:orreryBigMoonCalendar_3.2.png|thumb|200px|alt=Screenshot of big moon calendar|Big Moon Calendar]]
+
[[Image:orreryBigMoonCalendar-3.1.png|200px|Big Moon Calendar]]
-
 
+
-
The Big Moon Calendar is a graphic display of the phase of the moon for each day from 10 months before the current month, until 10 months after the current month (roughly 640 days), as shown at right.
+
-
Each column shows one month, and the day number is shown for each row. At the top and bottom of each column is shown the first letter of the name of the month shown in the column. Two vertical green lines separate years. The current Universal Time date is outlined in a red box.
+
Each column shows one month, and the day number is shown for each row.
-
{{clear}}
+
At the top and bottom of each column is shown the first letter of the
 +
name of the month
 +
shown in the column.   Two vertical green lines separate years.
 +
The current Universal Time date is outlined in a red box.
==== This Month's Moons ====
==== This Month's Moons ====
 +
The This Moon's Moons page shows the phase of the moon for each day
 +
of a particular month.  By default, the current month is shown, but
 +
one may use the arrow buttons to pan through the months.
-
[[Image:orreryMonthlyMoonCalendar_3.2.png|thumb|200px|alt=Screenshot of monthly moon calendar|Monthly Moon Calendar]]
+
[[Image:orreryMonthlyMoonCalendar-3.1.png|200px|Monthly Moon Calendar]]
-
The ''This Month's Moons'' page shows the phase of the moon for each day of a particular month. By default, the current month is shown, but one may use the arrow buttons to pan through the months.  The day of the calendar month is shown in blue in the upper left corner of each day, and the number of days since the last New Moon (the "age" of the moon) is shown in red at the bottom right corner.  The current day is highlighted with a white box with the day of the month in white and the age of the moon in pink.
+
Both moon calendars show "[http://en.wikipedia.org/wiki/Blue_Moon Blue Moons]", which are (according to the most
-
 
+
commonly used definition) the second full moon in a calendar month which
-
Both moon calendars show "[[:wikipedia:Blue_Moon|Blue Moons]]", which are (according to the most commonly used definition) the second full moon in a calendar month which has two full moons. Both images at right show the Blue Moon which falls on New Year's Eve, 2009.
+
has two full moons.   Both images above show the Blue Moon which falls
-
{{clear}}
+
on New Year's Eve, 2009.
==== Meteor Showers ====
==== Meteor Showers ====
 +
This display shows information for all the [http://en.wikipedia.org/wiki/Meteor_shower meteors showers] which
 +
will occur during the current year.  Remember that to see a meteor
 +
shower, you must travel to a site that has a very dark sky.    In
 +
a city, few meteors will be seen even during a shower.
-
[[Image:orreryMeteorShower-3.1.png|thumb|200px|alt=Screenshot of Meteor Showers view|Meteor Showers]]
+
[[Image:orreryMeteorShower-3.1.png|200px|Meteor Showers]]
-
This display shows information for all the [[:wikipedia:Meteor_shower|meteors showers]] which will occur during the current year. Remember that to see a meteor shower, you must travel to a site that has a very dark sky. In a city, few meteors will be seen even during a shower.
+
The items
-
 
+
shown on the Meteor Showers page are 1) The name of the meteor
-
The items shown on the Meteor Showers page are:
+
shower 2) the abbreviation used for this shower when its [http://en.wikipedia.org/wiki/Meteor_shower#The_radiant_point radiant]
-
# the name of the meteor shower
+
is plotted on the sky display 3) the expected number of meteors
-
# the abbreviation used for this shower when its [[:wikipedia:Meteor_shower#The_radiant_point|radiant]] is plotted on the sky display
+
per hour - this is the maximum you will see under the best circumstances
-
# the expected number of meteors per hour - this is the maximum you will see under the best circumstances with a very dark sky and the shower radiant directly overhead on the date of the shower maximum. If the rate entry says "Var", that means the rate is variable; such shower are not apt to show a large number of meteors per hour.
+
with a very dark sky and the shower radiant directly overhead
-
# the range of dates during which the shower will occur
+
on the date of the shower maximum.   If the rate entry says "Var", that
-
# the date at which the shower shows the maximum number of meteors
+
means the rate is variable; such shower are not apt to show
-
# the typical velocity of the showers meteors in km/sec - larger numbers lead to brighter, bluer meteors
+
a large number of meteors per hour. 4) the range of dates during
-
# the percentage of the moon's disk which is illuminated on the date of shower maximum - full moon = 100%. A minus sign following the percentage means the moon is [[:wikipedia:Lunar_phase#Names_of_lunar_phases|waning]], a plus sign means it is [[:wikipedia:Lunar_phase#Names_of_lunar_phases|waxing]]. Moonlight greatly interferes with seeing meteors
+
which the shower will occur 5) the date at which the shower shows
-
# the number of dark hours on the date of the shower maximum - defined as the time during which the sun is more than 12 degrees below the horizon, and the moon is far enough below
+
the maximum number of meteors 6) the typical velocity of the
 +
showers meteors in km/sec - larger numbers lead to brighter, bluer
 +
meteors 7) the percentage of the moon's disk which is illuminated
 +
on the date of shower maximum - full moon = 100%.   A minus sign
 +
following the percentage means the moon is [http://en.wikipedia.org/wiki/Waning#Names_of_lunar_phases waning], a plus sign
 +
means it is [http://en.wikipedia.org/wiki/Waning#Names_of_lunar_phases waxing].   Moonlight greatly interferes with seeing
 +
meteors 8) the number of dark hours on the date of the shower
 +
maximum - defined as the time during which the sun is more than
 +
12 degrees below the horizon, and the moon is far enough below
the horizon to not appreciably brighten the sky.
the horizon to not appreciably brighten the sky.
-
The Meteor Showers page shows information for all showers, the large majority of which are really minor events. Even when a meteor shower is not occurring, you can expect to see 4 to 10 meteors per hour. Many of the showers listed do not even double that background rate, and are of interest only to serious meteor enthusiasts. If you just want to go out and see some meteors for fun, it's best to select a shower with a rate of at least 50 meteors per hour, and to watch it on or very near the date of the shower's maximum.
+
The Meteor Showers page shows information for all showers, the
 +
large majority of which are really minor events.   Even when a
 +
meteor shower is not occurring, you can expect to see 4 to 10 meteors
 +
per hour. Many of the showers listed do not even double that
 +
background rate, and are of interest only to serious meteor
 +
enthusiasts.   If you just want to go out and see some meteors
 +
for fun, it's best to select a shower with a rate of at least 50
 +
meteors per hour, and to watch it on or very near the date of the
 +
shower's maximum.
-
Each line of the display describes a separate shower. If the shower currently in progress, the line is shown in green - bright green if there will be 2 or more hours of dark sky tonight, and dark green otherwise. If the shower is not currently underway, it will be shown in a cream color if on the night of the shower's maximum, the sky will be dark for at least 2 hours. Otherwise the shower information will be shown in grey, indicating that this year is not a good one to observe that particular shower.
+
Each line of the display describes a separate shower.   If the
 +
shower currently in progress, the line is shown in green - bright
 +
green if there will be 2 or more hours of dark sky tonight, and
 +
dark green otherwise.   If the shower is not currently underway,
 +
it will be shown in a cream color if on the night of the shower's maximum, the sky will be dark for at least 2 hours.   Otherwise
 +
the shower information will be shown in grey, indicating that this
 +
year is not a good one to observe that particular shower.
-
At the bottom of the Meteor Showers page is shown the number of dark sky hours to expect tonight. In this context, "tonight" means the upcoming night if the sun is currently above the horizon, or the current night, if the sun is below the horizon.
+
At the bottom of the Meteor Showers page is shown the number of
 +
dark sky hours to expect tonight. In this context, "tonight"
 +
means the upcoming night if the sun is currently above the horizon,
 +
or the current night, if the sun is below the horizon.
-
If you wish to get meteor shower information for a different year, simply change in year using the time menu.
+
If you wish to get meteor shower information for a different year,
 +
simply change in year using the time menu.
-
Many thanks to the International Meteor Organization (http://www.imo.net/imo/intro)
+
Many thanks to the International Meteor Organization
-
for permission to use their data to produce the meteor shower related displays.
+
(http://www.imo.net/imo/intro)
 +
for permission to use their data to produce the meteor shower
 +
related displays.
==== Planet Compass ====
==== Planet Compass ====
 +
The Planet Compass page graphically shows where each of the planets
 +
is at the current time.
-
[[Image:OrreryPlanetCompass_3.2.png|thumb|200px|alt=Screenshot of moon calendar|Moon Calendar]]
+
[[Image:OrreryPlanetCompass-3.1.png|200px|Moon Calendar]]
-
The Planet Compass page graphically shows where each of the planets is at the current time.
+
The image has one complete circle, which shows the planet azimuth,
 +
and one semicircle, which shows the [http://en.wikipedia.org/wiki/Altitude_(astronomy) elevation].
-
The image has one complete circle, which shows the planet azimuth, and one semicircle, which shows the [[:wikipedia:Altitude_(astronomy)|elevation]].
+
The azimuth circle has blue
 +
triangles marking the four [http://en.wikipedia.org/wiki/Cardinal_points cardinal points]: North, South, East and West.
 +
There are small tick lines at the NE, SE, SW and NW directions, as
 +
well as a small dot every 10 degrees.  The planet symbols are shown
 +
with lines projecting to their current azimuth.  The line is white if
 +
the planet is above the horizon, and red if it is below the horizon.
-
The azimuth circle has blue triangles marking the four [[:wikipedia:Cardinal_points|cardinal points]]: North, South, East and West. There are small tick lines at the NE, SE, SW and NW directions, as well as a small dot every 10 degrees. The planet symbols are shown with lines projecting to their current azimuth. The line is white if the planet is above the horizon, and red if it is below the horizon.
+
The elevation semicircle has blue triangles marking the directions
 +
of the Zenith, Horizon and Nadir.   Small dots are shown every 10
 +
degrees, and there are short lines at +-45 degrees.
 +
As with the azimuth circle, lines connect the planet
 +
symbols to their current elevations.
-
The elevation semicircle has blue triangles marking the directions of the Zenith, Horizon and Nadir. Small dots are shown every 10 degrees, and there are short lines at +-45 degrees. As with the azimuth circle, lines connect the planet symbols to their current elevations.
+
Below the compass graphic, the name, [http://en.wikipedia.org/wiki/Hour_angle Hour Angle] (HA) rising time
-
 
+
and azimuth, transit time and elevation, and setting time and
-
Below the compass graphic, the name, [[:wikipedia:Hour_angle|Hour Angle]] (HA) rising time and azimuth, transit time and elevation, and setting time and azimuth is shown for each planet. The name of the planet is shown in green if the planet is currently above the horizon, or red if it is not. The time of the next event - rising, transiting or setting, is also highlighted for each planet.
+
azimuth is shown for each planet.   The name and HA of the planet is
-
{{clear}}
+
highlighted if the planet is above the horizon. The time of
 +
the next event - rising, transiting or setting, is also highlighted
 +
for each planet.
==== Solar System ====
==== Solar System ====
-
 
+
The program can display the relative planet positions in two
-
The program can display the relative planet positions in two different ways. In both cases, the view is from the north looking down, with the direction of the [[:wikipedia:Vernal_Equinox|Vernal Equinox]] to the left of the screen (marked with the vernal equinox symbol, and an arrow). At the time of the vernal equinox, the earth will be at the 3 o'clock position in its orbit, so that the Sun will appear at the vernal equinox position.
+
different ways.   In both cases, the view is from the north looking down,
 +
with the direction of the [http://en.wikipedia.org/wiki/Vernal_Equinox Vernal Equinox] to the left of the screen
 +
(marked with the vernal equinox symbol, and an arrow).   At the
 +
time of the vernal equinox, the earth will be at the 3 o'clock position
 +
in its orbit, so that the Sun will appear at the vernal equinox
 +
position.
===== Schematic Solar System View =====
===== Schematic Solar System View =====
 +
This button presents a schematic view of the Solar System, showing
 +
the locations of the earth, the earth's moon and the other planets
 +
in their orbits around the sun.  The view is schematic in the sense
 +
that the orbit radii and planet sizes are not shown to scale.  However
 +
the positions of the objects within their orbits are correct
 +
(the heliocentric [http://en.wikipedia.org/wiki/Ecliptic_longitude ecliptic longitudes] are correct).
-
[[Image:OrrerySchematicSolSys_3.2.png|thumb|200px|alt=Screenshot of schematic solar system view |Solar System View (schematic)]]
+
[[Image:OrrerySchematicSolSys-3.1.png|200px|Solar System View (schematic)]]
-
This button presents a schematic view of the Solar System, showing the locations of the earth, the earth's moon and the other planets in their orbits around the sun. The view is schematic in the sense that the orbit radii and planet sizes are not shown to scale. However the positions of the objects within their orbits are correct (the heliocentric [[:wikipedia:Ecliptic_longitude|ecliptic longitudes]] are correct).
+
Several buttons are drawn at the bottom of the display, which allow you to
-
 
+
show an animation of the motion of the Solar System objects for several
-
Several buttons are drawn at the bottom of the display, which allow you to show an animation of the motion of the Solar System objects for several time increments. Showing the motion of planets in this way is what mechanical orreries do.
+
time increments.   Showing the motion of planets in this way is what
-
{{clear}}
+
mechanical orreries do.
===== To-Scale Solar System View =====
===== To-Scale Solar System View =====
-
 
-
[[Image:OrreryToScaleSolSys_3.2.png|thumb|200px|alt=Screenshot of to-scale solar system view|Solar System View (to-scale)]]
 
-
 
This button displays the Solar System with the planet orbits shown with
This button displays the Solar System with the planet orbits shown with
-
the proper relative sizes. The orbits are also plotted as [[:wikipedia:Ellipse|ellipses]] in this display, with the correct eccentricity and orientation. The moon is not plotted, because it would be too close to the earth to display if any of the planet orbits were completely shown. Because Neptune's orbit is nearly 100 times larger than Mercury's, it is not possible to display all of the planet orbits simultaneously. There are "Zoom In" and "Zoom Out" buttons which allow you to select which proper subset of planet orbits is shown. The current position of each planet in its orbit is shown. Also plotted are grey lines connecting the Sun to each orbit, terminating with a white dot at the position of the planet's [[:wikipedia:Perihelion#Planetary_perihelion_and_aphelion|perihelion]] (where it is closest to the sun in its orbit). The image at right shows the display when the outermost plotted planet is Mars. Note that the orbits of Mercury and Mars are quite non-circular.
+
the proper relative sizes.   The orbits are also plotted as [http://en.wikipedia.org/wiki/Ellipse ellipses] in
-
{{clear}}
+
this display, with the correct eccentricity and orientation.   The
 +
moon is not plotted, because it would be too close to the earth to display
 +
if any of the planet orbits were completely shown.   Because Neptune's
 +
orbit is nearly 100 times larger than Mercury's, it is not possible to
 +
display all of the planet orbits simultaneously.   There are "Zoom In"
 +
and "Zoom Out" buttons which allow you to select which proper subset of
 +
planet orbits is shown.   The current position of each planet in its
 +
orbit is shown.   Also plotted are grey lines connecting the Sun to
 +
each orbit, terminating with a white dot at the position of the
 +
planet's [http://en.wikipedia.org/wiki/Perihelion#Planetary_perihelion_and_aphelion perihelion] (where it is closest to the sun in its orbit).
 +
The image below shows the display when the outermost plotted planet is
 +
Mars.   Note that the orbits of Mercury and Mars are quite non-circular:
-
==== Astronomical Times ====
+
[[Image:OrreryToScaleSolSys-3.1.png|200px|Solar System View (to-scale)]]
-
 
+
-
[[Image:OrreryTimesPage.png|thumb|200px|alt=Screenshot of astronomical times view|Astronomical Times Page]]
+
-
 
+
-
This button displays the current value of several astronomically important time scales, including the [[:wikipedia:Julian_day|Julian Date]] (JD), the Modified Julian Date (MJD), which is simply the JD - 2400000.5, the [[:wikipedia:Universal_Time|Universal time]] (UT), the [[:wikipedia:Equation_of_time|Equation of time]] (Eq. of Time), which is the difference between mean solar time and sundial (apparent) solar time, and the Equation of the Equinoxes (Eq. of Equin.), which is the very small difference between the Mean [[:wikipedia:Sidereal_time|Sidereal Time]], and the Apparent Sidereal Time. All of those values are the same anywhere in the world. Also displayed are several times specific to the location you are at (or have selected): The Mean Solar Time, the apparent solar time (the time shown by sundials), the Mean Local Sidereal Time (Mean LST) and the apparent local sidereal time (App. LST). Unlike the other orrery pages, this page is updated rapidly (at 10 Hz), so that you can see the exact current values.
+
-
{{clear}}
+
-
 
+
-
==== Analemma ====
+
-
 
+
-
[[Image:OrreryAnalemma.png|thumb|200px|alt=Screenshot of analemma view|Analemma]]
+
-
 
+
-
This button displays the [[:wikipedia:Analemma|Analemma]] for the current time, or the time which has been selected with the Change Time button. The analemma's horizontal axis is the Equation of Time value, which is the difference between Mean Solar Time (what a clock set to your local time, not your timezone time, would show) and the Apparent Solar Time (what a sundial would show - the time defined by the position of the real sun in the sky). The vertical axis shows the elevation of the sun above the horizon, at noon, from your location (or the location you have selected). The analemma is labeled with a year, because it slowly changes as the earth's orbit changes and the earth's pole wobbles. No phone can really be called a smartphone if it cannot show the analemma. The analemma page takes a second or two to display - nearly 750,000 trigonometric function calls are needed to calculate it accurately!
+
-
 
+
-
When the Equation of Time is negative, clocks run ahead of sundial (apparent solar) time.
+
-
 
+
-
If you were to photograph the sun, at the same time each day, the resulting set of sun images would trace out the analemma. The analemma can be used to calculate the direction of the sun's rays at your location.
+
-
{{clear}}
+
-
 
+
-
==== Planet Elevations ====
+
-
 
+
-
[[Image:OrreryPlanetElevations.png|thumb|200px|alt=Screenshot of Planet Elevations|Planet Elevations]]
+
-
 
+
-
The "Planet Elevations" page offers another way of seeing if and when the planets will be visible.  A typical display is shown at the right.
+
-
The page shows a plot of one full day, with time increasing as you move to the right of the plot.  The Universal Time is shown at the top of the plot, and the Local Sidereal time is shown at the bottom.  The grey line in the center of the plot marks local midnight (which, in general will ''not'' be timezone midnight).  There is a horizontal line drawn for the Sun, the Moon and each of the planets (except earth!).
+
-
The line for the sun is drawn in red; for other objects the portion of the line which is drawn in white shows when the object is above the horizon at night and the portion shown in grey shows when the object is above the horizon during daylight.    Below each object's line is shown a series of tick marks with the elevation of the object at that time shown below.  Below the center of each object line, the elevation of the source at transit is shown.  There are grey vertical lines shown covering the entire height of the plot marking sunrize and sunset.  In between those lines, the Sun is below the horizon, and a planet may be visible.  There is a colored vertical line, with a UT time at the top and an LST at the bottom.  That line shows the current time, and it is red if the Sun is above the horizon, yellow during twilight, and green when the sky should be pretty dark.  If that line intersects an object line (in the plot shown here, it intersects the lines for Mars, Jupiter, Uranus and Neptune) that object is above the horizon, and the object's current elevation is shown next to the current time line (in this case, 2 degrees for Mars, 58 for Jupiter, 44 for Uranus and 18 degrees for Neptune).  If the sky is dark, and the object is above the horizon, its name is shown in green.  Otherwise, it is shown in red.
+
-
 
+
-
One can obviously change the time on using the orrery's "Change Time" menu item, and then use this page to see the range of time that any planet will be visible for, at any time from 3000 BC until 3000 AD.
+
-
 
+
-
One little wrinkle for this display is when to update the tracks for the next day.  In other words, if an object is currently below the horizon, is the elevation track shown correct for today, or tomorrow, or yesterday?  This doesn't really matter for anything other than the Moon, because no other object moves on the sky enough during one day to make its track change significantly.  But a one day change in the Moon's position is very significant.  The way the orrery handles this is to switch to the next day's tracks at local noon.  So once noon passes, the tracks will be correct for the night which begins at the next sundown.  Before local noon, the tracks are correct for the night which ended at the most recent sunrise.  This means that the tracks should be correct at all times when the sun is down.
+
-
 
+
-
{{clear}}
+
-
 
+
-
==== Planet Phenomena ====
+
-
 
+
-
[[Image:OrreryPlanetPhenomena.png|thumb|200px|alt=Screenshot of Planet Phenomena|Planet Phenomena]]
+
-
 
+
-
The "Planet Phenomena" page shows the date and hour of the most recent and next [[wikipedia:Conjunction_(astronomy_and_astrology)|conjunction]] and [[wikipedia:Opposition_(planets)|opposition]] (for [[wikipedia:Superior_planets|superior planets]]).  For [[wikipedia:Superior_planets|inferior planets]], the inferior and superior conjunction dates are shown, along with the date of greatest eastern and western elongation, and the separtion from the Sun on those dates.  Mercury and Venus are most easily observed around the date of greatest elongation.  In fact, it's virtually impossible to see Mercury with the unaided eye, except very near the time of greatest elongation.  When Mercury or Venus is at greatest eastern elongation (labeled "Max. East" on the table) the planet is visible after sunset in the evening.  Near greatest western elongation (labeled "Max. West") it is visible before sunrise in the morning.
+
-
 
+
-
 
+
-
The dates and times shown on this page have an accuracy of about +- one hour.
+
-
{{clear}}
+
-
 
+
-
==== Jovian Moons ====
+
-
[[Image:orreryJovianMoonGraph.png|thumb|200px|alt=Screenshot of the Jovian Moon Graph Page|Jovian Moon Graph Page]]
+
-
The Jovian Moons page displays information about the positions and
+
-
phenomena for the four largest moons of Jupiter - the [[wikipedia:Galilean_moons|Galilean Moons]].  These moons are easily seen with even small binoculars.  Some sharp-eyed people claim to be able to see them with their unaided eyes.  The moons are easily bright enough to be seen with the unaided eye, and at least the outermost two get far enough away from the planet's disk to be resolved by a human eye.  But the dazzling brilliance of Jupiter so near the moons makes viewing them without optical aid very difficult.
+
-
 
+
-
 
+
-
A screenshot of the Jovian Moon first page is shown on the right.  At the top of the page is a plot showing Jupiter and
+
-
its four main moons, which are color coded for easy identification, in their proper positions for the current time (or any other time you set).  All four moons will not always be visible - sometimes they pass behind Jupiter and are
+
-
blocked from our line of sight.  Occasionally the shadow of one of the moons will pass across Jupiter's disk, and that shadow too will be shown in the plot.
+
-
Because the inclination of Jupiter's axis is only 3 degrees, and the moons orbit nearly in Jupiter's equatorial plane, these moons appear to move nearly on a line, with Jupiter in the center.   Eclipses for the three innermost moons happen very frequently, and Callisto, the outermost Galilean Moon, is eclipsed less frequently.  Which side the moons appear on depends upon what equipment you use to observe them.  Many telescopes invert or mirror reflect the image.
+
-
There are four buttons near the bottom of the page which allow you to
+
-
invert and reflect the plots, to make them match what you see with your equipment.
+
-
 
+
-
Most of the page is taken up with "wiggly line" plots which show the east-west positions of the moons throughout the current month.  They are color coded, for identification.  At the position in the plot corresponding to the current time, the lines are interrupted, and dots representing the moons are plotted.
+
-
Although these lines look like simple sine waves, they are not.  The moons (and other objects) perturb the orbits o these moons, making the motion far more complex than simple harmonic motion.  The two cream-colored vertical lines in each plot shows the size of Jupiter's disk.  You can see on the plot when a moon passes in front of or behind Jupiter.  There is a scale at the bottom of the plots which allows you to see the separation in arc seconds.  This scale changes as the distant to Jupiter from the Earth changes.
+
-
 
+
-
At the bottom of the page is a button you can press to go to the "Events" page.
+
-
 
+
-
{{clear}}
+
-
[[Image:orreryJovianMoonEvents.png|thumb|200px|alt=Screenshot of the Jovian Moon Events Page|Jovian Moon Events Page]]
+
-
 
+
-
The Events page lists the times of the satellite events such as eclipses, occultations and transits.  This page takes a second or so to plot,
+
-
because it requires roughly one million double precision trigonometric functions to be evaluated (the event timings are calculated by your phone, not fetched from a website). Since the app is location-aware, it can tell you which of these events will be visible to you from your current location.    If the Sun is above the horizon, or Jupiter is below the horizon, you cannot see a satellite event; such events are listed in grey.  Events that you can see are shown in green, except for he ''next'' event you can see, which is shown in red.  The times are all in UT, of course.  The plot on the right shows the events for the very special evening of Oct 12, 2013.  On that night three satellite shadows crossing Jupiter's disk are visible at once (see plot at the top of the page).  The color coding shows that this rare triple shadow event will be visible from my current location.
+
-
 
+
-
At the bottom of the Events page is a button you can click to return to the Graph page.
+
-
{{clear}}
+
-
 
+
-
==== Celestial Navigation ====
+
-
[[Image:orrerySextantFullList.png|thumb|200px|alt=Screenshot of the Celestial Navigation Default Page|Celestial Navigation Default Page]]
+
-
The Celestial Navigation page shows the information needed to perform [[wikipedia:Celestial_navigation|celestial navigation]] calculations with a [[wikipedia:Sextant|sextant]].  The default page, shown on the right,  shows the information presented by the [[wikipedia:US_Naval_Observatory|US Naval Observatory]] on its online calculator (located at http://aa.usno.navy.mil/data/docs/celnavtable.php).
+
-
The orrery does not use that Naval Observatory calculator; it calculates the values itself (so you do not need an internet connection to use it).  The orrery uses the same list of objects as the Naval Observatory calculator, but it color-codes them differently for improved visibility.  Solar System objects are shown at the top of the list in red.  Objects with elevations between 15 and 65 degrees are shown in green, and objects above the horizon but outside of that range are shown in grey.  Data for Polaris and the First Point in Aries are shown at the bottom of the table, in white.  The values are not updated as time passes unless you press the "Press Here to Update" button at the bottom of the page.
+
-
 
+
-
If you need the reduction table values for some arbitrary time, you can of course use the normal method of changing the orrery's time, and then return to the Sextant Navigation page to see the appropriate values.
+
-
 
+
-
[[Image:orrerySextantSingleObject.png|thumb|200px|alt=Screenshot of the Celestial Navigation Single Object Page|Celestial Navigation Single Object Page]]
+
-
Showing all of the navigational objects on one page requires a very small font, which is hard to read.  If you press the touchscreen near any of the objects, a white box will appear highlighting a selected object.  Releasing the screen will present another page showing the data for the selected object only, with a much larger, more readable font, as shown on the right.
+
-
 
+
-
{{clear}}
+
-
==== Lunar Eclipses ====
+
-
The orrery can display information about every [[:wikipedia:Lunar_Eclipse|lunar eclipse]] occurring from from 1999 BC through 3000 AD - a bit more than 12000 eclipses (the database used is the "Five Millennium Canon of Lunar Eclipses: -1999 to +3000" available at http://eclipse.gsfc.nasa.gov/SEpubs/5MCLE.html, although the orrery generates its own maps).  It will display information about the visibility and duration of the eclipse as seen from the current location.  When one selects the Lunar Eclipse page, the checklist page shown on the right is presented.[[Image:OrreryLunarEclipsePage1.png|thumb|200px|alt=Selection page for Lunar Eclipses|Selection page for Lunar Eclipses]] Because so many eclipses can be displayed, by default the user is presented with a small subset of the eclipses: those which occur during the next 10 years.  One may change the starting and ending years to access other eclipses.  The "List only eclipses visible from here" checkbox allows you to produce a list of only those eclipses for which at least some portion of the eclipse is visible at your location.  Other checkboxes allow you to decide which types of lunar eclipses; penumbral, partial and/or total, you wish to display.  By default [[:wikipedia:Lunar_Eclipse#Types_of_lunar_eclipse|penumbral]] eclipses are not displayed, because they involve only a rather subtle changing of the moon's illumination.    If you change any of the selection criteria on this page, you need to tell the program to generate a new list of eclipses to display by pressing the "Rebuild the Eclipse List" button.  If you don't change the checkboxes, you do not need to push that button.  '''To select the eclipse you wish to observe, click the "Click Here to Select the Eclipse to Display" area''', and you will be presented with a scrollable list of eclipses to choose from.  You will not be presented with an eclipse list unless you click in that region (shown outlined in red, in the screenshot to the right).
+
-
 
+
-
 
+
-
Once you have chosen the eclipse you're interested in, you will be shown information about that eclipse on a new page.  Once such image, for the total lunar eclipse of April 15, 2014,  is shown on the right.[[Image:OrreryLunarEclipsePage2.png|thumb|200px|alt=Lunar Eclipse Display Page|Lunar Eclipse Display Page]]  Below the title of the page, the orrery displays whether or not you can see the selected eclipse.  If the moon rises or sets during the eclipse, that information is listed too.  Below that, the duration of each phase of the eclipse (as seen from your location) is listed.  Below that, the starting and ending times of each phase, along with the time of maximum eclipse, is listed.  All times are in Universal Time.  Remember that if you observe the penumbral phase of the eclipse, the changes in the moon's appearance may not even be noticeable; only the partial and total phases are visually striking.
+
-
 
+
-
 
+
-
The upper graphic on the eclipse display page shows the path of the moon through the earth's shadow.  The [[:wikipedia:Umbra|penumbra]] (where the earth only partially blocks the sun as seen from the moon) is shown in light grey and the umbra (where the earth completely blocks the sun as seen from the moon) is shown in darker grey.  The ecliptic is shown in red, and the path of the moon is indicated with a turquoise arrow.  If the moon rises or sets at your location during the eclipse, the moon's position in the shadow at that time is shown in red.
+
-
 
+
-
 
+
-
At the bottom of the eclipse display page a map is presented showing the portions of the earth which can see the eclipse.  The observer's location is indicated with a red dot, and the map itself is centered at the longitude of the observer.  The light blue dot shows the position on the earth for which the moon is at the zenith at the moment of maximum eclipse.  The light blue line shows the longitude for which the moon is on the [[:wikipedia:Meridian_(astronomy)|meridian]] at the moment of maximum eclipse.  The darkest grey region shows the portion of the earth for which none of the eclipse can be seen.  Observers in the white region can see at least some portion of the maximum phase of the eclipse.  In other words, if the eclipse is total, an observer in the white region sees at least some part of the total phase of the eclipse.  If the eclipse is partial, an observer in the white region sees a partial eclipse.  Other shades of grey are used for regions that, for example, can only see the partial phases of a total eclipse.  The next image to the right indicates the meaning of the various shaded regions and lines on this eclipse visibility plot.[[Image:OrreryLunarEclipseMapKey.png|thumb|200px|alt=Lunar Eclipse Visibility Plot|Lunar Eclipse Visibility Plot]]
+
-
{{clear}}
+
-
 
+
-
{{clear}}
+
-
==== Comets ====
+
-
 
+
-
The Comets page displays information about any [[:wikipedia:Comet|comet(s)]] that the app knows about.  An example of the display produced is shown on the right.[[Image:orreryCometPage.png|thumb|200px|alt=Comets Page|Comets page]] Information for comets which are currently below the horizon is shown in grey (as is the case for comet [[:wikipedia:C/2011_L4|Pan-STARRS]] in the sample page).
+
-
 
+
-
Unlike the major planets, comet information for orrery is obtained from
+
-
[[:wikipedia:Ephemerides|ephemerides]] obtained from the [[:wikipedia:JPL_Horizons|JPL Horizons website]].  Ephemerides are used for comets because their orbits may be strongly perturbed by the major planets as the comets move through the inner Solar System.  Since ephemerides are used, the orrery can only display information for a comet during the period covered by the ephemeris, usually one year before and after the periheion passage.  Outside of that period the comet is ignored and not plotted anywhere.
+
-
 
+
-
In addition to the Comets page, comet information shows up several other places.  The comet will be plotted on the sky map page (default page) if showing comets has been enabled via the Displayed Items menu page.  Comets will also be shown on the Planet Compas page, the Planet Elevations page and the To-scale Solar System page.  Note that if their are comets visible, there will be a button in the upper left area of the Planet Elevation page allowing you to toggle between showing planets and showing comets.
+
-
 
+
-
The To-scale Solar System page shows the orbits projected onto the Solar System's equatorial plane.  Since comets follow paths that are often very highly inclined to that plane (as is the case for comet Pan-STARRS), this projection effect can make it look like the Sun is not at the focus of the orbit, but of course it must be.  This is merely an illusion.
+
-
 
+
-
===== Adding Additional Comets =====
+
-
 
+
-
You can add more comets for the orrery to display.  To do so, you need to create an ephemeris file.  The file must have the following format:
+
-
 
+
-
The first line must contain the name of the comet, optionally followed by a second "nickname" for the comet.
+
-
All other lines must be formatted as follows:
+
-
Character Range                        Description
+
-
  0 ->  3                          Year (2012, etc)
+
-
  5 ->  7                          Month (Jan, Feb, etc)
+
-
  9 -> 10                          Day of month
+
-
12 -> 13                          Hour
+
-
15 -> 16                          Minute
+
-
18 -> 28                          Geocentric RA (HH:MM:SS.SS)
+
-
30 -> 40                          Geocentric Dec (+DD:MM:SS.SS)
+
-
43 -> 47                          Magnitude (MM.MM)
+
-
49 -> 56                          Ecliptic Longitude (DDD.DDDD)
+
-
58 -> 65                          Ecliptic Latitude (+DD.DDDD)
+
-
67 -> 79                          Distance from Sun (AU)
+
-
 
+
-
This information can be easily obtained from the JPL Horizons website.  For the ephemerides I include with the package, I have one entry for every time the comet moves by one degree in the sky, so the sampling is much finer near perihelion.  The file must be placed in the directory /opt/maemo/usr/share/orrery/comets/ .  The name of the file does not matter.
+
=== Displayed Items ===
=== Displayed Items ===
-
 
+
The "Displayed Items" page allows you to configure the display, selecting
-
The "Displayed Items" page allows you to configure the display, selecting such things as the faintest magnitude object displayed, whether constellation lines are plotted, whether or not star names are displayed, etc.
+
such things as the faintest magnitude object displayed, whether constellation
 +
lines are plotted, whether or not star names are displayed, etc.
==== Deep Sky Objects ====
==== Deep Sky Objects ====
 +
If you select "Deep Sky Obs" from the "Displayed Items" menu, you will
 +
be shown some of the brightest Deep Sky Objects.  Deep Sky
 +
Objects are objects such as galaxies, expelled envelopes of
 +
dying stars, clusters of young stars and luminous gas.  A few,
 +
such as the Andromeda Galaxy, are visible to the unaided eye.
 +
Many more are visible with binoculars or a small telescope.
 +
The orrery shows all messier objects, and many other
 +
well known bright nebulae and star clusters.
 +
The image bellow shows the Messier objects in Sagittarius.
-
[[Image:orrerySagitarriusClusters_3.2.png|thumb|200px|alt=Screenshot of star clusters in Sagittarius|Star clusters in Sagittarius]]
+
[[Image:orrerySagitarriusClusters.png|200px|Star clusters in Sagittarius]]
-
 
+
-
If you select "Deep Sky Obs" from the "Displayed Items" menu, you will be shown some of the brightest [[:wikipedia:Deep_sky_object|Deep Sky Objects]]. Deep Sky Objects are objects such as galaxies, expelled envelopes of dying stars, clusters of young stars and luminous gas. A few, such as the Andromeda Galaxy, are visible to the unaided eye. Many more are visible with binoculars or a small telescope. The orrery shows all [[:wikipedia:Messier_object|Messier objects]], and many other well known bright nebulae and star clusters. The image bellow shows the Messier objects in Sagittarius.
+
===== Adding Your Own Deep Sky Object List =====
===== Adding Your Own Deep Sky Object List =====
 +
You may add your own list of deep sky objects to be
 +
plotted.  Simply create a file within the directory
 +
/usr/share/orrery/deepSky/ with any name.  The
 +
file should contain lines of text with the format
-
You may add your own list of deep sky objects to be plotted. Simply create a file within the directory <code>/usr/share/orrery/deepSky/</code> with any name. The file should contain lines of text with the format:
+
name HH MM SS.SS DD MM SS.S type mag
-
name HH MM SS.SS DD MM SS.S type mag
+
where name is the object name, which may not include
-
 
+
white space, HH MM SS.SS is the Right Ascension,
-
where name is the object name, which may not include white space, HH MM SS.SS is the Right Ascension, DD MM SS.S is the declination (do not include a + sign for positive declinations) "type" is an integer specifying the type of object:
+
DD MM SS.S is the declination (do not include a + sign
-
* 0 = [[:wikipedia:Supernova_remnant|Supernova Remnant]]
+
for positive declinations) "type" is an integer
-
* 1 = [[:wikipedia:Globular_cluster|Globular Cluster]]
+
specifying the type of object. 0 = [http://en.wikipedia.org/wiki/Supernova Supernova] Remnant,
-
* 2 = [[:wikipedia:Open_cluster|Open Cluster]]
+
1 = [http://en.wikipedia.org/wiki/Globular_Cluster Globular Cluster], 2 = [http://en.wikipedia.org/wiki/Open_cluster Open Cluster], 3 = [http://en.wikipedia.org/wiki/Diffuse_nebula#Diffuse_nebulae Diffuse Nebula] ([http://en.wikipedia.org/wiki/HII_regions HII region], etc), 4 = [http://en.wikipedia.org/wiki/Planetary_nebula Planetary Nebula], and
-
* 3 = [[:wikipedia:Nebula#Diffuse_nebulae|Diffuse Nebula]] ([[:wikipedia:H_II_region|HII region]], etc.)
+
5 = [http://en.wikipedia.org/wiki/Galaxy Galaxy]The "mag" is the visual magnitude.   The
-
* 4 = [[:wikipedia:Planetary_nebula|Planetary Nebula]]
+
orrery program currently does nothing with the visual magnitude, but future versions may use it.
-
* 5 = [[:wikipedia:Galaxy|Galaxy]]
+
-
The "mag" is the visual magnitude. The orrery program currently does nothing with the visual magnitude, but future versions may use it.
+
==== Meteor Radiants ====
==== Meteor Radiants ====
-
 
+
If you select Meteor Radiants, then the radiant position for any
-
If you select Meteor Radiants, then the radiant position for any meteor showers which are now occurring will be plotted. The radiant is the position in the sky from which meteors seem to emerge during a shower - it's the best place in the sky to look for meteors.The radiant is plotted in white if more than 50 meteors per hour are expected under optimal viewing conditions, cream-color if 20 or more meteors per hour are expected, and grey if fewer then 20 meteors per hour are expected. Note that these are meteor rates for the date of the shower maximum - see the Meteor Showers page for more information. The radiant position usually changes as the shower progresses. The orrery takes that into account when plotting the radiant.
+
meteor showers which are now occurring will be plotted.
 +
The radiant is the position in the sky from which meteors seem
 +
to emerge during a shower - it's the best place in the sky to
 +
look for meteors. The radiant is plotted in
 +
white if more than 50 meteors per hour are expected under optimal
 +
viewing conditions, cream-color if 20 or more meteors per hour
 +
are expected, and grey if fewer then 20 meteors per hour are
 +
expected.   Note that these are meteor rates for the date of the
 +
shower maximum - see the Meteor Showers page for more information.
 +
The radiant position usually changes as the shower progresses.
 +
The orrery takes that into account when plotting the radiant.
==== Changing the Magnitude Limit ====
==== Changing the Magnitude Limit ====
-
 
+
The magnitude scale for expressing the brightness of
-
The magnitude scale for expressing the brightness of stars and planets is explained [[:wikipedia:Apparent_magnitude|in this Wikipedia article]]. It is one of the oldest
+
stars and planets is explained [http://en.wikipedia.org/wiki/Apparent_magnitude here].   It is one of the oldest
measurement systems still in use today.
measurement systems still in use today.
-
By default, the orrery displays every star a person with excellent eyesight located in a very dark area on a moonless night can see. If your observing conditions are less ideal than that, it can be helpful to use the "Mag. Limit" field in the item menu to lower
+
By default, the orrery displays every star a person with excellent
-
the limit of the faintest object plotted.
+
eyesight located in a very dark area on a moonless night can see.
-
 
+
If your observing conditions are less ideal than that, it can be
-
==== Star Names ====
+
helpful to use the "Mag. Limit" field in the item menu to lower
-
 
+
the limit of the faintest object plotted.  
-
[[Image:OrreryNamesWithZooming5.png|thumb|400px|alt=Screenshot of star names|Star Names]]
+
-
 
+
-
Selecting Star Names will cause the traditional, western names for stars to be displayed.  Most of these names are corrupted versions of ancient Arabic names. If you zoom the image, more names will be shown.
+
-
{{clear}}
+
-
 
+
-
==== Bayer Designations ====
+
-
 
+
-
[[Image:OrreryBayerNames.png|thumb|400px|alt=Screenshot of Bayer star names|Bayer star Names]]
+
-
 
+
-
As an alternative to displaying the names of the bright stars, you can instead display the [[:wikipedia:Bayer_designation|Bayer Designations]]. These are the designations using Greek letters, like the well-known "[[:wikipedia:Alpha_Centauri|Alpha Centauri]]". It is recommended that you do not display both the star names and Bayer designations at the same time, because the display will become rather crowded. As with star names, if you zoom the display, more Bayer designations will become visible, as shown at right.
+
-
{{clear}}
+
=== Change Time ===
=== Change Time ===
 +
The "Change Time" page allows you to specify an
 +
explicit time between 3000 BC and 3000 AD, or the current
 +
time.  If "Now" is selected, the current time is used and the display updates
 +
automatically once per minute.  If a specific time is selected,
 +
it is shown in red, to remind you that the display is not
 +
going to update automatically as time passes.  The time may be
 +
specified as a calendar date, or as a Julian Date.
-
The "Change Time" page allows you to specify an explicit time between 3000 BC and 3000 AD, or the current time. If "Now" is selected, the current time is used and the display updates automatically once per minute. If a specific time is selected, it is shown in red, to remind you that the display is not going to update automatically as time passes. The time may be specified as a calendar date, or as a Julian Date.
+
If the Calendar checkbox is selected, you can choose the date and time (UT) using the normal Hildon selector widgets for these quantities.   Note - this option only allows dates from 1900 to 2100 AD to be selected.   To chose a date outside that time range, you must use the Text Entry option.
-
If the Calendar checkbox is selected, you can choose the date and time (UT) using the normal Hildon selector widgets for these quantities. Note - this option only allows dates from 1900 to 2100 AD to be selected. To chose a date outside that time range, you must use the Text Entry option.
+
The [http://en.wikipedia.org/wiki/Julian_Date Julian Date] is a less ambiguous way of entering times
-
 
+
in the distant past than using a calendar date, because of the
-
The [[:wikipedia:Julian_Date|Julian Date]] is a less ambiguous way of entering times
+
differing calendar systems in use worldwide before the late 16th
-
in the distant past than using a calendar date, because of the differing calendar systems in use worldwide before the late 16th century. For example, the date October 10, 1582 never occurred in some European countries. Many countries have gaps in their calendars
+
century. For example, the date October 10, 1582 never occurred in
-
with missing dates when they adopted the [[:wikipedia:Gregorian_Calendar|Gregorian Calendar]].
+
some European countries. Many countries have gaps in their calendars
 +
with missing dates when they adopted the [http://en.wikipedia.org/wiki/Gregorian_Calendar Gregorian Calendar].
Note about the Text Entry option: At this time, the numeric fields can only be changed with the keyboard's up/down arrow keys, or with text entry via the soft keyboard.
Note about the Text Entry option: At this time, the numeric fields can only be changed with the keyboard's up/down arrow keys, or with text entry via the soft keyboard.
=== Change Location ===
=== Change Location ===
 +
This page allows you to select the position of the observer on the earth's surface.  You can use the position derived by the N900 itself
 +
(either from cell tower coordinates or GPS),
 +
a user specified latitude and longitude, or a location selected from a menu.
-
This page allows you to select the position of the observer on the earth's surface. You can use the position derived by the N900 itself (either from cell tower coordinates or GPS), a user specified latitude and longitude, or a location selected from a menu.
+
If you chose the "Phone" option, the most recent position derived by the N900 will be used.  If the phone has not yet established a position, the default location will be used until the phone has derived a position.
-
If you chose the "Phone" option, the most recent position derived by the N900 will be used. If the phone has not yet established a position, the default location will be used until the phone has derived a position.
+
If you choose the "Custom" option, you may enter a new position by typing text into the "Name" field, and using the "Longitude" and "Latitude" selection widgets.   Don't forget the "West", "East", "North" and "South" buttons - they select the sign of the latitude and longitude.  Once you've entered a new custom position, you'll be given the option of saving it in your private catalog.
-
If you choose the "Custom" option, you may enter a new position by typing text into the "Name" field, and using the "Longitude" and "Latitude" selection widgets. Don't forget the "West", "East", "North" and "South" buttons - they select the sign of the latitude and longitude. Once you've entered a new custom position, you'll be given the option of saving it in your private catalog.
+
To choose a predefined position from a menu, select the "Menu" option near the bottom of the page.
 +
You will notice that the "Region" menu will then become highlighted.  Push "Region", and then select the continent or category of the area you want the sky to be shown for.   Once you have selected a region, a pull-down menu with the name of that region will appear next to the "Region" button.  Use that new menu to select your city.  After the city is selected, its name will appear next to the regional menu.
-
To choose a predefined position from a menu, select the "Menu" option near the bottom of the page. You will notice that the "Region" menu will then become highlighted. Push "Region", and then select the continent or category of the area you want the sky to be shown for. Once you have selected a region, a pull-down menu with the name of that region will appear next to the "Region" button. Use that new menu to select your city. After the city is selected, its name will appear next to the regional menu.
+
If you select a "Custom" or "Menu" location, a button labeled
 +
"Save in Private Menu" will appear.   After you select your new position,
 +
you may push that button to save it in the menu labeled "Private".
 +
That menu is initially empty.
-
If you select a "Custom" or "Menu" location, a button labeled "Save in Private Menu" will appear. After you select your new position, you may push that button to save it in the menu labeled "Private". That menu is initially empty.
+
If you would like
-
 
+
to add additional cities etc to one of the menus other than the private menu, you may simply
-
If you would like to add additional cities, etc. to one of the menus other than the private menu, you may simply edit one of the menu files, and add the name, latitude and longitude of the location. The lists of locations are stored in ASCII text files under the menus subdirectory of the program installation area on your phone. You will need to reload the "Change Location" page for your new locations to become available.
+
edit one of the menu files, and add the name, latitude and longitude
 +
of the location.     The lists of
 +
locations are stored in ASCII text files under the menus subdirectory
 +
of the program installation area on your phone. You will need to reload the "Change Location" page for
 +
your new locations to become available.
==== How to change the default location from Boston ====
==== How to change the default location from Boston ====
-
 
To change the default location, just use the "Change Location" menu option to select a new
To change the default location, just use the "Change Location" menu option to select a new
-
location as described above. That will make the currently selected position your new default location, which will be used whenever the program is started, unless "Phone" is selected as the source for position information.
+
location as described above.   That will make the currently selected position your new default location, which will be used whenever the program is started, unless "Phone" is selected as the source for position information.
=== Web Help Page ===
=== Web Help Page ===
-
 
This button brings up this wiki page in the browser, provided you have a network connection.
This button brings up this wiki page in the browser, provided you have a network connection.
=== Quick Tips ===
=== Quick Tips ===
-
 
This button brings up a page with a few basic instructions for operating the program.  It does not require a network connection.
This button brings up a page with a few basic instructions for operating the program.  It does not require a network connection.
-
 
-
== Minimized Display ==
 
-
 
-
[[Image:OrreryMinimized.png|thumb|200px|alt=Screenshot of minimized orrery|Minimized Orrery]]
 
-
When the orrery window is minimized by the N900's window manager, it produces a different display which is legible even when the window is in its shrunken state.  The image at the right shown this minimal mode, when the N900 is in landscape mode.  It shown the phase of the moon in the center, and plots indicating the Sun (far right plot) and Moon (far left plot) azimuth (outside triangle) and elevation (inside arrow).  The triangle and arrow are green if the object is currently above the horizon.  At the top of the display, the UT is shown, and the bottom of the display has the LST.  These are continuously updated.
 
-
 
-
In portrait mode, the minimized display shows the names of each planet that is currently above the horizon (not including uranus and Neptune, which are not visible to the unaided eye).  The elevation of the planet, in degrees, is also shown, in green if the source has not yet passed through transit, and red otherwise.
 
-
 
-
{{clear}}
 
== Touchscreen Gestures ==
== Touchscreen Gestures ==
-
 
+
There are four types of touchscreen gestures which you can make
-
There are four types of touchscreen gestures which you can make in the plotting area which are recognized by the orrery: Taps, Zooms, Pans and Presses.
+
in the plotting area which are recognized by the orrery: Taps,
 +
Zooms, Pans and Presses.
=== Taps ===
=== Taps ===
-
 
+
If you press the display area, and withdraw your finger or stylus
-
If you press the display area, and withdraw your finger or stylus within 0.25 seconds, that gesture is considered a tap. Tapping in the lower 1/5 of the display area will pan the display in azimuth. Tapping anywhere else toggles between the default screen and the constellation screen.
+
within 0.25 seconds, that gesture is considered a tap.
 +
Tapping in the lower 1/5 of the display area will pan the display in
 +
azimuth.   Tapping anywhere
 +
else toggles between the default screen and the constellation screen.
=== Zooms ===
=== Zooms ===
 +
If you press the screen and trace out a roundish figure, and remain
 +
in contact with the screen for more than 0.25 seconds, and if
 +
the figure encloses a nontrivial (> 300 pixels) area, the gesture
 +
is considered to be a zoom.  As you move your finger or
 +
stylus, the region you are outlining will be shown
 +
as a green dotted line.  After you release your finger
 +
from the display, a red box will be shown.
 +
The red box is a rectangle with the aspect ratio of the
 +
display area, and the same area and centroid as the region you
 +
traced out with your finger.  The display will then be zoomed so
 +
that the region in the red box fills the display area.
-
If you press the screen and trace out a roundish figure, and remain in contact with the screen for more than 0.25 seconds, and if the figure encloses a nontrivial (> 300 pixels) area, the gesture is considered to be a zoom. As you move your finger or stylus, the region you are outlining will be shown as a green dotted line.  After you release your finger from the display, a red box will be shown. The red box is a rectangle with the aspect ratio of the display area, and the same area and centroid as the region you
+
Zooming can do some non-intuitive things, especially if you zoom near
-
traced out with your finger. The display will then be zoomed so that the region in the red box fills the display area.
+
the upper left or upper right of the display.   This is because
 +
the orrery's transverse mercator projection always has a line of
 +
constant azimuth in the centerThis means that something zoomed
 +
at the edge of the display area will be rotated as it is zoomed, and
 +
some of the stars you wish to display may be rotated out of the
 +
display area.  It is best, especially if you are zooming in on
 +
an area near the zenith, to first pan the display so that the region
 +
is near the center of the display, before zooming.  The nice
 +
thing about the transverse mercator projection is that a zoomed
 +
area is displayed with the orientation it would have if you were
 +
directly facing it at the time indicated by the display.
-
Zooming can do some non-intuitive things, especially if you zoom near the upper left or upper right of the display. This is because the orrery's transverse mercator projection always has a line of constant azimuth in the center. This means that something zoomed
+
If your zoom area includes the zenith, the display may do weird
-
at the edge of the display area will be rotated as it is zoomed, and some of the stars you wish to display may be rotated out of the display area. It is best, especially if you are zooming in on an area near the zenith, to first pan the display so that the region
+
things.   This is a bug.
-
is near the center of the display, before zooming. The nice thing about the transverse mercator projection is that a zoomed area is displayed with the orientation it would have if you were directly facing it at the time indicated by the display.
+
-
 
+
-
If your zoom area includes the zenith, the display may do weird things. This is a bug.
+
'''To unzoom - just press the screen for longer than 0.25 seconds, without moving your finger (much)'''.
'''To unzoom - just press the screen for longer than 0.25 seconds, without moving your finger (much)'''.
=== Pans ===
=== Pans ===
-
 
+
A pan is like a zoom, but with a more linear, rather than roundish
-
A pan is like a zoom, but with a more linear, rather than roundish gesture. A pan can be used to move the center of a zoomed region. It has no effect if the display area is not zoomed. After you release your finger or stylus following a zoom gesture, orrery will show the region you traced out in green, and will draw a red arrow showing the direction and size of the pan. After that, the display is re-drawn with the new center position.
+
gesture.   A pan can be used to move the center of a zoomed region.
 +
It has no effect if the display area is not zoomed.   After you
 +
release your finger or stylus following a zoom gesture, orrery
 +
will show the region you traced out in green, and will draw a red
 +
arrow showing the direction and size of the pan.   After that,
 +
the display is re-drawn with the new center position.
=== Presses ===
=== Presses ===
 +
If you push down on the touchscreen for more than 0.25 seconds, and
 +
do not move your finger or stylus significantly while making contact,
 +
you will have made a press gesture.  Since one almost always moves
 +
one's finger a little by while pressing the screen, some small motion
 +
is allowed during a press gesture.  This means that a zoom or pan
 +
gesture cannot be arbitrarily small, because it will be interpreted
 +
as a press.
-
If you push down on the touchscreen for more than 0.25 seconds, and do not move your finger or stylus significantly while making contact, you will have made a press gesture. Since one almost always moves one's finger a little by while pressing the screen, some small motion is allowed during a press gesture. This means that a zoom or pan gesture cannot be arbitrarily small, because it will be interpreted as a press.
+
If the screen is zoomed, then the press gesture unzooms it.   If the
-
 
+
screen is already unzoomed, then the press gesture has the same
-
If the screen is zoomed, then the press gesture unzooms it. If the screen is already unzoomed, then the press gesture has the same effect as a tap gesture.
+
effect as a tap gesture.
== Symbols ==
== Symbols ==
-
 
=== Symbol Key ===
=== Symbol Key ===
 +
If you select "About Orrery / Symbol Key" from the "opts" menu, you
 +
will be shown an annotated list of the symbols used by the orrery,
 +
which is reproduced below:
-
[[Image:orrerySymbolKey_3.2.png|thumb|200px|alt=Screenshot of Orrery symbols|Symbols used by the orrery]]
+
[[Image:orrerySymbolKey-3.1.png|200px|Symbols used by the orrery]]
-
If you select "About Orrery / Symbol Key" from the "opts" menu, you will be shown an annotated list of the symbols used by the orrery, which is reproduced at right.
+
NOTE: the current version is 3.1.
-
 
+
-
NOTE: the current version is 3.5.
+
=== Planet Symbols ===
=== Planet Symbols ===
-
 
+
The solar system symbols, used by default on the constellation
-
The solar system symbols, used by default on the constellation page (screen two), are the standard astronomical symbols for these objects. They are explained
+
page (screen two), are the standard astronomical symbols for these
-
[[:wikipedia:Planet_symbols|on Wikipedia]].
+
objects.   They are explained
 +
[http://en.wikipedia.org/wiki/Planet_symbols here].
=== Plotted Lines ===
=== Plotted Lines ===
-
 
+
The dotted yellow line is the Celestial Equator, the intersection of
-
The dotted yellow line is the Celestial Equator, the intersection of the Earth's equatorial plane with the celestial sphere. The red dotted line is the Ecliptic. The Ecliptic is the intersection of the Earth's orbital plane with the celestial sphere. The Ecliptic is also the path of the Sun across the sky, and the intersection points between the Celestial Equator and the Ecliptic are where the Sun is at the time of an equinox. Constellations lying along the Ecliptic plane are zodiac constellations. The planets and the Moon are always near, but usually not exactly on, the Ecliptic. The blue-green dotted line is the Galactic Plane, the intersection of the plane of the Milky Way's disk and the celestial sphere.
+
the Earth's equatorial plane with the celestial sphere.   The red
-
{{clear}}
+
dotted line is the Ecliptic.   The Ecliptic is the intersection
 +
of the Earth's orbital plane with the celestial sphere.   The
 +
Ecliptic is also the path of the Sun across the sky, and the intersection
 +
points between the Celestial Equator and the Ecliptic are where the
 +
Sun is at the time of an equinox.   Constellations lying along the
 +
Ecliptic plane are zodiac constellations.   The planets and the Moon
 +
are always near, but usually not exactly on, the Ecliptic.
 +
The blue-green dotted line is
 +
the Galactic Plane, the intersection of the plane of the Milky Way's
 +
disk and the celestial sphere.
== Displaying Stars Too Faint for the Unaided Eye to See ==
== Displaying Stars Too Faint for the Unaided Eye to See ==
-
 
+
The default sky catalog used by the orrery contains every star
-
The default sky catalog used by the orrery contains every star you can see with your unaided eye, even if you have exceptionally good eyesight, and are located in a very dark area on a moonless night. If you wish to display stars which require binoculars or a small telescope to be seen, you can download the file hipparcos_9.0.dat from the  
+
you can see with your unaided eye, even if you have
 +
exceptionally good eyesight, and are located in a
 +
very dark area on a moonless night. If you wish to display stars
 +
which require binoculars or a small telescope to be seen, you can
 +
download the file hipparcos_9.0.dat from the  
[https://garage.maemo.org/projects/orrery/ orrery area of the gForge site].   
[https://garage.maemo.org/projects/orrery/ orrery area of the gForge site].   
-
You must load this file onto your phone, of course, but you probably will want to store it on the removable microSD card, because the file is so large (3 megabytes). You must make a softlink in the top of the orrery files area called "faintStars", which will point to where the hipparcos_9.0.dat is actually stored. For example, if you do the default installation of the orrery, and if you store the hipparcos_9.0.dat at the top directory of your microSD card, you must issue the following command to make the faint star catalog usable:
+
You must load this file onto your phone, of course, but you
-
 
+
probably will want to store it on the removable microSD card, because the file
-
ln -s /media/mmc1/hipparcos_9.0.dat /usr/share/orrery/faintStars
+
is so large (3 megabytes).   You must make a softlink in the top
-
 
+
of the orrery files area called "faintStars", which will point to
 +
where the hipparcos_9.0.dat is actually stored.   For example,
 +
if you do the default installation of the orrery, and if you store the hipparcos_9.0.dat
 +
at the top directory of your microSD card, you must issue the following
 +
command to make the faint star catalog usable:
 +
<pre>
 +
> ln -s /media/mmc1/hipparcos_9.0.dat \
 +
/usr/share/orrery/faintStars
 +
</pre>
You must restart the orrery after making this softlink.
You must restart the orrery after making this softlink.
-
Once the new catalog and softlink are in place, the orrery will allow you to change the maximum magnitude (using the "Displayed Items" menu option) all the way up to magnitude 9.0. Note that the default, smaller catalog is still used if the maximum magnitude is no larger than 6.6, so you may used the orrery with the faint star catalog, and not incur and performance penalty as long as you restrict yourself to stars no fainter than 6.6.  The faint (mag > 6.6) stars cannot be displayed in constellation mode.
+
Once the new catalog and softlink are in place, the orrery will  
 +
allow you to change the maximum magnitude (using the "Displayed Items" menu option)
 +
all the way up to magnitude 9.0.   Note that the default, smaller catalog
 +
is still used if the maximum magnitude is no larger than 6.6, so you
 +
may used the orrery with the faint star catalog, and not incur and
 +
performance penalty as long as you restrict yourself to stars no
 +
fainter than 6.6.  The faint (mag > 6.6) stars cannot be displayed
 +
in constellation mode.
-
The default orrery star catalog contains 9931 stars. hipparcos_9.0.dat contains 83392 stars, and is complete to 9th magnitude. The orrery will be more sluggish if you choose to display stars fainter than 6.6, because it must process the larger star catalog.
+
The default orrery star catalog contains 9931 stars.   hipparcos_9.0.dat
 +
contains 83392 stars, and is complete to 9th magnitude. The orrery will
 +
be more sluggish if you choose to display stars fainter than 6.6, because
 +
it must process the larger star catalog.
-
The plot below shows [[:wikipedia:Hyades_(star_cluster)|Hyades star cluster]] with limiting magnitudes of 6.6 (left) and 9.0 (right).
+
The plot below shows [http://en.wikipedia.org/wiki/Hyades_(star_cluster) Hyades star cluster] with limiting magnitudes of 6.6 (left) and 9.0 (right).
-
[[Image:orreryHyadesMagComp.png|thumb|400px|alt=Screenshot of Orrery catalogs|Orrery Catalogs]]
+
[[Image:orreryHyadesMagComp.png|400px|Orrery Catalogs]]
-
Remember, there's no reason at all to install the hipparcos_9.0.dat file unless you plan to do star gazing with binoculars or a small telescope.
+
Remember, there's no reason at all to install the hipparcos_9.0.dat
-
{{clear}}
+
file unless you plan to do star gazing with binoculars or a small
 +
telescope.
== Chinese Color Scheme ==
== Chinese Color Scheme ==
-
 
+
In traditional Chinese astronomy, the zodiac is known as the Yellow Way, and the celestial equator is known as the Red Way.   If you want the orrery to use that color scheme for great circles and constellations, edit the file /usr/share/orrery/config, and make the first line
-
In traditional Chinese astronomy, the zodiac is known as the Yellow Way, and the celestial equator is known as the Red Way. If you want the orrery to use that color scheme for great circles and constellations, edit the file <code>/usr/share/orrery/config</code>, and make the first line read
+
read
  CHINESE_COLOR_SCHEME 1
  CHINESE_COLOR_SCHEME 1
Line 498: Line 561:
=== Preserving the Private Catalog ===
=== Preserving the Private Catalog ===
-
If you installed the first version of the orrery program (3.0.x), and if you made location entries in the "Private catalog", upgrading to the 3..1.3-1 version will delete your "Private catalog", and all your saved locations will be lost. You may prevent this by using "X Terminal" to issue the following commands '''before upgrading''':
+
If you installed the first version of the orrery program (3.0.x), and if you made location entries in the "Private catalog", upgrading to the 3..1.3-1 version will delete your "Private catalog", and all your saved locations will be lost.   You may prevent this by using "X Terminal" to issue the following commands '''before upgrading''':
  mkdir /home/user/.orrery
  mkdir /home/user/.orrery
Line 504: Line 567:
== Contact Information ==
== Contact Information ==
-
 
+
Please send comments, suggestions, questions and/or
-
Please send comments, suggestions, questions and/or abuse to orrery.moko@gmail.com
+
abuse to orrery.moko@gmail.com
[[Category:Software]]
[[Category:Software]]
[[Category:Users]]
[[Category:Users]]

Learn more about Contributing to the wiki.


Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!


Cancel | Editing help (opens in new window)

Templates used on this page: