Metadata-Version: 2.1
Name: ctdfjorder
Version: 0.5.6
Summary: A package for processing and analyzing CTD data.
Home-page: https://github.com/nikothomas/ctdfjorder
License: MIT
Keywords: CTD
Author: Nikolas Yanek-Chrones
Author-email: research@icarai.io
Requires-Python: >=3.11
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: dash (>=2.17.1,<3.0.0)
Requires-Dist: dash-core-components (>=2.0.0,<3.0.0)
Requires-Dist: dash-html-components (>=2.0.0,<3.0.0)
Requires-Dist: dash-table (>=5.0.0,<6.0.0)
Requires-Dist: fastexcel (>=0.10.4)
Requires-Dist: flask (>=3.0.3,<4.0.0)
Requires-Dist: gsw (>=3.6.18)
Requires-Dist: matplotlib (>=3.9.1)
Requires-Dist: numpy (>=2.0.0)
Requires-Dist: openpyxl (>=3.1.4)
Requires-Dist: pandas (>=2.2.2)
Requires-Dist: plotly (>=5.20.0,<6.0.0)
Requires-Dist: polars (>=1.1.0)
Requires-Dist: psutil (>=6.0.0,<7.0.0)
Requires-Dist: pyarrow (>=17.0.0)
Requires-Dist: pytest (>=8.3.1,<9.0.0)
Requires-Dist: rich (>=13.7.1,<14.0.0)
Requires-Dist: rich-argparse (>=1.5.2,<2.0.0)
Requires-Dist: scikit-learn (>=1.5.1,<2.0.0)
Requires-Dist: scipy (>=1.14.0,<2.0.0)
Requires-Dist: statsmodels (>=0.14.2)
Requires-Dist: torch (>=2.4.0)
Project-URL: Documentation, https://nikothomas.github.io/ctdfjorder/
Project-URL: Repository, https://github.com/nikothomas/ctdfjorder
Project-URL: homepage, https://github.com/nikothomas/ctdfjorder
Project-URL: issues, https://github.com/nikothomas/ctdfjorder/issues
Description-Content-Type: text/markdown

[![CircleCI](https://dl.circleci.com/status-badge/img/circleci/BqQeY7gNQzLD7veRpM5Fpj/4nijPG3CZqyE8SAoqtPWZr/tree/main.svg?style=shield)](https://dl.circleci.com/status-badge/redirect/circleci/BqQeY7gNQzLD7veRpM5Fpj/4nijPG3CZqyE8SAoqtPWZr/tree/main)
[![PyPI version](https://badge.fury.io/py/ctdfjorder.svg)](https://badge.fury.io/py/ctdfjorder)

# CTDFjorder
CTDFjorder is a Python package for processing and analyzing CTD (Conductivity, Temperature, Depth) data.
Documentation: [Read the docs](https://nikothomas.github.io/ctdfjorder/)

- [<code>⭐ Features</code>](#-features)
- [<code>📦 Installation</code>](#-installation)
- [<code>🗺️ Mapping</code>](#-mapping)
- [<code>🚀 Usage</code>](#-usage)
- [<code>📝 License</code>](#-license)
- [<code>📢 Acknowledgments</code>](#-acknowledgments)

## ⭐ Features
- Read RBR (.rsk) and SonTek Castaway (.csv) files and extract CTD data
- Process CTD data, including removing non-positive samples and cleaning data
- Calculate derived quantities such as absolute salinity, density, and potential density
- Determine mixed layer depth (MLD) using different methods
- Generate plots for visualizing CTD profiles and derived quantities
- Command-line interface (CLI) for easy processing and merging of CTD data files

## 📦 Installation
It's recommended that you create a new environment just for CTDFjorder. This can be done in conda with the following
command.
```shell
conda create --name ctdfjorder python=3.12
conda activate ctdfjorder
```
To install ctdfjorder you can use pip:
```shell
pip install ctdfjorder
```

## 🚀 Usage
CTDFjorder provides a command-line interface (CLI) for processing and analyzing CTD data in addition to serving
as a python library. A tutorial has been setup [here](https://nikothomas.github.io/ctdfjorder/Getting%20Started.html)
for running the CLI.

## 📝 License
CTDFjorder is released under the MIT License.

## 📢 Acknowledgments
CTDFjorder was developed for the Fjord Phyto project. The gsw library was used for certain dervied calculations.

## Citations
McDougall, T. J., & Barker, P. M. (2011). Getting started with TEOS-10 and the Gibbs Seawater (GSW) Oceanographic Toolbox. SCOR/IAPSO WG127.

Pan, B.J.; Vernet, M.; Reynolds, R.A.; Mitchell, B.G.: The optical and biological properties of glacial meltwater in an Antarctic fjord. PLOS ONE 14(2): e0211107 (2019). https://doi.org/10.1371/journal.pone.0211107

