World Soil Resources Reports71/7
Agro-ecological land Resources Assessment for agricultural Development Planning - A case Study of Kenya- Technical Annex 7

Technical Annex 7

Systems Documentation Guide to Computer Programs for Land Productivity Assessments

A.H. Kassam, H.T. van Velthuizen, G.W. Fischer and M.M. Shah

Any part of this set of computer programs and the corresponding data sets may be modified in the light of new knowledge and/or new objectives. The model is part of a larger district and national planning tool and is expected to be expanded and refined with use.

The designations employed and the presentation of material in this publication do not imply the expression of any opinion whatsoever on the part of the Food and Agriculture Organization of the United Nations or IIASA concerning the legal or constitutional status of any country, territory, city or area of land or sea or of its authorities, or concerning the delimitation of its frontiers or boundaries.

ISBN 92-5103435-4

All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying or otherwise, without the prior permission of the copyright owner. Applications for such permission, with a statement of the purpose and extent of the reproduction, should be addressed to the Director, Publications Division, Food and Agriculture Organization of the United Nations, Viale delle Terme di Caracalla, 00100 Rome, Italy.

Land and Water Development Division
Food and Agriculture Organization of the United Nations
International Institute for Applied Systems Analysis

© FAO1993

Hyperlinks to non-FAO Internet sites do not imply any official endorsement of or responsibility for the opinions, ideas, data or products presented at these locations, or guarantee the validity of the information provided. The sole purpose of links to non-FAO sites is to indicate further information available on related topics.

This electronic document has been scanned using optical character recognition (OCR) software. FAO declines all responsibility for any discrepancies that may exist between the present document and its original printed version.



1.1   About This Technical Annex

1.2   Overview of the AEZ-CCS Software Package

1.3   Program Flow and Sub-Program Definitions

1.3.1     Program Flow Charts

1.3.2     Sub-Program Definitions


2.1   Program Logic and Overview

2.2   Input/Output File Sizes and Connections

2.3   Subprogram Description

2.4   Program Control Data, File CTRL01

2.5   AEZ Productivity Assessment Parameters, File RULES

2.5.1     CC - Card: Cash Crop LGP Allocation Rule

2.5.2     CN - Card: Crop Cycle Requirement Rules

2.5.3     CR - Card: Coarse Material Rating Rules

2.5.4     CY - Card: Crop Yield by LGP

2.5.5     FR - Card: Fallow Land Requirement Rules

2.5.6     FY - Card: Fluvisol LGP Suitability Rules

2.5.7     PL - Card: Pattern LGP Rules

2.5.8     PP - Card: Pattern Proportion Rules

2.5.9     PR - Card: Phase Rules

2.5.10     SR - Card: Soil Unit Rules

2.5.11     TR - Card: Thermal Zone Suitability Rules


3.1   Program Logic and Overview

3.2   Input/Output File Sizes and Connections

3.3   Subprogram Description

3.4   Program Control Data, File CTRL02


4.1   Program Logic and Overview

4.2   Input/Output File Sizes and Connections

4.3   Subprogram Description

4.4   Program Control Data, File CTRL03

4.5   Computerized Land Inventory Data, File LINV.$$$

4.6   Additional Crop Factors, File COMMDAT

4.7   Crop Productivity Assessment Results, File BIN.$$$


5.1   Program Logic and Overview

5.2   Input/Output File Sizes and Connections

5.3   Subprogram Description

5.4   Program Control Data, File CTRL$$$

5.5   Commodity Aggregation Data, File COMMDAT

5.5.1     FC-Card: Conversion from Crop -> Agricultural Production List

5.5.2     FQ-Card: Conversion from Agricultural Production -> Food List

5.5.3     AG-Card: Food List Cards

5.6   Livestock Systems Definition Data, File LVSDAT

5.6.1     LZ-Card: Livestock Zone Definition Records

5.6.2     LS-Card: Livestock System Definition Record

5.6.3     LQ-Card: Livestock Product Definition Record

5.7   Technology Matrix, File TECHMAT


6.1   Program Logic and Overview

6.2   Input/Output File Sizes and Connections

6.3   Subprogram Description

6.4   Program Control Data, File CTRL$$$

6.5   Commodity Aggregation Data, File COMMDAT

6.6   Livestock System Definition Data, File LVSDAT

6.7   Technology Matrix, File TECHMAT

6.8   Scenario Summary Tables, File OUT$$$


Appendix A:   Kenya Country Case Study Coding Schemes

Appendix B:   Parameter Constants used in AEZ-CCS Programs

Appendix C:   AEZ Productivity Assessment Rule Definition Cards

Appendix D:   Miscellaneous Record Formats used in AEZ-CCS Programs

Appendix E:   MPS Record Format


1.1   Overview of AEZ-CCS Software Package

3.1   Program Structure AEZCCS02

4.1   Information Flow in Program AEZCCS03

4.2   Information Flow in Crop Combination Sub-component of Program AEZCCS03

4.3   AEZ Productivity Assessment, Crops

4.4   AEZ Productivity Assessment, Pastures

4.5   AEZ Productivity Assessment, Fuelwood Species

5.1   Information Flow in Program AEZCCS04

6.1   Information Flow in Program AEZCCS05


2.1   Control Input Data for Program AEZCCS01

3.1   Control Input Data for Program AEZCCS02

4.1   Control Input Data for Program AEZCCS03

5.1   Variables read from Scenario Control Input File, File CTRL$$$


This work is recorded in a main report and technical annexes.

Main Report:
Agro-ecological Land Resources Assessment for Agricultural Development Planning - A Case Study of Kenya

Resources Data Base and Land Productivity

Technical Annexes:

  1. Land Resources

  2. Soil Erosion and Productivity

  3. Agro-climatic and Agro-edaphic Suitabilities for Barley, Oat, Cowpea, Green gram and Pigeonpea

  4. Crop Productivity

  5. Livestock Productivity

  6. Fuelwood Productivity

  7. Systems Documentation Guide to Computer Programs for Land Productivity Assessments

  8. Crop Productivity Assessment: Results at District Level