Using standards for your permafrost data when sharing or publishing it is one of the ways to make your data more discoverable and reusable by others. Participants at the 2020 Permafrost Data Workshop identified access to standardized data and the discoverability of existing data as two of their main data-related challenges.
This page describes NSERC PermafrostNet’s recommendations for sharing and publishing permafrost data. Here we focus on ground temperature data and geotechnical measurements. These recommendations will promote data interoperability within the network and the broader community.
PermafrostNet has started to develop a python package to support file interoperability.
Contributions are welcome and we invite other researchers and initiatives to build on and contribute to the tools and practices we have. For more information, email us.
Describing permafrost datasets with CF Standard Names
The CF Standard names are a list of terms used to unambiguously identify the kinds of measurements in a dataset. Nick Brown and Michel Paquette (NSERC PermafrostNet) have coordinated the inclusion of 12 additional permafrost-related terms (see table below) in the latest release of the Standard Names vocabulary (version 78). These terms will be particularly useful for field scientists wanting to make their published datasets more interoperable and for data publishers who host permafrost-related data. An additional 14 terms relevant to permafrost science have since been requested. The addition of permafrost-related terms contributes to improved data interoperability with the atmospheric science and modelling communities, where the CF terms are widely used.
For self-describing formats like netcdf, you can include these attributes directly in your data file, following the CF standards. If you are publishing your data in a text file, like a CSV, you should include metadata (like the standard_name) about each column in your dataset in a separate metadata file. This information should also include the units and anything else that someone else might need to re-use your data.
Common name | CF Name | Status |
---|---|---|
Ground temperature | temperature_in_ground | Added (v78) |
Excess ice | ice_volume_in_frozen_ground_ in_excess_of_pore_volume_in_unfrozen_ground_ expressed_as_fraction_of_frozen_ground_volume | Added (v78) |
Ice saturation index | ratio_of_ice_volume_in_frozen_ground_ to_pore_volume_in_unfrozen_ground | Added (v78) |
Thaw depth | depth_at_base_of_unfrozen_ground | Added (v78) |
Frozen thermal conductivity | thermal_conductivity_of_frozen_ground | Added (v78) |
Frozen heat capacity | specific_heat_capacity_of_frozen_ground | Added (v78) |
Gravel content by mass | mass_fraction_of_gravel_in_soil | Added (v78) |
Sand content by mass | mass_fraction_of_sand_in_soil | Added (v78) |
Silt content by mass | mass_fraction_of_silt_in_soil | Added (v78) |
Clay content by mass | mass_fraction_of_clay_in_soil | Added (v78) |
Organic matter content by mass | mass_fraction_of_organic_matter_in_soil | Added (v78) |
Soil water pH | soil_water_ph | Added (v78) |
Aspect | Ground_surface_slope_orientation | Requested |
Slope | Ground_surface_slope_angle | Requested |
Organic layer thickness | Thickness_of_soil_surface_organic_layer | Requested |
Shear strength | Soil_shear_strength | Requested |
Frozen shear strength | Frozen_soil_shear_strength | Requested |
Unconfined compressive strength | Soil_unconfined_compressive_strength | Requested |
Frozen unconfined compressive strength | Frozen_soil_unconfined_compressive_strength | Requested |
Specific gravity | Density_ratio_of_soil_to_water | Requested |
Frozen bulk density | Frozen_soil_density | Requested |
Bulk density | Soil_density | Requested |
Liquid limit | Soil_liquid_limit | Requested |
Plastic limit | Soil_plastic_limit | Requested |
Dry density | Soil_dry_density | Requested |
Soil salinity | Soil_water_salinity | Requested |
Permafrost related terms added to the CF Standard Name vocabulary by NSERC PermafrostNet
This technical note document provides variable names / column headings for the NSERC PermafrostNet ERDDAP server and can also be used as a guide to CF standard_name use for commonly-measured permafrost data.
Ground temperature data
Here we provide two recommendations for file formats and associated standards for permafrost ground temperature data. If you’re publishing your data in an online repository, don’t hesitate to include your data in more than one format.
Text Files
Text-based, or ASCII files are commonly used to store ground temperature measurements. These are familiar and simple to edit. However, you must include appropriate metadata so that your data can be reused by others.
- Choose text formats (*.csv, *.txt) over excel-based or proprietary formats (*.xls, *.xlsx)
- Follow an existing template for ground temperature measurements rather than coming up with your own
- The Northwest Territories Geological Survey (NTGS) has developed standard templates for permafrost data and metadata:
- For example, look at recently-published NTGS open files (e.g. Open Report 2019-007) or this example file.
- You can check your own file against the template using the PermafrostNet file validator (you can register a new account to log in)
- Note that the current template does not include time zone information, so you should include this somewhere in your metadata.
- The Northwest Territories Geological Survey (NTGS) has developed standard templates for permafrost data and metadata:
NetCDF
NetCDF files are commonly used in a variety of scientific disciplines to share data. These files are self-describing and are able to contain any required metadata. An example of netCDF files being used for permafrost data can be found in Nordicana-D issue 39. Or, you can download the file directly. Check back to this page for more examples of netCDF files for permafrost data.
- Follow the CF conventions; these describe a set of standards for structuring and describing netCDF files.
- Use the standard_name attribute to clearly specify what your data represents. The CF standard name table provides a list of accepted standard names. We recommend using the soil_temperature standard name for ground temperature.
- Include a units attribute to describe the units for each variable.
- Consider adding discovery-level metadata using the ACDD attributes.
Geotechnical data
This document suggests a structure for observed borehole profile data to increase the interoperability of permafrost data generated by and used within the network.
Return to the main data page.