calibCert {masscor}

Information of balance calibration certificate

Description

Creates an object of class calibCert that contains the information of a balance calibration certificate. The object can later be used to correct mass readings and calculate mass uncertainties. Mandatory arguments for this function are the balance division scale (d), the results of the indication error test (indError), the results of repeatability test (rep), and the results of the eccentricity test (eccen).

Usage

calibCert(balanceID = "BalanceID", serial = NULL, certificate = NULL, d,
  d.units = "mg", indError, indError.units = c("g", "mg", "mg"),
  expanded = TRUE, k = 2, rep, rep.units = c("g", "mg"), eccen,
  eccen.units = "mg", classSTD = NULL, traceability = NULL,
  Temp = NULL, p = NULL, h = NULL, unitsENV = c("deg.C", "hPa", "%"),
  institution = NULL, accreditation = NULL, date = NULL,
  add.info = NULL)

Arguments

balanceID

character with balance identification. May include balance model, brand or internal location.

serial

serial number of the balance.

certificate

character with the calibration certificate number and date of issue.

d

division scale of the balance.

d.units

character with the units of the division scale of the balance. Default value is 'mg'. See Details for more options.

indError

data.frame with the indication error test results in three columns containing balance reading, indication error and associated uncertainties, respectively, for at least two mass standards.

indError.units

character of length three with the units for each column in the data frame provided in indError. Default value is c('g', 'mg', 'mg').

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.

rep

results of the repeatability test. If the test is performed in only one point, then rep is a numeric vector of length two with the balance load and standard deviation for the same object measured under repeatability conditions. If the test is performed at more than one point rep is a data frame with balance loadings in the first column and standard deviations in the second.

rep.units

character of length two with the units for balance loads and standard deviations provided in rep. Default value is c('g', 'mg').

eccen

numeric vector of length two with balance load and maximal reading difference obtained during eccentricity test.

eccen.units

character of length two with the units for balance loads and maximal reading difference provided in eccen. Default value is c('g', 'mg').

classSTD

character with the class of the mass standards used.

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.

institution

character with the identification of the calibration laboratory.

accreditation

character with the accreditation information 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.

Details

The units of d, indError, rep and eccen shall be provided to the arguments d.units, indError.units, rep.units and eccen.units, respectively. The units can be any multiple or subdivision of the SI unit for mass, the kilogram. The greek letter \mu used to represent a millionth part, is replaced by the vocal u. Remember that both R and the SI prefixes are case sensitive.

Value

Object of class calibCert with information of the calibration certificate for a balance.

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

See Also

S3 methods print.calibCert() and plot.calibCert() are available. See convertMassUnitsSI() for information about mass units.

Examples

massSTD  <- c(0.01, 0.5, 1, 10, 20, 50, 100, 120, 150, 200, 220)  ## [g]
indError <- c(0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, -0.2, -0.2) ## [mg]
uncert   <- c(0.1, 0.1, 0.1, 0.1, 0.1, 0.2, 0.2, 0.3, 0.3, 0.4, 0.5) ## [mg]
d <- 0.1 ## [mg]

Balance.D1 <- calibCert(balanceID = 'MT XPE 204', serial = 'B403223982',
                        d = d, d.units = 'mg',
                        indError = data.frame(massSTD, indError, uncert),
                        indError.units = c('g', 'mg', 'mg'),
                        rep = data.frame(load = c(0.1, 100, 220),
                                         sd = c(0.00, 0.04, 0.03)),
                        rep.units = c('g', 'mg'),
                        eccen = c(100, 0.1), eccen.units = c('g', 'mg'),
                        Temp = c(17.4, 17.9), ## [deg.C]
                        p = c(750.4, 751.0), ## [hPa]
                        h = c(70.5, 71.4), ## [%]
                        unitsENV = c('deg.C', 'hPa', '%'),
                        institution = 'Instituto Nacional de Metrologia de Colombia',
                        date = '2021-03-18')
print(Balance.D1)