Perform Library Match

Use the Perform Library Match option (Geosoft.uxo.gxnet.dll(Geosoft.GX.UXO.UxaPerformLibraryMatch;Run)*) from the AGC Expert User > Source and Library Management menu to classify the targets against a master signature library.

Perform Library Match dialog options

Library Database
Name	Select the signature library. This library is a Geosoft database containing a variety of known munitions. Script Parameter:UXAPERFORMLIBRARYMATCH.SIGNATURE_LIBRARY_DATABASE
Group	Select the library group. Script Parameter:UXAPERFORMLIBRARYMATCH.LIBRARY_DATABASE_GROUP
Item description channel	Select the item description (ID) channel in the signature library. Script Parameter:UXAPERFORMLIBRARYMATCH.ITEM_DESCRIPTION_CHANNEL
Source Database
Name	Specify the source database. Script Parameter:UXAPERFORMLIBRARYMATCH.TARGET_DATABASE_NAME
Group	Select the source group. Script Parameter:UXAPERFORMLIBRARYMATCH.TARGET_DATABASE_GROUP
ID channel	Select the source ID channel. Script Parameter:UXAPERFORMLIBRARYMATCH.TARGET_DATABASE_ID
Mask channel	Select the source mask channel. Script Parameter:UXAPERFORMLIBRARYMATCH.TARGET_DATABASE_MASK
Match channel suffix	Select/specify the channel suffix. Channel suffix will be added to "UXA_LmStat_" and "UXA_LmID_" prefixes to create match statistics and match ID channel names. Script Parameter:UXAPERFORMLIBRARYMATCH.CHANNEL_SUFFIX
Match statistics channel	Read only field - contains match statistics channel name. Match statistics metric shows the degree of match between a target and the items in the signature library, so its size would be the same as the number of items in the signature library. Script Parameter:UXAPERFORMLIBRARYMATCH.MATCH_STATISTICS
Match ID channel	Read only field - contains match ID channel name. Each item in this channel shows the indices of the items in the signature library associated with the match ID values. Script Parameter:UXAPERFORMLIBRARYMATCH.MATCH_ID
Match Calculation Options
Min. polarizability amplitude	Specify the minimum polarizability amplitude, which is the lower bound of the polarizability values used in the classification. This value should be above or equal to zero. The default value is zero. Script Parameter:UXAPERFORMLIBRARYMATCH.MIN_BETA_AMP
Gates - Low	Select the low gate, which will affect the match statistic. Script Parameter:UXAPERFORMLIBRARYMATCH.LOGATE
Gates - High	Select the high gate, which will affect the match statistic. Script Parameter:UXAPERFORMLIBRARYMATCH.HIGATE
Criteria weights - Size	Specify the size. See the Application Notes below for more information. Script Parameter:UXAPERFORMLIBRARYMATCH.WEIGHT_SIZE
Criteria weights - Shape 1	Specify the shape. See the Application Notes below for more information. Script Parameter:UXAPERFORMLIBRARYMATCH.WEIGHT_SHAPE1
Criteria weights - Shape 2	Specify the shape. See the Application Notes below for more information. Script Parameter:UXAPERFORMLIBRARYMATCH.WEIGHT_SHAPE2

Application Notes

The library match routine reads in a library group containing polarizability data for either targets of interest (TOI) or clutter items and compares them to the modelled polarizability data in the source database.

For each source in the selected group from the source database, the matching routine compares it to all the items in the se

lected library group and generates a match statistic. The match statistic for each of the three polarizabilities are combined into a final single match statistic, or metric, based on the weighting using the following criteria:

Size - the primary polarizability (β1),
Shape 1 - the secondary polarizability normalized by primary polarizability (β2/β1), and
Shape 2 - the tertiary or third polarizability normalized by primary polarizability (β3/β1).

By appropriately selecting the criteria weights, the library match can be based on 1, 2 or 3 of the polarizabilities. The match statistic ranges between 0 and 1, where 1 is a perfect match. This statistic and the library item description are each stored as array channels in the source database, labelled with the Match Channel Suffix.

The difference in the values is computed at all time gates, excluding those where the values are below the minimum polarizability amplitude. If the polarizabilities used do not exceed the defined minimum polarizability amplitude, the comparison cannot be performed and a metric of exactly zero (0) is returned.