Models Methods Software

Dan Hughes

Coding Guidelines and Inline Documentation: GISS ModelE

Here’s an example of what a lack on coding guidelines (or ignoring them) can lead to. From the NASA/GISS ModelE online source code browser:

!@sum SURFCE calculates the surface fluxes which include
!@+ sensible heat, evaporation, thermal radiation, and momentum
!@+ drag. It also calculates instantaneous surface temperature,
!@+ surface specific humidity, and surface wind components.
!@auth Nobody will claim responsibilty

This is the entire header information for a 1228-line routine.

The last line says it all.


August 9, 2007 - Posted by | Uncategorized | , , ,


  1. Pardon me if this Should Be Obvious: is there a known technique for getting ModelE to compile under any open source Fortran compiler?

    Comment by sondbax | December 4, 2007 | Reply

  2. […] Coding Guidelines and Inline Documentation […]

    Pingback by Coding Standards Finally Appear « Models Methods Software | November 8, 2010 | Reply

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: