Moon: Difference between revisions

From OLPC
Jump to navigation Jump to search
 
(63 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{Activity migrated to sl.o
| download=http://activities.sugarlabs.org/en-US/sugar/addon/4034 Moon
| git=http://git.sugarlabs.org/projects/moon Moon
| homepage=http://wiki.sugarlabs.org/go/Activities/Moon Moon
}}

[[Category:Science]]
[[Category:Science]]


{{olpcboxtop|toptext=[[{{PAGENAME}}|Moon]]}}
{{olpcboxtop|toptext=[[{{PAGENAME}}|Moon]]}}
{{ OBX activity |[[Image:moon-icon.png]]|extra}}
{{ OBX activity|[[Image:moon-icon.png|40px]]|extra}}
{{ OBX source|http://git.sugarlabs.org/projects/moon}}
{{ OBX pot|}}
{{ OBX xobundle|http://activities.sugarlabs.org/en-US/sugar/downloads/file/26476/moon-11.xo|Moon-11}}
{{ OBX team |[[User:Garycmartin|Gary C Martin]]}}
{{ OBX pootle|1=http://git.sugarlabs.org/projects/moon/repos/mainline/blobs/master/po/moon.pot}}
{{ OBX team|[[User:Garycmartin|Gary C Martin]]}}
{{olpcboxbottom}}
{{olpcboxbottom}}


= Moon =
= Description =
A simple Moon phase viewer for the XO laptop including Lunar eclipse information and effect. Its usefulness as a shared activity will make more sense once the planned Sugar bulletin-board/chat overlay interface is implemented, where children will be able to point out features and places of interest to each other.


Moon is a simple Lunar phase activity for the XO laptop, including upcoming Lunar eclipse information and effects. Its usefulness as a shared activity will make more sense once the planned Sugar bulletin-board overlay interface is implemented, where children will be able to point out features and places of interest to each other.
= Screenshot =
[[Image:MoonActivity.gif|640px]]


== Screenshots ==
= How to Install =

Download this '''.xo''' file using the Browse activity: [http://wiki.laptop.org/images/c/c5/Moon-v1.xo Moon.xo]
[[Image:moon_screen1.jpg|615px]]

[[Image:moon_screen2.jpg|305px]] [[Image:moon_screen3.jpg|305px]]

== How to Install ==

Download this '''.xo''' file using the Browse activity: [http://activities.sugarlabs.org/en-US/sugar/downloads/file/26476/moon-11.xo Moon-11.xo]

== Moon Phases ==

See also http://en.wikipedia.org/wiki/Lunar_phase#Names_of_lunar_phases

=== New Moon ===

[[Image:Newmoon.jpg|left]] The new Moon is very hard to observe as it rises and sets so close to the Sun's position in the sky. This is the time when it's possible for a solar eclipse to occur, but due to the small visible size of both the Sun and the Moon disks, it happens very rarely. You may get a glimpse of the Moon's unlit disk just before sunrise or just after sun set before the sky gets too bright.<br clear="all" />

=== First Quarter ===

[[Image:Firstquartermoon.jpg|left]] The Moon rises after the Sun is up, while you're in full daylight, so you'll not get a good view until the Sun begins to set and the sky darkens. As the sky darkens the Moon will be high and/or towards the west.<br clear="all" />

=== Full Moon ===

[[Image:Fullmoon.jpg|left]] The full Moon rises in the east at about the same time the Sun sets, then sets in the west at about the same time the Sun rises - so it's quite easy to observe on a clear night. The Moon rise and set times, opposing the Sun's, are because full Moons occur when you (and the rest of the Earth) are directly between the Moon and the Sun. This is also the time when it's possible for a luna eclipse to occur (the Moon hidden by the Earth's shadow). Due to the Moon's slightly offset orbit, luna eclipses are quite rare as it usually misses the Earth's shadow.<br clear="all" />

=== Last Quarter ===

[[Image:Lastquartermoon.jpg|left]] The Moon rises late at night, before dawn, when the sky is dark and can be seen over in the east of the sky. By the time it reaches it's highest point in the sky the Sun will be beginning to rise making viewing less easy.<br clear="all" />

== Some Definitions ==

; Phase : Historical names for the various portion of the Moon as illuminated by the Sun
; Lunation : Average lunar month (roughly 29 days, 12 hours, and 44 minutes)
; Selenographic Terminator Longitude : Longitudinal position of the shadow as it moves east to west across the Moon's visible surface
; Lunar Eclipse : When the Earth is directly between the Sun and Moon, casting a shadow over the Moon's surface
; Solar Eclipse : When the Moon is directly between the Sun and Earth, casting a shadow on the Earth's surface
; Julian Date : Unit of measurement measuring days passed from a known point in history (BC 4713-01-01 12:00, Monday)
; Latitude : Unit of measurement indicating a position north or south
; Longitude : Unit of measurement indicating a position east or west


= Development =
= Development =

Moon is a standard Python activity that uses PyGTG for graphics and events. All Python is in an easily modifiable single file with a Sugar activity subclass that takes care of control and views, and a model class for Moon calculations. Code was ported from a Cocoa Mac application I wrote some time ago called [http://osx.garycmartin.com MoonDock].
Moon is a fully Python activity that uses PyGTK for graphics and events. All Python code is in an easily modifiable single file with a Sugar activity subclass that takes care of control, views, and a model class for actual Moon calculations. The code was ported from a Cocoa application I wrote some time ago for the Mac, called [http://osx.garycmartin.com MoonDock].


== Release Notes ==
== Release Notes ==

=== v11 ===

* Includes latest translations available (many thanks to the translation team)
* Support new Sugar (0.86) and old activity toolbar designs
* Information panel allows virtical scrolling for showing all text on smaller screens #506
* Adjustment to compass and labels positions to give more spacing away from widget edges
* Tidy grid line overlaps

=== v10 ===

* Merged alsroot's solution to future proof json module
* Picked-up latest localizations

=== v9 ===

* Code cleanup (make pylint happier)
* Merged alsroot's excellent independence resolution code addition (resizes moon image to fit available display)
* Updated localizations (latest from Pootle, thanks all!)

=== v8 ===

* Updated empty NEWS file with actual news
* Added pt_BR.po translation (from Gabriel Menini).
* Corrected some word translations for Spanish.
* Added some revised Spanish translation changes from Gabriel Menini.

=== v7 ===

* Added French locale by Bastien Guerry (thanks!)
* Reduced frame padding to allow more space for longer French strings.
* Fixed encoding issue affecting one string in the po file for both FR and ES.
* Corrected missing newline from Juliana ES translation string.

=== v6 ===

* Now has a Spanish locale by Gabriel Menini (many thanks!)
* Removed service_name from .info, that spec went away a long time ago.
* Change methods from camelcase to make pylint happier...

=== v5 ===

* Cleaned up MANIFEST.
* Added extra licensing texts and activity.info fluff.
* Journal stores state for grid on/off and southern/northern view.
* Activity remembers last used defaults and will use them for new launches.
* GIT now includes the below Spanish name modification

=== v4 ===

* Now called Luna in the activity bar in Spanish locales. Still needs translation for spanish...

=== v3 ===

* Added a view toolbar.
* Feature added to display selenographic longitude and latitude grid lines (to help learning the terms).
* Feature added to toggle Moon image view between Northern and Southern hemisphere viewing location (rotates view 180deg).
* Textual displayed dates/times comply with local daylight saving rules and time zones (all internal calculations are in UTC).
* More accurate selenographic terminator visualisation (shadow) for waning gibbous & waxing crescent (corrected estimate for 3d curvature).

=== v2 ===

* Minor update to display information using your local time zone, instead of UTC

=== v1 ===
=== v1 ===

Beta version with basic core functionality.
* Beta version with basic core functionality (text information, Moon phase visualisation, Lunar eclipse data & effect).


== Testing (Yes) ==
== Testing (Yes) ==

Moon v1 has been tested on build 690, 691, 693 and various joyride builds on a B4 laptop.
Moon v1 was tested on build 690, 691, 693 and various joyride builds on a XO-B4 laptop. Moon v3-v10 has been tested on a range of builds from 711 to 8.2-767. See the Moon [[Tests/Activity/Moon|test page]] for a list of simple Activity test cases.

=== Submitting bugs and feature requests ===

You can view existing Moon bug/feature reports at [http://dev.sugarlabs.org/query?component=Moon], if you don't see your bug/feature already reported please create a new ticket (you'll need to register) and assign it to the component to 'Moon'.


== TODOs ==
== TODOs ==

* Mini-month Lunar calendar (stylised icons)
* Mouse over hover hints for major Lunar features
* Mouse over hover hints for major Lunar features
* Markers for interesting locations, view toolbar button, showing Lunar landings etc.
* Add a Tool menu
* State saving to Journal, for the new view options
** North/south hemisphere view
* Simplify/clean-up textual data and information
** Grid lines
** Improve information for the targeted demographic age
** Markers of interest
* Convert main view to Cairo to allow improved rendering
* Simplify/clean-up textual data
** Soft shadows
** Better target the demographic age
** Antialiased grid
* Convert main view to Cairo to allow improved rendering (soft shadow)
** New daylight view feature (would be an estimate)
* Translation work
*** Light blue to black transition of sky and Moon composite
* Consider possible shared activity functionality
* Consider possible shared activity functionality
** Shared markers with text notes?
** Shared markers with text notes?
* Mini-month Lunar calendar (stylised icons)


== Feature requests ==
== Feature requests ==

Add your feature requests here!
Add your feature requests here!


It would be good to have associated displays that explain some of the technical terms like, waxing, Julian, lunation, Selenographic, teminator, longitude for the schoolchild or anyone wanting a lesson on Earth's moon. --[[User:FGrose|FGrose]] 23:00, 19 February 2008 (EST)
It would be good to have associated displays that explain some of the technical terms like, waxing, Julian, lunation, Selenographic, terminator, & longitude for the schoolchild or anyone wanting a lesson on Earth's moon. --[[User:FGrose|FGrose]] 23:00, 19 February 2008 (EST)

:In version 3, I've added an extra colour coded view showing a longitude and latitude grid along with compass directions - I'll probably extend this technique (least text as possible) in future versions (e.g with a view mode for labelling/highlighting the terminator edge in green). Hopefully this will help. --[[User:garycmartin|Garycmartin]] 2:00, 26 February 2008 (GMT)

It would be great if explanation (or link to it) for technical terms are provided on this wiki page. Without the knowledge it is very difficult to localize this activity on Pootle. --[[User:Korakurider|Korakurider]] 2:00, 10 October 2008 (JST)

:Thanks Korakurider, I'm just starting to add more descriptions on the wiki now (ideally I'll be looking to migrate some of this into the Moon Activity itself, I've avoided using much text so far to reduce the translation effort required). --[[User:Garycmartin|Garycmartin]] 20:58, 9 October 2008 (UTC)

Change date function would rock. --Edward/Tabitha 07:14, 15 November 2008 (UTC)

:Thanks Edward/Tabitha (I added this here from your email), the Moon source code is designed to support this, I just need to come up with a simple/friendly Sugar UI to allow it to happen. Thinking I might try a slightly different approach and solve this with a Lunar calendar view. --[[User:Garycmartin|Garycmartin]] 16:36, 15 November 2008 (UTC)

{{:Activities/Moon}}
{{Activity page
|icon=Image:moon-icon.png
|genre=Math and Science
|activity group=Activities/G1G1, Activities/Peru
|short description=A simple Lunar phase activity for the XO laptop, including upcoming Lunar eclipse information and effects.
|contact person=User:Garycmartin
|activity source=http://git.sugarlabs.org/projects/moon
|language=English, Spanish, French, Brazilian Portuguese
|language codes=en, es, fr
|bundle URL=http://activities.sugarlabs.org/en-US/sugar/downloads/file/26476/moon-11.xo
|activity version=11
|releases=7.1.1 (653), 7.1.2 (656), 8.1.0 (703), 8.1.1 (708), Candidate
|devel status=5. Production-stable
}}
{{Activity bundle
|bundle URL=http://activities.sugarlabs.org/en-US/sugar/downloads/file/26476/moon-11.xo
|activity version=11
|releases=7.1.2 (656), 8.1.0 (703), 8.1.1 (708), Candidate
|devel status=5. Production-stable
}}

Latest revision as of 15:13, 30 November 2009

?Sugar icon}}    This activity is now hosted at the Sugar Activity Library.

The information here is likely to be out-of-date. Consult the new pages for "Moon" first:

Moon-icon.png
.xo BundleMoon-11.xo

Description

Moon is a simple Lunar phase activity for the XO laptop, including upcoming Lunar eclipse information and effects. Its usefulness as a shared activity will make more sense once the planned Sugar bulletin-board overlay interface is implemented, where children will be able to point out features and places of interest to each other.

Screenshots

Moon screen1.jpg

Moon screen2.jpg Moon screen3.jpg

How to Install

Download this .xo file using the Browse activity: Moon-11.xo

Moon Phases

See also http://en.wikipedia.org/wiki/Lunar_phase#Names_of_lunar_phases

New Moon

Newmoon.jpg
The new Moon is very hard to observe as it rises and sets so close to the Sun's position in the sky. This is the time when it's possible for a solar eclipse to occur, but due to the small visible size of both the Sun and the Moon disks, it happens very rarely. You may get a glimpse of the Moon's unlit disk just before sunrise or just after sun set before the sky gets too bright.

First Quarter

Firstquartermoon.jpg
The Moon rises after the Sun is up, while you're in full daylight, so you'll not get a good view until the Sun begins to set and the sky darkens. As the sky darkens the Moon will be high and/or towards the west.

Full Moon

Fullmoon.jpg
The full Moon rises in the east at about the same time the Sun sets, then sets in the west at about the same time the Sun rises - so it's quite easy to observe on a clear night. The Moon rise and set times, opposing the Sun's, are because full Moons occur when you (and the rest of the Earth) are directly between the Moon and the Sun. This is also the time when it's possible for a luna eclipse to occur (the Moon hidden by the Earth's shadow). Due to the Moon's slightly offset orbit, luna eclipses are quite rare as it usually misses the Earth's shadow.

Last Quarter

Lastquartermoon.jpg
The Moon rises late at night, before dawn, when the sky is dark and can be seen over in the east of the sky. By the time it reaches it's highest point in the sky the Sun will be beginning to rise making viewing less easy.

Some Definitions

Phase
Historical names for the various portion of the Moon as illuminated by the Sun
Lunation
Average lunar month (roughly 29 days, 12 hours, and 44 minutes)
Selenographic Terminator Longitude
Longitudinal position of the shadow as it moves east to west across the Moon's visible surface
Lunar Eclipse
When the Earth is directly between the Sun and Moon, casting a shadow over the Moon's surface
Solar Eclipse
When the Moon is directly between the Sun and Earth, casting a shadow on the Earth's surface
Julian Date
Unit of measurement measuring days passed from a known point in history (BC 4713-01-01 12:00, Monday)
Latitude
Unit of measurement indicating a position north or south
Longitude
Unit of measurement indicating a position east or west

Development

Moon is a fully Python activity that uses PyGTK for graphics and events. All Python code is in an easily modifiable single file with a Sugar activity subclass that takes care of control, views, and a model class for actual Moon calculations. The code was ported from a Cocoa application I wrote some time ago for the Mac, called MoonDock.

Release Notes

v11

  • Includes latest translations available (many thanks to the translation team)
  • Support new Sugar (0.86) and old activity toolbar designs
  • Information panel allows virtical scrolling for showing all text on smaller screens #506
  • Adjustment to compass and labels positions to give more spacing away from widget edges
  • Tidy grid line overlaps

v10

  • Merged alsroot's solution to future proof json module
  • Picked-up latest localizations

v9

  • Code cleanup (make pylint happier)
  • Merged alsroot's excellent independence resolution code addition (resizes moon image to fit available display)
  • Updated localizations (latest from Pootle, thanks all!)

v8

  • Updated empty NEWS file with actual news
  • Added pt_BR.po translation (from Gabriel Menini).
  • Corrected some word translations for Spanish.
  • Added some revised Spanish translation changes from Gabriel Menini.

v7

  • Added French locale by Bastien Guerry (thanks!)
  • Reduced frame padding to allow more space for longer French strings.
  • Fixed encoding issue affecting one string in the po file for both FR and ES.
  • Corrected missing newline from Juliana ES translation string.

v6

  • Now has a Spanish locale by Gabriel Menini (many thanks!)
  • Removed service_name from .info, that spec went away a long time ago.
  • Change methods from camelcase to make pylint happier...

v5

  • Cleaned up MANIFEST.
  • Added extra licensing texts and activity.info fluff.
  • Journal stores state for grid on/off and southern/northern view.
  • Activity remembers last used defaults and will use them for new launches.
  • GIT now includes the below Spanish name modification

v4

  • Now called Luna in the activity bar in Spanish locales. Still needs translation for spanish...

v3

  • Added a view toolbar.
  • Feature added to display selenographic longitude and latitude grid lines (to help learning the terms).
  • Feature added to toggle Moon image view between Northern and Southern hemisphere viewing location (rotates view 180deg).
  • Textual displayed dates/times comply with local daylight saving rules and time zones (all internal calculations are in UTC).
  • More accurate selenographic terminator visualisation (shadow) for waning gibbous & waxing crescent (corrected estimate for 3d curvature).

v2

  • Minor update to display information using your local time zone, instead of UTC

v1

  • Beta version with basic core functionality (text information, Moon phase visualisation, Lunar eclipse data & effect).

Testing (Yes)

Moon v1 was tested on build 690, 691, 693 and various joyride builds on a XO-B4 laptop. Moon v3-v10 has been tested on a range of builds from 711 to 8.2-767. See the Moon test page for a list of simple Activity test cases.

Submitting bugs and feature requests

You can view existing Moon bug/feature reports at [1], if you don't see your bug/feature already reported please create a new ticket (you'll need to register) and assign it to the component to 'Moon'.

TODOs

  • Mouse over hover hints for major Lunar features
  • Markers for interesting locations, view toolbar button, showing Lunar landings etc.
  • State saving to Journal, for the new view options
  • Simplify/clean-up textual data and information
    • Improve information for the targeted demographic age
  • Convert main view to Cairo to allow improved rendering
    • Soft shadows
    • Antialiased grid
    • New daylight view feature (would be an estimate)
      • Light blue to black transition of sky and Moon composite
  • Consider possible shared activity functionality
    • Shared markers with text notes?
  • Mini-month Lunar calendar (stylised icons)

Feature requests

Add your feature requests here!

It would be good to have associated displays that explain some of the technical terms like, waxing, Julian, lunation, Selenographic, terminator, & longitude for the schoolchild or anyone wanting a lesson on Earth's moon. --FGrose 23:00, 19 February 2008 (EST)

In version 3, I've added an extra colour coded view showing a longitude and latitude grid along with compass directions - I'll probably extend this technique (least text as possible) in future versions (e.g with a view mode for labelling/highlighting the terminator edge in green). Hopefully this will help. --Garycmartin 2:00, 26 February 2008 (GMT)

It would be great if explanation (or link to it) for technical terms are provided on this wiki page. Without the knowledge it is very difficult to localize this activity on Pootle. --Korakurider 2:00, 10 October 2008 (JST)

Thanks Korakurider, I'm just starting to add more descriptions on the wiki now (ideally I'll be looking to migrate some of this into the Moon Activity itself, I've avoided using much text so far to reduce the translation effort required). --Garycmartin 20:58, 9 October 2008 (UTC)

Change date function would rock. --Edward/Tabitha 07:14, 15 November 2008 (UTC)

Thanks Edward/Tabitha (I added this here from your email), the Moon source code is designed to support this, I just need to come up with a simple/friendly Sugar UI to allow it to happen. Thinking I might try a slightly different approach and solve this with a Lunar calendar view. --Garycmartin 16:36, 15 November 2008 (UTC)


Moon-icon.png Moon: Moon phase viewer
Moon phase viewer, includes Lunar phase information and eclipse data.

edit this box

Download: [2] (v.11)
Source: git
Build: all
Mime types:
Internationalization: honey
Tags: astronomy, science, nature
Development Status: 5-Production-stable


Activity Summary

Icon: Sugar icon::Image:moon-icon.png
Genre: Activity genre::Math and Science
Activity group: ,|x|Activity group::x}}
Short description: Short description::A simple Lunar phase activity for the XO laptop, including upcoming Lunar eclipse information and effects.
Description:
Maintainers: ,|x|Contact person::x}}
Repository URL: Source code::http://git.sugarlabs.org/projects/moon
Available languages: ,|x|Available languages::x}}
Available languages (codes): ,|x|Language code::x}}
Pootle URL:
Related projects: Related projects,|x|Related projects::x}}
Contributors: ,|x|Team member::x}}
URL from which to download the latest .xo bundle Activity bundle::http://activities.sugarlabs.org/en-US/sugar/downloads/file/26476/moon-11.xo
Last tested version number: Activity version::11
The releases with which this version of the activity has been tested. ,|x|Software release::x}}
Development status: Devel status::5. Production-stable
Ready for testing (development has progressed to the point where testers should try it out): ,|x|Ready for testing::x}}
smoke tested :
test plan available :
test plan executed :
developer response to testing :


URL from which to download the last .xo bundle that works with old releases Activity bundle::http://activities.sugarlabs.org/en-US/sugar/downloads/file/26476/moon-11.xo
Activity version number: Activity version::11
The releases with which this version of the activity has been tested. ,|x|Software release::x}}
Development status: Devel status::5. Production-stable