Metadata-Version: 2.1
Name: ncplot
Version: 0.1.1
Summary: Interactive viewing of NetCDF data
Home-page: https://github.com/pmlmodelling/ncplot
Author: Robert Wilson
Author-email: rwi@pml.ac.uk
Maintainer: Robert Wilson
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/pmlmodelling/ncplot/issues
Project-URL: Documentation, https://ncplot.readthedocs.io/en/stable
Project-URL: Source Code, https://github.com/pmlmodelling/ncplot
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6.1
Description-Content-Type: text/markdown
License-File: LICENSE



# ncplot - Easy interactive viewing of NetCDF files in Python 



[![pypi](https://img.shields.io/pypi/v/ncplot.svg)](https://pypi.python.org/pypi/ncplot/)
[![Documentation Status](https://readthedocs.org/projects/ncplot/badge/?version=latest)](https://ncplot.readthedocs.io/en/latest/?badge=latest)


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](https://cfconventions.org/) compliant NetCDF data.

## Installation

To install from conda:
```sh
conda install -c conda-forge ncplot

```

To install from pypi:
```sh
pip install ncplot 
```

Install the development version using using pip:
```sh
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:

```sh
from ncplot import view

view("example.nc")

```

or to visualize a specific variable or list of variables:

```sh
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:


```sh
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:


```sh


ncplot example.nc

```












# Reference and tutorials

A full API reference, and a how-to guide are available at [readthedocs](https://ncplot.readthedocs.io/en/latest/).










