National Academies Press: OpenBook
« Previous: Model Documentation
Suggested Citation:"INTRODUCTION." National Research Council. 1991. Improving Information for Social Policy Decisions -- The Uses of Microsimulation Modeling: Volume II, Technical Papers. Washington, DC: The National Academies Press. doi: 10.17226/1853.
×
Page 333
Suggested Citation:"INTRODUCTION." National Research Council. 1991. Improving Information for Social Policy Decisions -- The Uses of Microsimulation Modeling: Volume II, Technical Papers. Washington, DC: The National Academies Press. doi: 10.17226/1853.
×
Page 334

Below is the uncorrected machine-read text of this chapter, intended to provide our own search engines and external engines with highly rich, chapter-representative searchable text of each book. Because it is UNCORRECTED material, please consider the following text as a useful but insufficient proxy for the authoritative book pages.

DOCUMENTATION FOR MICROSIMULATION MODELS: A REVIEW OF TRIM2, MATH, AND HITSM 333 10 Documentation for Microsimulation Models: A Review of TRIM2, MATH, and HITSM Kevin M.Hollenbeck INTRODUCTION As part of its investigation of microsimulation models, the Panel to Evaluate Microsimulation Models for Social Welfare Programs examined the extant documentation of three such models—TRIM2 (Transfer Income Model 2), MATH (Micro Analysis of Transfers to Households), and HITSM (Household Income and Tax Simulation Model). The precise documents examined are as follows: for TRIM2, Webb et al. (1982, 1986) and Bergsman (1989); for MATH, Doyle et al. (1989), Social & Scientific Systems, Inc. (n.d.), and Doyle (1989); and for HITSM, Lewin/ICF, Inc. (1988). In some ways one might presume that the panel was on firmer ground in this examination than in other aspects of its investigation. After all, few members of the panel have actually performed an application with a microsimulation model. But with the widespread use of personal computers for word processing, spreadsheet applications, and information retrieval through database packages, millions of individuals in professional, technical, and clerical occupations, including all of the panel's members, have navigated software documentation. Another common encounter with software documentation, particularly among Kevin M.Hollenbeck is senior economist at the W.E.Upjohn Institute for Employment Research; he served as a member of the panel.

DOCUMENTATION FOR MICROSIMULATION MODELS: A REVIEW OF TRIM2, MATH, AND HITSM 334 researchers and policy analysts, has come through use of statistical software packages. Nevertheless, because of the way that microsimulation has developed and been applied, comparison of microsimulation model documentation to personal computer software or statistical package documentation is not necessarily appropriate. This is because microsimulation models have, for the most part, been marketed by their developers as a service rather than a good. The prototypical transaction for microsimulation involves a sponsor purchasing the services of an analyst who specifies model parameters and changes for an applications programmer, who runs the model. The model is being constantly updated and changed. An analogy might be the purchase of insurance from an agent who uses a computer model to examine outcomes of different premiums, investment returns, and life tables. The audience for the documentation of that model, just like the audience for the documentation of microsimulation models (up to this point), is limited to the purveyors of the service. The purchaser of the service is expected to have little interest in the technical details, only the outcomes. From this perspective, then, the panel's seeming ability to evaluate documentation was severely constrained. The role of the panel is analogous to providing advice to the purchaser of insurance (or sponsor of microsimulation) concerning documentation of the computer model used by the insurance company's agent. In general, the panel's belief is that the better the documentation, the better the model and thus the more comfortable the purchaser should be with the model's outcomes.1 This chapter first establishes general criteria that can be used to evaluate documentation and then addresses the documents mentioned above for TRIM2, MATH, and HITSM. The final section evaluates all three sets of documentation based on an industry standard for software documentation. General conclusions from this review of the documentation are as follows: • In general, documentation can serve informational, instructional, or reference functions and must serve various audiences. Microsimulation model documentation in particular must cater to a wide range of backgrounds—from individuals with an interest in microsimulation but no technical expertise to policy analysts with technical expertise and programmers who might conduct an application or change a model in some manner. The TRIM2 documentation comes closest to serving these functions for all audiences; the HITSM documentation is intended primarily to provide information to a nontechnical audience. 1Of course, there are many reasons why this belief may be inaccurate. For example, one might argue that the best models are produced by the best technicians, who may not be skilled at producing good documentation. But recognition of the possibility of an inverse relationship between good programming and good documentation does not imply that low-quality documentation is evidence of high-quality programming!

Next: PURPOSES OF DOCUMENTATION AND EVALUATION CRITERIA »
Improving Information for Social Policy Decisions -- The Uses of Microsimulation Modeling: Volume II, Technical Papers Get This Book
×
Buy Paperback | $100.00
MyNAP members save 10% online.
Login or Register to save!
Download Free PDF

This volume, second in the series, provides essential background material for policy analysts, researchers, statisticians, and others interested in the application of microsimulation techniques to develop estimates of the costs and population impacts of proposed changes in government policies ranging from welfare to retirement income to health care to taxes.

The material spans data inputs to models, design and computer implementation of models, validation of model outputs, and model documentation.

  1. ×

    Welcome to OpenBook!

    You're looking at OpenBook, NAP.edu's online reading room since 1999. Based on feedback from you, our users, we've made some improvements that make it easier than ever to read thousands of publications on our website.

    Do you want to take a quick tour of the OpenBook's features?

    No Thanks Take a Tour »
  2. ×

    Show this book's table of contents, where you can jump to any chapter by name.

    « Back Next »
  3. ×

    ...or use these buttons to go back to the previous chapter or skip to the next one.

    « Back Next »
  4. ×

    Jump up to the previous page or down to the next one. Also, you can type in a page number and press Enter to go directly to that page in the book.

    « Back Next »
  5. ×

    To search the entire text of this book, type in your search term here and press Enter.

    « Back Next »
  6. ×

    Share a link to this book page on your preferred social network or via email.

    « Back Next »
  7. ×

    View our suggested citation for this chapter.

    « Back Next »
  8. ×

    Ready to take your reading offline? Click here to buy this book in print or download it as a free PDF, if available.

    « Back Next »
Stay Connected!