CHAPTER 1 Introduction

• Overview
• Variables
• File I/O
• Domains and Axes
• Attributes
• Masked values
• File Variables
• Dataset Variables
• Grids and Regridding
• Time types
• Plotting data
• Databases

CHAPTER 2 CDMS Python Application Programming Interface

• Overview

Python types used in CDMS 22

• A first example
• cdms module

cdms module functions 25

Class Tags 31

• CdmsObj

Attributes common to all CDMS objects 32

Getting and setting attributes 32

• Axis

Axis Internal Attributes 33

• partition attribute

Axis Constructors 35

Axis Methods 36

• CdmsFile

Axis Slice Operators 42

CdmsFile Internal Attributes 43

CdmsFile Constructors 43

CdmsFile Methods 44

• Database

CDMS Datatypes 49

• Overview

Database Internal Attributes 51

Database Constructors 52

Database Methods 52

• Searching a database

SearchResult Methods 57

• Accessing data

ResultEntry Attributes 58

ResultEntry Methods 58

• Examples of database searches
• Dataset

Dataset Internal Attributes 60

Dataset Constructors 61

Open Modes 62

Template Specifiers 62

Dataset Methods 63

• MV module

Variable Constructors in module MV 67

MV functions 68

• RectGrid

RectGrid Internal Attributes 72

RectGrid Constructors 72

RectGrid Methods 73

• Variable
• cu interface support

Variable Internal Attributes 80

Variable Constructors 81

Variable Methods 84

Variable Slice Operators 93

• Selectors

Index and Coordinate Intervals 94

Selector keywords 96

• Selector examples
• Examples

CHAPTER 3 cdtime Module

• Time types
• Calendars
• Time Constructors

Time Constructors 107

• Relative Time

Relative Time Members 108

• Component Time
• Time Methods

Component Time Members 109

Time Methods 110

CHAPTER 4 Regridding Data

• Overview
• Horizontal regridder
• Pressure-level regridder
• Cross-section regridder
• regrid module

Regridder Constructor 116

• regridder functions

Regridder function 118

• Examples

CHAPTER 5 Plotting CDMS data in Python

• Overview
• Examples
• Example: plotting a horizontal grid
• Example: using plot keywords.
• Example: plotting a time-latitude slice
• Example: plotting subsetted data
• plot method

plot keywords 129

CHAPTER 6 Climate Data Markup Language (CDML)

• Introduction
• Elements

CDML Tags 134

• Special Characters

Special Character Encodings 135

• Identifiers
• CF Metadata Standard
• CDML Syntax
• Dataset Element

Dataset Attributes 137

• Axis Element

Axis Attributes 139

• Grid Element
• Variable Element

RectGrid Attributes 142

Variable Attributes 143

• Attribute Element
• A Sample CDML Document

CHAPTER 7 CDMS Utilities

• cdscan: Importing datasets into CDMS
• Overview
• cdscan Syntax

cdscan command options 149

• Examples
• File Formats
• Name Aliasing
• Generating Metadata for a File

APPENDIX A CDMS Classes

APPENDIX B Version Notes

• Version 3.0 Overview
• V3.0 Details
• AbstractVariable
• AbstractAxis
• AbstractDatabase
• Dataset
• cdms module
• CdmsFile
• CDMSError
• AbstractRectGrid
• InternalAttributes
• TransientVariable
• MV

APPENDIX C cu Module

• Slab

Slab Methods 160

• cuDataset

cuDataset Methods 161

A

• arange 67
• argsort 68
• arrayrange 67
• asarray 68
• asComponentTime 36
• asRelativeTime 36
• assignValue
• axis 36
• variable 84
• astype 84
• asVariable 25
• average 69

C

• CDML
• Climate Data Markup Language 133
• element 134
• identifier 136
• tags 134
• cdms module 25
• CdmsFile
• as a dictionary 44
• calling as a function 44
• cdscan 148
• choose 69
• clone 84
• close 44
• database 52
• dataset 64
• concatenate 69
• connect 52
• copyAxis 45
• copyGrid 45
• count 69
• createAxis
• cdmsFile 35, 45
• dataset 35
• transient 25, 35
• createDataset 43, 61
• createEqualAreaAxis 26, 35
• createGaussianAxis 26, 35
• createGaussianGrid 26, 72
• createGenericGrid 27, 72
• createGlobalMeanGrid 27, 73
• createRectGrid 73
• cdmsFile 46, 72
• dataset 64, 72
• transient 28, 72
• createUniformGrid 28, 73
• createUniformLatitudeAxis 29, 35
• createUniformLongitudeAxis 29, 35
• createVariable 29, 46, 81, 82, 83
• createVariableCopy 47
• createZonalGrid 29, 73
• crossSectionRegrid 85
• crossSectionRegridder 115

D

• database 49
• Dataset
• as a dictionary 64
• calling as a function 63
• designateCircular 37
• designateLatitude 37
• designateLevel 37
• designateLongitude 37
• designateTime 37
• DRS 152

G

• getAxis 64, 73, 85
• getAxisIds 85
• getAxisIndex 85
• getAxisList 86
• getAxisListIndex 86
• getBounds
• axis 38
• grid 74
• getCalendar 38
• getDomain 87
• getGrid 65, 87
• getLatitude
• grid 74
• variable 87
• getLevel 87
• getLongitude
• grid 74
• variable 87
• getMask 74
• getMissing 87
• getObject 58
• getOrder
• grid 74
• variable 88
• getPaths
• dataset 65
• variable 88
• getTemplate 89
• getTime 89
• getType 75
• getValue
• axis 38
• getVariable 65
• getWeights 75
• GRIB 152

H

• HDF 151

I

• id 49
• isCircular 38
• isLatitude 39
• isLevel 39
• isLinear 39
• isLongitude 39
• isMaskedVariable 69
• isTime 39
• isVariable 29

L

• len 39, 57, 89
• listDatasets 52

M

• mapInterval 39
• mapIntervalExt 40
• masked_array 67
• masked_equal 69
• masked_greater 69
• masked_greater_equal 69
• masked_less 70
• masked_less_equal 70
• masked_not_equal 70
• masked_object 67
• masked_outside 70
• masked_values 67
• masked_where 70
• maximum 70
• minimum 70

N

• name alias 152
• netCDF 151

O

• ones 67
• open 53, 61
• openDataset 30, 43, 53, 61
• order string 88
• order2index 30
• orderparse 30
• outerproduct 70

P

• plot method 128
• power 70
• pressureRegrid 89, 115
• product 70

R

• rank 89
• regrid 90
• regrid function 118
• Regridder 116
• relative name 49
• repeat 71
• reshape 68
• resize 68

S

• search result 57
• search result entry 58
• searchFilter 54
• searchPredicate 57
• set_default_fill_value 71
• setAutoBounds 31
• setAxis 90
• setAxisList 90
• setBounds
• grid 76
• setCalendar 41
• setClassifyGrids 31
• setMask 76
• setMissing 90
• setType 76
• size 91
• subaxis 41
• subGrid 77
• subGridRegion 78
• subRegion 91
• subSlice 92
• sum 71
• sync
• cdmsFile 47
• dataset 65

T

• tag 49
• take 71
• template Specifiers 62
• transpose 71, 79
• typecode
• axis 41
• variable 92

W

• where 71
• write 48

X

• XML 133

Z

• zeros 68