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:

SUBROUTINE SURFCE 1,30
!@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.

Advertisements

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

2 Comments »

  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:

WordPress.com Logo

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

Twitter picture

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

Facebook photo

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

Google+ photo

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

Connecting to %s

%d bloggers like this: