Changes between Version 4 and Version 5 of IncrementalAnalysisUpdates


Ignore:
Timestamp:
Aug 21, 2025, 5:03:04 PM (12 days ago)
Author:
lnerger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • IncrementalAnalysisUpdates

    v4 v5  
    8080}}}
    8181
    82 
     82**Note:**
     83- (Added in the final release of PDAF V3.0): When using the EnOI modes (subtype 10 or 11), one has to set `dim_ens_l=1` and allocate `ens_inc` accordingly. Then `ens_inc` contains a single vector for the increment of the state vector.
    8384
    8485== Change the IAU configuration ==
     
    136137=== PDAF_iau_set_pointer ===
    137138
    138 With this routine the user can set a pointer to the PDAF-internal array of ensemble increments. This provides direct access to the increment array e.g. to analyze it or to write it into a file for restarting. The routine is different from `PDAF_iau_set_inc` in that here the user obtains access to the internal IAU array, while in `PDAF_iau_set_inc` one can only overwrite the internal array.
     139With this routine the user can set a pointer to the PDAF-internal array of ensemble increments. This provides direct access to the increment array e.g. to analyze it or to write it into a file for restarting. The routine is different from `PDAF_iau_init_inc` in that here the user obtains access to the internal IAU array, while in `PDAF_iau_init_inc` one can only overwrite the internal array.
    139140
    140141The routine can be called by each single process, but it only provides a pointer to the process-local part of the increment array. For domain-decomposed models, this array only includes the state vector part for the process domain. In addition, it usually only contains a sub-ensemble unless one uses the flexible parallelization mode with a single model task. For the fully parallel mode, the process(es) of a single model task only hold a single ensemble state.
     
    157158
    158159This routine is a replacement for `PDAF_iau_set_pointer` clarifying that it relates to the increment ensemble array.
    159 With this routine the user can set a pointer to the PDAF-internal array of ensemble increments. This provides direct access to the increment array e.g. to analyze it or to write it into a file for restarting. The routine is different from `PDAF_iau_set_inc` in that here the user obtains access to the internal IAU array, while in `PDAF_iau_set_inc` one can only overwrite the internal array.
     160With this routine the user can set a pointer to the PDAF-internal array of ensemble increments. This provides direct access to the increment array e.g. to analyze it or to write it into a file for restarting. The routine is different from `PDAF_iau_init_inc` in that here the user obtains access to the internal IAU array, while in `PDAF_iau_init_inc` one can only overwrite the internal array.
    160161
    161162The routine can be called by each single process, but it only provides a pointer to the process-local part of the increment array. For domain-decomposed models, this array only includes the state vector part for the process domain. In addition, it usually only contains a sub-ensemble unless one uses the flexible parallelization mode with a single model task. For the fully parallel mode, the process(es) of a single model task only hold a single ensemble state.
     
    177178(This routine is added in the final PDAF V3.0 release, while it's not present in V3.0beta)
    178179
    179 This routine is used in the EnOI modes (subtype 10 and 11) where only the state estimate is integrated. The routine allows the user to set a pointer to the PDAF-internal array of state vector increments. This provides direct access to the increment vector e.g. to analyze it or to write it into a file for restarting. The routine is different from `PDAF_iau_set_inc` in that here the user obtains access to the internal IAU array, while in `PDAF_iau_set_inc` one can only overwrite the internal array.
     180This routine is used in the EnOI modes (subtype 10 and 11) where only the state estimate is integrated. The routine allows the user to set a pointer to the PDAF-internal array of state vector increments. This provides direct access to the increment vector e.g. to analyze it or to write it into a file for restarting. The routine is different from `PDAF_iau_init_inc` in that here the user obtains access to the internal IAU array, while in `PDAF_iau_init_inc` one can only overwrite the internal array.
    180181
    181182The routine can be called by each single process, but it only provides a pointer to the process-local part of the increment vector. For domain-decomposed models, this array only includes the state vector part for the process domain.