Java solar positioning code (topocentric coordinates, sunrise/sunset)
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
resources update docs Jun 27, 2015
src typo Nov 6, 2015
.gitignore Added gradle files Oct 18, 2014
.travis.yml Create .travis.yml Jul 24, 2015
LICENSE.txt Rename README.txt to LICENSE.txt Apr 21, 2013
README.md note on accuracy of sunrise/sunset Feb 23, 2017
pom.xml [maven-release-plugin] prepare for next development iteration Nov 6, 2015

README.md

solarpositioning

Build Status

This is a Java library for finding topocentric solar coordinates, i.e. the sun’s position on the sky at a given date, latitude, and longitude (and other parameters). Calculations are based on well-known published algorithms: SPA by Reda and Andreas and, alternatively, Grena/ENEA by Grena or PSA by Blanco-Muriel et al.

Usage

Maven coordinates

<dependency>
    <groupId>net.e175.klaus</groupId>
    <artifactId>solarpositioning</artifactId>
    <version>0.0.9</version> <!-- or whatever latest release is -->
</dependency>

Occasional snapshots are deployed to https://oss.sonatype.org/content/repositories/snapshots

Code

import net.e175.klaus.solarpositioning.*;

public class App {
  public static void main(String[] args) {
    final GregorianCalendar dateTime = new GregorianCalendar();

    AzimuthZenithAngle position = SPA.calculateSolarPosition(
                                            dateTime,
                                            48.21, // latitude (degrees)
                                            16.37, // longitude (degrees)
                                            190, // elevation (m)
                                            DeltaT.estimate(dateTime), // delta T (s)
                                            1010, // avg. air pressure (hPa)
                                            11); // avg. air temperature (°C)
    System.out.println("SPA: " + position);
  }
}

Which algorithm should I use?

  • For many applications, Grena3 should work just fine. It's fast and pretty accurate for a time window from 2010 to 2110 CE.
  • If you're looking for maximum accuracy or need to calculate for historic dates, use SPA. It's widely considered the reference algorithm for solar positioning, being very accurate and usable in a very large time window. Its only downside is that it's relatively slow.
  • PSA is another fast and simple algorithm, but should not be used for new applications due to its limited time window. It is currently kept for backwards compatibility.

Is the code thread-safe?

Yes. None of the classes hold any mutable shared state. As the calculation is obviously CPU-bound, explicit multithreading does make sense whenever a lot of positions need to be calculated.

How do I get the time of sunrise or sunset?

The SPA class now includes a method to calculate the times of sunrise, sun transit, and sunset in one fell swoop:

GregorianCalendar[] res = SPA.calculateSunriseTransitSet(
                                    time, 
                                    70.978056, // latitude  
                                    25.974722, // longitude
                                    68); // delta T

Notes:

  • The times of sunrise and sunset may be null if the sun never sets or rises during the specified day (i.e. polar days and nights).
  • Calculation is based on the usual correction of 0.8333° on the zenith angle, i.e. sunrise and sunset are assumed to occur when the center of the solar disc is 50 arc-minutes below the 90° horizon.
  • For various reasons, sunrise and sunset times may differ from those given by other sources. If you feel there's something wrong with the results of this library, please make sure to compare with a reputable source such as the NOAA calculator and not one of the many quick-and-dirty algorithms found on the Web.
  • As a general note on accuracy, Jean Meeus advises that "giving rising or setting times .. more accurately than to the nearest minute makes no sense" (Astronomical Algorithms). Errors increase the farther observer's position from the equator, i.e. values for polar regions are much less reliable.

What's with this "delta T" thing?

See Wikipedia for an explanation. For many simple applications, this value could be negligible as it's just about a minute as of this writing. However, if you're looking for maximum accuracy, you should either use a current observed value (available from e.g. the US Naval Observatory) or at least a solid estimate.

The DeltaT class provides an estimator based on polynomials fitting a number of observed (or extrapolated) historical values, published by Espenak and Meeus. Here's a plot of its output compared with some published ΔT data:

deltat