PointPoly, and
PointPoly Help.

When the required point and polygon files are visible, select PointPoly to run PointPoly.

Instructions on running PointPoly directly from your Avenue script or calling it from C++ code are provided below.

Return to Table of Contents

Run from ArcView

To run PointPoly from ArcView, make all point and polygon shape files that you are interested in visible in a view. Then choose Polygon > PointPoly.

If the product is still being evaluated, the registration screen below will appear next. Clicking the Purchase PointPoly button will evoke your browser with www.spatial-online.com to enable you to purchase the product on-line, through the Fax or via Purchase Order. When you purchase the product, you will be required to supply your site code (just below the Purchase button). In return, you will get a product key. Insert that key into the Edit Box next to Product Key and click OK to register the product. Once you have done this, this registration box will no longer appear.

To run the product in trial mode, click the Run in Demo Mode button. Below the button, the remaining trial period is shown.

Clicking the Cancel button will stop the process.

The PointPoly process will be evoked. It will provide the dialog below. The point files in your current view will be listed in the top combo box beside Point File with the first selected. The polygon files in your current view will be listed in the next combo box beside Polygon File with the first selected. The first two combo boxes on the subsequent line will be loaded with the attributes of the currently selected point file and polygon file. The third will provide join attributes.

Note: The text at the bottom of the box, "Click OK when parameters selected" in the diagram below, supplies instructions and error messages. If the process does not seem to be proceeding as expected, check the text and it will explain why.

Before clicking OK to run the process, the following must be specified:

• A Point File must be chosen. If the desired point file was in your view, it will be listed in the combo box and must be selected if not the first. If the file was not in the view, push the Browse button beside the combo box to find the point file on disk.

• A Polygon File must be chosen. If the desired polygon file was in your view, it will be listed in the combo box and must be selected if not the first. If the file was not in the view, push the Browse button beside the combo box to find the polygon file on disk.

• A set of rules for transferring attribute values from the polygon file to the point file must be established. Any number of transfer rules can be added. For each point, containing polygons will be established. The requested attribute values of these polygons will be transferred to the requested field of the point file. In case there is no containing polygon, the values will be defaulted.

  To establish a transfer rule, choose a Point Attribute from its combo box and a Polygon Attribute from its combo box. The choice of Join will determine what will happen in case there is more than one polygon containing this point, either internally (if the polygons overlap) or as a boundary point. The default case is that the first encountered is chosen (First). Alternately, the field values for the various polygons can be chosen to be the maximum (Max) or minimum (Min) if those operations are applicable to field types. Additionally, if the field is character, the values can also be concatenated (Concatenate) and if the attribute is numeric, the values can also be summed (Sum).

  Once the above are specified, click the Add button. The rule will appear in the list box as "Set attribute PointAttribute to PolygonAttribute (JoinType)".

  To remove a previously established rule, select it and click the Remove button.