BRSunTracker

BRSunTracker is a set of classes using Augmented Reality that allow you to track and display the position of the sun on your device screen, based on your current GPS location, the device gyroscope, the time and the date.

The position of the sun in the sky is computed via the PSA Algorithm, and its position on the screen uses the device rotation matrix provided by the gyroscope (See "How does it work?" section below). BRSunTracker also works during the night, just aim at your feet to find to find the sun.

The sample app included displays a marker on a camera preview that follows the sun on the screen and snaps to the middle of the view once the phone is oriented towards it.

Installation

BRSunTracker is available through CocoaPods, to install it simply add the following line to your Podfile:

pod "BRSunTracker"

Usage

1. Import the BRSunTrackerView class into your view controller:

  #import "BRSunTrackerView.h"

2. Instanciate BRSunTrackerView and add it as a subview.

BRSunTrackerView *sunTrackerView = [[BRSunTrackerView alloc] initWithFrame:CGRectMake(0, 0, 320, 428)];
[self.view addSubview:sunTrackerView];

Or you can also add a BRSunTrackerView directly via the Interface Builder.

3. By default, the BRSunTrackerView will display a camera preview, and a default marker following the sun. You can enable or disable the camera and provide your own UIView as a marker by setting these properties:

  // Enable or disable the camera preview
  // (The default value is YES)
  [sunTrackerView setDisplayCameraPreview:YES];

  // Provide your own marker subview 
  // (otherwise will display the default one)
  [sunTrackerView setSunView:myMarkerView];

4. (Optional) Set your view controller as the delegate of the BRSunTrackerView and make it conform to the BRSunTrackerViewDelegate protocol. Implement the following methods to detect when the phone is aligned with the sun:

  [sunTrackerView setDelegate:self];  

  - (void)sunTrackerViewGotFocus:(BRSunTrackerView *)sunTrackerView{
      NSLog(@"The sun is aligned with the device.");
  }
  
  - (void)sunTrackerViewLostFocus:(BRSunTrackerView *)sunTrackerView{
      NSLog(@"The sun is not aligned with the device anymore.");
  }

5. Grab a pair of sunglasses (and a cold drink).

How does it work?

A diagram explaining roughly the process of computing the sun 2D screen coordinates in BRSunTracker is shown below. All of this happens inside the BRSunTracker class. The gyroscope orientation data is currently sampled 60 times per second, the sun spherical coordinates are computed every minute or when the GPS location gets updated.

Sources and acknowledgements

pARk, Apple code sample showing a basic Augmented Reality implementation

PSA Algorithm, C++ function that computes the spherical coordinates of the sun based on the GPS coordinates, the time and date.

Stack Overflow, My initial Stack Overflow post about how to compare the device orientation with the sun position.

Thanks to Dan Marson who provided the GIF shown above.

This feature was conceived and built for the "Piano Ombre" album-app concept for Frànçois and the Atlas Mountains, now available on the App Store.

Author

Julien Ducret - [email protected]

Follow me on Twitter @jbrocoo

Check out my app: Spores

Licence

BRSunTracker is under Apache licence, see the LICENCE file for more info.