*  NCSTAT ChangeLog
====================================================================
* Version 2.1
* 08-June-2021

This version provides bug corrections, improved documentation, large speed improvements
and very fast randomized algorithms for multivariate analysis procedures included in NCSTAT,
improved propagation of input NetCDF variable attributes in the output NetCDF files produced
by NCSTAT executables, improved computations of scale factors in mesh-mask NetCDF files
produced by NCSTAT executables, new procedures for windowed filtering of time series, new procedures
for vertical integrations in the atmosphere (or ocean) using scale factors included in mesh-mask
NetCDF files produced by NCSTAT executables or from NEMO ocean model and, finally, new procedures for
manipulation of fourdimensional NetCDF variables with missing values.

This release requires version 2.1 or above of the STATPACK library.
	   
Changes and updates:

comp_clim_3d, comp_clim_4d, comp_clim_miss_3d, comp_clim_miss_4d, comp_stat_3d, comp_stat_4d, comp_stat_miss_3d:

	* When computing a mesh-mask NetCDF file, the -yl= argument, which specifies the latitude
	  limits of the domain in degrees, is now needed only if the grid of the input NetCDF variable
	  is a (regular) gaussian grid, but the domain is not the whole globe. Scale factors are now
	  correctly estimated without the -yl= argument for a regular grid, even if the domain is not
	  the whole globe.
	* Useful attributes of the input NetCDF variable (like grid_type, code and table attributes)
	  are now propagated in the output NetCDF climatology or statistics files produced by these executables.
	* The documentation of these executables has been improved.

comp_clim_4d, comp_clim_miss_4d, comp_stat_4d:

	* A bug in the computation of the third (vertical) scale factor (included in mesh-mask NetCDF files produced
          by these executables) has been corrected and the computation of this third (vertical) scale factor has been
	  improved (specifically the first and last elements of the third scale factor vector are now computed in all
	  cases) such that this third scale factor vector can now be used for computing vertical integrals from
	  fourdimensional NetCDF variables with the new NCSTAT executables comp_integral_4d and comp_integral_miss_4d.

comp_norm_4d:

	* A bug has been corrected. The old version of this exectuable was trying to open a mesh-mask NetCDF file
	  in all cases, even when such a mesh-mask NetCDF file was not needed for the transformation of the input
	  NetCDF variable.

comp_norm_3d, comp_norm_4d, comp_norm_miss_3d, comp_norm_miss_4d:

	* The documentation and the efficiency of the code of these executables have been significantly improved.
	* Useful attributes of the input NetCDF variable (like units, grid_type, code and table attributes)
	  are now propagated in the output NetCDF files produced by these executables.
	* The new NCSTAT executable comp_norm_miss_4d allows now to process fourdimensional NetCDF variables
	  with misssing values.

comp_season_3d, comp_season_4d, comp_season_miss_3d, comp_season_miss_4d:

	* Useful attributes of the input NetCDF variable (like units, grid_type, code and table attributes)
	  are now propagated in the output NetCDF files produced by these executables.
	* The new NCSTAT executable comp_season_miss_4d allows now to process fourdimensional NetCDF variables
	  with misssing values.

comp_integral_4d, comp_integral_miss_4d:

	* These 2 new NCSTAT executables compute vertical integrals from fourdimensional NetCDF variables with or without
	  missing values, thanks to the improved computation of the third (vertical) scale factor descrived above for
	  the comp_clim_4d, comp_clim_miss_4d, comp_stat_4d NCSTAT executables.

comp_fftfilter_1d, comp_fftfilter_3d, comp_fftfilter_4:

	* These 3 new NCSTAT executables filter real (multichannel) time series in a selected frequency band by windowed
	  filtering and store the filtered (multichannel) time series in an output NetCDF file. These executables are
	  well adapted for filtering short length time series.

comp_svd_3d:

	* Two bugs have been corrected. The first bug concerns the computation of the metric with the -d2=dist3 option
	  and the second bug concerns the bootstrapped computations when the -alg=deflate option is used.
	* Large speed improvements in all the (partial) SVD algorithms and implementation of a new and very fast
	  randomized partial SVD algoritm (this new algorithm is selected when the -alg=rsvd argument is used).
	* Useful attributes of the input NetCDF variable (like units, grid_type, code and table attributes)
	  are now propagated in the output NetCDF SVD files produced by this executable.
	* The documentation has been substantially improved.

comp_eof_3d, comp_eof_4d, comp_eof_miss_3d:

	* Large speed improvements in all the (partial) SVD algorithms and implementation of a new and very fast
	  randomized partial SVD algoritm (this new algorithm is selected when the -alg=rsvd argument is used).
	* Useful attributes of the input NetCDF variable (like units, grid_type, code and table attributes)
	  are now propagated in the output NetCDF EOF files produced by these executables.
	* The documentation of these executables has been substantially improved.

comp_project_eof_3d, comp_project_eof_4d:

	* The documentation of these executables has been substantially improved.
	* Useful attributes of the input NetCDF variable (like units, grid_type, code and table attributes)
	  are now propagated in the output NetCDF files produced by these executables.

comp_stl_1d, comp_stl_3d, comp_stl_4d, comp_trend_1d, comp_trend_3d, comp_trend_4d:

	* Useful attributes of the input NetCDF variable (like units, grid_type, code and table attributes)
	  are now propagated in the output NetCDF STL and trend files produced by these executables.

====================================================================
* Version 2.0
* 07-Dec-2018

First open source release

Updated Feb 17,  2021 for bug corrections
Updated May 07,  2021 for bug corrections
Updated June 07, 2021 for bug corrections

====================================================================
