Installing Pynasonde¶

Get Up and Running in Minutes

Pynasonde requires Python 3.11+ and installs cleanly via pip into any virtual environment. Most users only need the one-line install below.

Quick Start¶

pip install pynasonde

Verify the install:

import pynasonde
print(pynasonde.__version__)

Upgrade

Already installed? Run pip install --upgrade pynasonde to get the latest release.

Recommended Workflows¶

conda (recommended)¶

conda create -n pynasonde python=3.11
conda activate pynasonde
pip install pynasonde

pip virtual environment¶

python3 -m venv pynasonde-env
source pynasonde-env/bin/activate   # Windows: pynasonde-env\Scripts\activate
pip install pynasonde

Developer Install¶

Clone the repository and install in editable mode so local source changes take effect immediately:

git clone https://github.com/shibaji7/pynasonde.git
cd pynasonde
pip install -e ".[dev]"

The [dev] extra pulls in pytest, pytest-cov, coverage, and the full scientific stack (numpy, pandas, matplotlib, scipy, …).

Cartopy (optional)

Coastline and geographic projection plots require cartopy >= 0.19. Install it separately following the Cartopy installation guide. On Ubuntu: sudo apt-get install python3-cartopy often works cleanly.

Core Dependencies¶

Pynasonde's setup.py installs these automatically:

Package	Version	Purpose
`numpy`	1.26.4	Array operations, bit-level unpacking
`pandas`	2.2.3	Tidy DataFrames for all parsed outputs
`matplotlib`	3.9.2	Publication-quality plotting
`scipy`	1.14.1	Signal processing utilities
`xarray`	2024.9.0	Gridded data structures
`loguru`	latest	Structured logging
`timezonefinder`	6.5.5	Station local-time lookup
`SciencePlots`	2.1.1	Clean scientific plot styles

System Requirements¶

OS	Required system package
Ubuntu / Debian	`libyaml-dev`
OpenSuse	`python3-PyYAML`
Fedora	`libyaml-devel`
macOS	Xcode Command Line Tools
Windows	pip (no extra system package)

Check your Python version:

python --version   # or python3 --version