dS: Declination of December Solstice for a given year

View source: R/events.R

dSR Documentation

Declination of December Solstice for a given year

Description

This function calculates the declination of the sun at December Solstice for a given year, based upon obliquity estimation and corrected average parallax.

Usage

dS(
  year = skyscapeR.env$cur.year,
  loc = FALSE,
  parallax = 0.00224,
  altitude = 0,
  verbose = TRUE
)

Arguments

year

Year for which to calculate the declination. Defaults to present year as given by Sys.Date.

loc

(Optional) This can be either the latitude of the location, or a skyscapeR.horizon object. If missing or FALSE, function will output geocentric declination.

parallax

(Optional) Average parallax value for the sun. Defaults to 0.00224.

altitude

(Optional) Altitude of the sun. Defaults to 0 degrees.

verbose

(Optional) Boolean to control output of warnings and messages. Defaults to TRUE.

See Also

obliquity, jS, eq, zenith, antizenith, spatial.equinox, parallax.corr

Examples

# December Solstice geocentric declination for year 4001 BC:
dS(-4000)

# Topocentric declination for same year and latitude of 50 degrees N:
dS(-4000, loc=50)

f-silva-archaeo/skyscapeR documentation built on Sept. 24, 2023, 8:14 p.m.