
wmSun README


wmSun displays the current day's sunrise and sunset times.  You must enter
your latitude and longitude correctly for it to work.

For help run the command:

    wmSun -h

For manual run the command:

    man wmSun

The latitude and longitude values after dot have to be decimal.  So if you
take into consideration Paris coordinates: 48 deg 51 min N and 2 deg 21 min
E you have to convert minutes to the decimal values:

    51 / 60 = 0.85
    21 / 60 = 0.35

As a result the valid command for Paris is:

    wmSun -lat 48.85 -lon -2.35

Examples:

Sunrise/sunset times in New York (43 deg N, 75 deg W) in local time using
hot sun image:

    wmSun -lat 43 -lon 75 -sun 1

Sunrise/sunset times in London (51 deg 30 min N, 0 deg 7 min W) in local
time using hot sun image with font anti-aliasing:

    wmSun -lat 51.50 -lon 0.12 -sun 1 -aa 1

Sunrise/sunset times in Moscow (55 deg 45 min N, 37 deg 37 min E -- east of
Greenwich) in local time:

    wmSun -lat 55.75 -lon -37.62

Sunrise/sunset times in Sydney (33 deg 51 min S, 151 deg 12 min E --
southern hemisphere, east of Greenwich) in local time:

    wmSun -lat -33.85 -lon -151.20

If you're in Paris (UTC + 01:00 in winter, UTC + 02:00 in summer) and you'd
like to display sunrise/sunset times for New York use the command:

    wmSun -lat 43 -lon 75 -td 4

If you're in Paris (UTC + 01:00 in winter, UTC + 02:00 in summer) and you'd
like to display sunrise/sunset times for Sydney use the command:

    wmSun -lat -33.85 -lon -151.20 -td -10

You can check the correctness of your settings using the following website:

    http://www.sunrisesunset.com/predefined.asp

Slight differences between sunrise/sunset times calculated by wmSun and
www.sunrisesunset.com are caused by different alghoritms used in both cases.
The difference can be caused also by different latitudes and longitudes
assumed in both cases.  For example New York expands from 40 deg 30 min to
45 deg 1 min N and from 71 deg 51 min to 79 deg 46 min W.  In decimal values
it's 40.50-45.02 N, 71.85-79.77 W.  The above wmSun commands assume 43 N, 75
W. The www.sunrisesunset.com website uses slightly different coordinates.

