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

Diff of /manual/manual_todo.txt

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

revision 1.10 by cnh, Thu Apr 6 20:03:45 2006 UTC revision 1.14 by edhill, Thu Apr 6 20:14:48 2006 UTC
# Line 14  o HTML, scripts and front content Line 14  o HTML, scripts and front content
14    - pick a URL    - pick a URL
15      TBD      TBD
16    
   - mitgcm.org very front page.  
     o too many clicks to get to model manual.  
       make doc link go to mitgcm.org/r2_web_testing/latest  
       and add "HowTo" reference etc... to /latest page  
   
17    - mitgcm.org/r2_web_testing/latest    - mitgcm.org/r2_web_testing/latest
18      o add another short-cut for quick download      o add another short-cut for quick download
19    
# Line 298  in content: Horizontal Dissipation: 2 ti Line 293  in content: Horizontal Dissipation: 2 ti
293    to add: mention the angle of the grid direction relative to    to add: mention the angle of the grid direction relative to
294    Eastward, Northward direction.    Eastward, Northward direction.
295    + mention horizGridFile= in file "data" (PARM04)    + mention horizGridFile= in file "data" (PARM04)
296  - add cylindrical grid description  - add cylindrical polar grid description
297     need to do a better job of relating model variables to this diagram     need to do a better job of relating model variables to this diagram
298    
299    
# Line 348  in content: Horizontal Dissipation: 2 ti Line 343  in content: Horizontal Dissipation: 2 ti
343  - does not use std notation  - does not use std notation
344  - would be better as an appendix of section 2.20:  - would be better as an appendix of section 2.20:
345  (e.g changing the tile to:  (e.g changing the tile to:
346    - talk to Baylor
347   Appendix: non-dimensional Equations on Spherical-Polar grid.)   Appendix: non-dimensional Equations on Spherical-Polar grid.)
348    
349    
350  JM  JM
351    
352    
353    >>>> From Andrea
354    
355    Chapter 3
356    --------
357    
358    Almost all of the 'math mode' text is dropped down as subscripts
359    
360    divide chapter 3 more clearly into 2 sections?
361       (ie, 3.1-3.6 are more informational, 3.8- 3.18 are examples, and
362        then 3.19 and 3.20 are informational again - rearrange subsections?)
363    
364    3.1 - don't need a link to the outside of the document (remove it)
365        - link to htdig is broken
366    
367    3.2.1 - link at bottom to source code points to section 3.2.1
368       (ie, to itself) - link should point to cvs code archive
369    
370    3.2.2.1  - ('upgrading from an earlier version') belongs under
371          the cvs part, ie, should be 3.2.1.1
372    
373    3.3 - remove reference to 'diags' section under MITgcm
374        - remove reference to 'exe' and 'bin' sections also
375          (remove the .cvsignore file under these directories in cvs)
376        - add a 'jobs' section, and a description as examples of run scripts
377        - add 'lsopt', 'optim' and 'tutorial examples' with brief descriptions
378        - under 'tools' add a reference to 'build_options'. refer to the 'optfiles'
379        - under 'tools' the adjoint points to section 5 - this is now section 8
380          (but should be a floating reference)
381        - under 'utils' add a reference to exch2 - stuff for different resolutions
382        - the description of the pkg section refers directly to
383          section 3. should be section 6 (actually should be a floating reference)
384    
385    3.4 - refer to sections 3.8 - 3.18 (now says 3.8 - 3.10)
386    3.4.1 - links to the following experiments don't exist or are broken:
387              exp2 - should link to section 3.9
388              hs94.cs-32x32x5 - link to section 3.12
389              add 'convection' to the list, link to section 3.13
390              add 'plume on slope` to the list, link to section 3.14
391              add '??' link to section 3.15
392              add 'dic_example on slope` to the list, link to section 3.16
393              add '??' link to section 3.17
394              add 'offline' and link to section 3.18
395              clean up others and make links where they are needed
396    3.4.2 - text suggests to see section 2 for details about what is in the 'code'
397            and 'input' directories - should refer to the examples in this section
398          - add 'build' bullet - this is where the model is compiled and exectuable lives
399    
400    3.5 - add some little text when talking about 'optfiles' to refer to the tools/build_options
401          as the place where they live (add a link?)
402    
403    3.6.1 - Add some general 'approach' text - ie, output is controlled either by the
404            'data' file in the input directory or by the data.[pkg name] file for any
405            package running. And there is some default behavior when the 'state' dumps
406            are written.
407    3.6.1.2 - needs to be moved to inside section 3.6.2
408    
409    3.7 - this section is superfluous - remove it -OR- put the tutorial sections (3.8-3.18)
410          underneath this one and leave the text for 3.7 in place
411    
412    All the 'overview' sections need some reference to the name of the experiment in
413    the verification directory
414    
415    3.10 - in title, 4 degrees - degree symbol is a subscript, not a superscript
416         - is this experiment in the list from section 3.4???
417    3.10.3.1 - refers to figures and equations, links are broken
418    
419    3.11.3.2 - line 43: link to equation is broken
420             - line 51-53: link to equation is broken
421             - there is some mess of text hanging around the end of this section. remove? reformat?
422    
423    3.12.4.1 - line 34 - link to equation is broken
424             - lines 60,61 - 1st (take out the 'r' in the superscript)
425    
426    3.13.2 - link to theta-equation is broken
427    3.13.5.4 -- ALL of the bold links to variable names are broken
428                line 34: link to equation is broken
429    
430    3.15.1 - reference to 'fourth experiment' should be removed
431    
432    3.16.4 - strange formatting, presence of '>' symbols - remove them
433    
434    3.17.3 - unknown verification directory pointed to - also: no link from list in sec 3.4
435    3.17.3.1 - nothing filled in under file input/data - needs description
436    
437    3.18.2 - point to section 2 for details - need hyperlink
438    
439    3.19.1 - text (2 places) says that section 3.5 called for compile in 'input' directory - not true!
440             section 3.5 has the 'build' directory in the example
441    
442    3.20.1 - link to doc at end of section points to this section
443    3.20.2 - link to doc at end of section points to this section
444    
445         offline - duplicate inputs, what is it, tidy up cfc v.
446                   other offline. JM thinks these need tidying up.
447  >>>> From Ed  >>>> From Ed
448    
449  Here are the remaining bits for Chap 4 :  Here are the remaining bits for Chap 4 :
# Line 475  to do list for chap 7: Line 567  to do list for chap 7:
567    
568  andrea  andrea
569    
 >>>> From Andrea  
   
 Chapter 3  
 --------  
   
 Almost all of the 'math mode' text is dropped down as subscripts  
   
 divide chapter 3 more clearly into 2 sections?  
    (ie, 3.1-3.6 are more informational, 3.8- 3.18 are examples, and  
     then 3.19 and 3.20 are informational again - rearrange subsections?)  
   
 3.1 - don't need a link to the outside of the document (remove it)  
     - link to htdig is broken  
   
 3.2.1 - link at bottom to source code points to section 3.2.1  
    (ie, to itself) - link should point to cvs code archive  
   
 3.2.2.1  - ('upgrading from an earlier version') belongs under  
       the cvs part, ie, should be 3.2.1.1  
   
 3.3 - remove reference to 'diags' section under MITgcm  
     - remove reference to 'exe' and 'bin' sections also  
       (remove the .cvsignore file under these directories in cvs)  
     - add a 'jobs' section, and a description as examples of run scripts  
     - add 'lsopt', 'optim' and 'tutorial examples' with brief descriptions  
     - under 'tools' add a reference to 'build_options'. refer to the 'optfiles'  
     - under 'tools' the adjoint points to section 5 - this is now section 8  
       (but should be a floating reference)  
     - under 'utils' add a reference to exch2 - stuff for different resolutions  
     - the description of the pkg section refers directly to  
       section 3. should be section 6 (actually should be a floating reference)  
   
 3.4 - refer to sections 3.8 - 3.18 (now says 3.8 - 3.10)  
 3.4.1 - links to the following experiments don't exist or are broken:  
           exp2 - should link to section 3.9  
           hs94.cs-32x32x5 - link to section 3.12  
           add 'convection' to the list, link to section 3.13  
           add 'plume on slope` to the list, link to section 3.14  
           add '??' link to section 3.15  
           add 'dic_example on slope` to the list, link to section 3.16  
           add '??' link to section 3.17  
           add 'offline' and link to section 3.18  
           clean up others and make links where they are needed  
 3.4.2 - text suggests to see section 2 for details about what is in the 'code'  
         and 'input' directories - should refer to the examples in this section  
       - add 'build' bullet - this is where the model is compiled and exectuable lives  
   
 3.5 - add some little text when talking about 'optfiles' to refer to the tools/build_options  
       as the place where they live (add a link?)  
   
 3.6.1 - Add some general 'approach' text - ie, output is controlled either by the  
         'data' file in the input directory or by the data.[pkg name] file for any  
         package running. And there is some default behavior when the 'state' dumps  
         are written.  
 3.6.1.2 - needs to be moved to inside section 3.6.2  
   
 3.7 - this section is superfluous - remove it -OR- put the tutorial sections (3.8-3.18)  
       underneath this one and leave the text for 3.7 in place  
   
 All the 'overview' sections need some reference to the name of the experiment in  
 the verification directory  
   
 3.10 - in title, 4 degrees - degree symbol is a subscript, not a superscript  
      - is this experiment in the list from section 3.4???  
 3.10.3.1 - refers to figures and equations, links are broken  
   
 3.11.3.2 - line 43: link to equation is broken  
          - line 51-53: link to equation is broken  
          - there is some mess of text hanging around the end of this section. remove? reformat?  
   
 3.12.4.1 - line 34 - link to equation is broken  
          - lines 60,61 - 1st (take out the 'r' in the superscript)  
   
 3.13.2 - link to theta-equation is broken  
 3.13.5.4 -- ALL of the bold links to variable names are broken  
             line 34: link to equation is broken  
   
 3.15.1 - reference to 'fourth experiment' should be removed  
   
 3.16.4 - strange formatting, presence of '>' symbols - remove them  
   
 3.17.3 - unknown verification directory pointed to - also: no link from list in sec 3.4  
 3.17.3.1 - nothing filled in under file input/data - needs description  
   
 3.18.2 - point to section 2 for details - need hyperlink  
   
 3.19.1 - text (2 places) says that section 3.5 called for compile in 'input' directory - not true!  
          section 3.5 has the 'build' directory in the example  
   
 3.20.1 - link to doc at end of section points to this section  
 3.20.2 - link to doc at end of section points to this section  
   
      offline - duplicate inputs, what is it, tidy up cfc v.  
                other offline. JM thinks these need tidying up.  
   
570    
571  9. Model uses  9. Model uses
572     Spall, Gianmaria, Legg, Dewar, Cessi, Cournelle, Follows, Adcroft, etc...     Spall, Gianmaria, Legg, Dewar, Cessi, Cournelle, Follows, Adcroft, etc...

Legend:
Removed from v.1.10  
changed lines
  Added in v.1.14

  ViewVC Help
Powered by ViewVC 1.1.22