Field.cell_area(radius='earth', insert=False, force=False)[source]

Return a field containing horizontal cell areas.

New in version 1.0.

See also

bin, collapse, radius, weights

radius: optional

Specify the radius used for calculating the areas of cells defined in spherical polar coordinates. The radius is that which would be returned by this call of the field construct’s radius method: f.radius(radius). See the cf.Field.radius for details.

By default radius is 'earth' which means that if and only if the radius can not found from the datums of any coordinate reference constucts, then the default radius taken as 6371229 metres.

insert: bool, optional

If True then calculated cell areas are also inserted in place as an “area” cell measure construct, unless there is already an existing area cell measure construct for the horizontal axes.

force: bool, optional

If True the always calculate the cell areas. By default, if there is already an “area” cell measure construct for the horizontal axes then it will be used provide the area values.


A field construct containing the horizontal cell areas.


>>> a = f.cell_area()
>>> a = f.cell_area(force=True)
>>> a = f.cell_area(radius=cf.Data(3389.5, 'km'))
>>> a = f.cell_area(insert=True)