Skip to main content

ncplot - Easy interactive viewing of NetCDF files in Python

pypi Documentation Status

An easy to use Python (3.6 and above) package for quickly plotting the contents of NetCDF files or xarray datasets in Python or on the command line.

This package is designed to work with CF compliant NetCDF data.

Installation

To install from conda:

conda install -c conda-forge ncplot

To install from pypi:

pip install ncplot 

Install the development version using using pip:

pip install git+https://github.com/pmlmodelling/ncplot.git

How to use in Python

The package is made up of a simple and easy to use function: view. To visualize everything in a file:

from ncplot import view

view("example.nc")

or to visualize a specific variable or list of variables:

from ncplot import view

view("example.nc", vars)

where vars is either a string representing a variable or a list of variables.

If you want to plot xarray datasets dataarrays, first import the xarray accessor, then plot in a similar way to xarray's built in plotting method:

import ncplot.xarray
import xarray as xr

ds = xr.open_dataset("example.nc") 
ds.ncplot.view()

How to use on the command line

Command line usage is as simple as:

ncplot example.nc

Reference and tutorials

A full API reference, and a how-to guide are available at readthedocs.

Metadata

Release files for ncplot 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ncplot 0.4.0
File Size Uploaded
ncplot-0.4.0.tar.gz 24.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ncplot 0.4.0
File Interpreter ABI Platform
ncplot-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 48.9 kB

Release files / ncplot-0.4.0.tar.gz

Download URL ncplot-0.4.0.tar.gz
Size 24.2 kB
Tags Source
SHA-256 checksum
How to use checksums
e68fb217e1fc7de503472b8bbda98f5acf6d4f000c4c864730f4f6a89fa229ba
BLAKE2b-256 checksum
How to use checksums
f9dc4a685715f97e5f8c3174a0e62839e624566ed7ecbda6d5de1f8612c65821
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.5

Release files / ncplot-0.4.0-py3-none-any.whl

Download URL ncplot-0.4.0-py3-none-any.whl
Size 24.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a17c56f9cad6f95925f75a8512d392a1a7d6a980dd4a70ea061786215b1e6671
BLAKE2b-256 checksum
How to use checksums
53d4e9c48e4cfa1a865d343cdf300c9e5341c80e5f3d0285a843fa0923dcb196
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.5

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 release files

0.3.13

2 release files

0.3.12

2 release files

0.3.9

2 release files

0.3.8

2 release files

0.3.6

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.0

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.9

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page