Configuration

Running EnOI data assimilation code requires an configuration file as input (assim.input in your distribution package). This file looks like this and is split below for a basic recap of the various settings.

... WRITE YOUR COMMENTS BELOW...

Ensemble description :
copie du persian pour tests amont version polychromatique
test toutes perturbations sauf OBC
M2 M4


... DO NOT REMOVE NEXT LINE...
end comments

header section: for user’s convenience only

16                                                                                                   !  twin experiment option flag (NONE|#)

run mode: sets the run mode. Alternates are DRY for a dry-run mode, # for a twin-experiment (# is the control run taken from the ensemble runs) and NONE for a realistic experiment.

M2 M4                                                                                            !  Tidal constituent list

tidal constituents list: sets the list of tidal constituent(s) to be processed. Polychromatic coupling is applied unless NO_COUPLING code building.

../../data/persian-gulf.nei                                                                !  Ensemble mesh file

mesh file: sets the common mesh file name for all ensemble runs.

../../data/topo.s2r                                                                           !  Ensemble topo file

topography file: sets the topography file name.

20                                                                                                  !  Number of members in ensemble

ensemble size: sets the ensemble dimension.

../../ensemble_topo-DGP1xLGP2/membre                                     !  Ensemble root name

ensemble runs rot name: sets the ensemble runs archiving directory root name.

WAVE.spectral.nc                                                                           !  Ensemble elevation solutions naming convention WAVE.spectral.nc                                           !  Ensemble velocities solutions naming convention

naming conventions: sets the naming conventions for ensemble runs solutions in tidal elevations and velocities. WAVE and/or ITERATION are respectively replaced by the tidal constituents and harmonic analysis solution processed.

09                                                                                                   !  Analysis number

harmonic analysis: sets the analysis solution to be used for ensemble runs.

DGP1xLGP2                                                                                   !  FE description

finite elements description: sets the finite elements pair describing ensemble runs. Available pairs are LGP0xLGP1, LGP1xLGP1, DGP1xLGP2.

../../data/persian-gulf.nei                                                                 !  Prior mesh file

mesh file: sets the mesh file name for prior solution.

../../spectral-gridded-DGP1xLGP2/                                                 !  Prior solution ("path"|NONE)

prior solution: sets the path to prior solution archiving directory.

WAVE.spectral.nc                                                                           !  Prior solution elevation naming convention WAVE.spectral.nc                 
                                                                                                       !  Prior solution velocity naming convention

naming conventions: sets the naming conventions for prior solution in tidal elevations and velocities. WAVE and/or ITERATION are respectively replaced by the tidal constituents and harmonic analysis solution processed.

09                                                                                                   !  Analysis number for prior solution

harmonic analysis: sets the analysis solution to be used for prior solution.

DGP1xLGP2                                                                                   !  FE description for prior solution

finite elements description: sets the finite elements pair describing ensemble runs. Available pairs are LGP0xLGP1, LGP1xLGP1, DGP1xLGP2.

../../obs/c-error/M2.obs                                                                   !  Observation file wave 1../../obs/c-error/M4.obs
                                                                                                       !  Observation file wave N

observation file(s): sets the observation file(s) corresponding to the tidal constituents to be processed.

NONE ../obs/test.plg                                                                       !  Filter polygone (file name| NONE )

polygone file: sets the polygone file defining the geographical area where observations are selected. NONE discards the option.

NONE geo-toponyms-18.grd                                                          !  Filter toponyms map (file name| NONE )

toponyms file: sets the toponyms map file defining the geographical area where observations are selected. NONE discards the option.

0                                                                                                    !  Observation additional error flag (0|1)0.05 0                               
                                                                                                      !  Observation additional errors [units: m and °]

additional error option: allows(1)/denies(0) an additional error in amplitude and phase lag to all observations.

0                                                                                                    !  Observation selection flag (0|1)0.9
                                                                                                      !  Observation selection correlation20                                    
                                                                                                      !  Observation selection distance [km]50                                   
                                                                                                      !  Observation selection tide constants similar at N percent

observation selection option: allows(1)/denies(0) observations are restricted to correlation, distance and likeliness parameter values.

8000                                                                                              !  Correlation radius maximum length(en km) R-LINEAR                                                  
                                                                                                      !  Covariance function (MODEL NAME | NONE)

observations decorrelation: sets the observation decorrelation length and model. Available models are linear (R-LINEAR, R-STEP), sinusoidal (R-COSINE), exponential (R-EXPONENTIAL, R-EXPONENTIAL-TRUNCATED), spheric (R-SPHERICAL), gaussian (R-GAUSSIAN, R-GAUSSIAN-TRUNCATED, R-GAUSSIAN-DAMPED), polynomial-exponential based from Arhan et Colin de Verdière, JPO, 1985 (R-ARHAN85). NONE or a negative distance discards the option.

1                                                                                                    !  Model units scale factor (default value is 1)

model units scaling: sets the model units scale factor

3.2                                                                                                 !  Model error scale factor (default value is 1)

model error scaling: sets the model error scale factor

1                                                                                                    !  Currents assimilation flag (0|1)

currents analysis option: allows(1)/denies(0) the use of model tidal velocities covariance information.

1                                                                                                    !  Compute penalty function (0|1)

penalty function option: allows(1)/denies(0) the computation of observation and prior/analysis model penalty function.

CHOLESKY                                                                                   !  Solver Type

solver type: sets the algorithm for assimilation system resolution and inverse computation of matrices. Alternates are CHOLESKY or LU.

1                                                                                                    !  Save elevation correction (0|1)1                                     
                                                                                                      !  Save currents correction (0|1)

analysis increments save options: allows(1)/denies(0) saving analysis increments for tidal elevation and velocities.

1                                                                                                    !  Save ensemble mean (0|1) 1    
                                                                                                      !  Save ensemble variance (0|1)

ensemble statistice save options: allows(1)/denies(0) saving ensemble means and variances for tidal elevation and velocities.

1                                                                                                    !  Save assimilated observations (selected.obs) (0|1)

observations save option: allows(1)/denies(0) saving observations used for the data assimilation run.

0                                                                                                    !  Save assimilation matrices (0|1)

matrix save option: allows(1)/denies(0) saving covariances matrices for both model and observations errors.

0                                                                                                    !  Save observations domain of influence (ASCII only, doi.s2r) (0|1)

domain of influence save option: allows(1)/denies(0) saving individual observation domain of influence.

0                                                                                                    !  Compress members solution (0|1)

archiving ensemble mode: allows(1)/denies(0) the use of compressed archives for ensemble runs solutions

1                                                                                                    !  Internal check mode (0|1)

internal check option: allows(1 or more)/denies(0) data assimilation run internal checks.

1                                                                                                    !  Additional diagnostic mode (0|1)

diagnostic mode option: allows(1)/denies(0) additional run diagnostics.

1                                                                                                    !  Verbose mode (0|1)

verbose mode option: allows(1)/denies(0) data assimilation run messages

2                                                                                                    !  Parallel mode CPUs (NONE | N)

parallel mode: sets the number of CPU(s) to be requested for parallel mode data assimilation run, provided a parallel code building.

Search