masscor (version 0.0.7.1)

massStandardKit: Creates an object of class "massStandardKit".

Description

The object of class "massStandardKit" is a wrapper for several objects of class "massStandard". The object of class "massStandard" contains the calibration information of a mass standard that is used in routine balance verification (e g. to calculate normalized error. See normalizedError()). When several mass standards are part of a kit their information can be in conveniently be stored together in a "massStandardKit" class object.

Usage

massStandardKit(nominal, convMassCor, uncert, units = c("g", "mg", "mg"),
  serial = NULL, manufacturer = NULL, class = NULL, certificate = NULL,
  traceability = NULL, Temp = NULL, p = NULL, h = NULL,
  unitsENV = c("deg.C", "hPa", "%"), expanded = TRUE, k = 2,
  rho = NULL, u_rho = NULL, unitsrho = "g/cm^3", institution = NULL,
  date = NULL, add.info = NULL)

Arguments

nominal

vector with nominal mass for each standard all in the same units. If no weights are duplicated in the kit the vector can be numeric. If there are duplicated standards some elements must be character type. See Details.

convMassCor

numeric vector with conventional mass corrections for each of the mass standard declared in nominal.

uncert

numeric vector with standard uncertainties of the conventional mass corrections for each mass standard declared in nominal.

units

character vector of length 3 with the units of nominal, convMass and uncert, respectively. Default is c('g', 'mg', 'mg').

serial

serial number of the mass standard or mass standards kit.

manufacturer

character with the manufacturer of the mass standard or mass standards kit.

class

character with the claimed class of the mass standard or mass standards kit, according to OIML (2004).

certificate

character with the calibration certificate number and date of issue.

traceability

character with information regarding the traceability of the calibration.

Temp

ambient temperature at the moment of the calibration.

p

barometric pressure at the moment of the calibration.

h

relative humidity at the moment of the calibration.

unitsENV

character vector of length three with the units of p, Temp and h. Default is c('deg.C', 'hPa', '%'). See unitsENV below for more options.

expanded

if TRUE (the default), uncertainties provided in indError are assumed to be expanded uncertainties, instead of standard uncertainties.

k

coverage factor for the expanded uncertainties when expanded = TRUE.

rho

numeric vector with densities for each mass standard declared in nominal. If not provided the default value of 8.000 g cm\(^{-3}\) is used for all weights.

u_rho

numeric vector with uncertainties in the density for each mass standard declared in nominal. If not provided the default value of 0.060 g cm\(^{-3}\) is used for all weights.

unitsrho

Units of the density of the mass standards. Default is 'g/cm^3'.

institution

character with the identification of the calibration laboratory.

date

character with the date of the measurements.

add.info

named list or vector with any additional details included in the calibration certificate.

Value

Object of class "massStandard" with calibration information of a mass standards kit.

unitsENV

Temperature units (Temp) can be either 'deg.C' (for Celsius degrees) or 'K'. Pressure units (p) can be any of 'mmHg', 'Pa', 'hPa' or 'kPa'. Relative humidity (h) can be expressed as fraction ('frac') or as percentage ('%'). A typical arrangement for the parameter unitsENV would be c('deg.C', 'hPa', '%').

Details

When two mass standards of equal nominal mass are present in the same kit (typically those of nominal mass in the form \(2\times10^n\)), it is necessary to make a distinction between them because their real mass are not likely to be exactly the same. Physically this distinction is achieved by marking one of them, for example, with a dot in the head of the knot weights, or by bending the final part of the lifted extreme in wire weights. To differentiate those duplicated mass standards in the "massStandardKit" class object, its nominal mass value must be entered as a character including an asterisk after the value (ie. '200*' instead of just entering 200). The function returns error if the kit contains duplicated mass standards and no differentiation is indicated.

See Also

massStandard(), normalizedError()

Examples

# NOT RUN {
nominal     <- c(1000, 500, 200, '200*', 100)   # [g]
convMassCor <- c(0.0, -0.03, 0.03, 0.06, 0.00)  # [mg]
uncert      <- c(0.50, 0.25, 0.10, 0.10, 0.05)  # [mg]
units       <- c('g', 'mg', 'mg')

rho         <- c(8012.217, 8008.640, 8011.126, 8010.722, 8010.935)# [kg/m^3]
u_rho       <- c(0.096, 0.090, 0.160, 0.160, 0.321)# [kg/m^3]
unitsrho    <- 'kg/m^3'

MS.Kit1 <- massStandardKit(nominal = nominal, convMassCor = convMassCor, uncert = uncert,
                           units = units, rho = rho, u_rho = u_rho, unitsrho = unitsrho)
print(MS.Kit1)

# }