skyscapeR (version 1.0.0)

coordtrans: Coordinate-transform azimuth prob distributions into declination prob distributions

Description

Coordinate-transform azimuth prob distributions into declination prob distributions

Usage

coordtrans(pdf, hor, refraction, atm, temp, verbose = T, .res = 0.1)

Arguments

pdf

A skyscapeR.pdf object created with az.pdf

hor

A skyscapeR.horizon object created with createHor or downloadHWT

refraction

(Optional) Whether atmospheric refraction is to be taken into account. If not given the value set by skyscapeR.vars will be used instead.

atm

(Optional) Atmospheric pressure for refraction calculation. If not given the value set by skyscapeR.vars will be used instead.

temp

(Optional) Atmospheric temperature for refraction calculation. If not given the value set by skyscapeR.vars will be used instead.

verbose

(Optional) Boolean to control whether or not to display text. Default is TRUE.

.res

(Optional) Declination resolution with which to output probability distribution(s). Default is 0.1 degrees.

References

Silva, F (2020) A probabilistic framework and significance test for the analysis of structural orientations in skyscape archaeology Journal of Archaeological Science 118, 105138. <doi:10.1016/j.jas.2020.105138>

Examples

# NOT RUN {
Az <- az.pdf(az=c(87,93,90,110), unc=3)
hor <- createHor(az=c(0,360), alt=c(0,0), loc=c(35,-8,25)) # flat horizon with 0 degrees of altitude
Dec <- coordtrans(Az, hor)
plot(Dec)
# }