/[MITgcm]/manual/manual_todo.txt
ViewVC logotype

Contents of /manual/manual_todo.txt

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph


Revision 1.2 - (show annotations) (download)
Thu Apr 6 00:48:34 2006 UTC (18 years ago) by molod
Branch: MAIN
Changes since 1.1: +1 -4 lines
File MIME type: text/plain
Remove a line from section 7 because the task was finished

1 Rebuild and set to do cron build
2
3 To do
4
5 - where to put under development links?
6
7 - mitgcm.org very front page.
8 o too many clicks to get to model manual.
9 make doc link go to mitgcm.org/r2_web_testing/latest
10 and add "HowTo" reference etc... to /latest page
11
12 - mitgcm.org/r2_web_testing/latest
13 o add another short-cut for quick download
14
15 o add another short-cut
16 About
17 Installation
18 Contents
19 Overview
20 Tutorials (broken)
21 Browse Code
22 Get Code (where does this go to?)
23
24 o authors
25 John, Alistair, Jean-Michel, Patrick, Andrea, Steph, Helen,
26 Martin, Baylor, Dimitris, David, Ed, Mick, Chris, Constantinos,
27 Gael - others?
28
29 o Tutorials side bar link is broken
30
31 o words
32 change to "access on-line Auser manual/A and Atable of contents/A
33 and browse the Aoverview section/A"
34
35 o finite-volume doesn't leap to FV figure
36
37 o date is 2002
38
39 o fix search so it doesn't include advertisements
40
41 o the src and equation links don't come through to
42 the html when they are in figures - see chapter 2 for some
43 examples.
44
45 o degree symbols keep getting "dropped down" - problem with
46 pnmcrop et al.
47
48
49 Contents
50
51 Intro - CNH
52 o single kernel diagram -
53 add reference to MWR paper
54
55 o non-hydro
56 add reference to 1995 and 1999 papers
57 pdf of 1995 paper
58
59 o FV
60 add references to 1997 papers.
61
62 o Tangent linear/adjoint add reference to
63 Heimbach papers, Marotzke, 1998 ECMWF, Bugi etc...
64
65 o platforms
66 Add reference to SC article and Scientific Programming article
67
68 o List of key papers needs to be updated and reformatted
69
70
71 o Global atmosphere: `Held Suarez',
72 update Adcroft reference
73 fix up ingrid link and frame (ingrid movies seem to be broken?)
74 Held and Suarez reference is not a link.
75
76 o Ocean Gyres
77 fix up frame link
78 make "lopped cell" a link to referenced paper.
79 add references (ask Steph/Mick)
80 online/offline paper
81
82 o Convection and mixing over topography
83 add in Legg references for convection and mixing over topography
84 and external link to CPT-GCE etc...
85
86 o Boundary forced internal waves
87 add in Legg references, obc's reference
88
89 o Parameter sensitivity
90 add in Bugnion references, Boyin references, Steph references
91
92 o State estimation
93 add in references from Patrick/Carl/Ichiro/Detlef etc...
94 update links to point to latest ECCO results
95 ECCO ingrid results have been moved
96 add forward links to "ECCO state estimation" chapter in manual
97
98 o Ocean biogeochemical cycles
99 add in references from Mick/Galen etc...
100 fix ingrid link ( date to date thing does not appear to work)
101 figure url does not have a "target=idontexist" entry
102
103 o Simulations of laboratory experiments
104 reference Wardle and Karsten papers
105 update links to include DDDAS "PIAB" page
106 cylindrical polar coordinates
107
108 o Continuos equations in ''r'' coordinates
109 add references to iso paper
110 no mention of z* and p* - forward reference to z*/p* in 2.
111 add that coupling also manifests through F, Q
112 add tracer transport
113
114 o Kinematic boundary conditions
115
116 o Hydrostatic, Quasi-hydrostatic, Quasi-nonhydrostatic and Non-hydrostatic forms
117 need to tidy up discussion of shallow-atmosphere to be
118 consistent with the code or change code to be consistent
119 with the discussion!
120 make references hyperlinks
121 add stuff too
122
123 o Finding the pressure field
124 make references hyperlinks
125 add forward references to manual algorithm section
126 change Elliptic to "elliptic"
127
128 o Forcing and dissipation
129 make "physics packages" refer to chapter 6.
130 should we move "external forcing" et. al to a
131 generic_forcing_driver package?
132
133 viscosities
134 update to mention Smag/Leith (Ah and A4 not constant)
135 and to have forward references to numerical section
136 tracers
137 forward references to numerical section, reddy, GM etc...
138 add references to literature
139
140 o 1.3.8 Vector invariant form
141 forward references to numerical section
142
143 o 1.3.9 Adjoint
144 add a little more here + some hyperlink to chapter 5.
145
146 o 1.4 Appendix ATMOSPHERE
147
148 add some introductory words
149
150 o 1.6 Coordinate systems
151 o only has some words on spherical polar. add some brief words
152 to cover all of
153 - cartesian
154 - spherical
155 - cylindrical
156 - general orthogonal curvilinear (vector invariant)
157
158 o Equation of state options
159 add some discussion
160 can't remember what we said we were going to do here
161 PH to do something
162
163
164 Discretization and alg - JMC+CNH
165
166 Tutorials - AM
167 3.1 "Where to find"
168 o link to Pelican not needed
169 o mailman twice (why?)
170 o no htdig (gone? - I liked it)
171
172 intro part
173 individual experiments
174
175 offline - duplicate inputs, what is it, tidy up cfc v.
176 other offline.
177
178 Software - EH to review
179
180 some to be done on resource estimates at the end - needs sorting.
181
182 Automatic Diff - CE
183
184 Physical Packages - ???
185
186 Diags and tools - ???
187
188 Interface with ECCO - ???
189
190 Model uses - ???
191
192 Building document - ???
193 via cron
194 tweaking latex2html etc..
195
196 Src Code tree (rename
197 examples etc..) - ???
198
199 Documentation
200
201 1. Introduction
202
203 2. Discretization and Algorithm
204
205 2.13.5 Lateral dissipation
206 o need to relate c11, c12 etc.. to COSFAC, USE_COS etc... flags
207 in code need to explain why cos()3/2 turns out to be
208 scaling (not cos()2)
209
210 2.13.6 Vertical dissipation
211 o update to have reference to Baylors section
212 reference to implicit discussion in time-stepping part of manual
213
214
215
216 3. Tutorials
217 reorg'd into
218 intro part
219 individual experiments
220
221 4. Software Architecture
222
223 5. Automatic Differentiation
224
225 6. Physical Parameterization and Packages
226
227 7. Diagnostics and tools
228
229 8. Interface with ECCO
230
231 9. Model uses
232 Spall, Gianmaria, Legg, Dewar, Cessi, Cournelle, Follows, Adcroft, etc...
233 (check in support for more names)
234
235 Need an empty package as part of distribution
236
237 latex2html equation formatting is still a bit weird in places. Need to have another go if we have a chance - especially the degree symbol seems to jump around somewhat!
238
239 Chapter 1
240
241 Change hydrodynamical to "dynamical"
242
243 Examples
244
245 - extra "in action" cases
246
247 o high res ocean with diurnal atmospheric state forcing
248 - links to ingrid output
249 CNH/Dimitris
250
251 o realistic FIZHI from Andrea
252 - links to ingrid output
253 from AM
254
255 o with seaice on high res cube
256 - links to ingrid output
257 CNH/Dimitris
258
259 o coupled aqua, ridge world etc...
260 - links to ingrid output
261 get stuff from Daniel
262
263 o constrained lab simulation
264 - links to ingrid output for model and lab
265 fields
266 get stuff from Sai/Andrew
267
268 o sensitivity wrt to iron
269
270 o optimization
271 - update to link to latest ECCO sites and GF
272 related material
273
274 o eddy diffusivity transport application
275
276 o Gas giant?
277
278 Chapter 6
279
280 the master package diagram does not appear in the document
281
282 pkg/ptracers doesn't seem to have any documentation (see packages list below)
283
284
285
286 2.10.5 Horizontal grid
287
288 need to do a better job of relating model variables to this diagram
289
290
291 Master list of packages
292
293 admtlm/ - autodiff (chapter 5)
294 aim/ - 6.4.1 (content needs fixing - JM to do)
295 aim_compon_interf/ - 6.6 (no content yet)
296 aim_ocn_coupler/ - 6.6 (no content yet)
297 aim_v23/ - retired
298 atm_common/ - 6.6 (no content yet)
299 autodiff/ - autodiff (chapter 5)
300 bulk_force/ - 6.3.3
301 cal/ - 6.3.5
302 cd_code/ - chapter 2 (JM check)
303 cfc/ - not sure
304 chronos/ - AM to check
305 compon_communic/ - 6.6 (no content yet)
306 cost/ - not sure, check with PH
307 ctrl/ - not sure, check with PH
308 debug/ - JM may do something in chapter 7 (utilities)
309 diagnostics/ - 7.1
310 dic/ - 6.7.2
311 ebm/ - not sure
312 ecco/ - chapter 8
313 embed_files/ - add something to chapter 7
314 ex3/ - rename to exch3
315 exch2/ - 6.2.2
316 exf/ - 6.3.4
317 fizhi/ - 6.4.3
318 flt/ - in chapter 2 (JM check)
319 gchem/ - 6.7.1
320 generic_advdiff/ - in chapter 2 (JM check)
321 ggl90/ - nothing, (Martin?)
322 gmredi/ - in chapter 2 (JM check). also need
323 Ferrari & Mc tapering
324 grdchk/ - grdchk (chapter 5 - check with PH)
325 gridalt/ - 6.2.4
326 kpp/ - 6.3.2
327 land/ - 6.4.2 (not connected to code - JM to fix)
328 matrix/ - Samar
329 mdsio/ - 7.3.1
330 mnc/ - 7.2.1
331 mom_common/ - in chapter 2 (JM check)
332 mom_fluxform/ - in chapter 2 (JM check)
333 mom_vecinv/ - in chapter 2 (JM check)
334 monitor/ - 7.4
335 my82/ - nothing, (martin?)
336 obcs/ - 6.3 (needs a check)
337 ocn_compon_interf/ - 6.6 (no content yet)
338 offline/ - nothing, tutorials that need work but no package section entry
339 opps/ - nothing, (martin?)
340 pp81/ - nothing, (martin?)
341 profiles/ - GAEL
342 ptracers/ - JM + SD to write something
343 rbcs/ - talk to steph
344 runclock/ - runclock
345 rw/ - not sure
346 sbo/ - text in sbo_descruption.tex but not linked into
347 part6
348 seaice/ - 6.5.2 - no equations, dimitris has promised some
349 shap_filt/ - chapter 2, JM to check
350 shelfice/ - nothing yet (martin?)
351 solver/ - empty
352 sphere/ - chapter 5 or 8 (PH to check)
353 therm_seaice/ - empty
354 thsice/ - 6.5.1 (JM to update?)
355 timeave/ - retiring......
356 zonal_filt/ - chapter 2 (JM to check)
357
358 Possible for chap 7 - Daniels grafix/ stuff
359
360 Need to get packages to contain their available diagnostics (i.e. calls to DIAGNOSTICS_ADD). these are listed in stdout when pacakages are started.
361
362 Figure 6.8 is missing
363
364
365 >>>> From Ed
366
367 Here are the remaining bits for Chap 4 :
368
369 - The grammar/flow could still use some work. Boo was an English
370 major and has experience editing/proofing technical papers. I
371 could print out a copy and ask her to read it and suggest
372 improvements.
373
374 - missing references (if you point me towards URLs, I'll add them
375 to the bibliography):
376 \ref{ref hoe and hill, ecmwf}
377 \ref{magicgarden}
378 \ref{IBMLAPI}
379 \ref{Memorychannel}
380 \ref{hoe-hill:99}
381
382 - There are a few empty sub-sections at the end of Chap 4 that
383 should either be commented out or fleshed out.
384
385 and thats about it for Chap 4.
386
387
388 Add more to quick links on front page
389
390
391 >>>> From Andrea
392
393 to do list for chap 7:
394
395
396 7.1.1 - links to section 7.1.4: the text of the first one should read "see MITgcm Kernel Diagnostics Menu"
397 the links are pointing to the proper place
398
399 7.5.1 - add Graphix to the list of stuff in utils/matlab
400 7.5.2 - empty
401
402
403 andrea
404
405 >>>> From Andrea
406
407 Chapter 3
408 --------
409
410 Almost all of the 'math mode' text is dropped down as subscripts
411
412 divide chapter 3 more clearly into 2 sections?
413 (ie, 3.1-3.6 are more informational, 3.8- 3.18 are examples, and
414 then 3.19 and 3.20 are informational again - rearrange subsections?)
415
416 3.1 - don't need a link to the outside of the document (remove it)
417 - link to htdig is broken
418
419 3.2.1 - link at bottom to source code points to section 3.2.1
420 (ie, to itself) - link should point to cvs code archive
421
422 3.2.2.1 - ('upgrading from an earlier version') belongs under
423 the cvs part, ie, should be 3.2.1.1
424
425 3.3 - remove reference to 'diags' section under MITgcm
426 - remove reference to 'exe' and 'bin' sections also
427 (remove the .cvsignore file under these directories in cvs)
428 - add a 'jobs' section, and a description as examples of run scripts
429 - add 'lsopt', 'optim' and 'tutorial examples' with brief descriptions
430 - under 'tools' add a reference to 'build_options'. refer to the 'optfiles'
431 - under 'tools' the adjoint points to section 5 - this is now section 8
432 (but should be a floating reference)
433 - under 'utils' add a reference to exch2 - stuff for different resolutions
434 - the description of the pkg section refers directly to
435 section 3. should be section 6 (actually should be a floating reference)
436
437 3.4 - refer to sections 3.8 - 3.18 (now says 3.8 - 3.10)
438 3.4.1 - links to the following experiments don't exist or are broken:
439 exp2 - should link to section 3.9
440 hs94.cs-32x32x5 - link to section 3.12
441 add 'convection' to the list, link to section 3.13
442 add 'plume on slope` to the list, link to section 3.14
443 add '??' link to section 3.15
444 add 'dic_example on slope` to the list, link to section 3.16
445 add '??' link to section 3.17
446 add 'offline' and link to section 3.18
447 clean up others and make links where they are needed
448 3.4.2 - text suggests to see section 2 for details about what is in the 'code'
449 and 'input' directories - should refer to the examples in this section
450 - add 'build' bullet - this is where the model is compiled and exectuable lives
451
452 3.5 - add some little text when talking about 'optfiles' to refer to the tools/build_options
453 as the place where they live (add a link?)
454
455 3.6.1 - Add some general 'approach' text - ie, output is controlled either by the
456 'data' file in the input directory or by the data.[pkg name] file for any
457 package running. And there is some default behavior when the 'state' dumps
458 are written.
459 3.6.1.2 - needs to be moved to inside section 3.6.2
460
461 3.7 - this section is superfluous - remove it -OR- put the tutorial sections (3.8-3.18)
462 underneath this one and leave the text for 3.7 in place
463
464 All the 'overview' sections need some reference to the name of the experiment in
465 the verification directory
466
467 3.10 - in title, 4 degrees - degree symbol is a subscript, not a superscript
468 - is this experiment in the list from section 3.4???
469 3.10.3.1 - refers to figures and equations, links are broken
470
471 3.11.3.2 - line 43: link to equation is broken
472 - line 51-53: link to equation is broken
473 - there is some mess of text hanging around the end of this section. remove? reformat?
474
475 3.12.4.1 - line 34 - link to equation is broken
476 - lines 60,61 - 1st (take out the 'r' in the superscript)
477
478 3.13.2 - link to theta-equation is broken
479 3.13.5.4 -- ALL of the bold links to variable names are broken
480 line 34: link to equation is broken
481
482 3.15.1 - reference to 'fourth experiment' should be removed
483
484 3.16.4 - strange formatting, presence of '>' symbols - remove them
485
486 3.17.3 - unknown verification directory pointed to - also: no link from list in sec 3.4
487 3.17.3.1 - nothing filled in under file input/data - needs description
488
489 3.18.2 - point to section 2 for details - need hyperlink
490
491 3.19.1 - text (2 places) says that section 3.5 called for compile in 'input' directory - not true!
492 section 3.5 has the 'build' directory in the example
493
494 3.20.1 - link to doc at end of section points to this section
495 3.20.2 - link to doc at end of section points to this section
496
497 >>>> from JM
498
499
500
501 manual, section.2 :
502
503 In general:
504 - add more refences/links to S/R & variable name
505 - would be nice to have an active link to the fortran-file
506 for all the S/R & eq.Number in the "calling-tree" boxes
507 - search for CALC_MOM_RHS and replace it by the appropriate S/R
508 (mom_flux_form, mom_vecinv, dynamics)
509 - Problem with notation: in section.1 \vec{\bf v_h} (or \vec{\mathbf{v}}_{h})
510 was used for the horizontal velocity vector, and the 3.D vector was \vec{\mathbf{v}}
511 in section.2, \vec{\bf v} is used instead and 3.D velocity vector is
512 simply written \vec{v}.
513 I would suggest to keep the notation as they are (since they are consistent
514 inside each section) but may be to move the "notation.tex" piece
515 at the beginning of section.2 and to mention clearly the changes between
516 the 2 sections.
517
518 in content: Horizontal Dissipation: 2 times in vector-invariant section
519
520 2.1 time-stepping (part2/time_stepping.tex)
521
522 - this is not clear to me:
523
524 >> In all the above configurations it is also possible to substitute the
525 >> Adams-Bashforth with an alternative time-stepping scheme for terms
526 >> evaluated explicitly in time
527
528
529 2.2 rigid-lid:
530
531 - At some point, would be better to replace "g \eta" with "\Phi_s (cg2d_x)"
532 to stay closer to the code.
533 - mention section 2.5 implicit-Time-stepping (for vertical viscosity)
534
535 2.3 linear free-surface:
536 - add ref(+link) to S/R names:
537 - add ref(+link) to Crank-Nickelson section 2.9.1
538
539 2.4 Adams-Bashforth
540 - add stability diagrams (I have some figures that I can put)
541 - add link for var. forcing_In_AB
542 - add S/R link for S/R ADAMS_BASHFORTH2
543
544 2.5 Implicit time-stepping
545 - add name of S/R: IMPLDIFF, GAD_IMPLICIT_R, MOM_U_IMPLICIT_R
546 SOLVE_TRIDIAGONAL, SOLVE_PENTADIAGONAL
547 - update: also used for vertical advection
548
549 2.6 Synchronous time-stepping:
550 - add link for S/R THERMODYNAMICS, DYNAMCIS, SOLVE_FOR_PRESSURE,
551 MOMENTUM_CORRECTION_STEP.
552
553 2.7 Stagger baroclinic time-stepping
554 - mention AB(T,S) instead of AB(Gt,Gs) (in development) at the end
555
556 2.8 NH
557 - add link & S/R names: CALC_GW, SOLVE_FOR_PRESSURE, CG3D
558
559 2.9 Variants on Free-Surface
560 - Delta.t mis-written (eq.2.73)
561 - Eq.Num missing (has been fixed since)
562 - u* is stored in gU (and not in gUnm1)
563 - Phi_nh in NH_VARS.h
564 - add link to S/R file: SOLVE_FOR_PRESSURE, CALC_DIV_GHAT, CG2D, CG3D,
565 INI_CG2D, INI_CG3D
566
567 2.9.1 Crank-Nickelson
568 - link for variable: implicSurfPress, implicDiv2DFlow, useRealFreshWater
569
570 2.9.2 NLFS
571 - eq.Nb are wrong in html
572 - 2.9.2.4 : set of eq. appears wrong in html (but right in .dvi)
573
574 2.10.1 Notation
575 - Area definition is not really used like this
576
577 >> Ao : Area of the face orthogonal to "o" direction (o=u,v,w)
578
579 Instead, in the following section, Ac,Aw,As,A_zeta (= corresponding to
580 the model variables) are used (e.g., see section 2.10.5)
581
582 2.10.5 Horizontal grid:
583 - fig.2.8 : should use Aw,As consistently in this figure description,
584 in the figure itself, as it is in the text.
585 - curvilinear:
586 to add: mention the angle of the grid direction relative to
587 Eastward, Northward direction.
588 + mention horizGridFile= in file "data" (PARM04)
589 - add cylindrical grid description
590
591 2.11 Continuity & Horizontal Pressure gradient terms
592 - mention that d.Phi/dr|s =g if using z coordinate
593 - eq. 2.90 not clear regarding \delta_k(P-E)
594 better to add the free surface eq: d.eta/dt = w_s + P-E
595
596 2.12 Hydrostatic balance
597 - add ref to Atmosphere Appendix section (1.4) since Adcroft 2002
598 is hard to find
599 - add ref to section 1.3.4 (Hydrostatic, Quasi-Hydrostatic & Non-H)
600 and in section 1.3.4: remove the 1.3.4.3.2 subsection:
601 Quasi-nonhydrostatic Atmosphere
602
603 2.13.2 Coriolis terms
604 - note: the discretization used when useEnergyConservingCoriolis=T
605 has no hFac and no Area and is still different from the form
606 described here (with Area & hFac);
607
608 2.13.5 Lateral dissipation
609 - add description of how to use cosFactor & cosPower
610 - add the parameter correspondence: Ah <-> viscAh ; A4 <-> viscA4
611
612 2.13.6 Vertical dissipation
613 - mention the implicit vertical viscosity option and ref to section 2.5
614 - add the parameter correspondence: Av <-> viscAr (and might change also
615 the notation to Ar)
616
617 2.14 Vector invariant momentum equations
618 - indicate that the NH pieces (vertical momentum eq) are not yet coded
619 and that the NH code uses the flux form.
620
621 2.14.6 Horizontal dissipation -> Horizontal Divergence
622
623 2.14.7 Horizontal dissipation
624 - add the parameter correspondence: A_D,A_z <-> viscAhD,viscAhZ
625 and A_D4,A_z4 <-> viscA4D,viscA4Z
626
627 2.16 & 2.17 & 2.18 :
628 - add 1rst Order upwind option & DST-2 (Lax-Wendroff) options
629
630 2.20.2 mercator, non-dimensional Equations:
631 - does not use std notation
632 - would be better as an appendix of section 2.20:
633 (e.g changing the tile to:
634 Appendix: non-dimensional Equations on Spherical-Polar grid.)
635
636 JM
637

  ViewVC Help
Powered by ViewVC 1.1.22