cf.FieldList

class cf.FieldList(sequence=())

Bases: cf.variable.VariableList

An ordered sequence of fields stored in a list-like object.

In some contexts, whether an object is a field or a field list is not known and does not matter. So to avoid ungainly type testing, some aspects of the FieldList interface are shared by a field and vice versa.

Any attribute or method belonging to a field may be used on a field list and will be applied independently to each element.

Just as it is straight forward to iterate over the fields in a field list, a field will behave like a single element field list in iterative and indexing contexts.

Initialization

Parameters :

sequence : iterable, optional

Define a new list with these elements.

coord(*args, **kwargs)

Apply the coord method to each element of the list.

Note that a coordinate list is returned (as opposed to a field list).

Parameters :

*args, **kwargs :

As for a field’s coord method.

Returns :

out : CoordinateList

copy()

Return a deep copy.

Equivalent to copy.deepcopy(x)

Returns :

out :

The deep copy.

Examples

>>> x.copy()

count(value) → integer -- return number of occurrences of value

Uses numerically tolerant equality.

delattr(attr)

Delete a public attribute from each element of the list of variables.

dump(*arg, **kwargs)

Return a string containing the full descriptions of each variable in the list.

See also

cf.dump

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

Return True if two lists are congruent in that

1. Each pair of their elements are equal.
2. Both instances have equal attributes.

Numerical equality 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.

extract(*args, **kwargs)

Return the elements which match the given conditions.

The match conditions are passed to each element’s match method in turn.

Parameters :

*args, **kwargs :

As for the variable’s match method.

Returns :

out :

A new list containing the matching elements.

Examples

>>> f
[<>
 <>]
>>> f.extract(attr={'standard_name': 'air_temperature'})
[<>]

getattr(*args)

Return a built-in list of the public attributes of each element of the list of variables.

hasattr(*args)

Return a built-in list of the public attributes of each element of the list of variables.

index(value[, start[, stop]]) → integer -- return first index of value

Uses numerically tolerant equality.

insert(index, object)

CFL.insert(index, object) – insert object before index

match(*args, **kwargs)

Return a list of booleans showing which elements match the given conditions.

The match conditions are passed to each element’s match method in turn.

Parameters :

*args, **kwargs :

As for the variable’s match method.

Returns :

out : list

A built-in list of booleans showing which elements match the conditions.

Examples

>>> f
[<>
 <>]
>>> f.match(attr={'standard_name': 'air_temperature'})
[True, False]

name(*arg, **kwargs)

Return a built-in list of the names of each element of the list of variables.

setattr(attr, value)

Set a public attribute from each element of the list of variables.

squeeze(*args, **kwargs)

Apply the squeeze method to each element of the list.

Parameters :

*args, **kwargs :

As for a field’s squeeze method.

Returns :

out : FieldList

unsqueeze(*args, **kwargs)

Apply the unsqueeze method to each element of the list.

Parameters :

*args, **kwargs :

As for a field’s unsqueeze method.

Returns :

out : FieldList

subset

Slice each field in the list, returning a new list of fields. Slicing by indices or by coordinate values are both allowed.

Examples

>>> sl
[<CF Variable: air_temperature(73, 96)>,
 <CF Variable: air_temperature(73, 96)>]
>>> sl.subset[0,0]
[<CF Variable: air_temperature(1,1)>,
 <CF Variable: air_temperature(1,1)>]
>>> sl.slice(longitude=0, latitude=0)
[<CF Variable: air_temperature(1,1)>,
 <CF Variable: air_temperature(1,1)>]