2023-12-06
+Python 3.7 support removed +(https://github.com/NCAS-CMS/cfdm/issues/274)
Implemented the reading and manipulation of UGRID mesh topologies +for CF-1.11 (https://github.com/NCAS-CMS/cfdm/issues/TODOUGRID)
New methods: cfdm.Field.cell_connectivity,
+cfdm.Field.cell_connectivities
New methods: cfdm.Field.domain_topology,
+cfdm.Field.domain_topologies
New methods: cfdm.Field.del_mesh_id, cfdm.Field.get_mesh_id,
+cfdm.Field.has_mesh_id, cfdm.Field.set_mesh_id,
New attribute: cfdm.Data.sparse_array
New dependency: scipy>=1.10.0
2023-08-31
Fix bug that prevented “https://” netCDF files from being read (https://github.com/NCAS-CMS/cfdm/issues/268)
2023-07-21
-2023-04-26
-2023-03-10
-2023-01-26
-2022-10-31
New method: cfdm.Data.get_tie_point_indices
2022-08-17
-2022-07-18
Upgrade to allow cfdm to work with Python 3.10 @@ -275,9 +296,9 @@
2022-03-10
Fixed bug that caused a failure from cfdm.write when writing
@@ -289,23 +310,23 @@
New dependency: packaging>=20.0
Changed dependency: cftime>=1.6.0
2022-01-31
Fixed bug that caused a cfdm.write failure when a vertical
coordinate reference construct has no coordinates
(https://github.com/NCAS-CMS/cfdm/issues/164)
Fixed bug that caused a failure when downstream identities methods
-return an itertools.chain object
+return an itertools.chain object
(https://github.com/NCAS-CMS/cfdm/issues/170)
2021-10-12
Fixed bug that prevented some geometry coordinates being written to @@ -316,10 +337,10 @@
Fixed bug in cf.Field.get_domain when there are climatological
time axes (https://github.com/NCAS-CMS/cfdm/issues/159)
2021-09-21
-2021-05-25
Construct access API changes @@ -374,10 +395,10 @@
Changed dependency: cftime>=1.5.0
Changed dependency: netCDF4>=1.5.4
2020-12-18
The setting of global constants can now be controlled by a context @@ -387,10 +408,10 @@
Changed dependency: cftime>=1.3.0
2020-10-09
Python 3.5 support deprecated (3.5 was retired on 2020-09-13)
Fixed bug that prevented the writing of multiple fields to netCDF when at least one dimension was shared between some of the fields.
2020-07-24
Removed Python 2.7 support @@ -458,19 +479,19 @@
Changed dependency: cftime>=1.2.1
Removed dependency: future
2020-06-10
Fixed bug that prevented the reading of certain netCDF files, such as those with at least one external variable.
2020-06-08
Added new example field 7 to cfdm.example_field.
2020-04-30
-2020-04-24
Added time coordinate bounds to the polygon geometry example field @@ -520,10 +541,10 @@
2020-04-16
Improved source code highlighting in links from the documentation @@ -531,10 +552,10 @@
Fixed bug that erroneously required netCDF geometry container
variables to have a geometry_dimension netCDF attribute.
2020-03-23
First release for CF-1.8 (does not include netCDF hierarchical @@ -561,22 +582,22 @@
Fixed bug whereby cfdm.Field.has_construct would try to delete the
construct rather than check whether it existed.
2019-11-27
New methods: cfdm.Field.compress, cfdm.Field.uncompress
New methods: cfdm.Data.flatten, cfdm.Data.uncompress
New dtype and mask keyword parameters to cfdm.Data
Changed the default value of the ignore_compression parameter to
-True.
True.
2019-11-14
-2019-11-07
Fixed bug relating to setting of parameters on datum and coordinate conversion objects of coordinate conversion constructs (https://github.com/NCAS-CMS/cfdm/issues/6).
2019-10-04
During writing to netCDF files, ensured that _FillValue and @@ -610,10 +631,10 @@
Now reads CDL files (https://github.com/NCAS-CMS/cfdm/issues/5)
2019-06-13
Don’t set the fill mode for a netCDF4.Dataset open for writing to
@@ -621,30 +642,30 @@
Updated documentation
2019-06-05
Added attributes _ATOL and _RTOL to facilitate subclassing.
Fixed bug in cfdm.Field.convert.
Fixed bug in cfdm.core.constructs.new_identifier.
2019-05-15
-2019-05-14
Changed behaviour of cfdm.Constructs.filter_by_axis.
2019-04-24
-2019-04-05
-2019-04-02
New methods cfdm.Constructs.clear_filters_applied,
@@ -733,17 +754,17 @@
2019-04-02
First release for CF-1.7
Version 1.10.1.2 for version 1.10 of the CF conventions.
+Version 1.11.0.0 for version 1.11 of the CF conventions.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
AuxiliaryCoordinate.ndim¶The number of dimensions in the data array.
+The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
AuxiliaryCoordinate.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
Bounds.ndim¶The number of dimensions in the data array.
+The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
Bounds.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
CellMeasure.ndim¶The number of dimensions in the data array.
+The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+CellMeasure.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
Count.ndim¶The number of dimensions in the data array.
+The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
Count.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
Data.array¶Return an independent numpy array containing the data.
-If a fill value has been set (see set_fill_value) then it will
-be used, otherwise the default numpy fill value appropriate to the
-data type will be used.
Return an independent numpy array containing the data.
If a fill value has been set (see set_fill_value) then it
+will be used, otherwise the default numpy fill value
+appropriate to the data type will be used.
numpy.ndarrayAn independent numpy array of the data.
+numpy.ndarrayAn independent numpy array of the data.
See also
+ +A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ Data.sparse_array¶Return an independent scipy sparse array of the data.
An AttributeError is raised if a sparse array representation
+is not available.
New in version (cfdm): 1.11.0.0
+See also
+ +An independent scipy sparse array of the data.
Examples
+>>> from scipy.sparse import issparse
+>>> issparse(d.sparse_array)
+True
+New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
DimensionCoordinate.ndim¶The number of dimensions in the data array.
+The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
DimensionCoordinate.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
DomainAncillary.ndim¶The number of dimensions in the data array.
+The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
DomainAncillary.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
Field.ndim¶The number of dimensions in the data array.
+The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
Field.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
FieldAncillary.ndim¶The number of dimensions in the data array.
+The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
FieldAncillary.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
Index.ndim¶The number of dimensions in the data array.
+The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
Index.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
InteriorRing.ndim¶The number of dimensions in the data array.
+The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+InteriorRing.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
New in version 1.10.0.0.
+New in version (cfdm): 1.10.0.0
List.ndim¶The number of dimensions in the data array.
+The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
List.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
Data-type of the array.
Shape of the array.
numpy.ndarrayThe compressed array.
+numpy.ndarrayThe compressed array.
AuxiliaryCoordinate.data¶Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
Note that a Data instance is returned. Use its array
+attribute to return the data as a numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ AuxiliaryCoordinate.ndim¶The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ AuxiliaryCoordinate.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ AuxiliaryCoordinate.size¶The number of elements in the data.
+size is equal to the product of shape, that only includes
+the sizes of dimensions that correspond to domain axis
+constructs.
Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+Bounds.data¶Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
Note that a Data instance is returned. Use its array
+attribute to return the data as a numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ Bounds.ndim¶The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ Bounds.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ Bounds.size¶The number elements in the data.
+size is equal to the product of shape, that only includes
+the sizes of dimensions that correspond to domain axis
+constructs.
Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+CellMeasure.data¶Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
Note that a Data instance is returned. Use its array
+attribute to return the data as a numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ CellMeasure.ndim¶The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ CellMeasure.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ CellMeasure.size¶The number elements in the data.
+size is equal to the product of shape, that only includes
+the sizes of dimensions that correspond to domain axis
+constructs.
Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+Coordinate.data¶Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
Note that a Data instance is returned. Use its array
+attribute to return the data as a numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ Coordinate.ndim¶The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ Coordinate.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ Coordinate.size¶The number of elements in the data.
+size is equal to the product of shape, that only includes
+the sizes of dimensions that correspond to domain axis
+constructs.
Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+Data.array¶Return an independent numpy array containing the data.
-If a fill value has been set (see set_fill_value) then it will
-be used, otherwise the default numpy fill value appropriate to the
-data type will be used.
Return an independent numpy array containing the data.
If a fill value has been set (see set_fill_value) then it
+will be used, otherwise the default numpy fill value
+appropriate to the data type will be used.
numpy.ndarrayAn independent numpy array of the data.
+numpy.ndarrayAn independent numpy array of the data.
DimensionCoordinate.data¶Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
Note that a Data instance is returned. Use its array
+attribute to return the data as a numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ DimensionCoordinate.ndim¶The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ DimensionCoordinate.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ DimensionCoordinate.size¶The number of elements in the data.
+size is equal to the product of shape, that only includes
+the sizes of dimensions that correspond to domain axis
+constructs.
Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+DomainAncillary.data¶Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
Note that a Data instance is returned. Use its array
+attribute to return the data as a numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ DomainAncillary.ndim¶The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ DomainAncillary.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ DomainAncillary.size¶The number of elements in the data.
+size is equal to the product of shape, that only includes
+the sizes of dimensions that correspond to domain axis
+constructs.
Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+Field.data¶Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
Note that a Data instance is returned. Use its array
+attribute to return the data as a numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ Field.ndim¶The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ Field.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ Field.size¶The number elements in the data.
+size is equal to the product of shape, that only includes
+the sizes of dimensions that correspond to domain axis
+constructs.
Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+FieldAncillary.data¶Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
Note that a Data instance is returned. Use its array
+attribute to return the data as a numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ FieldAncillary.ndim¶The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ FieldAncillary.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ FieldAncillary.size¶The number elements in the data.
+size is equal to the product of shape, that only includes
+the sizes of dimensions that correspond to domain axis
+constructs.
Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+InteriorRing.data¶Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
Note that a Data instance is returned. Use its array
+attribute to return the data as a numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ InteriorRing.ndim¶The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ InteriorRing.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ InteriorRing.size¶The number elements in the data.
+size is equal to the product of shape, that only includes
+the sizes of dimensions that correspond to domain axis
+constructs.
Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+PropertiesData.data¶Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
Note that a Data instance is returned. Use its array
+attribute to return the data as a numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ PropertiesData.ndim¶The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ PropertiesData.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ PropertiesData.size¶The number elements in the data.
+size is equal to the product of shape, that only includes
+the sizes of dimensions that correspond to domain axis
+constructs.
Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+PropertiesDataBounds.data¶Return the data.
f.data is equivalent to f.get_data()
Note that a Data instance is returned. Use its array
-attribute to return the data as a numpy array.
Note that a Data instance is returned. Use its array
+attribute to return the data as a numpy array.
The units, calendar and fill value properties are, if set, inserted into the data.
A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ PropertiesDataBounds.ndim¶The number of data dimensions.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ PropertiesDataBounds.shape¶A tuple of the data array’s dimension sizes.
+Only dimensions that correspond to domain axis constructs are +included.
+ +Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+A Python reference implementation of the CF data model
+ + + + ++ +
+ + + + + + + + +
+
+
+
+ PropertiesDataBounds.size¶The number of elements in the data.
+size is equal to the product of shape, that only includes
+the sizes of dimensions that correspond to domain axis
+constructs.
Examples
+>>> f.shape
+(73, 96)
+>>> f.ndim
+2
+>>> f.size
+7008
+>>> f.shape
+(73, 1, 96)
+>>> f.ndim
+3
+>>> f.size
+7008
+>>> f.shape
+(73,)
+>>> f.ndim
+1
+>>> f.size
+73
+>>> f.shape
+()
+>>> f.ndim
+0
+>>> f.size
+1
+Version 1.11.0.0 for version 1.11 of the CF conventions.
The CF (Climate and Forecast) metadata conventions (http://cfconventions.org) provide a description of the physical meaning of data and of their spatial and temporal properties and are @@ -177,6 +179,10 @@
corresponding to CF-netCDF cell measure variables
corresponding to CF-netCDF UGRID mesh topology variables
+corresponding to CF-netCDF UGRID connectivity variables
+
-The constructs of the CF data model described using UML. The field construct corresponds to a CF-netCDF data variable. The domain construct provides the linkage between the field construct and the constructs which describe measurement locations and cell properties. It is useful to define an abstract generic coordinate construct that can be used to refer to coordinates when the their type (dimension or auxiliary coordinate construct) is not an issue.¶
-The constructs of the CF data model described using UML. The field construct corresponds to a CF-netCDF data variable. The domain construct provides the linkage between the field construct and the constructs which describe measurement locations and cell properties. It is useful to define an abstract generic coordinate construct that can be used to refer to coordinates when the their type (dimension or auxiliary coordinate construct) is not an issue.¶
+Version 1.10.1.2 for version 1.10 of the CF conventions.
-Version 1.11.0.0 for version 1.11 of the CF conventions.
+