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.