createMast: Creation of met mast objects

Description

Creates met mast objects from one or more datasets (measurement heights). All datasets are sorted by height in descending order.

Usage

createMast(time.stamp, ..., loc=NULL, desc=NULL)

Arguments

time.stamp

Time stamp as POSIXlt vector, e.g. created by formatTS.

...

At least one dataset created by createSet.

loc

Lat/lon coordinates of the site in decimal degrees as vector of two numeric values (optional).

desc

Plain text information about the site, measurement, met mast condition, etc. as string (optional).

Value

Returns a met mast object, which is necessary for all data analyses. A met mast object is a list of:
time.stampTime stamp of the observations.
locationLat/lon coordinates of the site (optional).
descriptionMast information (optional).
setsList of one or more datasets (measurement heights) consisting of height information and the data.

encoding

UTF-8

Details

Valuable information about a met mast is usually provided by an installation protocol.

Measurements of wind speed in several heights is required for the computation of the site's wind profile. Met masts might have mounted more than one sensor of the same type at the same height. Thus, the data of a broken sensor can later be substituted by the 'backup-sensor'.

Examples

Run this code

# load data, prepare sets and time stamp
data(winddata)
set40 <- createSet(height=40, v.avg=winddata[,2], v.std=winddata[,5],
  dir.avg=winddata[,14])
set30 <- createSet(height=30, v.avg=winddata[,6], v.std=winddata[,9],
  dir.avg=winddata[,16])
set20 <- createSet(height=20, v.avg=winddata[,10], v.std=winddata[,13])
ts <- formatTS(time.stamp=winddata[,1])

# create met mast object
neubuerg <- createMast(time.stamp=ts, set40, set30, set20)

# create met mast with location and description
neubuerg.2 <- createMast(time.stamp=ts, set40, set30, set20, 
  loc=c(49.8909,11.4017), desc="Site #247 - Neubuerg")

# view structure of met mast
str(neubuerg.2)

# name sets
neubuerg.3 <- createMast(time.stamp=ts, C1.A1=set40, C2.A2=set30, 
  C3=set20, loc=c(49.8909,11.4017), desc="Site #247 - Neubuerg")

# compare names
names(neubuerg.2$sets)	# default names
names(neubuerg.3$sets)

Run the code above in your browser using DataLab

State of Data and AI Literacy Report 2025