Metadata-Version: 2.4
Name: tsp
Version: 1.10.4
Summary: Making permafrost data effortless
Home-page: https://gitlab.com/permafrostnet/teaspoon
Author: Nick Brown
Author-email: nick.brown@carleton.ca
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas
Requires-Dist: numpy
Requires-Dist: regex
Requires-Dist: matplotlib
Requires-Dist: setuptools
Requires-Dist: netCDF4
Requires-Dist: pfit>=0.3.0
Requires-Dist: scipy
Requires-Dist: pyrsktools
Requires-Dist: openpyxl
Provides-Extra: nc
Requires-Dist: netCDF4; extra == "nc"
Requires-Dist: pfit>=0.3.0; extra == "nc"
Provides-Extra: plotting
Requires-Dist: scipy; extra == "plotting"
Provides-Extra: rbr
Requires-Dist: pyrsktools; extra == "rbr"
Requires-Dist: openpyxl; extra == "rbr"
Provides-Extra: full
Requires-Dist: pfit>=0.3.0; extra == "full"
Requires-Dist: netCDF4; extra == "full"
Requires-Dist: pyrsktools; extra == "full"
Requires-Dist: scipy; extra == "full"
Requires-Dist: openpyxl; extra == "full"
Provides-Extra: dev
Requires-Dist: manuel; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: coverage; extra == "dev"
Requires-Dist: mock; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: summary

# Teaspoon

## See the full documentation on the [ReadTheDocs Pages](https://permafrostnet.gitlab.io/teaspoon/source/about.html)

## [What is it?](https://permafrostnet.gitlab.io/teaspoon/source/about.html)
`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
    * TSP-recommended csv format
    * 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

## [Installation](https://permafrostnet.gitlab.io/teaspoon/source/install.html)

## [Usage Examples](https://permafrostnet.gitlab.io/teaspoon/source/examples.html)

## [How to contribute](https://permafrostnet.gitlab.io/teaspoon/source/contributions.html)

## Data Standard
TSP also defines a recommended csv format for ground temperature data (which can also be extended to many other kinds of permafrost data). It is described in the [DATA_STANDARD.md](./DATA_STANDARD.md) file in this directory. Files can be read (using the `TSP.to_csv` method) and written (using `read_tsp`) using the teaspoon software package. 

## Citation
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, [https://doi.org/10.21105/joss.04704](https://doi.org/10.21105/joss.04704)
