diff --git a/docs/API.html b/docs/API.html index 6da6ff8b..cba03cc4 100644 --- a/docs/API.html +++ b/docs/API.html @@ -38,16 +38,16 @@

API

pyPDAF.PDAF.assimilate_3dvar

-

It is recommended to use OMI functionalities for fewer user-supplied functions and improved efficiency.I.e., pyPDAF.PDAF.omi_assimilate_3dvar or pyPDAF.PDAF.omi_assimilate_3dvar_nondiagR.

+

It is recommended to use pyPDAF.PDAF.omi_assimilate_3dvar() or pyPDAF.PDAF.omi_assimilate_3dvar_nondiagR().

pyPDAF.PDAF.assimilate_en3dvar_estkf

-

It is recommended to use OMI functionalities for fewer user-supplied functions and improved efficiency.

+

It is recommended to use pyPDAF.PDAF.omi_assimilate_en3dvar_estkf() or pyPDAF.PDAF.omi_assimilate_en3dvar_estkf_nondiagR().

pyPDAF.PDAF.assimilate_en3dvar_lestkf

-

It is recommended to use local module with OMI functionalities for fewer user-supplied functions and improved efficiency.

+

It is recommended to use pyPDAF.PDAF.localomi_assimilate_en3dvar_lestkf() or pyPDAF.PDAF.localomi_assimilate_en3dvar_lestkf_nondiagR().

pyPDAF.PDAF.assimilate_enkf

-

It is recommended to use pyPDAF.PDAF.omi_assimilate_global() or pyPDAF.PDAF.omi_assimilate_enkf_nondiagR().

+

It is recommended to use pyPDAF.PDAF.omi_assimilate_global() or pyPDAF.PDAF.omi_assimilate_enkf_nondiagR().

pyPDAF.PDAF.assimilate_estkf

It is recommended to use pyPDAF.PDAF.omi_assimilate_global() or pyPDAF.PDAF.omi_assimilate_global_nondiagR() instead of this function.

@@ -56,13 +56,13 @@

API

It is recommended to use pyPDAF.PDAF.omi_assimilate_global() or pyPDAF.PDAF.omi_assimilate_global_nondiagR().

pyPDAF.PDAF.assimilate_hyb3dvar_estkf

-

It is recommended to use OMI functionalities for fewer user-supplied functions and improved efficiency.

+

It is recommended to use pyPDAF.PDAF.omi_assimilate_hyb3dvar_estkf() or pyPDAF.PDAF.omi_assimilate_hyb3dvar_estkf_nondiagR().

pyPDAF.PDAF.assimilate_hyb3dvar_lestkf

-

It is recommended to use local module with OMI functionalities for fewer user-supplied functions and improved efficiency.

+

It is recommended to use pyPDAF.PDAF.localomi_assimilate_hyb3dvar_lestkf() or pyPDAF.PDAF.localomi_assimilate_hyb3dvar_lestkf_nondiagR().

pyPDAF.PDAF.assimilate_lenkf

-

It is recommended to use pyPDAF.PDAF.omi_assimilate_lenkf() or pyPDAF.PDAF.omi_assimilate_lenkf_nondiagR().

+

It is recommended to use pyPDAF.PDAF.omi_assimilate_lenkf() or pyPDAF.PDAF.omi_assimilate_lenkf_nondiagR().

pyPDAF.PDAF.assimilate_lestkf

It is recommended to use pyPDAF.PDAF.localomi_assimilate() or pyPDAF.PDAF.localomi_assimilate_nondiagR().

@@ -71,31 +71,31 @@

API

It is recommended to use pyPDAF.PDAF.localomi_assimilate() or pyPDAF.PDAF.localomi_assimilate_nondiagR().

pyPDAF.PDAF.assimilate_lnetf

-

It is recommended to use local module with OMI functionalities for fewer user-supplied functions and improved efficiency.

+

It is recommended to use pyPDAF.PDAF.localomi_assimilate() or pyPDAF.PDAF.localomi_assimilate_lnetf_nondiagR().

pyPDAF.PDAF.assimilate_lknetf

-

It is recommended to use local module with OMI functionalities for fewer user-supplied functions and improved efficiency.

+

It is recommended to use pyPDAF.PDAF.localomi_assimilate() or pyPDAF.PDAF.localomi_assimilate_lknetf_nondiagR().

pyPDAF.PDAF.assimilate_lseik

-

It is recommended to use local module with OMI functionalities for fewer user-supplied functions and improved efficiency.

+

It is recommended to use pyPDAF.PDAF.localomi_assimilate() or pyPDAF.PDAF.localomi_assimilate_nondiagR().

pyPDAF.PDAF.assimilate_netf

-

It is recommended to use OMI functionalities for fewer user-supplied functions and improved efficiency.

+

It is recommended to use pyPDAF.PDAF.omi_assimilate_global() or pyPDAF.PDAF.omi_assimilate_nonlin_nondiagR().

pyPDAF.PDAF.assimilate_pf

-

It is recommended to use OMI functionalities for fewer user-supplied functions and improved efficiency.

+

It is recommended to use pyPDAF.PDAF.omi_assimilate_global() or pyPDAF.PDAF.omi_assimilate_nonlin_nondiagR().

pyPDAF.PDAF.assimilate_seek

-

It is recommended to use OMI functionalities for fewer user-supplied functions and improved efficiency.

+

It is recommended to use pyPDAF.PDAF.omi_assimilate_global() or pyPDAF.PDAF.omi_assimilate_global_nondiagR().

pyPDAF.PDAF.assimilate_seik

-

It is recommended to use OMI functionalities for fewer user-supplied functions and improved efficiency.

+

It is recommended to use pyPDAF.PDAF.omi_assimilate_global() or pyPDAF.PDAF.omi_assimilate_global_nondiagR().

pyPDAF.PDAF.assimilate_prepost

-

This function does not perform any DA.

+

It is used to preprocess and postprocess of the ensemble.

pyPDAF.PDAF.deallocate

-

This function finalise the PDAF systems including deaclloating all arrays in PDAF.

+

This function finalise the PDAF systems including freeing all memory used by PDAF.

pyPDAF.PDAF.diag_effsample

This function calculates the effective sample size of a particle filter as defined in Doucet et al. 2001 p.

@@ -119,7 +119,7 @@

API

In the local filters (LESKTF, LETKF, LSEIK, LNETF) this function returns the full observation coordinates from process-local observation coordinates.

pyPDAF.PDAF.generate_obs

-

When diagonal observation error covariance matrix is used, it is recommended to use OMI functionalities for fewer user-supplied functions and improved efficiency.

+

Generation of synthetic observations based on given error statistics and observation operator.

pyPDAF.PDAF.get_assim_flag

This function returns the flag that indicates if the DA is performed in the last time step.

@@ -502,9 +502,45 @@

API

pyPDAF.PDAF.omi_omit_by_inno_cb

The function is called during the analysis step of a global filter.

-

pyPDAF.PDAF.omi_assimilate_global_nondiagR

+

pyPDAF.PDAF.omi_assimilate_3dvar_nondiagR

+

Using 3DVar for DA with non-diagonal observation error covariance matrix.

+ +

pyPDAF.PDAF.omi_assimilate_en3dvar_estkf_nondiagR

+

Using 3DEnVar for DA with non-diagonal observation error covariance matrix.

+ +

pyPDAF.PDAF.omi_assimilate_hyb3dvar_estkf_nondiagR

+

Using Hybrid 3DEnVar for DA with non-diagonal observation error covariance matrix.

+ +

pyPDAF.PDAF.omi_assimilate_lenkf_nondiagR

+

Using stochastic EnKF (ensemble Kalman filter) with covariance localisation for DA with non-diagonal observation error covariance matrix.

+ +

pyPDAF.PDAF.omi_assimilate_enkf_nondiagR

+

Using stochastic EnKF (ensemble Kalman filter) for DA with non-diagonal observation error covariance matrix.

+ +

pyPDAF.PDAF.omi_assimilate_global_nondiagR

Global DA filters for DA except for 3DVars with non-diagonal observation error covariance matrix.

+

pyPDAF.PDAF.omi_assimilate_nonlin_nondiagR

+

Using nonlinear filters (particle filter, NETF) for DA except for 3DVars with non-diagonal observation error covariance matrix.

+ +

pyPDAF.PDAF.omi_assimilate_en3dvar_lestkf_nondiagR

+

It is recommended to use local module for fewer user-supplied functions and improved efficiency.

+ +

pyPDAF.PDAF.omi_assimilate_hyb3dvar_lestkf_nondiagR

+

It is recommended to use local module for fewer user-supplied functions and improved efficiency.

+ +

pyPDAF.PDAF.omi_put_state_en3dvar_lestkf_nondiagR

+

It is recommended to use local module for fewer user-supplied functions and improved efficiency.

+ +

pyPDAF.PDAF.omi_put_state_hyb3dvar_lestkf_nondiagR

+

It is recommended to use local module for fewer user-supplied functions and improved efficiency.

+ +

pyPDAF.PDAF.omi_put_state_lknetf_nondiagR

+

It is recommended to use local module for fewer user-supplied functions and improved efficiency.

+ +

pyPDAF.PDAF.omi_put_state_lnetf_nondiagR

+

It is recommended to use local module for fewer user-supplied functions and improved efficiency.

+

pyPDAF.PDAF.local_set_indices

Set index vector to map local state vector to global state vectors.

@@ -810,7 +846,19 @@

pyPDAF

  • pyPDAF.PDAF.omi_localize_covar_noniso_locweights
  • pyPDAF.PDAF.omi_omit_by_inno_l_cb
  • pyPDAF.PDAF.omi_omit_by_inno_cb
  • +
  • pyPDAF.PDAF.omi_assimilate_3dvar_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_en3dvar_estkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_hyb3dvar_estkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_lenkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_enkf_nondiagR
  • pyPDAF.PDAF.omi_assimilate_global_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_nonlin_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_en3dvar_lestkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_hyb3dvar_lestkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_put_state_en3dvar_lestkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_put_state_hyb3dvar_lestkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_put_state_lknetf_nondiagR
  • +
  • pyPDAF.PDAF.omi_put_state_lnetf_nondiagR
  • pyPDAF.PDAF.local_set_indices
  • pyPDAF.PDAF.local_set_increment_weights
  • pyPDAF.PDAF.local_clear_increment_weights
  • diff --git a/docs/_autosummary/pyPDAF.PDAF.SampleEns.html b/docs/_autosummary/pyPDAF.PDAF.SampleEns.html index 93601130..5e8bf741 100644 --- a/docs/_autosummary/pyPDAF.PDAF.SampleEns.html +++ b/docs/_autosummary/pyPDAF.PDAF.SampleEns.html @@ -262,7 +262,19 @@

    pyPDAF

  • pyPDAF.PDAF.omi_localize_covar_noniso_locweights
  • pyPDAF.PDAF.omi_omit_by_inno_l_cb
  • pyPDAF.PDAF.omi_omit_by_inno_cb
  • +
  • pyPDAF.PDAF.omi_assimilate_3dvar_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_en3dvar_estkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_hyb3dvar_estkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_lenkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_enkf_nondiagR
  • pyPDAF.PDAF.omi_assimilate_global_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_nonlin_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_en3dvar_lestkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_hyb3dvar_lestkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_put_state_en3dvar_lestkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_put_state_hyb3dvar_lestkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_put_state_lknetf_nondiagR
  • +
  • pyPDAF.PDAF.omi_put_state_lnetf_nondiagR
  • pyPDAF.PDAF.local_set_indices
  • pyPDAF.PDAF.local_set_increment_weights
  • pyPDAF.PDAF.local_clear_increment_weights
  • diff --git a/docs/_autosummary/pyPDAF.PDAF.add_increment.html b/docs/_autosummary/pyPDAF.PDAF.add_increment.html index 57be1f99..b248ccab 100644 --- a/docs/_autosummary/pyPDAF.PDAF.add_increment.html +++ b/docs/_autosummary/pyPDAF.PDAF.add_increment.html @@ -253,7 +253,19 @@

    pyPDAF

  • pyPDAF.PDAF.omi_localize_covar_noniso_locweights
  • pyPDAF.PDAF.omi_omit_by_inno_l_cb
  • pyPDAF.PDAF.omi_omit_by_inno_cb
  • +
  • pyPDAF.PDAF.omi_assimilate_3dvar_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_en3dvar_estkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_hyb3dvar_estkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_lenkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_enkf_nondiagR
  • pyPDAF.PDAF.omi_assimilate_global_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_nonlin_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_en3dvar_lestkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_assimilate_hyb3dvar_lestkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_put_state_en3dvar_lestkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_put_state_hyb3dvar_lestkf_nondiagR
  • +
  • pyPDAF.PDAF.omi_put_state_lknetf_nondiagR
  • +
  • pyPDAF.PDAF.omi_put_state_lnetf_nondiagR
  • pyPDAF.PDAF.local_set_indices
  • pyPDAF.PDAF.local_set_increment_weights
  • pyPDAF.PDAF.local_clear_increment_weights
  • diff --git a/docs/_autosummary/pyPDAF.PDAF.assimilate_3dvar.html b/docs/_autosummary/pyPDAF.PDAF.assimilate_3dvar.html index 221b5ec3..7c7de187 100644 --- a/docs/_autosummary/pyPDAF.PDAF.assimilate_3dvar.html +++ b/docs/_autosummary/pyPDAF.PDAF.assimilate_3dvar.html @@ -38,26 +38,46 @@

    pyPDAF.PDAF.assimilate_3dvar
    pyPDAF.PDAF.assimilate_3dvar()
    -

    It is recommended to use OMI functionalities for fewer user-supplied functions and improved efficiency.I.e., pyPDAF.PDAF.omi_assimilate_3dvar or pyPDAF.PDAF.omi_assimilate_3dvar_nondiagR. -Using 3DVar for DA without OMI. This is a deterministic filtering scheme. This function should be called at each model time step.

    -

    The function is a combination of pyPDAF.PDAF.put_state_3dvar and pyPDAF.PDAF.get_state, and executes the user-supplied function in the following sequence: -1. py__collect_state_pdaf -2. py__prepoststep_state_pdaf -3. py__init_dim_obs_pdaf -4. py__obs_op_pdaf -5. py__init_obs_pdaf -Starting the iterative optimisation: -6. py__cvt_pdaf -7. py__obs_op_lin_pdaf -8. py__prodRinvA_pdaf -9. py__obs_op_adj_pdaf -10. py__cvt_adj_pdaf -11. core DA algorithm -After the iterations: -12. py__cvt_pdaf -13. py__prepoststep_state_pdaf -14. py__distribute_state_pdaf -15. py__next_observation_pdaf

    +

    It is recommended to use pyPDAF.PDAF.omi_assimilate_3dvar() +or pyPDAF.PDAF.omi_assimilate_3dvar_nondiagR().

    +

    PDAF-OMI modules require fewer user-supplied functions and improved efficiency.

    +

    3DVar DA for a single step without OMI. +When 3DVar is used, the background error covariance matrix +has to be modelled for cotrol variable transformation. +This is a deterministic filtering scheme so no ensemble and parallelisation is needed. +This function should be called at each model time step.

    +

    The function is a combination of pyPDAF.PDAF.put_state_3dvar() +and pyPDAF.PDAF.get_state().

    +
    +
    User-supplied functions are executed in the following sequence:
      +
    1. py__collect_state_pdaf

    2. +
    3. py__prepoststep_state_pdaf

    4. +
    5. py__init_dim_obs_pdaf

    6. +
    7. py__obs_op_pdaf

    8. +
    9. py__init_obs_pdaf

    10. +
    11. +
      Iterative optimisation:
        +
      1. py__cvt_pdaf

      2. +
      3. py__obs_op_lin_pdaf

      4. +
      5. py__prodRinvA_pdaf

      6. +
      7. py__obs_op_adj_pdaf

      8. +
      9. py__cvt_adj_pdaf

      10. +
      11. core DA algorithm

      12. +
      +
      +
      +
    12. +
    13. py__cvt_pdaf

    14. +
    15. py__prepoststep_state_pdaf

    16. +
    17. py__distribute_state_pdaf

    18. +
    19. py__next_observation_pdaf

    20. +
    +
    +
    +
    +

    Deprecated since version 1.0.0: This function is replaced by pyPDAF.PDAF.omi_assimilate_3dvar() +and pyPDAF.PDAF.omi_assimilate_3dvar_nondiagR()

    +
    Parameters: