snowprofileCsv_advanced: Read routine for advanced csv tables containing various...

In sarp.snowprofile: Snow Profile Analysis for Snowpack and Avalanche Research

Read routine for advanced csv tables containing various snowprofile information

Description

This routine reads blocks of snowprofile metadata, layers, tests, and stability signs. Columns contain different variables, rows different observations. While metadata only contains one row, layers, tests, and signs consist of potentially multiple rows. Within each block of information, mind the correct alignment of rows. Missing values (i.e., NA) need to be left blank or called NA. See the examples below including the example file shipped with the package.

Usage

snowprofileCsv_advanced(
  csvFile,
  meta = c("uid", "hs", "maxObservedDepth", "comment"),
  layers = c("depth", "height", "gtype", "hardness", "datetag", "gsize", "gtype_sec",
    "layer_comment"),
  tests = c("test", "result", "fract_char", "score", "test_depth", "test_comment"),
  instabilitySigns = c("instabilitySign_type", "instabilitySign_present",
    "instabilitySign_comment"),
  sep = ",",
  elev.units = "ft",
  tz = "UTC"
)

Arguments

csvFile	'path/to/file.csv'
meta	column names of block metadata
layers	column names of block snowprofileLayers
tests	column names of block snowprofileTests
instabilitySigns	column names of block snowprofileInstabilitySigns
sep	csv column separator
elev.units	if set to "ft", the routine will convert to "m". Set to "m" (or anything else) if it should be unchanged
tz	time zone (default = 'UTC')

Author(s)

fherla

Examples

## load example csv file that ships with package:
csvFile <- system.file('extdata', 'example_adv.csv', package = 'sarp.snowprofile')

profile <- snowprofileCsv_advanced(csvFile, meta = c("uid", "hs", "maxObservedDepth", "comment",
                                                     "datetime", "zone", "station",
                                                     "station_id", "aspect", "elev", "angle"))

plot(profile)

sarp.snowprofile documentation built on March 31, 2023, 5:17 p.m.