This is a simple example of the use of PAGC.
Let us suppose you have a reference shapeset named whatcom located in the /home/your_name/shapeset directory. Suppose too that it is a Tigerline file format shapeset. Suppose further you require no statistics file ( See the Statistics file) and are using the default standardization files ( See Standardization Files). You won't need the specifics on the progress of the program provided by the -v switch. In this case, assuming you located in the /home/your_name directory, you would type at the shell prompt:
pagc -b shapeset/whatcom
The program then builds the standardized reference in the /home/your_name/shapeset directory. The program will tell you, in 10% increments, how far along it has proceeded.
After the build is complete, examine the whatcom.err file with a text viewer to see if there are any problems with the build. See Build Error File for details. You should also see a number of files in the /home/your_name/shapeset directory. ( See Files Produced By the Build Phase for details).
Now suppose you have an xbase file named Customers.dbf that contains Customer names and addresses located in Whatcom County, Washington. It contains fields named by Customer Name, Email address, Address, ZIP. This file will not require a user order table ( See User Order Table). The first two fields will be ignored since PAGC does not recognize those field names as ones probably containing postal data. Suppose this file is located in the /home/your_name/data directory.
If you were located in the /home/your_name directory, you would type at the shell prompt:
pagc -mdata/Customers -rshapeset/whatcom
Since no order table was specified, PAGC locates the field names and asks you if it has located the proper fields:
Fields with MICRO address attributes:
ADDRESS
Fields with MACRO address attributes:
ZIP
Type y (return) to confirm list, n (return) to reject.
The program will geocode the addresses in the Customers file against the Whatcom County reference. If an address cannot be matched exactly with a record in the reference, you will be asked to select from a numbered list of candidates, ranked by likelihood. To select the best candidate you type in the number:
Unstandardized user row 1: 8868 Northwood
Lynden WA 98264
Numbers 0 to 9 of 12 items:
(0): 8701-8899 & 8700-8898|NORTHWOOD|ROAD|98264 & 98264 0.849502 (shp 103)
(1): 8959-9099 & 8958-9098|NORTHWOOD|ROAD|98264 & 98264 0.846397 (shp 459)
(2): 9101-9299 & 9100-9298|NORTHWOOD|ROAD|98264 & 98264 0.841498 (shp 86)
(3): 8901-8957 & 8900-8956|NORTHWOOD|ROAD|98264 & 98264 0.838462 (shp 806)
(4): 9301-9499 & 9300-9498|NORTHWOOD|ROAD|98264 & 98264 0.834598 (shp 81)
(5): 9501-9799 & 9500-9798|NORTHWOOD|ROAD|98264 & 98264 0.827697 (shp 70)
(6): 8601-8699 & 8600-8698|NORTHWOOD|ROAD|98264 & 98264 0.791195 (shp 458)
(7): 8519-8599 & 8518-8598|NORTHWOOD|ROAD|98264 & 98264 0.756694 (shp 443)
(8): 8501-8517 & 8500-8516|NORTHWOOD|ROAD|98264 & 98264 0.728403 (shp 455)
(9): 8453-8499 & 8452-8498|NORTHWOOD|ROAD|98264 & 98264 0.722193 (shp 461)
Select by item number, or q to quit, n for next,
b for back, s for start, e for end, x exit program
"*" followed by item number see documenttion.
"+" or "-" followed by number see documentation
>
In the above example you would probably enter "0", on the assumption that your target address had just omitted the ROAD street type.
At the end you will have the Customers shapeset, located in the /home/your_name/data directory. Check that the files Customers.dbf, Customers.shp, and Customers.shx are there. There should also be a file named Customers.err with any errors that the program encountered ( See Match Error Log).