About
What is it?
tsp
(“teaspoon”) is a python library designed to make working with permafrost time series data more straightforward, efficient, and reproduceable. It is described in this JOSS paper. Some of the features include:
- Read a variety of common published data formats, datalogger outputs, and model results into a common data structure
GEOtop model output
GTN-P database export csv
NTGS ground temperature report csv
Geoprecision datalogger export
HoboWare datalogger export
logR datalogger export
- Export data in a variety of common formats
netcdf
‘GTN-P’-style csv
‘NTGS’-style csv
- Perform common data transformations
Calculate daily, monthly, or yearly means, ignoring averaging periods with missing data
Switch between “long” and “wide” dataframes
- Visualize and explore your data with commonly used plots
Trumpet curves
Temperature-time graphs
Colour-contour profiles

Figure 1: A summary of the main capabilities of the tsp library
Why “teaspoon” (tsp)?
The data represent the Thermal State of Permafrost (or alternatively the Temperature du Sol en Profondeur)
The data are easily represented by the “Time Series of Profiles” CF discrete sampling geometry
It’s short and memorable!
Where do I find it?
The code repository is hosted on Gitlab
How can I install it?
See the Installation page of this documentation.