Dataset containing the mapping between laboratory parameter names/units and their equivalent SNIRH (Sistema Nacional de Informação de Recursos Hídricos) database format. It includes conversion factors for unit transformations and standardized symbols used in the SNIRH system.
Format
A data.table with 7 variables and multiple rows covering water quality, sediment, and biota parameters:
- param_lab
Character. Parameter name as provided by the laboratory. These are the original parameter names found in laboratory reports and may include special characters, accents, or laboratory-specific naming conventions.
- unit_lab
Character. Unit of measurement as provided by the laboratory. These represent the original units used in laboratory measurements and may vary between laboratories or analytical methods.
- symbol_snirh
Character. Standardized parameter symbol used in the SNIRH database. These symbols are unique identifiers that allow for consistent data storage and retrieval in the national database.
- param_snirh
Character. Standardized parameter name used in SNIRH. These names follow SNIRH conventions and provide consistency across different data sources and time periods.
- unit_snirh
Character. Standardized unit used in the SNIRH database. All measurements are converted to these standard units to ensure comparability and compliance with national monitoring standards.
- factor
Numeric. Conversion factor to transform laboratory units to SNIRH units. The formula is: snirh_value = lab_value * factor. For example, if converting mg/L to µg/L, the factor would be 1000.
- sample_type
Character. Type of sample matrix. Valid values are:
water: Surface water and groundwater samplesbiota: Biota to assess the chemical statussediment: Sediment samples from aquatic environments
Details
This dataset is essential for the convert_to_snirh function,
which uses it to:
Validate that all laboratory parameters can be converted to SNIRH format
Apply appropriate unit conversions using the conversion factors
Map laboratory parameter names to standardized SNIRH symbols
Ensure data quality and consistency with national standards
The conversion factors are carefully calibrated to maintain measurement accuracy while ensuring compliance with SNIRH database requirements. Parameters without a direct SNIRH equivalent are not included in this table and will cause the conversion function to raise an error.
Parameter Categories
The parameters are organized by sample type:
- Water parameters
Include physical properties (temperature, pH, conductivity), chemical parameters (nutrients, metals, organic compounds), and biological indicators.
- Sediment parameters
Cover grain size distribution, chemical composition, contaminant levels, and organic matter content.
- Biota parameters
Include bioaccumulation measurements and organism-specific parameters.
Data Quality
This dataset is maintained according to:
SNIRH technical specifications and data model requirements
Portuguese water quality monitoring standards (WFD implementation)
European Water Framework Directive requirements
Laboratory accreditation standards (ISO 17025)
Updates
This dataset should be updated when:
New parameters are added to SNIRH database
Laboratory methods change, requiring new unit conversions
SNIRH symbols or naming conventions are updated
New sample types are introduced to the monitoring program
References
APA (2023). Critérios para a monitorização das massas de água. https://apambiente.pt/sites/default/files/_SNIAMB_Agua/DRH/PlaneamentoOrdenamento/PGRH/2022-2027/PGRH_3_PTCONT_Monitorizacao.pdf
APA (2023). Critérios para a classificação das massas de água. https://apambiente.pt/sites/default/files/_SNIAMB_Agua/DRH/PlaneamentoOrdenamento/PGRH/2022-2027/PGRH_3_PTCONT_SistemasClassificacao.pdf
European Commission (2000). Water Framework Directive 2000/60/EC
ISO/IEC 17025:2017. General requirements for the competence of testing and calibration laboratories
See also
convert_to_snirh for the main conversion function that uses this data
Examples
# View all available parameters for water samples
water_params <- parameters[sample_type == "water"]
print(water_params[, .(param_lab, unit_lab, param_snirh, unit_snirh)])
#> param_lab unit_lab
#> <char> <char>
#> 1: % DE BIOVOLUME DE CIANOBACTÉRIAS %
#> 2: (m+p)-Xileno µg/L
#> 3: (meta+para)-Xileno µg/L
#> 4: 1,2-Dicloroetano µg/L
#> 5: 1,2-Dicloroetano - Subcontratado µg/L
#> ---
#> 518: PFOS (Ácido Perfluoroctanossulfónico) ng/L
#> 519: Fitobentos (IPS) -
#> 520: Fitobentos (RQE) -
#> 521: Macroinvertebrados (RQE) IPtIN -
#> 522: Macroinvertebrados (RQE) IPtIS -
#> param_snirh unit_snirh
#> <char> <char>
#> 1: % DE BIOVOLUME DE CIANOBACTÉRIAS (%) (%)
#> 2: (m+p)-Xileno (ug/l) µg/l
#> 3: (m+p)-Xileno (ug/l) µg/l
#> 4: 1,2-Dicloroetano ou EDC (ug/l) µg/l
#> 5: 1,2-Dicloroetano ou EDC (ug/l) µg/l
#> ---
#> 518: Ácido perfluorooctanossulfónico (PFOS) (ug/l) µg/l
#> 519: Fitobentos (IPS) -
#> 520: Fitobentos (RQE) -
#> 521: Macroinvertebrados (RQE) IPtIN -
#> 522: Macroinvertebrados (RQE) IPtIS -
# Check conversion factor for a specific parameter
ph_conversion <- parameters[param_lab == "pH" & sample_type == "water"]
print(ph_conversion$factor) # Should be 1 (no conversion needed)
#> [1] 1
# Find all parameters that require unit conversion
converted_params <- parameters[factor != 1]
print(converted_params[, .(param_lab, unit_lab, unit_snirh, factor)])
#> param_lab unit_lab unit_snirh factor
#> <char> <char> <char> <num>
#> 1: 1,2,3,4,6,7,8-HpCDD ng/kg µg/Kg 0.001
#> 2: 1,2,3,4,6,7,8-HpCDD (TEQ) ng OMS-TEQ/kg µg/Kg 0.001
#> 3: 1,2,3,4,6,7,8-HpCDF ng/kg µg/Kg 0.001
#> 4: 1,2,3,4,6,7,8-HpCDF (TEQ) ng OMS-TEQ/kg µg/Kg 0.001
#> 5: 1,2,3,4,7,8,9-HpCDF ng/kg µg/Kg 0.001
#> ---
#> 204: Zinco µg/L mg/l 0.001
#> 205: Zinco µg/L Zn mg/l 0.001
#> 206: Zinco dissolvido µg/L mg/l 0.001
#> 207: Zinco dissolvido µg/L Zn mg/l 0.001
#> 208: PFOS (Ácido Perfluoroctanossulfónico) ng/L µg/l 0.001
# Get SNIRH symbols for biota parameters
biota_symbols <- parameters[sample_type == "biota", unique(symbol_snirh)]
print(biota_symbols)
#> [1] "1234678-HpCDD_BIOTA" "1234678-HpCDD(TEQ)_BIOTA"
#> [3] "1234678-HpCDF_BIOTA" "1234678-HpCDF(TEQ)_BIOTA"
#> [5] "1234789-HpCDF_BIOTA" "1234789-HpCDF(TEQ)_BIOTA"
#> [7] "123478-HxCDD_BIOTA" "123478-HxCDD(TEQ)_BIOTA"
#> [9] "123478-HxCDF_BIOTA" "123478-HxCDF(TEQ)_BIOTA"
#> [11] "123678-HxCDD_BIOTA" "123678-HxCDD(TEQ)_BIOTA"
#> [13] "123678-HxCDF_BIOTA" "123678-HxCDF(TEQ)_BIOTA"
#> [15] "123789-HxCDD_BIOTA" "123789-HxCDD(TEQ)_BIOTA"
#> [17] "123789-HxCDF_BIOTA" "123789-HxCDF(TEQ)_BIOTA"
#> [19] "12378-PeCDD_BIOTA" "12378-PeCDD(TEQ)_BIOTA"
#> [21] "12378-PeCDF_BIOTA" "12378-PeCDF(TEQ)_BIOTA"
#> [23] "2334455-HpCB189_BIOTA" "2334455-HpCB189(TEQ)_BIOTA"
#> [25] "233445-HxCB156_BIOTA" "233445-HxCB156(TEQ)_BIOTA"
#> [27] "233445-HxCB157_BIOTA" "233445-HxCB157(TEQ)_BIOTA"
#> [29] "23344-PeCB105_BIOTA" "23344-PeCB105(TEQ)_BIOTA"
#> [31] "234455-HxCB167_BIOTA" "234455-HxCB167(TEQ)_BIOTA"
#> [33] "23445-PeCB114_BIOTA" "23445-PeCB114(TEQ)_BIOTA"
#> [35] "23445-PeCB118_BIOTA" "23445-PeCB118(TEQ)_BIOTA"
#> [37] "23445-PeCB123_BIOTA" "23445-PeCB123(TEQ)_BIOTA"
#> [39] "234678-HxCDF_BIOTA" "234678-HxCDF(TEQ)_BIOTA"
#> [41] "23478-PeCDF_BIOTA" "23478-PeCDF(TEQ)_BIOTA"
#> [43] "2378-TCDD_BIOTA" "2378-TCDD(TEQ)_BIOTA"
#> [45] "2378-TCDF_BIOTA" "2378-TCDF(TEQ)_BIOTA"
#> [47] "334455-HxCB169_BIOTA" "334455-HxCB169(TEQ)_BIOTA"
#> [49] "33445-PeCB126_BIOTA" "33445-PeCB126(TEQ)_BIOTA"
#> [51] "3344-TCB77_BIOTA" "3344-TCB77(TEQ)_BIOTA"
#> [53] "3445-TCB81_BIOTA" "3445-TCB81(TEQ)_BIOTA"
#> [55] "PBDE_IUPAC100_BIOTA" "PBDE_IUPAC153_BIOTA"
#> [57] "PBDE_IUPAC154_BIOTA" "PBDE_IUPAC28_BIOTA"
#> [59] "PBDE_IUPAC47_BIOTA" "PBDE_IUPAC99_BIOTA"
#> [61] "BENAPIR_BIOTA" "FANTENO_BIOTA"
#> [63] "Hg_BIOTA" "OCDD_BIOTA"
#> [65] "OCDD(TEQ)_BIOTA" "OCDF_BIOTA"
#> [67] "OCDF(TEQ)_BIOTA" "SOMAPCBs(TEQ)_BIOTA"
#> [69] "SOMAPCDD/Fs(TEQ)_BIOTA"