cf.Coordinate

class cf.Coordinate(public_attributes={}, private_attributes={})

Bases: cf.field.Variable

A CF coordinate object.

Refer to the Variable and Field classes and the cf package for details.

Reserved public attributes:

In addition to the reserved public attributes inherited from the Variable class, the following are also reserved public attributes:

Attribute	Description
axis	As in the CF convention.
positive	As in the CF convention.

Reserved attributes:

In addition to the reserved attributes inherited from the Variable class, the following attributes have special definitions and it is recommended to set them accordingly.

Attribute	Description
bounds	The coordinate’s CoordinateBounds object.
climatology	An indicator to specify if the coordinate’s bounds are intervals of climatological time.
transform	A pointer to the coordinate’s Transform object.

Units

The coordinate’s Units object.

array

Create a numpy array deep copy of the data.

If the data was stored as a file pointer then it will be changed in-place to be stored as a numpy array.

Returns:A numpy array.

Examples:

>>> a = x.array
>>> type(a)
<type 'numpy.ndarray'>
>>> a = x.array[[0,1]]
>>> type(a)
<type 'numpy.ndarray'>
>>> a.shape
(2,)

axis

The coordinate’s CF axis public attribute.

bounds

The coordinate’s bounds object.

calendar

The variable’s CF calendar public attribute.

x.calendar=value <==> x.setpub(‘calendar’, value) x.calendar <==> x.getpub(‘calendar’) del x.calendar <==> x.delpub(‘calendar’) x.calendar=value <==> x.Units.calendar=value x.calendar <==> x.Units.calendar del x.calendar <==> del x.Units.calendar

climatology

Indicator of whether the coordinate’s bounds represent climatologocal time intervals.

copy(data=True)

Return a deep copy.

Parameters:data (bool) – Optional. If False then assign the output variable’s data elements to None, with the expectation that they will be replaced subsequently. The data object’s metadata are deep copied in any case. Returns:A deep copy.

delpriv(attr)

Delete a private attribute.

Parameters:attr (str) – The name of the private attribute to be deleted. Returns:None

delpub(attr)

Delete a public attribute.

Parameters:attr (str) – The name of the public attribute to be deleted. Returns:None

dtype

Data-type of the data’s elements.

Returns:A numpy dtype object.

dump(id=None, omit=())

Return a string containing a full description of the coordinate.

Parameters:

• id (str) – Optional. Set the common prefix of component names. If None then defaults to the class name.
• omit (sequence) – Optional. Omit the given attributes from the description.

Returns:

A string containing the description of the coordinate.

See also

cf.dump

eextract(**kwargs)

Return the variable if and only if it matches conditions on its phenomena, i.e. its public attributes and, if it has any, its scalar or 1-d, size 1 coordinates. As extract, but with the restriction that only exact public attribute or coordinate names are allowed.

keyword **kwargs: The keyword arguments identify exact phenomenon

names, either a public attribute names or 1-d, size 1 coorinate standard names.

The keyword values are as for match.

Returns:The variable if the it matches the criteria, otherwise a ValueError is raised.

ematch(**kwargs)

Determine whether or not a variable matches conditions on its phenomena, i.e. its public attributes and, if it has any, its scalar or 1-d, size 1 coordinates. As match, but with the restriction that only exact public attribute or coordinate names are allowed.

Parameters:**kwargs –

The keyword arguments identify exact phenomenon names, either a public attribute names or 1-d, size 1 coorinate standard names.

The keyword values are as for match.

Returns:True if the variable matches the criteria, False otherwise.

Examples:

>>> s
<CF Field: air_temperature(19, 30, 24)>
>>> s.standard_name
'air_temperature'
>>> s.extract(standard_name = 'air_temperature')
True
>>> s.extract(standard_n = '^air.*')
False

equals(other, rtol=None, atol=None)

Return True if the variable is congruent to another variable in that

1. They have identical data. Pointers to data on disk may be converted to numpy arrays in memory if required.
2. They have identical reserved public attributes.
3. They have identical public attributes.

Equality of numbers is to within a tolerance. Refer to cf for details.

Parameters:

• other (object) – The variable to compare against for equality.
• atol (None or float) – Optional. If None then use the default method for setting the absolute tolerance for numerical equality (refer to cf for details). If a number then set the absolute tolerance to this value for all such comparisons.
• rtol (None or float) – Optional. If None then use the default method for setting the relative tolerance for numerical equality (refer to cf for details). If a number then set the relative tolerance to this value for all such comparisons.

Returns:

True if the two objects are congruent, False otherwise.

Examples:

>>> y = x
>>> x.equals(y)
True
>>> y = x + 1
>>> x.equals(y)
False
>>> y -= 1
>>> x.equals(y)
True
>>> x.setpub('name', 'name0')
>>> y.setpub('name', 'name1')
>>> x.equals(y)
False

extract(**kwargs)

Return the variable if and only if it matches conditions on its phenomena, i.e. its public attributes and, if it has any, its scalar or 1-d, size 1 coordinates. Unambiguous abbreviations of public attribute or coordinate names are allowed.

Refer to match for further details.

keyword **kwargs: The keyword arguments identify a public attribute’s

name or a coordinate’s standard name. Any unambiguous abbreviation of the phenomenon’s name is acceptable.

The keyword values are as for match.

Returns:The variable if the it matches the criteria, otherwise a ValueError is raised.

first_datum

Return the first element of the data without replacing a file pointer with a numpy array.

Returns:The scalar value of the first element of the data.

getpriv(attr, *default)

Return a private attribute.

Parameters:

• attr (str) – The name of the private attribute to be returned.
• default (object) – Optional. Return default if the requested private attribute has not been set

Returns:

The value of a private attribute.

getpub(attr, *default)

Return a public attribute.

Parameters:

• attr (str) – The name of the public attribute to be returned.
• default (object) – Optional. Return default if the requested public attribute has not been set

Returns:

The value of a public attribute.

istime()

last_datum

Return the last element of the data without replacing a file pointer with a numpy array.

Returns:The scalar value of the last element of the data.

lon_name

The variable’s CF long_name public attribute.

long_name

The variable’s CF long_name public attribute.

mask(m)

mask coordinate data

match(**kwargs)

Determine whether or not a variable matches conditions on its phenomena, i.e. its public attributes and, if it has any, its scalar or 1-d, size 1 coordinates. Unambiguous abbreviations of public attribute or coordinate names are allowed.

The phenomena and their conditions are specified with **kwargs parameters.

The variable matches the conditions if and only if it contains all of the specified phenomena and they satisfy all of their given criteria. A variable always matches no criteria.

Parameters:**kwargs –

The keyword arguments identify a public attribute’s name or a coordinate’s standard name. Any unambiguous abbreviation of the phenomenon’s name is acceptable.

A keyword’s value may be one of the following:

1. A number. A match requires that a numeric valued phenomenon equals the number using the numerically tolerant equality.
2. A string. A match requires that a string-valued phenomenon passes a regular expression match on the string. The string may contain regular expression special characters. To avoid ambiguities, it is assumed that the regular expression string matches the whole of the phenomenon string, i.e. the regular expression special characters ^ and $ are assumed if not given.
3. A sequence of numbers or strings. A match requires that a numeric phenomenon equals, within numerical tolerance, at least one of the sequence’s elements or a string-valued phenomenon passes a regular expression match for at least one string in the sequence (see 2.).
4. A Comparison object. A match requires that the comparison for the phenomenon evaluates to True.

Returns:True if the variable matches the criteria, False otherwise.

Examples:

>>> s
<CF Field: air_temperature(19, 30, 24)>
>>> s.pub('standard_name'), s.pub('units')
('air_temperature', 'K')
>>> s.extract(standard_name = 'air_temperature')
True
>>> s.extract(standard = '^air.*')
True
>>> s.extract(standard_name = lt('b'))
True
>>> s.extract(standard_name = outside('b', 'p'))
True
>>> s.extract(standard = ['.*temp.*', 'pressure'])
True
>>> s.extract(height = 2.0, units = 'K')
True

missing_value

The variable’s CF missing_value public attribute.

Assigning a value to this attribute also assigns the same value to the _FillValue public attribute, if the latter has previously been defined.

name(long_name=False, ncvar=False, default=None)

Return the standard_name attribute of the variable.

If there is no standard_name attribute then return one of the long_name attribute, the ncvar attribute or the value of the default parameter, depending on the values of the parameters.

Parameters:

• long_name (bool) – Optional. If True, return the long_name if standard_name does not exist.
• ncvar (bool) – Optional If True, return ncvar if neither standard_name not long_name have already been returned.
• default (None or object) – Optional. Return default if standard_name, long_name nor ncvar have already been returned.

Returns:

The name of the variable.

ndim

Number of data dimensions.

Equivalent to the number of elements in shape tuple.

Returns:A non-negative integer

override_Units(units)

Change the variable’s units in place without changing the variable’s data.

Parameters:units (Units) – The new units as a Units object. Returns:None

Examples:

>>> v.Units
<CF Units: metre>
>>> v.varray
array([ 0.,  1.,  2.,  3.,  4.])

>>> v.override_Units(cf.Units('km'))
>>> v.Units
<CF Units: km>
>>> v.varray
array([ 0.,  1.,  2.,  3.,  4.])

positive

The coordinate’s CF positive public attribute.

priv(*args, **kwargs)

A method which may be used in place of getpriv or setpriv.

If called with positional parameters, then they are interpreted as for getpriv and a public attribute (or default) value is returned.

If called with a keyword parameter, then the keyword and its value act as the two positional parameters of setpriv and a public attribute is set.

privattrs

Return a dictionary of the instance’s private attributes.

pub(*args, **kwargs)

A method which may be used in place of getpub or setpub.

If called with positional parameters, then they are interpreted as for getpub and a public attribute (or default) value is returned.

If called with a keyword parameter, then the keyword and its value act as the two positional parameters of setpub and a public attribute is set.

Examples:

>>> v.pub(units='K')
>>> v.pub('units')
'K'
>>> v.pub('UNITS', 'default_value')
'default_value'

pubattrs

Return a dictionary of the instance’s public attributes.

setpriv(attr, value)

Set a private attribute.

Parameters:

• attr (str) – The name of the private attribute to be set.
• value (object) – Optional. The value for the private attribute.

Returns:

None

setpub(attr, value)

Set a public attribute.

Parameters:

• attr (str) – The name of the public attribute to be set.
• value (object) – Optional. The value for the public attribute.

Returns:

None

shape

Tuple of the data’s dimension sizes.

Returns:A tuple

size

Number of elements in the data.

Equivalent to the product of the data’s dimension sizes.

Returns:A non-negative integer

slice

Slice the coordinate’s data, returning a new coordinate. The coordinate’ bounds are also sliced.

Examples:

>>> c
<CF Coordinate: longitude(96)>
>>> c.bounds
<CF CoordinateBounds: longitude(96,2)>
>>> d=c.slice[1:]
>>> d
<CF Coordinate: longitude(95)>
>>> d.bounds
<CF CoordinateBounds: longitude(95,2)>

standard_name

The variable’s CF standard_name public attribute.

transform

Pointer to coordinate’s transfrom.

type()

The types of the data stored in the variable’s Data object.

Returns:A list of type objects for each of the data elements.

Examples:

>>> v.type()
[<type 'netCDF4.Variable'>]
>>> v.slice[...]
>>> v.type()
[<type 'numpy.ndarray'>]

units

The coordinate’s units public attribute.

x.units=value <==> x.setpub(‘units’, value) x.units <==> x.getpub(‘units’) del x.units <==> x.delpub(‘units’) x.units=value <==> x.Units.units=value x.units <==> x.Units.units del x.units <==> del x.Units.units

varray

Create a numpy view of the data.

If the data was stored as a file pointer then it will be changed in-place to be stored as a numpy array.

Note that making changes to elements of the returned view changes the underlying data. Refer to numpy.ndarray.view.

Returns:A numpy view.

Examples:

>>> a = x.varray
>>> print a
array([0, 1, 2, 3, 4])
>>> a[0] = 999
>>> print x.varray[0]
999
>>> a = 'a_different_object'
>>> print x.varray
array([999, 1, 2, 3, 4])