reduct.compass: Data reduction for compass measurements

Description Usage Arguments See Also Examples

View source: R/data-reduction.R

Description

This function calculates the true azimuth of a structure measured with a compass.

Usage

1
reduct.compass(loc, mag.az, date, magdec, alt, name, ID, HWT.ID)

Arguments

loc

Location, either a skyscapeR.object or a vector containing the latitude and longitude of location, in this order.

mag.az

Array of magnetic azimuth measurements.

date

(Optional) Date of measurements as a string in the format: 'YYYY/MM/DD'. Only necessary if magdec is not given.

magdec

(Optional) Magnetic declination, if known.

alt

(Optional) Altitude, necessary for automatic declination calculation. If missing and loc is a skyscapeR.horizon object then the altitude will be automatically read from the horizon profile.

name

(Optional) Names or labels to identify each measurement.

ID

(Optional) IDs or codes to identify each measurement.

HWT.ID

(Optional) HeyWhatsThat IDs relating to a previously generated horizon profile for measurement.

See Also

mag.dec, az2dec, hor2alt

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
loc <- c(35,-7)
mag.az <- c(89.5, 105, 109.5)
data <- reduct.compass(loc, mag.az, "2016/04/02")

# Declination will be automatically calculated if the altitude is also given:
data <- reduct.compass(loc, mag.az, "2016/04/02", alt=c(1,2,0))

# Alternatively, the altitude can be automatically retrieved from a horizon profile:
hor <- downloadHWT('NML6GMSX')
data <- reduct.compass(hor, mag.az, "2016/04/02")

f-silva-archaeo/skyscapeR documentation built on Jan. 22, 2019, 8:11 a.m.