INFOREPORT2

 

creates a report with the INFO REPORT writer.  INFOREPORT2 is an adaptation to the report writer in ArcTools (INFOREPORT).  What's different: 1) INFOREPORT2 allows you to convert the units in AREA and LENGTH items and round the output, 2) automatically summarizes the selected items using FREQUENCY and the FREQUENCY item can be included in the report, 3) automatically sizes character items so that trailing blanks won't cause the report to be unnecessarily wide, 4) saves the arguments used to create a report so that a report can be recalled, modified, and rerun, 5) runs from the command line as well as from a menu, and 6) allows for the inclusion of RELATEd items.

 

____________________________________________________________________________

 

INFOREPORT2 <out_file> {title} <in_file> <feature_type> {autosize?} {in_units_area} {out_units_area} {in_units_len} {out_units_len} {rounding_factor} <itemlist>

 

ARGUMENTS

 

<out_file> - the name for the output ASCII report.

 

If <out_file> is the name of an existing file, the existing file will be overwritten

 

However, when INFOREPORT2 is being run from the menu and <out_file> is the name of an existing INFOREPORT2 report, then the arguments used to generate the existing report will be read from <out_file>.args.  The arguments may then be modified, but if the report is rerun it will overwrite the initial report, unless you change the <out_file> name first.

 

<out_file>.args is automatically created.

 

{title} - the title for the report.

 

Default is: 'Report for: <in_file>'

 

DO NOT USE QUOTES within the title, but...

 

In command mode, the title MUST BE QUOTED if it contains blanks.

 

<in_file> - the name of the ARC coverage or INFO file on which the report is to be run.

 

<feature_type> - the feature type of the <in_file> on which to report.

 

For instance: POLY, LINE, POINT... for coverages.

 

Enter 'INFO' if <in_file> is an INFO file.

 

Enter 'VAT' if <in_file> is a GRID.

 

{autosize?} - whether or not to size fields in the report so

that they don't take up unnecessary space.  NO or YES.

 

NO - The output widths of the items determine how much space

they will take up in the report.*

 

YES - The output widths of the items is temporarily modified to be equal to their longest entry (without leading/trailing blanks), so that these items won't take up unnecessary space in the report.  This is not the default, since it takes additional processing time.

 

*NOTE: The actual space taken by a field is the output width + 5, unless the number of characters in the item heading is greater than the output width, then the size of the field is the heading width + 5.

 

R6TOOLS AUTOSIZE or CHANGEITEM can be used to permanently autosize items.

 

{in_units_area} - the units of the values stored in the AREA item.  SQUARE_METERS, SQUARE_FEET, HECTARES, ACRES, or SQUARE_MILES.

 

Default is SQUARE_METERS, unless <in_file> is a coverage whose projection units is FEET, in which case the default {in_units_area} is SQUARE_FEET.

 

Used in conjunction with {out_units_area} to determine the appropriate conversion factor so that {out_units_area} is the units assigned to the values of AREA in the report.

 

Not used, if there is no item named AREA in the <in_file> or among the items selected for the report.

 

{out_units_area} - the units for the values of AREA in the report.  ACRES, HECTARES, SQUARE_FEET, SQUARE_METERS, or SQUARE_MILES.

 

Used in conjunction with {in_units_area} to determine the appropriate conversion factor so that {out_units_area} is the units assigned to the values of AREA in the report.

 

Not used, if there is no item named AREA in the <in_file> or among the items selected for the report.

 

{in_units_len} - the units of the values stored in the LENGTH item.  METERS, FEET, KILOMETERS, or MILES.

 

Default is METERS, unless <in_file> is a coverage whose projection units is FEET, in which case the default {in_units_len} is FEET.

 

Used in conjunction with {out_units_len} to determine the appropriate conversion factor so that {out_units_len} is the units assigned to the values of LENGTH in the report.

 

Not used, if there is no item named LENGTH in the <in_file> or among the items selected for the report.

 

{out_units_len} - the units for the values of LENGTH in the report.  MILES, KILOMETERS, FEET, or METERS.

 

Used in conjunction with {in_units_len} to determine the appropriate conversion factor so that {out_units_len} is the units assigned to the values of LENGTH in the report.

 

Not used, if there is no item named LENGTH in the <in_file> or among the items selected for the report.

 

{rounding_factor} - the unit interval to which to round the output from AREA and LENGTH items.  Default is 1 for AREA and 0.01 for LENGTH.

 

AREA and LENGTH outputs are rounded to the nearest multiple of the {rounding_factor}.  For example, when AREA equals 104.009, then

 

{rounding_factor}   Output

------------------------------

.000001          104.009000

.01              104.01

1                104

10               100

 

<itemlist> - the list of the items on which to report.  Each item name should be followed by its {column_heading} and any {column_options}, and be surrounded by quotes.

 

{column_heading} is the name given to the field when the report is generated.  DO NOT QUOTE the heading, blanks are allowed.

 

{column_options} are:

-BREAK - break the report on this item.

-AVER - generate and list averages for this item at each break point.

-TOTAL - generate and list totals for this item at each break point.

 

For example, in command mode the <itemlist> might look like:

 

'MAC Management Area Category -break' 'SOIL_TYPE Soils' 'AREA Acres -total'

 

In this case, three items will be reported on: MAC, SOIL_TYPE, and AREA.  In the report, these fields will be given headings of 'Management Area Category', 'Soils', and 'Acres', respectively.  The report will be broken by MAC, and AREA will be subtotaled by MAC as well as totaled for the whole report.

 

From the menu, you interactively build the <itemlist>.

 

The item FREQUENCY, which is created when the command FREQUENCY is run to summarize the selected items, can be included in the <itemlist>.

 

The item AREA can be included in the <itemlist> when the <in_file> is a GRID.  It will be calculated from the COUNT item in the <in_file>.VAT.

 

 

NOTES

 

- INFOREPORT2 runs from all modules of ARC/INFO, ver. 8.1.

 

- When run from ARCPLOT or GRID, only features/records that are currently selected (e.g. using RESELECT) will be reported.  If no selection has been made on the <in_file> <feature_type>, then all features/records will be processed.

 

- For more information on how to use the INFOREPORT2 menu, see the INFOREPORT help file.  This is available through the ArcTools Tool Browser under lib, inforeport.  Or from ARC enter: &popup $ATHOME/lib/inforeport.hlp.

 

- The [Add Related Items] button on the menu, when clicked, will add all items which can be accessed via an active relate to the list of available items.

 

- WARNING - The names of related items get truncated to 16 characters when converted to INFO.  For this reason, INFOREPORT2 will not work correctly if there are multiple items being reported on whose names are identical through the first 16 characters.

 

- The maximum line width of the report is 400 characters.