Parcels v1.1.1: a Lagrangian Ocean Analysis tool for the petascale age
Parcels v1.1.1 builds on the previous v1.1.0 release. Major changes since then:
-
In
Fieldset.from_netcdf(), the format offilenamesargument has been enriched (#463).
As before,filenamescan be:- list of files
- dictionaries of list of files, where the dictionary keys are field names
On top of that,
filenamescan now be:- dictionaries of lists of files, where the dictionary keys are dimension names:
filenames[dimension_name] = [files] - dictionaries of dictionaries of lists of files:
filenames[field_name][dimension_name] = [files]
This particularly affects the function
Fieldset.from_nemo():New
filenameslooks like:filenames = {'U': {'lon': data_path + 'mesh_mask.nc4', 'lat': data_path + 'mesh_mask.nc4', 'data': data_path + 'U_purely_zonal-ORCA025_grid_U.nc4'}, 'V': {'lon': data_path + 'mesh_mask.nc4', 'lat': data_path + 'mesh_mask.nc4', 'data': data_path + 'V_purely_zonal-ORCA025_grid_V.nc4'}}instead of:
filenames = {'U': data_path + 'U_purely_zonal-ORCA025_grid_U.nc4', 'V': data_path + 'V_purely_zonal-ORCA025_grid_V.nc4', 'mesh_mask': data_path + 'mesh_mask.nc4'}This modification enables to easily read 3d curvilinear NEMO fields, when the depth dimension is in the data-files.
-
A new
TimeConverterclass converts between dates and the number of seconds that Parcels uses under the hood. This enables to read netcdf files with less common time formats, such as NOLEAP. (#456) -
New
netcdf_engineas argument forFieldset.from_netcdf(), enables to open netcdf files with a different engine when the default netcdf4 engine does not work. (#460) -
Improved error messages for C-kernel generator (#457)
-
Minor bug fixes
Note that it is now recommended to use a recent version of xarray (>=0.10.8) together with Parcels, since it better parses some netcdf files used by common OGCMs.