MITgcm/optim/flowchart_optim.txt


Flow chart for offline optimization based upon ECCO/MITGCMUV c27
################################################################
Patrick Heimbach, MIT 00/06/08

/data10/heimbach/ecco/ecco_c27/optim

   **********
   optim_main
   **********
    |
    |--- optim_numbmod (Get the number of control variables)
    |    |
    |    |--- (read data.<...>)
    |    |
    |    |--- optim_readdata.F (Read header of control vector)
    |    |
    |    |--- (Determine the total number of control variables)
    |    |
    |    o
    |
    |--- optim_sub (Call the subroutine)
    |    |
    |    |--- optim_initmod (Initialisize model and set first guess control variables)
    |    |
    |    |--- lsopt_top (Large scale optimization)
    |    |    |
    |    |    |--- ....
    |    |    |
    |    |    |--- simul (Call combined modified forward model and adjoint model)
    |    |    |    |
    |    |    |    |--- optim_readdata(ecco_ctrl) (instead of running the model online,...
    |    |    |    |--- optim_readdata(ecco_cost) ... read the data after offline run)
    |    |    |    |
    |    |    |    o
    |    |    |
    |    |    |--- ... (perform line search)
    |    |    |
    |    |    |--- optim_write_control (Write new control vector to file ecco_ctrl)
    |    |    |    |
    |    |    |    |--- optim_writedata (Write new control vector to file ecco_ctrl)
    |    |    |    |
    |    |    |    o
    |    |    |
    |    |    o
    |    |
    |    o
    |
    o


Interface between ECCO environment and offline line search lsopt:
################################################################

ECCO: the_model_main -> ctrl_finalise -> ctrl_pack:
      should write 2 files:
        - ecco_ctrl: xx_...     ok
        - ecco_cost: adxx_...   ok

LSOPT: optim_main -> optim_sub -> lsopt_top -> simul:
       should read 2 files:
        - ecco_ctrl: xx_...     ok
        - ecco_cost: adxx_...   ok

LSOPT: optim_main -> optim_sub -> lsopt_top -> optim_write_control::
       should write 1 file:
        - ecco_ctrl: xx_...     ok

ECCO: the_model_main -> initialise_fixed -> ctrl_init -> ctrl_unpack:
       should read 1 file:
        - ecco_ctrl: xx_...     ok


1	heimbach	1.1.2.1
2			Flow chart for offline optimization based upon ECCO/MITGCMUV c27
3			################################################################
4			Patrick Heimbach, MIT 00/06/08
5
6			/data10/heimbach/ecco/ecco_c27/optim
7
8			**********
9			optim_main
10			**********
11			\|
12			\|--- optim_numbmod (Get the number of control variables)
13			\| \|
14			\| \|--- (read data.<...>)
15			\| \|
16			\| \|--- optim_readdata.F (Read header of control vector)
17			\| \|
18			\| \|--- (Determine the total number of control variables)
19			\| \|
20			\| o
21			\|
22			\|--- optim_sub (Call the subroutine)
23			\| \|
24			\| \|--- optim_initmod (Initialisize model and set first guess control variables)
25			\| \|
26			\| \|--- lsopt_top (Large scale optimization)
27			\| \| \|
28			\| \| \|--- ....
29			\| \| \|
30			\| \| \|--- simul (Call combined modified forward model and adjoint model)
31			\| \| \| \|
32			\| \| \| \|--- optim_readdata(ecco_ctrl) (instead of running the model online,...
33			\| \| \| \|--- optim_readdata(ecco_cost) ... read the data after offline run)
34			\| \| \| \|
35			\| \| \| o
36			\| \| \|
37			\| \| \|--- ... (perform line search)
38			\| \| \|
39			\| \| \|--- optim_write_control (Write new control vector to file ecco_ctrl)
40			\| \| \| \|
41			\| \| \| \|--- optim_writedata (Write new control vector to file ecco_ctrl)
42			\| \| \| \|
43			\| \| \| o
44			\| \| \|
45			\| \| o
46			\| \|
47			\| o
48			\|
49			o
50
51
52			Interface between ECCO environment and offline line search lsopt:
53			################################################################
54
55			ECCO: the_model_main -> ctrl_finalise -> ctrl_pack:
56			should write 2 files:
57			- ecco_ctrl: xx_... ok
58			- ecco_cost: adxx_... ok
59
60			LSOPT: optim_main -> optim_sub -> lsopt_top -> simul:
61			should read 2 files:
62			- ecco_ctrl: xx_... ok
63			- ecco_cost: adxx_... ok
64
65			LSOPT: optim_main -> optim_sub -> lsopt_top -> optim_write_control::
66			should write 1 file:
67			- ecco_ctrl: xx_... ok
68
69			ECCO: the_model_main -> initialise_fixed -> ctrl_init -> ctrl_unpack:
70			should read 1 file:
71			- ecco_ctrl: xx_... ok
72
73
74
75
76