Skip to main content

A python module for obtaining reduced(min,max,avg) value from netCDF file under a polygon region

Project description


Supported Version Action: Build publish License: MIT
A Python3 module for extracting data from netcdf file under a shapefile region.


pyscissor can be installed using the following commands

$ git clone
$ cd pyscissor
$ python3 install

or using pip

$ pip install pyscissor

Using pyscissor

import fiona
import numpy as np
from netCDF4 import Dataset
from shapely.geometry import shape
from pyscissor import scissor 

# read shapefile
sf ='data/shape.geojson')
shapely_shp =shape(sf.get(0)['geometry'])

# read netcdf
nf = Dataset('data/','r')
lats = nf.variables['lat'][:]
lons = nf.variables['lon'][:]

# create scissor object 
pys = scissor(shapely_shp,lats,lons)

weight_grid = pys.get_masked_weight() #=> returns a masked array containing weights

# get weighted average
avg = np.average(var,weights=weight_grid)

# if only intersection mask with shape is needed use `weight_grid.mask`

A detailed use case can be found in the following jupyter notebooks


this package contains a script. A command line tool that can be used to quickly extract reduced(min/max/average/weighted average) time-series form netcdf file with shapefile

# with 3d array [data/] generel case
$ -nci='Y=lat;X=lon;T=time;V=tmin;' \
		-sp='ADM2_EN;ADM3_EN' -r=avg -o=test2.csv

# with 4d array [data/]
$ -nci='Y=lat;X=lon;T=time;V=temperature;slicer=[:,0,:,:]' \
		-sfp='ADM2_EN;ADM3_EN' -r=wavg -o=test1.csv


-nc  = netcdf file

-nci = netcdf variable and dimension information
		available options:
		X = x dimension variable name,
		Y = y dimension variable name,
		T = time dimension variable name,
		V = variable name,
		slicer = slicing index for obtaining 3d array [optional]
		note: `slicer` is required if variable has more than three dimension

-sf  = shape file ( can be zipped shapefile, shapefile or geojson )

-sfp = shapefile properties
		only required when shapefile contains multiple records

-r   = reducer, default is average
		Available options: min,max,avg,wavg

-o   = output file name

Causes of Erroneous output

- when shapefile and netcdf file have different projection
- shapefile dosen't fully reside within netcdf bounds 

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyscissor, version 1.1.4
Filename, size File type Python version Upload date Hashes
Filename, size pyscissor-1.1.4.tar.gz (9.9 kB) File type Source Python version None Upload date Hashes View
Filename, size pyscissor-1.1.4-py3-none-any.whl (12.4 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page