MGS
A Problem of Legacy Code

MGS is a C library which is intended to embody the problem of "legacy code", provided by Diane O'Leary.

Legacy code is software that is useful, but out of date, not documented, not well understood, and in need of some new features.

When approaching legacy software, it's useful to try to come up with good documentation for what the program is doing, a set of test problems which must be correctly handled by any new version of the software, and a set of timing problems that can show whether changes to the software have improved its efficiency.

In this case, the student is challenged to make a copy of the source code, read it, try to work out what it is doing, document it, and come up with a nice set of examples illustrating what is going on. A student might also be interested in the task of creating an equivalent version in a different language, and then demonstrating that the two programs produce the same results.

Licensing:

The computer code and data files described and made available on this web page are distributed under the GNU LGPL license.

Languages:

MGS is available in a C version and a C++ version and a FORTRAN90 version and a MATLAB version.

Author:

Diane O'Leary.

Reference:

1. Dianne O'Leary,
   Computational Software: Writing Your Legacy, Partial Solution to Last Issue's Homework Assignment,
   Computing in Science and Engineering,
   Volume 8, Number 2, March/April 2006, pages 70-71.

Source Code:

• mgs.c, the original version of the software.
• mgs.h, an include file.

Examples and Tests:

• mgs_test.c, a set of tests for MGS.
• mgs_test.txt, the output file.

You can go up one level to the C source codes.