Parent Topic: Language

REPORT

The REPORT statement generates a text report. A single report can be generated for each model. Reports can be based on means, sums (accumulated totals), or areas. It is also possible to use an `enumeration' value which allows reports to be broken down by subareas.

Syntax:

 REPORT v1 BY type [IDENTIFY a1] [UNDER v2 [IDENTIFY a2]] [FULL]
where:

   v1,v2            are layer or numeric variables

   a1,a2       are attribute variables

   type     is one of the following report types:

   mean        for reports by mean values
   sum         for reports by sums of values
   kilometre   for area reports in square kilometres
   metres      for area reports in square metres
   hectares    for area reports in hectares
   centimetre  for area reports in square centimetres
   miles       for area reports in square miles
   acres       for area reports in acres
   yards       for area reports in square yards
   feet        for area reports in square feet

 IDENTIFY    
   [optionally] specifies that an attribute
   should be used for labelling within the report.

 UNDER  
   [optionally] specifies the use of enumeration
   value (usually a layer variable) to allow the
   report to be broken down into subareas.

 FULL    
   [optionally] specifies a more extensive report
   when used in conjunction with an IDENTIFY.
   FULL will force an entry to be made in the
   report even if no data was accumulated for
   a particular value.
Examples:

   report %6 by sum;

   report #volume by sum under %3;

   report %tree by hectares identify %tree.3 under %county ;
Since data must be accumulated in memory, which is limited, the following restrictions/assumptions are made on the different types of reports. Values outside the range are counted and separately reported.

REPORT v1 BY mean/sum;

  No restrictions
REPORT v1 BY area;

  v1 must be an integer on the range 0 to 65535,
  area means one of:  kilometre; metres; hectares; ...; feet.
REPORT v1 BY mean/sum UNDER v2;

  v2 must be an integer on the range 0 to 65535.
REPORT v1 BY area UNDER v2;

  v1 must be an integer on the range 0 to 255.  v2 must be an
  integer on the range 0 to 255.
  area means one of:  kilometre; metres; hectares; ...; feet.

Parent Topic: Language
About PCI Help Gateway