L3TK_Feature_Extractor_Configuration
This page contains information on how to configure the [L3TK_Feature_Extractor] by use of a configuration file.
MINDTCT Path
Set the path to your
mindtct
executable (
mindtct.exe
on Windows) by including the line:
mindtct_path = c:\NBIS\bin\mindtct.exe
On Windows,
cygwin1.dll
must exist in the same directory.
On Linux, the line would look something like:
mindtct_path = /usr/local/bin/mindtct
Configuration Parameters
The sections below describe the configuration keys and identify the default value for each.
Image preprocessor parameters
Configuration Key
Description
**Default **
ip_verbose
Print image preprocessing progress data to the console
True
ip_diagnostics
Save image preprocessing diagnostics to the output directory
False
ip_minimumdiagnostics
Save only the most important image preprocessing diagnostics
False
ip_macroblocksize
Size of the blocks (in pixels) over which the ridge flow orientation is determined; overrides ip_macroblocksizeperdpi
30
ip_macroblocksizeperdpi
Size of the blocks (in pixels) over which the ridge flow orientation is determined (per DPI)
0.015
ip_gaussianvariance
Variance of the Gaussian kernel used to blur the image; overrides ip_gaussianvarianceperdpi
2.0
ip_gaussianvarianceperdpi
Variance of the Gaussian kernel used to blur the image (per DPI)
0.001
ip_uppercontrastthresh
The assumed ratio of undetermined valley pixels to total pixels in the image; this ratio determines the threshold at which pixels with a greater intensity are set to 255
0.85
ip_lowercontrastthresh
The assumed ratio of definitive ridge pixels to total pixels in the image; this ratio determines the threshold at which pixels with a lower intensity are set to 0
0.15
Pore extractor parameters
Configuration Key
Description
Default
pe_verbose
Print pore extraction progress data to the console
True
pe_diagnostics
Save pore extraction diagnostics to the output directory
False
pe_minimumdiagnostics
Save only the most important pore extraction diagnostics
False
pe_minimumblobsize
Lower size bound on pore blobs to be detected; overrides pe_minimumblobsizeperdpi
0
pe_minimumblobsizeperdpi
Lower size bound on pore blobs to be detected (per DPI)
0.0
pe_maximumblobsize
Upper size bound on pore blobs to be detected; overrides pe_maximumblobsizeperdpi
90
pe_maximumblobsizeperdpi
Upper size bound on pore blobs to be detected (per DPI)
0.045
pe_mexhatvariance
Variance of the 2D Mexican hat wavelet kernel; overrides pe_mexhatvarianceperdpi
2.6
pe_mexhatvarianceperdpi
Variance of the 2D Mexican hat wavelet kernel (per DPI)
0.0013
pe_mexhatthreshold
Intensity threshold at which the Mexican hat processed image is thresholded
192
pe_border
Size of the border which is applied to the image to remove invalid data introduced by the various processing steps; overrides pe_borderperdpi
10
pe_borderperdpi
Size of the border which is applied to the image to remove invalid data introduced by the various processing steps (per DPI)
0.005
Ridge extraction parameters
Configuration Key
Description
Default
pe_verbose
Print ridge extraction progress data to the console
True
pe_diagnostics
Save ridge extraction diagnostics to the output directory
False
pe_minimumdiagnostics
Save only the most important ridge extraction diagnostics
False
re_microblocksize
Size of the blocks (in pixels) over which the ridge contour orientation is determined; overrides ip_microblocksizeperdpi
4
re_microblocksizeperdpi
Size of the blocks (in pixels) over which the ridge contour orientation is determined (per DPI)
0.002
re_minimumblobfillsize
Lower size bound on blobs to be filled; overrides pe_minimumblobfillsizeperdpi
0
re_minimumblobfillsizeperdpi
Lower size bound on blobs to be filled (per DPI)
0.0
re_maximumblobfillsize
Upper size bound on blobs to be filled; overrides pe_maximumblobfillsizeperdpi
250
re_maximumblobfillsizeperdpi
Upper size bound on blobs to be filled (per DPI)
0.125
re_threshold
Intensity threshold at which the preprocessed image is thresholded prior to blob detection
127
re_border
Size of the border which is applied to the image to remove invalid data introduced by the various processing steps; overrides re_borderperdpi
12
re_borderperdpi
Size of the border which is applied to the image to remove invalid data introduced by the various processing steps (per DPI)
0.006
re_pixelspacing
Controls the interval at which pixels are kept along each ridge contour; overrides re_pixelspacingperdpi
8
re_pixelspacingperdpi
Controls the interval at which pixels are kept along each ridge contour (per DPI)
0.004
re_suppressionradius
Radius around minutia; ridge contour pixels outside of this radius are removed; overrides re_suppressionradiusperdpi
30
re_suppressionradiusperdpi
Radius around minutia; ridge contour pixels outside of this radius are removed (per DPI)
0.015
Edgeoscopy extraction parameters
Configuration Key
Description
Default
ee_verbose
Print ridge extraction progress data to the console
True
ee_diagnostics
Save ridge extraction diagnostics to the output directory
False
ee_minimumdiagnostics
Save only the most important ridge extraction diagnostics
False
ee_pixelspread
Distance over which the orientation difference is calculated; overrides ee_pixelspreadperdpi
6
ee_pixelspreadperdpi
Distance over which the orientation difference is calculated (per DPI)
0.003
ee_numberofpoints
Quantity of edgeoscopic points to extract
200
ee_proximitythreshold
Maximum distance two edgeoscopic points may fall within each other; overrides ee_proximitythresholdperdpi
9
ee_proximitythresholdperdpi
Maximum distance two edgeoscopic points may fall within each other (per DPI)
0.0045
Sample Config File
The contents of a sample configuration file are below.
#------------------------------------------
#Image preprocessing parameters
#------------------------------------------
ip_verbose = true
ip_diagnostics = true
ip_minimumdiagnostics = false
#ip_macroblocksize = 30
ip_macroblocksizeperdpi = 0.015
#ip_gaussianvariance = 2.0
ip_gaussianvarianceperdpi = 0.001
ip_uppercontrastthresh = 0.85
ip_lowercontrastthresh = 0.15
#------------------------------------------
#Pore extraction parameters
#------------------------------------------
pe_verbose = true
pe_diagnostics = true
pe_minimumdiagnostics = false
#pe_minimumblobsize = 0
pe_minimumblobsizeperdpi = 0.0
#pe_maximumblobsize = 90
pe_maximumblobsizeperdpi = 0.045
#pe_mexhatvariance = 2.6
pe_mexhatvarianceperdpi = 0.0013
pe_mexhatthreshold = 192
#pe_border = 10
pe_borderperdpi = 0.005
#------------------------------------------
#Ridge extraction parameters
#------------------------------------------
re_verbose = true
re_diagnostics = true
re_minimumdiagnostics = false
#re_microblocksize = 4
re_microblocksizeperdpi = 0.002
#re_minimumblobfillsize = 0
re_minimumblobfillsizeperdpi = 0.0
#re_maximumblobfillsize = 250
re_maximumblobfillsizeperdpi = 0.125
re_threshold = 127
#re_border = 12
re_borderperdpi = 0.006
#re_pixelspacing = 8
re_pixelspacingperdpi = 0.004
#re_suppressionradius = 30
re_suppressionradiusperdpi = 0.015
#------------------------------------------
#Edgeoscopic extraction parameters
#------------------------------------------
ee_verbose = true
ee_diagnostics = true
ee_minimumdiagnostics = false
#ee_pixelspread = 6
ee_pixelspreadperdpi = 0.003
ee_numberofpoints = 200
#ee_proximitythreshold = 9
ee_proximitythresholdperdpi = 0.0045
[Category:Feature_Extractor_Guide] [Category:Technical_Documentation]
