Changelog♻️

v2025.12.0

Released on: 2025/11/29

• feat: add ts on normalized funcs

⚠️ From this version, we change the functions name as follows:

• normalize_zscore ➡️ timeseries_normalize_zscore

• normalize_minmax ➡️ timeseries_normalize_minmax

• normalize_robust ➡️ timeseries_normalize_robust

• normalize_mean ➡️ timeseries_normalize_mean

and add function:

• calc_precip_anomaly_percentage

• fix: use get_axis_num instead

• feat: delete climatological macro

⚠️ From this version, we change the functions name as follows:

• calc_yearly_mean ➡️ calc_yearly_climatological_mean

• calc_yearly_sum ➡️ calc_yearly_climatological_sum

• calc_yearly_std ➡️ calc_yearly_climatological_std

• calc_yearly_var ➡️ calc_yearly_climatological_var

• calc_yearly_max ➡️ calc_yearly_climatological_max

• calc_yearly_min ➡️ calc_yearly_climatological_min

• feat: add sample units for q

• feat: seperate units module

• fix: radius of the earth

• feat: add monthstat

⚠️ From this version, we add the functions name as follows:

• calc_monthly_mean

• calc_monthly_sum

• calc_monthly_std

• calc_monthly_var

• calc_monthly_max

• calc_monthly_min

• feat & fix: update diff

⚠️ From this version, we change the functions name as follows:

• calc_lon_gradient ➡️ calc_dx_gradient

• calc_lat_gradient ➡️ calc_dy_gradient

add functions:

• calc_dlon_radian_gradient

• calc_dlon_degree_gradient

• calc_dlat_radian_gradient

• calc_dlat_degree_gradient

• calc_shear_stretch_deform

and fix functions:

• calc_delta_pressure

• calc_p_gradient

• calc_p_integral

• calc_top2surface_integral

• calc_divergence

• calc_vorticity

• calc_geostrophic_wind

• calc_geostrophic_wind_vorticity

• calc_water_flux_top2surface_integral

• calc_divergence_watervaporflux

• calc_divergence_watervaporflux_top2surface_integral

• calc_u_advection

• calc_v_advection

• calc_p_advection

• feat: add egr example

• fix: fix waf calc

⚠️ From this version, we fix the functions name as follows:

• calc_Plumb_wave_activity_horizontal_flux

• calc_TN_wave_activity_horizontal_flux

• feat: add fortran macro

• feat: add remove_sst_trend

• feat: add add_lon_cyclic_lonarray

• fix: fix calc_seasonal_mean

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.11.0…v2025.12.0

v2025.11.0

Released on: 2025/10/23

• fix: EGR error

⚠️ From this version:

• We addressed the issue in calc_eady_growth_rate where there was an unnecessary multiplication by the gravitational acceleration g. This extra part was confirmed to be incorrect🛠️, so there is now an order of magnitude difference between the current version and the previous version.

• feat: add time_range for normalize

• feat: add calc_eof_projection_coefficient

• feat: add func

  • calc_windmask_ttestSpatialPattern_spatial

  • calc_non_centered_corr

  • calc_pattern_corr

• fix: fix codacy.instructions

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.10.0…v2025.11.0

v2025.10.0

Released on: 2025/9/24

• fix: dp error

• feat: add mini*gallery

• feat: add show_versions

• feat: add windspeed

• fix: reg error

• feat: add track and axisymmetric

• feat: add contributing

• fix: system info

• fix: para error in color

• feat: add linux install docs

• feat: change coastlines_linewidths to coastlines_kwargs

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.9.0…v2025.10.0

v2025.9.0

Released on: 2025/8/21

• docs: add uv

• docs: add video

• update: black version

• update: black exclude

• fix: build process error

• fix: remove_low_frequency_signal

• fix: fixed dims

• fix: explicit normalized

• feat: add normalized

• fix: fix bar and line

• fix: corr fix

• fix: fix pdo

• text: fix file

• feat: add calc_timeseries_correlations

• feat: use rich instead

• fix: fix draw_significant_area_contourf

• fix: fix cgt error

• feat: add calc_leadlag_corr_spatial

• update: update version

• fix: wk_spectra docs

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.8.0…v2025.9.0

What’s Changed

v2025.8.0

Released on: 2025/7/24

What’s Changed

• feat: add wet bulk

• feat: add calc_lat_weight_lin_rood

• feat: add transfer_relative_humidity_2_dewpoint

• feat: add condensation and convection

• fix: icon error win32

• feat: add vinth2p_dp

• feat: add enthalpy

• fix: add mixing_ratio_data_units

• fix: q unit error

• feat: add latent heat water

• feat: add vinth2p

• feat: add calc_enthalpy

• feat: add calc_relative_angular_momentum

• feat: add daily std var signal

• feat: add pytest parallel support

• feat: add vinth2p

• feat: add spectrum

• feat: center files in backend

• feat: add calc_lead_lag_correlation_coefficients

• feat: add bsiso

• fix: fix datanode plain text

• feat: migrate datatree to datanode

• feat: add da and bbo

• feat: add clean_extra_coords

• feat: add interp_mesh2point_withtime

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.7.0…v2025.8.0

v2025.7.0

Released on: 2025/6/21

What’s Changed

• feat: seperate physics part

• feat: add mesh2point

• feat: add emd

• feat: add AO support

• feat: add spharm support

• feat: add statellite support

• feat: add plot of coriolis coefficient

• feat: add gaussian filter

⚠️ From this version:

• We removed calc_potential_intensity_Bister_Emanuel_2002 code from easyclimate.field.mesoscale.potential_intensity.py, please use easyclimate.field.typhoon.potential_intensity.py instead 🛠️.

• Seperate easyclimate.core.diagnosis to the part easyclimate.physics.

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.5.0…v2025.7.0

v2025.5.0

Released on: 2025/5/9

What’s Changed

• feat: add smooth_daily_annual_cycle gallery

• add: add bar and line

  • bar_plot_with_threshold

  • line_plot_with_threshold

• add: diagnosis func

  • calc_potential_temperature

  • calc_potential_temperature_vertical

  • calc_equivalent_potential_temperature

  • calc_equivalent_potential_temperature_davies_jones2009

  • calc_wet_bulb_potential_temperature_iteration

  • calc_wet_bulb_potential_temperature_davies_jones2008

  • calc_wet_bulb_temperature_stull2011

  • calc_wet_bulb_temperature_sadeghi2013

  • calc_lifting_condensation_level_bolton1980

  • calc_lifting_condensation_level_Bohren_Albrecht2023

  • calc_moist_adiabatic_lapse_rate

  • transfer_dewpoint_2_mixing_ratio

• fix: Solve Invalid value for attr solver_kwargs: dict

• fix: units fix

• fix: change calc_potential_temperature_vertical from calc_potential_temperature

• feat: datanode enhance

• feat: add datatime steps

  • datetime_to_numeric

  • numeric_to_datetime

  • calculate_time_steps

• fix: fix time-invariant dependence

• docs: add example for tcpv

• feat: add emd func

  • filter_emd

  • filter_eemd

• fix: list errors

• feat: add open_datanode

  • open_datanode

• feat: add meof support

  • easyclimate.eof.get_EOF_model

• fix: path support linux

• fix: fix snowballstemmer version

• docs: use zarr 2

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.4.0…v2025.5.0

v2025.4.0

Released on: 2025/4/12

What’s Changed

• feat: function enhancement

  • transfer_data_temperature_units

  • check_deprecation_status

  • smooth_daily_annual_cycle

  • calc_daily_annual_cycle_mean

  • remove_smooth_daily_annual_cycle_mean

  • draw_mjo_phase_space_basemap

  • draw_mjo_phase_space

  • remove_dominant_signals

  • decompose_symasym

  • calc_spectral_coefficients

  • draw_wk_anti_analysis

  • draw_wk_sym_analysis

• feat: add dependency

• feat: add check deprecations

• feat: add calc_corr_spatial

• feat: add validate_dataarrays

• fix: add default args

• fix: auto repair lon error

• feat: add barnes_filter

• feat: add gallery

• feat: add spatial pcf

• update: docs update

⚠️ From this version, we migrated calc_potential_intensity_Bister_Emanuel_2002 code from easyclimate.field.mesoscale.potential_intensity.py (Removal Version v2025.7.0) to easyclimate.field.typhoon.potential_intensity.py 🛠️.

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.3.0…v2025.4.0

v2025.3.0

Released on: 2025/3/16

What’s Changed

• fix: fast-barnes-py error

• feat: add wrf-python docs

• feat: add test_transfer_data_units

• feat: add human index

• update: move backend

• fix: redfit check

• feat: add aerobulk

⚠️ From this version, we uniformly migrated fortran-related code to the easyclimate-backend repository 🛠️.

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.2.0…v2025.3.0

v2025.2.0

Released on: 2025/2/17

What’s Changed

• feat: add Lanczos filter

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.1.0…v2025.2.0

v2025.1.0

Released on: 2025/1/9

What’s Changed

• feat: add curly vector support

• fix: fix Collection in matplotlib

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.12.0…v2025.1.0

v2024.12.0

Released on: 2024/12/12

What’s Changed

• feat: add interp1d_vertical_pressure2altitude

• feat: add docs seaborn rely

• fix: rtd github download

• feat: support Chinese and Japanese readme

• update: update index page

• fix: fix fast-barnes-py version temperately

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.11.0…v2024.12.0

v2024.11.0

Released on: 2024/11/17

What’s Changed

• fix: modify specific_humidity_units to specific_humidity_data_units

• fix: rename file in the field

• fix: fix error DataTree immigration

• feat: add Potential intensity of TC

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.10.0…v2024.11.0

v2024.10.0

Released on: 2024/10/09

What’s Changed

• feat: add quick_draw_rectangular_box

• feat: Modify the units conversion module

• feat: Enhance unit availability

• feat: add water vapor parameter calculation function

• fix: fix error introduced by xeofs 3.0.0

• fix: Type expression

• update: fix eof error for xeof>3.0.0

• test: add test for water vapor calculation

• fix: accuracy problem on linux

• depend: update dependency

• update: update version of precommitconfig

• fix: test dependency for netcdf

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.08.01…v2024.10.0

v2024.08.01

Released on: 2024/08/02

What’s Changed

• Update requirements text by @shenyulu in https://github.com/shenyulu/easyclimate/pull/51

• Update sphinx from 6.2.1 to 7.3.7 in the requirements.txt by @shenyulu in https://github.com/shenyulu/easyclimate/pull/52

• update sphinx version from 6.2.1 to 7.3.7 by @shenyulu in https://github.com/shenyulu/easyclimate/pull/53

• build(deps): bump sphinx-autoapi from 3.1.1 to 3.1.2 by @dependabot in https://github.com/shenyulu/easyclimate/pull/54

• chore: necessary update (2024.08.01) by @shenyulu in https://github.com/shenyulu/easyclimate/pull/66

  • fix: update calc_NPWI_monsoon_retreat from calc_NPWI_monsoon_detreat

  • fix: change name calc_detrend_spatial from calc_detrend_data

  • test: update calc_NPWI_monsoon_retreat from `calc_NPWI_monsoon_detreat

  • feat: add quick_draw_spatial_basemap for quick drawing

  • depend: Update dependency requirement

  • test: add test for quick_draw_spatial_basemap

  • fix: File reference modification

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.05.01…v2024.08.01

v2024.05.01

Released on: 2024/05/19

What’s Changed

• Add the calculation of virtual temperature and interpolating from the model levels to pressure levels by @shenyulu in https://github.com/shenyulu/easyclimate/pull/27

• [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/shenyulu/easyclimate/pull/29

• Bump pytest from 8.0.2 to 8.1.1 by @dependabot in https://github.com/shenyulu/easyclimate/pull/28

• [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/shenyulu/easyclimate/pull/30

• update testdata for the change of pyspharm-syl by @shenyulu in https://github.com/shenyulu/easyclimate/pull/33

• Remove the pin of xarray by @shenyulu in https://github.com/shenyulu/easyclimate/pull/34

• chore: necessary update (2024.04.01) by @shenyulu in https://github.com/shenyulu/easyclimate/pull/36

  • fix: calculation of ENSO index

  • fix: dropping variables using drop is deprecated, use drop_vars

  • refactor, test: rename populate_monmean2everymon and `populate_daym…

  • docs: add more details for calc_daily_climatological_anomaly

  • feat: supports the removal of seasonal cycles from the climate averag…

• chore: necessary update (2024.05.01) by @shenyulu in https://github.com/shenyulu/easyclimate/pull/43

  • feat: The calculation of the PNA index

  • feat: The calculation of the NAO index

  • refactor: rename field.atm to field.teleconnection

  • feat: add teleconnection index

  • feat: add calc_seasonal_mean

  • feat: add IOD index

  • refactor, test: use SST data to calculate ENSO index

  • fix: Change the file name to lowercase

  • feat: add IOBM index

  • fix: change module name land_atm_interaction to land

New Contributors

• @pre-commit-ci made their first contribution in https://github.com/shenyulu/easyclimate/pull/29

Full Changelog: https://github.com/shenyulu/easyclimate/compare/v2024.03.01…v2024.05.01

v2024.03.01

Released on: 2024/03/05

What’s Changed

• pin xarray version <=2023.12.0 by @shenyulu in https://github.com/shenyulu/easyclimate/pull/13

• modify eof functions and add test and add create .pre-commit-config.yaml by @shenyulu in https://github.com/shenyulu/easyclimate/pull/16

• update requirement by @shenyulu in https://github.com/shenyulu/easyclimate/pull/23

• remove the pin of geocat.viz by @shenyulu in https://github.com/shenyulu/easyclimate/pull/24

• change binder example location by @shenyulu in https://github.com/shenyulu/easyclimate/pull/25

v2024.01.01

Released on: 2024/01/04

What’s Changed

• Publish version 2024.01.01 by @shenyulu in https://github.com/shenyulu/easyclimate/pull/9

• Bump pytest from 7.4.3 to 7.4.4 by @dependabot in https://github.com/shenyulu/easyclimate/pull/8

v2023.12.01

Released on: 2023/12/10

What’s Changed

• Bump sphinx from 6.2.1 to 7.2.6 by @dependabot in https://github.com/shenyulu/easyclimate/pull/2

• Publish version 2023.12.01 by @shenyulu in https://github.com/shenyulu/easyclimate/pull/3

• Add pytest (codecov to 44.37%)

• Improve requirements

New Contributors

• @shenyulu made their first contribution in https://github.com/shenyulu/easyclimate/pull/3

v0.0.1

Released on: 2022/05/02

What’s Changed

• First release

New Contributors

• shenyulu