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
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