Skip to content

huard/ocgis

 
 

Repository files navigation

Build Status

For documentation please visit: https://ocgis.readthedocs.io/en/latest/

For additional project information please visit: http://www.earthsystemcog.org/projects/openclimategis/

Overview

OpenClimateGIS (OCGIS) is a Python package designed for geospatial manipulation, subsetting, computation, and translation of spatiotemporal datasets stored in local NetCDF files or files served through THREDDS data servers. OpenClimateGIS has a straightforward, request-based API that is simple to use yet complex enough to perform a variety of computational tasks. The software is built entirely from open source packages.

OpenClimateGIS supports many NetCDF metadata conventions (ESRI Shapefiles / File Geodatabases and CSV formats are also supported):

  • Climate & Forecast (CF) Grid
  • Unstructured Grid (UGRID)
  • SCRIP
  • ESMF Unstructured

GIS Capabilities

  • Subsetting (intersects and intersection) of climate datasets by bounding box, Shapely geometries, or shapefiles (city centroid, river reach, a single county or watershed, state boundaries).
  • Time and level range subsetting. Also allows for arbitrary label-based slicing.
  • Single or multi-dataset requests (concatenation).
  • Area-weighted aggregation (spatial averaging) to selection geometries.
  • Handles CF-based coordinate systems with full support for coordinate transformations (including the rotated pole coordinate system)
  • Geometry wrapping and unwrapping to maintain logically consistent longitudinal domains.
  • Polygon, line, and point geometric abstractions.

Data Conversion

  • Access to local NetCDF data or data hosted remotely on a THREDDS (OPeNDAP protocol) data server. Only the piece of data selected by an area-of-interest is transferred from the remote server.
  • Stream climate data to multiple formats.
  • Extensible converter framework to add custom formats.
  • Automatic generation of request metadata.
  • Push data to a familiar format to perform analysis or keep the data as NumPy arrays, perform analysis, and dump to a supported format.

Computation

  • Extensible computational framework for arbitrary inclusion of NumPy-based calculations.
  • Apply computations to entire data arrays or temporal groups.
  • Computed data may be streamed to any supported formats.

About

OpenClimateGIS is a set of geoprocessing and calculation tools for CF-compliant climate datasets.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 99.1%
  • Other 0.9%