README.md

suntools

R-CMD-check

suntools provides functions for calculating the sun's position, sunrise, sunset, solar noon, and crepuscular (twilight) times for any given geographical location and time on earth. Functions in suntools used to be part of the maptools package. The functions are based on equations provided by the National Oceanic & Atmospheric Administration (NOAA).

Main package functions: crepuscule(): Calculates crepuscular (twilight) times, i.e. the time of dawn or dusk. sunriset(): Calculates the times of sunrise and sunset at a given location. solarpos(): Calculates the solar position (elevation and azimuth) at a given location and time. solarnoon(): Calculates solar noon time at a given location.

Installation

You can install the released version of suntools from CRAN with:

install.packages("suntools")

Alternatively, you can install the development version from GitHub with:

devtools::install_github("adokter/suntools")

Example

library(suntools)

#Calculate sunset in Ithaca, NY, USA on June 1, 2023

sunriset(
  matrix(c(-76.4511, 42.4800), nrow = 1),
  as.POSIXct("2023-06-01", tz = "America/New_York"),
  direction='sunset',
  POSIXct.out=TRUE
)

#  day_frac                time
#1 0.858628 2023-06-01 20:36:25

Author(s)

References

This package uses algorithms provided by the National Oceanic & Atmospheric Administration (NOAA), for more information see



Try the suntools package in your browser

Any scripts or data that you put into this service are public.

suntools documentation built on July 9, 2023, 6:44 p.m.