Version 1.7.0

To be released

• added animate=True argument to plot() command for animated plots in Jupyter notebooks
• allowed cfgrib backend keyword arguments to be passed to Fieldset.to_dataset(), e.g.
  • my_fieldset.to_dataset(squeeze=False, read_keys=["experimentVersionNumber"])
• Fieldset out-of-range indexing now raises an IndexError
• Fieldset merge() function now allows a single Fieldset as argument

The animation control provides a simple slider to control which step of an animation is displayed: 

Version 1.6.0

Released on github and pypi (pip install metview). Installed at ECMWF as part of metview/5.10.2

• added new function download_gallery_data() to download Gallery example data files
• added write(filename) method for classes Fieldset, Geopoints, GeopointSet, Bufr and NetCDF
• added ability to construct a Fieldset from a list of Fieldsets, e.g. Fieldset([f1, f2, f3])
• added metzoom() function (for a future development)
• added png driver keyword arguments to setoutput('jupyter') to control output size in notebooks, e.g.
  • mv.setoutput('jupyter', output_width=1200)
• added metview_python member to result of version_info() function

Version 1.5.1

• just a version bump to help install to PyPi

Version 1.5.0

• added support for int numpy arrays as input to functions and methods
• added support for bitwise and (&), or (|) and not (~) operators on Fieldsets
• added div() function (already available via the '/' operator)
• added mod() function
• improved timeout message by mentioning how to increase the timeout
• fixed error when updating an mv.Request object

Version 1.4.2

Released on github and pypi (pip install metview)

• fixed issue where indexing a Fieldset with a numpy array of indexes did not work

Version 1.4.1

Released on github and pypi (pip install metview)

• added Travis and Coveralls testing on github

Version 1.4.0

Released on github and pypi (pip install metview)

• allow a geopoints column name to be used as index when assigning data to a column
• allow -, + and abs operators to work on Metview classes (e.g. a = -my_fieldset)
• added support for Metview's file object
• fixed issue where negative indexing did not work on a Fieldset
• fixed issue where concurrent iterators on a Fieldset did not work
• added experimental support for pickling Fieldsets
• automatically obtain list of Macro-based functions
• allow all example notebooks to run in Binder

Version 1.3.4

Released on github and pypi (pip install metview)

• Fixed issue when passing sliced Numpy arrays to Metview functions
• Fixed issue when running notebooks in Binder environment

Version 1.3.3

Released on ECMWF desktops, ecgate, Linux clusters and HPC on 2020-01-14 as part of Metview 5.7.5. Also on github and pypi (pip install metview)

• Fixed memory leak in the Fieldset.append() function

Version 1.3.2

Released on ECMWF desktops, ecgate, Linux clusters and HPC on 2019-12-06 as part of Metview 5.7.4. Also on github and pypi (pip install metview)

• added 'reflected operator' support for Fieldsets. We previously supported expressions such as "Fieldset * 2", but now we also support "2 * Fieldset". Affected operators are add, subtract, multiply, divide and power.

Version 1.3.1

Released on ECMWF desktops, ecgate, Linux clusters and HPC on 2019-12-06 as part of Metview 5.7.4. Also on github and pypi (pip install metview)

• added the function ml_to_hl() to convert GRIB fields from model levels to height levels

Version 1.3.0

Released on ECMWF desktops, ecgate and lxc on 2019-10-04. Also on github and pypi (pip install metview)

• fixed memory leak when returning a list of items
• allow bool-typed numpy arrays as input
• fixed issue where the Fieldset iterator could fail if used multiple times
• export the Request class (dict + verb, can be passed to Meview and automatically converted into a 'definition')

Version 1.2.0

Released on ECMWF desktops, ecgate and lxc on 2019-07-15. Also on github and pypi (pip install metview)

• Metview startup timeout configurable via environment variable METVIEW_PYTHON_START_TIMEOUT (in seconds)
• Metview startup timeout default set to 8 seconds in case of busy systems
• added integral() function
• fixed memory leak when exporting vectors as numpy arrays

Version 1.1.0

Released on ECMWF desktops, ecgate and lxc on 2019-03-04. Also on github and pypi (pip install metview)

• added equality (``==``) and non-equality (``!=``) operators for Fieldset and Geopoints objects, e.g. ``same = (a == b)`` will produce a new Fieldset or Geopoints with 1s where the values are the same, and 0s elsewhere.
• added new thermodynamic, gradient and utility functions: 'thermo_data_info', 'thermo_parcel_path', 'thermo_parcel_area', 'xy_curve', 'potential_temperature', 'temperature_from_potential_temperature', 'saturation_mixing_ratio', 'mixing_ratio', 'vapour_pressure', 'saturation_vapour_pressure', 'lifted_condensation_level', 'divergence', 'vorticity', 'laplacian', 'geostrophic_wind_pl', 'geostrophic_wind_ml'
• improved conversion from geopoints to pandas dataframe to cope with new NCOLS subformat
• make conversion from Fieldset to xarray dataset compatible with latest versions of cfgrib

Version 1.0.0

Released on ECMWF desktops, ecgate and lxc on 2018-12-21. Also on github and pypi (pip install metview)

This version is the first 'full release', containing only some internal cleanups. Some more example Jupyter notebooks were added.

From this point, all developments and issue tracking will be performed directly on github. Please report any issues there.

Version 0.9.1

Released on ECMWF desktops, ecgate and lxc on 2018-11-24. Also on github and pypi (pip install metview).

This version is considered beta.

Bug

• [MPY-207] - Filedset slicing fails with a large number of fields

Task

• [MPY-205] - Allow the creation of an empty Fieldset object
• [MPY-206] - Add append() function to Fieldset class
• [MPY-208] - Passed named arguments to dataset_to_fieldset function
• [MPY-209] - Ignore errors on exit from a data examiner
• [MPY-210] - Add expanded field-obs example

Version 0.8.6

Released on ECMWF desktops, ecgate and lxc on 2018-10-26. Also on github and pypi (pip install metview)

Bug

• [MPY-186] - Cannot plot a multi-page PostScript file - now we can do it by inserting calls to newpage():
  • e.g. plot(dw, data1, visdef1, newpage(), data2, visdef2) - requires Metview >=5.2
• [MPY-196] - Cannot take scalar numpy numbers (e.g. np.int64) as input arguments to Metview functions

Task

• [MPY-136] - Use environment variable to determine how to invoke Metview (METVIEW_PYTHON_START_CMD)
• [MPY-137] - Support passing of float32 vectors between Metview and Python numPy
• [MPY-153] - Add function to convert NetCDF to xarray dataset
  • e.g. xs = mv.mcross_sect(line=[59,-180,-13,158],data=grib); xarr = xs.to_dataset()
• [MPY-162] - Tidy up value_from_metview
• [MPY-163] - Tidy up push_arg
• [MPY-177] - Revise example scripts in repo
• [MPY-187] - Allow assignment to indexed fields in a Fieldset object
  • e.g. fs[3] = fs[2] + 5
• [MPY-188] - Allow xarray datasets to the provided as input to Metview functions
  • e.g. m = mv.mean(my_xarray_dataset); also f = mv.dataset_to_fieldset(x) - only for very compliant datasets though!
• [MPY-189] - Check and revise the scripts in the examples folder
• [MPY-190] - Create an example using data from the CDS
• [MPY-191] - Ensure that FLEXTRA work from Metview's Python API
• [MPY-192] - Create Jupyter notebook examples
• [MPY-193] - Fix netcdf and geopoints functions that take indexes as parameters
• [MPY-194] - Implement self-check command to ensure Metview installation ok
  • python -m metview selfcheck
• [MPY-195] - Ensure all index-returning functions are context-sensitive
• [MPY-197] - Add ability to export table data as a Pandas Dataframe
  • df = table.to_dataframe()
• [MPY-198] - Add batch plotting tests
• [MPY-199] - Improve organisation of code in bindings.py
• [MPY-200] - Remove experimental 'mf' class
• [MPY-201] - Support extended slicing on Fieldset objects 
  • e.g. fields = fs[2:12:3]

Version 0.8.4

Released on ECMWF desktops, ecgate and lxc on 2018-08-01. Also on github.

Bug

• [MPY-164] - importing the metview module overrides the keyboard interrupt signal
• [MPY-179] - Cannot find libMvMacro.so in /usr/lib

Task

• [MPY-180] - Replace klass with class_ in MARS requests (change in behaviour)
• [MPY-183] - Use cfgrib in metview-python

Version 0.8.1

Released on ECMWF desktops and ecgate on 2018-06-08.

Task

• [MPY-144] - Support passing of geopointset between Macro and Python
• [MPY-150] - Add ability to export ODB table as a Pandas Dataframe
• [MPY-151] - Simplify data classes through multiple inheritance
• [MPY-152] - Allow access to individual geopoints
• [MPY-154] - Implement aliases for 'class' as MARS parameter
• [MPY-155] - Improve error message if correct version of Metview not found

Version 0.8.0

First internal release.