massStandardKit: Creates an object of class '"massStandardKit"'.
In masscor: Mass Measurement Corrections

Description Usage Arguments Details Value unitsENV See Also Examples

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.

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)

`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.

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.

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

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', '%').

massStandard(), normalizedError()

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)