Skip to main content

Making permafrost data effortless

Project description


See the full documentation on the ReadTheDocs Pages

What is it?

tsp ('teaspoon') is a python library designed to make working with permafrost ground temperature time series data more straightforward, efficient, and reproduceable. 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
  • 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


Usage Examples

How to contribute


If you find this software helpful, please consider using the following citation:

Brown, N., (2022). tsp ("Teaspoon"): A library for ground temperature data. Journal of Open Source Software, 7(77), 4704,

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release. See tutorial on generating distribution archives.

Built Distribution

tsp-1.6.0-py3-none-any.whl (3.0 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page