Travis-CI Build Status Coverage Status

The mudata2 package provides tools to read, write, and document multi-parameter spatiotemporal data.


You can install mudata2 from github with:

# install.packages("devtools")

What is mudata?

The mudata format is a data table in a specific form, with data dictionaries for locations, parameters, and datasets contained in the data table. The term “mudata” refers to a (mostly) universal data structure; the term “multi-parameter spatiotemporal data” is a mouthful, but just means that you measured a bunch of things (parameters) in a bunch of places (locations) at a bunch of different times. The best example of this is historical climate data, because it is usually set up in such a way that there are climate stations (locations) that measure some things (parameters, like temperature, precipitation, wind, etc.) at various points in time. This package is designed primarily for climate data and sediment core data, however the format can be applied to many other types of data where parameters are measured along one or more common axes (time, depth, etc.).

Why do I need it?

There are plenty of ways to store “multi-parameter spatiotemporal data”, but few of them are good at keeping metadata like what method was used to measure a parameter, the latitude and longitude of a sample location, or the level of uncertainty of a parameter measurement. These metadata are rarely used directly in analyses, but are invaluable to correctly interpret the results (and to correctly choose the analysis).

When do I need it?

We have used the mudata format in the following situations:

More information

For more examples of mudata usage, see the package vignettes: vignette("mudata", package = "mudata2"), and vignette("mudata_create", package = "mudata2")

Why mudata2?

The first mudata went on CRAN before I learned about unit testing, before I learned about the tidyverse, and before the journal article describing the format went through peer review. This led to important changes that couldn’t be backward-compabible (but don’t worry, all those files I sent you before September 2017 can still be read no problem).