spacepy.pycdf.zAttrList

class spacepy.pycdf.zAttrList(zvar)[source]

Object representing all the zAttributes in a zVariable.

Normally accessed as an attribute of a Var in an open CDF:

>>> epoch_attribs = cdffile['Epoch'].attrs

Appears as a dictionary: keys are attribute names, values are the value of the zEntry associated with the appropriate zVariable. Each vAttribute in a CDF may only have a single entry associated with each variable. The entry may be a string, a single numerical value, or a series of numerical values. Entries with multiple values are returned as an entire list; direct access to the individual elements is not possible.

Example: finding the first dependency of (ISTP-compliant) variable Flux:

>>> print cdffile['Flux'].attrs['DEPEND_0']

zAttributes are shared among zVariables, one zEntry allowed per zVariable. (pyCDF hides this detail.) Deleting the last zEntry for a zAttribute will delete the underlying zAttribute.

zEntries are created and destroyed by the usual dict methods on the zAttrlist:

>>> epoch_attribs['new_entry'] = [1, 2, 4] #assign a list to new zEntry
>>> del epoch_attribs['new_entry'] #delete the zEntry

The type of the zEntry is guessed from data provided. The type is chosen to match the data; subject to that constraint, it will try to match (in order):

  1. existing zEntry corresponding to this zVar

  2. other zEntries in this zAttribute

  3. the type of this zVar

  4. data-matching constraints described in CDF.new()

See also

AttrList