Geotest

Configuring Geotest

If you do not specify any arguments on the command line when initializing geotest, geotest initializes using the information in the test.ini file. You need to modify the test.ini file to fit the configuration of your system. You can find this file in the directory where you installed GeoStan in Test_fls.

The format of the test.ini file consists of the following lines:

Line 1   Search path for the GeoStan data files.

Line 2   Search path and file name for the ZIP + 4 file (Us.z9).

Line 3   Search path and file name for GeoStan license file (Geostan.lic).

Line 4   Password for your GeoStan license.

Line 5   (Optional) DPV data directory.

Line 6   (Optional) Security key to initialize DPV functionality.

Line 7   (Optional) LACS^Link data directory.

Line 8   (Optional) Security key to initialize LACS^Link functionality.

Line 9    (Optional) Amount of memory GeoStan uses for memory mapped files. For more information, see GS_INIT_FILE_MEMORY_LIMIT.

Line 10    (Optional) Sets a select number of processing options.

n A – Loads the files for address geocoding.

n Z – Loads the file for centroid geocoding.

n S – Loads spatial query files.

n C – Loads the file (zipsmld.gsd) for returning PreciselyIDs for Master Location Data addresses with ZIP centroid locations.

Line 11   (Optional) Suite^Link data directory.

Line 12   (Optional) To exit the main menu, enter q or Q.

Line 13   (Optional) Sets the cache size (0, 1, or 3).

Line 14   (Optional) Sets the path to a file that contains all of your find properties.

Line 15   (Optional) RDI data directory.

For example:

C:\geostan\datasets

C:\geostan\datasets\us.z9

C:\licensefiles\geostan.lic

43218765

C:\geostan\datasets\DPV

9999-9999-9999-9999

C:\geostan\datasets\LACS

9999-9999-9999-9999

Using Geotest

You can run geotest using geotest.exe located in the platform-specific file where you installed GeoStan, or you can run geotest by specifying arguments on a command line.

Command Line

Command line usage format:

geotest searchPath ZIP4File licenseFile password (-sp searchpath -z ZIP4File -l licenseFile -lpw password) [-dp DPVDataDir -dk DPVSecurityKey] [-lp LACSLinkDataDir -lk LACSLinkSecurityKey] [-tp SuiteLinkDataDir] [-rp RDIDataDir][-gc] [-fml fileMemoryLimit] [-q][-i initProps] [-c cacheSize] [-fp findPropsPath]

where:

The following is an example of running geotest from the command line.

geotestsearchpath z9path licensefile password -dpdpvpath -dkdpvSecuritykey -lplacslinkpath -lklacslinksecuritykey -fml memorylimit-fp Find Properties Path -tp SuiteLink Path -rp RDI Path -gc geocoder init flags -c cache size -sp search path -z z9file -l license file -lpw license password -log turn on logging -q quit main menu -i Init options

If any of the setup criteria does not initialize correctly, a list of problems displays. Check and correct all of the listed problems and rerun geotest.

The Geotest Main Menu displays when all configurations are correct (sample menu shown below).

The following contains a description of each menu item.

Match an address   Prompts for an address to standardize and geocode. Returns a matched address or a list of possible matches.

Match a geocode   Prompts for a geocode (latitude and longitude) to convert to an address. Returns the closest match. Returns a possible match; the address may not physically exist or may not accept mail delivery.

Match an address & geocodePrompts for an input street address and latitude/longitude coordinates. Returns a matched address or a list of possible matches.

Match a PreciselyID   Prompts for a PreciselyID unique identifier (PBKey) to attempt a Reverse PreciselyID Lookup match. For more information, see PreciselyID Fallback.

Match a ZIP + 4   Prompts for information to attempt a ZIP Code match.

Query   Prompts for a ZIP Code or city and state, then asks if you want to search by street by name or soundex. If you want to output to a file, enter the file name at the Name prompt.

Configure   Provides a way for you to configure the matching and output of geotest.

Z4Change   Prompts for ZIP Code information, then indicates if the ZIP + 4 has changed since you last processed the address.

Generate Soundex   Prompts for a string and returns a soundex value.

Test range   Prompts for the house number and the low and high house number in the range to determine if the house number falls within a range.

Verify Aux File   Prompts for the path of the auxiliary file to verify if any error exists in the file.

Acquire Metadata   Provides information regarding the input data sets.

Geographic Geocoding   Prompts for a city, a county, and a state to provide returns for CloseFlag, City\County\State, State, ResultCode, FIPS, LocationCode, Lat, and Long.

Query Cities   Prompts for a city name, full or partial, or a ZIP Code, 3- or 5-digits. Returns the cities that match your input.

Get City MBR   Prompts for a city number. Returns the Minimum Bounding Rectangle (MBR).

q or Q   Quits the application.

Configure - User Settable Options window

To set matching and geocoding options for forward geocoding, enter the Configure option on the main menu, then select User Settable Options. Geotest displays the window below.

For more information about these options, see the associated section referenced by the links in the following table.