Riseset Application for Ewe
Version 1.2*

Description

Riseset is an application for Ewe enabled computers to compute physical information for the Sun, Moon, Mercury, Venus, Mars, Jupiter and Saturn. Any user location and date may be specified.

To use this version of Riseset you must install a Ewe¹ VM (Virtual Machine) on your computer. Ewe is a version of Java. It is very compact and efficient. It uses only about 2 Mbytes of memory.
To learn more about Ewe please read the introduction on the Bray Mobile Applications page.

Riseset has good accuracy for visual sighting. The actual Sun times should be within a few seconds of the time shown. The Moon and major Planet times are given to the second, but the actual time could be ± a minute. Studies indicate that in general the Moon times given are about 22 seconds late.
Be aware that visual sighting times can vary because of atmospheric aberration. Riseset Sun Display

Riseset also gives:

About This Documentation

Riseset is intuitive and easy to use. This documentation probably seems large, but you really should read it to fully understand all of the features.
For a Quick Start read Installation. Then after trying it out please return to this documentation to learn all of the features.


Installation

Since you are reading this documentation, you have found that you have two .zip archives in riseset12.zip.
The riseset12Install.zip archive contains the files to be installed on your computer.
The riseset12Doc.zip contains this documentation you are now reading.

Installation Steps

  1. Install the the Ewe VM.
  2. Copy all files from riseset12Install.zip.
  3. If updating Riseset, delete riseset.ini.
  4. Optionally, install GeomagInfo.ewe in the same directory as Riseset.ewe
Each step is explained next.
Step 1
The first thing to do is to install the Ewe VM on your computer(s), if not already installed. Follow the instruction found on the Ewe Download and Installation Page for your computer. The Ewe installer will create directories on your computer and put the Ewe VM files in them.

After Ewe is installed find the Ewe directory. For example, in a Windows Desktop it will be where you told the installer to install it, and in the Pocket PC it will (probably) be in \Windows\StartMenu\Programs\Ewe. Specifically, it is the directory in which you find 'ewe.ewe'. ewe.ewe is the Ewe Launcher. Use of Ewe Launcher is not mandatory for the Windows and Pocket PC operating system. However please read Changing Display Font below.
If you put all of your applications in this directory, when you add additional applications from Bray Mobile Applications common files can be shared. Especially the Location Data CSV files.

Step 2
There is no installer for Riseset.ewe. The files in the riseset12Install.zip archive can be put in any directory of your choice. However it is recommended that you put them in the directory with the Ewe VM you found in Step 1.

Once you find the proper directory copy all of the files in riseset12Install.zip into that directory, in what ever manner you copy files to your computer.

There is also no uninstaller for Riseset. It does not use the operating system registry, so nothing is hidden. To remove Riseset, simply delete: Riseset.ewe, and Riseset.ini.

Step 3
If you are updating Riseset.ewe delete riseset.ini.

Step 4
If you wish to use the optional Magnetic Compass Correction install GeomagInfo.ewe in the same directory as Riseset.ewe. GeomagInfo.ewe can be download from Bray Mobile Applications.
GeomagInfo require a magnetic model. Thus, carefully read its documentation, install it as instructed into the same directory as Riseset.ewe, and test it. Instructions for turning it on and off are discussed below.

Note: No matter what Regional settings are used on your computer(s), Riseset always uses the '.' (period) as the decimal point, the ':' (colon) as the hour/minute/second separator, and the ',' (comma) as the data separator.

Riseset should be ready to run now. Find Riseset.ewe with your File Explorer, click on it to try it out!

Using Riseset

Display

Riseset Moon Display Hopefully the application output is self explanatory. In this documentation we will use the word 'Planet' to refer to the celestial bodies available in Riseset.

A word about the time line. The time to the left is Home time and the time to the right is the Local time. More about the two different times below.

Six terms used are:

To save display space the names of the Moon phases are abbreviated to: 'New' for New Moon, 'First' for First Quarter, 'Full' for Full Moon, 'Last' for Last Quarter. The date of the event is shown as the first three letters of the day and month name.
Eclipse data is given for the best possible location on earth. See About Eclipses below.

When getting times at latitudes near the poles, it is possible that the Planet does not rise or set. In that case the time output will be displayed as: 0:00:00. It is also possible that the rise time occurs on the previous day, or the set time occurs on the next day.

Buttons

On the Data page there are six active buttons:
  • Across the Bottom: Data, Compass, Locations
  • Across the Top: Menus, Time, Date

    The Bottom Buttons

    : Riseset Compass Display
    Data
    This button forces the display to show the Data page, as shown in the two sample displays above: "Sun at Potsdam" and "Moon at Chicago IL". (The "Moon at Chicago IL" image was captured from a Windows Desktop running Riseset which was resized with the mouse to show the entire main page -- most mobile computers will show only part of this data with scrolling bars as in "Sun at Potsdam" above).

    Compass
    This button forces the display to the show a Compass display of the current Altitude and Azimuth. As noted in the display the Azimuth is shown in Blue and the Altitude is shown in Red. If the optional magnetic compass correction is On the Azimuth Compass angle is shown in Green.
    Note: the Moon is below the horizon in the display to the right

    Locations
    This button brings up a 'File Chooser' for selection of the desired Location Data file (files with the extension of .csv). Once the file is chosen all locations in this file are displayed. To have Riseset show the data for a location simply tap the location data line to highlight it, and then tap the Data button.

    Each Location Data line not only includes latitude and longitude, but also time zone and daylight time information so that Riseset will automatically adjust the Local Time for accurate Altitude and Azimuth information.
    More information on this is discussed below. See Location Data


    The Top Buttons

    : Riseset Set Menu
    Planets
    This is a menu which has 7 selections:Planet is to be active. Selection changes the Data page immediately.


    Set
    This is a menu (below) with 7 selections:

  • MagCorr. On   This menu turns on the magnetic compass correction. Actually it toggles the correction Off or On. If GeomagInfo.ewe is not installed in the same directory as Riseset.ewe this menu item will be "MagCorr. N/A" indicating the option is "Not Available". GeomagInfo.ewe must be executed and its setting saved before it will be available for use by Riseset.

  • GetNewData   Selecting this forces Locations to display the 'File Chooser' so that you can select a new file, thereby allowing a locations to be found that is not in the current Location data CSV file.


    Riseset Set Menu
  • ThisIsHome   As you have seen Riseset keeps two times: Home Time: your computer time, and Local Time: the time at the active location. Setting the Home Time is important so that the Altitude and Azimuth data is correct.
    To set Home Time: use the Location button to choose your Home location. Then use this menu item to set it. You can see your current Home location is the Set/About display.
    It is recommended that you add an accurate location for your Home Location to a Location Data CSV File. See About Location Data
    Local time is set according to the Location Data CSV data and is correct only when the Time Zone and Daylight Time Code is correct, and the Home time is also correct.

  • Use EweVM Font   This forces the display font to be that of the Ewe Launcher. A full explanation is given in Changing Display Font.

  • Show Coord's.   This displays both the current Latitude and Longitude in each of the three acceptable format. They are displayed with south latitude and west longitude as negative.

  • About   This is the usual About information. It tells you the version of Riseset and Ewe VM installed, and the current Home location.

  • Quit   The obvious Quit selection. You can also quit using the upper right hand X. In either case you will asked if you with to save the current settings of Riseset for next usage start-up.
  • Riseset Time Menu
    Time
    This menu allows you to set the time for which the Planet data is calculated. There are five selections in this menu:

  • NewTime: This pops up a box to allow you to enter the desired time -- Enter the hour in 24 hour time.
    When done select which time is being set -- Home or Local time.

  • Now: This refreshes the Data page to the current time, keeping the date setting.

  • Today: This refreshes the Data page to the current date, keeping the time setting.

  • Tomorrow: This refreshes the Data page to the date following the displayed date, keeping the time setting.

  • Yesterday: This refreshes the Data page to the date preceding the displayed date, keeping the time setting.

  • Date
    This Selection Box allows you to set the date for which Planet data are calculated. Its usage should be obvious. Use the X to abort the date change, and the CHECK sign to accept the date change.

    More Details

    Changing Display Font

    The default font for Riseset is 'Courier New' with a size of 15 points. This font was chosen because it has a fixed character width (monospaced font), and thus displays lined-up data columns. It is available in both the Windows and Pocket PC operating systems. However, not all operating supported by Ewe have that font defined. Thus the display for those operating systems may not be easily readable.

    To solve this problem a menu item has been added to Riseset, "Use EweVM Font". When this is selected the font used is that of the Ewe Launcher. This is explained next.

    In Riseset tap Menu then tap Use EweVM Font. Nothing will happen. Exit Riseset and save the settings. Next time you restart Riseset, the display will use the Ewe Vm font. If the font is not to your liking, run the Ewe Launcher: ewe.ewe. It is located in the directory in which you installed Ewe. That is discussed in: Installation above.

    To change the Ewe VM font in the Ewe Launcher, click on the VM Options tab. Select the font and size you want. Save it. Selecting a monospaced font will look the best. Once this is done start Riseset.

    Ewe Launcher also allows you to change the style of the display bottoms. You might want to check this out.

    Supplied Location Data

    The riseset12Install.zip archive contains two Location Data CSV Files: NoAmerica.csv, and Europe.csv. The locations in these files have been collected from various sources. They are not very accurate and could even be incorrect, especially the time zone and daylight time settings. For locations which do not observe integer (whole number) time zones, the supplied time zone is probably incorrect.
    These files are text files and thus may be edited by with any text editor. You should edit these files into a new one containing your favorite locations. When doing so check for accuracy.

    The Location Data CSV Editor Application (LocEdit) is available at the Bray Mobile Applications page. LocEdit makes it easier to edit Location Data CSV files and more data is available. If you are intending to create your own personal Location Data CSV files it is recommended that you get LocEdit.

    Documentation that comes with LocEdit has full details about a Location Data CSV file format.

    The format of Location Data files is described next.

    NOTE: Beware that CSV files are an acceptable format for Excel. However, DO NOT use Excel to create or edit them since all the latitude, longitude formats are not known to Excel and it will modify them incorrectly without giving an error message!

    About Location Data

    The Location Data allows you to select a location on the Earth for Riseset to display its information.

    Having a file of locations is much easier than entering a location manually when you want different information -- especially for travelers.

    The form of the Location Data has been chosen to allow it to be easily edited so that you can create and update your favorite locations collection them together into files. As stated above, only use a text editor on these files. DO NOT use Excel it can modify your data WITHOUT warning.

    The Location Data is defined in Comma Separated File (CSV) files. These Location Data files were first introduced in the Palm OS GeoDB application.

    The format for these files is as follows:

  • Each location record is defined on one line of an ASCII (text) file.
  • Each field of a record is separated by a ','. Thus the name 'Comma Separated Value'.
  • The field contents are as follows:
    1. Name
    2. Latitude -- Three possible formats (described below)
    3. Latitude Hemisphere -- N (Northern) or S (Southern), above and below the equator
    4. Longitude -- Three possible formats
    5. Longitude Hemisphere -- E (Eastern) or W (Western), east or west from Greenwich
    6. Elevation -- Application defined units, not used in Riseset.
    7. Time Zone -- Three possible formats -- Note: The time zone may be a non-whole number.
    8. Time Zone Hemisphere -- E (Eastern) or W (Western)
    9. Daylight Time Code -- Digit

    Example: Potsdam NY,44:38.562,N,75.03,W,,5,W,4

    The three formats for latitude, longitude, and time zone are:
    degree ':' minute ':' second '.' decimal second     44:38:33.72
    degree ':' minute '.' decimal minute     44:38.562
    degree '.' decimal degree     44.6427
    Note: All three of these value are the same earth latitude.

    The Daylight Time Code is as follows:
    0No -- Never
    1Yes -- Always
    2Australia -- Start: Last Sunday in October; End: Last Sunday in March
    3Europe -- Start: Last Sunday in March; End: Last Sunday in October
    4N. America -- Start: Second Sunday in March; End: first Sunday in November (The new 2007 rules.)
    5S. America -- Start: First Sunday in October; End: Last Sunday in February

    Back to Bottom Buttons

    Finding the Azimuth angle at Rise/Set

    To find the azimuth angle at which a Planet will rise (or set).
    1. Find the desired rise/set time. Then tap Time/NewTime in the top bar.
    2. Set the time to the rise (or set) time. (Remember the hour is 24 time).
    3. Tap Local Time to set the time. Then tap Data to re-computed data which will then show the azimuth angle at rise (or set), and the magnetic compass angle if turned on.
    To return to real time tap Time/Now.

    About Eclipses

    When you check the Moon data, eclipse data will be given a few days before a solar or lunar eclipse will occur.
    This information is for the best possible location on Earth. Unfortunately getting more specific data is beyond the scope of Riseset, but you can do some checking.

    To determine if you will have a chance to see it, use the Time/NewTime menu and set the Local Time to that of the eclipse.
    For a lunar eclipse check the Moon data again. For a solar eclipse check the Sun.
    If the eclipsed body is above the horizon (i.e. the altitude is positive) and the sky light is favorable, then it is possible that you can see it, but it still may not be visible.
    You can usually find all of the details of an eclipse at: http://skyandtelescope.com/.

    Back to Using Riseset

    Contact Information

    Riseset was created by David W. Bray, Potsdam, NY.
    Copyright © David W. Bray 2004-2007, All Rights Reserved.

    An interactive web version of Riseset (for the Sun and Moon) can be found at: http://www.40-below.com/sunmoon/

    More applications can be found at The Bray Mobile Applications page: http://davidbray.org/mobile/

    Registering

    Riseset is freeware -- no registration is required. We hope you enjoy using it.
    It would be appreciated if you would send an email to David stating what computer(s) on which you have Riseset installed. Thank you.

    This archive may be freely redistributed, provided it is made available only in its complete, unmodified form with no additional files and for noncommercial purposes only. Any other use must have prior written authorization from: David W. Bray .

    Unauthorized commercial use includes, but is not limited to:

    Disclaimer

    This application is provided without warranty and the user accepts full responsibility for any damages, consequential or otherwise, resulting from its use.

    Foot Notes

    ¹ Ewe is developed by Michael L Brereton. We are indebted to him for his outstanding software product and making it freely available. Thank you Michael!

    *Changes in Version 1.2

    Bld:726 is the current release.
    RiseSet Version 1.2 Bld:728 differs from Version 1.0 Bld:414 in:
    1. Original release -- Version 1.0 Bld:414
    2. Error popup message on "save current state" error. (V1.0 Bld:421)
    3. Added Magnetic Correction. (V1.1 Bld:435)
    4. Changed the Time/NewTime data entry form. (V1.1 Bld:435)
    5. Changed the '.' to always be the decimal point. (V1.1 Bld:438)
    6. Added moon phase change (waxing/waning). (V1.1 Bld:507)
    7. Improved eclipse time accuracy by about 6 minutes. (V1.1 Bld:507)
    8. Improved moon phase time accuracy. (V1.1 Bld:507)
    9. Added date options to the Time menu. (V1.1 Bld:507)
    10. New Format for the Riseset display. (V1.2 Bld:617)
    11. Added menu item: 'Show Coord's.' to display the Latitude and Longitude. (V1.2 Bld:617)
    12. Added menu item: 'User EweVM Font' to improve display on some supported operating systems. (V1.2 Bld:617)
    13. Changed menu organization: Two menus split into three to shorten their lengths. (V1.2 Bld:644)
    14. Changed the North American daylight savings rules to conform to those of 2007. (V1.2 Bld:644)
    15. Corrected errors in use of non-integer GMTOffsets. (V1.2 Bld:728)

    To be sure that your version is up-to-date check the Bld: number in the current description of Riseset at: http://davidbray.org/mobile/