calibCert: Information of balance calibration certificate
In masscor: Mass Measurement Corrections

Description Usage Arguments Details Value unitsENV See Also Examples

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

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)

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

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 μ used to represent a millionth part, is replaced by the vocal u. Remember that both R and the SI prefixes are case sensitive.

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

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

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

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)