skip to navigation
skip to content

spacegrids 1.0.8

numpy array with grids and associated operations

Package Documentation

Latest Version: 1.9


The Python 2.7 Spacegrids module, “Numpy on grids”, provides useful classes for analyzing spatial data defined on grids. It is designed to ensure consistency between data and grid information via interacting objects of fields, grids, coordinates and axes. It provides very simple expressions for complex operations, including volume and distance related concepts such as integration and differentiation.

Works with most models and datasets, including: UVic (all versions), CSIRO Mk3L, FAMOUS, CCM3.6 (Atmosphere), Levitus Data

On Ubuntu/ Debian, install dependencies via package manager if pip install fails:

apt-get install python-{tk,numpy,matplotlib,scipy}


The following import statement provides all functionality:

from spacegrids import sg

Once loaded, sg allows an overview of the available data via A project object is created via P = sg.project(D[‘some_project’]). This then allows fields to be loaded automatically for all experiment subdirectories. Data grids are constructed based on the Netcdf metadata.


Before using projects, Netcdf data must be organised in a projects directory tree. Create a directory named PROJECTS inside your home directory ($HOME) or on a storage disk (see below). This will contain all the data for all the projects. Then create a subdirectory for each of your projects. Inside each project, create a small text file named projname containing only a name, say “glacial”, to identify your project. In this case, type: echo glacial > projname within the project dir. This will allow the sg Python code to regard all subdirectories inside the project directory as experiment directories and will be searched for netcdf files when a sg project object P is created (see below) on the Python command line or inside a script. If a netcdf file is found in any of these (experiment) subdirectories, an exper (experiment) object of the same name as the directory is created and added to the dictionary of experiments belonging to the project object P.

The following python modules are required:

numpy matplotlib (requires python-tk) scipy

It is possible to use Scientific.IO (for Netcdf) instead of scipy for Netcdf IO by setting a flag.

File Type Py Version Uploaded on Size
spacegrids-1.0.8-py2.7.egg (md5) Python Egg 2.7 2014-04-18 85KB
spacegrids-1.0.8.tar.gz (md5) Source 2014-04-18 40KB