cf.example_fields

cf.example_fields(*n, _func=<function example_field>)[source]

Return example field constructs.

New in version (cfdm): 1.8.9.0

See also

cf.example_field, cf.example_domain

Parameters
n: zero or more int, optional

Select the example field constructs to return, any combination of:

n

Field construct description

0

Cell method and dimension coordinate metadata constructs.

1

Cell method, dimension coordinate, auxiliary coordinate, cell measure, coordinate reference, domain ancillary and field ancillary metadata constructs.

2

A monthly time series at each latitude-longitude location.

3

Discrete sampling geometry (DSG) “timeSeries” features.

4

Discrete sampling geometry (DSG) “timeSeriesProfile” features.

5

A 12 hourly time series at each latitude-longitude location.

6

Polygon geometry coordinate cells with interior ring variables.

7

Rotated pole dimension coordinate constructs and 2-d latitude and longitude auxiliary coordinate constructs.

8

A UGRID mesh topology of face cells.

9

A UGRID mesh topology of edge cells.

10

A UGRID mesh topology of point cells.

If no individual field constructs are selected then all available field constructs will be returned.

Field constructs may be selected multiple time, and will be output in the order that they are given.

See the cf.example_field for details.

_func: function

The function that returns each individual field construct.

Returns
FieldList

The example field constructs.

Examples

>>> cf.example_fields()
[<CF Field: specific_humidity(latitude(5), longitude(8)) 1>,
 <CF Field: air_temperature(atmosphere_hybrid_height_coordinate(1), grid_latitude(10), grid_longitude(9)) K>,
 <CF Field: air_potential_temperature(time(36), latitude(5), longitude(8)) K>,
 <CF Field: precipitation_flux(cf_role=timeseries_id(4), ncdim%timeseries(9)) kg m-2 day-1>,
 <CF Field: air_temperature(cf_role=timeseries_id(3), ncdim%timeseries(26), ncdim%profile_1(4)) K>,
 <CF Field: air_potential_temperature(time(118), latitude(5), longitude(8)) K>,
 <CF Field: precipitation_amount(cf_role=timeseries_id(2), time(4))>,
 <CF Field: eastward_wind(time(3), air_pressure(1), grid_latitude(4), grid_longitude(5)) m s-1>,
 <CF Field: air_temperature(time(2), ncdim%nMesh2_face(3)) K>,
 <CF Field: northward_wind(time(2), ncdim%nMesh2_edge(9)) ms-1>,
 <CF Field: air_pressure(time(2), ncdim%nMesh2_node(7)) hPa>]

>>> cf.example_fields(7, 1)
[<CF Field: eastward_wind(time(3), air_pressure(1), grid_latitude(4), grid_longitude(5)) m s-1>,
 <CF Field: air_temperature(atmosphere_hybrid_height_coordinate(1), grid_latitude(10), grid_longitude(9)) K>]

>>> cf.example_fields(3)
[<CF Field: precipitation_flux(cf_role=timeseries_id(4), ncdim%timeseries(9)) kg m-2 day-1>]

>>> cf.example_fields(3, 3, 4)
[<CF Field: precipitation_flux(cf_role=timeseries_id(4), ncdim%timeseries(9)) kg m-2 day-1>,
 <CF Field: precipitation_flux(cf_role=timeseries_id(4), ncdim%timeseries(9)) kg m-2 day-1>,
 <CF Field: air_temperature(cf_role=timeseries_id(3), ncdim%timeseries(26), ncdim%profile_1(4)) K>]

See the cf.example_field for more details.