Following the constructors and parameter definitions set out above, a Period Category Report could be added and defined in the PIN file as:

ReportWriter.addReport(new PeriodCategoryReport("ageClass",
                      "Managed area by age class and period",
                      "hectares", 
                      control.getBlockTable(),
                      "MANAGEDAREA",
                      "MANAGEDOFFSET",
                      ageClass,
                      null,
                      21,
                      "Spatial Planning Systems:
                      September 2002",
                      false));

      

In this example, a new Period Category Report is being added to the Report Writer with a filename "ageClass". NO file extension has been identified, therefore three files will appear in the scenario folder entitled "ageClass.html, ageClass.png, and ageClass.csv". The title of this report is "Managed area by age class and period" and will be followed by the name of the scenario it was saved to.

Since this report is displaying area the units have been designated as "hectares" and will appear on the Y-axis of the PNG chart.

The information for this report was derived from data contained in the "Block Table" using the instruction control.getBlockTable(),. The area information was contained in the column "MANAGEDAREA" and was further divided into category ranges based on information contained in the "MANAGEDOFFSET" column of the Block Table. The information in the "MANAGEDOFFSET" column was used to assign records to one of the ranges in the "ageClass" range. In this particular example no other restrictions or reselections have been used to further narrow the information being displayed.

The number of periods being displayed is 21 (20 planning periods plus the initial conditions). Finally, additional text was added to display "Spatial Planning Systems: September 2002" under the PNG bar chart, and the values in this report are to appear in absolute terms (computePercent= false) as opposed to percentages.

This PIN file definition and range label definition was used to produce the example charts and tables found in this section.