mf_interprete_image ( : : ImageFeatureName, UnknownAllowed, Iteration : )

Execution of an MF image interpretation.

The operator mf_interprete_image calculates the interpretation of the image with respect to the currently active MF-database by using the MF-featurefile ImageFeatureName.

The image interpretation is executed according to the solution of a minimizing problem (MAP-formula) with the help of the simulated annealing by using a special, efficient cooling-schedule and ensuing zero-temperature-annealing. The calculation is based on an MF-feature file ImageFeatureName of the image to be interpreted. The input parameter UnknownAllowed hereby indicates whether the special interpretation "unknown" shall be used for the interpretation of regions differing strongly from the object models which the currently used MF-database contains. This interpretation is included implicitly in the interpretation system and has the interpretation index m. The input parameter Iteration indicates how often the simulated annealing is to be executed. As the annealing is a stochastical procedure, to find the global energy minimum can be counted on only up to a certain probability. If the optimizing procedure is executed iteratively, the image interpretation with the minimal energy will be returned as result, so that the hit rate can hereby be increased.

As output an MF-interpretation file called ImageFeatureName.int is created which contains the detected image interpretations.


Parameters

ImageFeatureName (input_control)
string -> string
Name of the MF-feature file of the image to be interpreted (the extension .fea will be added automatically).

UnknownAllowed (input_control)
string -> string
Flag which indicates whether the "unknown" interpretation shall be used or not.
Default value: 'unknown_not_allowed'
Suggested values: 'unknown_allowed', 'unknown_not_allowed'

Iteration (input_control)
integer -> integer
Number of the desired annealing-iterations.
Default value: 1
Restriction: Iteration > 0


Example
read_image(:Obj:'fabrik':) >
gauss__(Obj:Smooth_Obj:7:) >
regiongrowing__(Smooth_Obj:Seg_Obj:1,1,5,50:) >
reduce_domain(Reg,Seg_Reg:Seg_Im::) >
mf_features(Seg_Im::'fabrik':) >
mf_read_db(::'fabrikhalle':) >
mf_interprete_image(::'fabrik','unknown_allowed',7:).

Result

If the parameter values are correct, the operator mf_interprete_image returns the value TRUE. Otherwise an exception is raised.


Possible Predecessors

mf_features, mf_db_generation, mf_read_db


Possible Successors

mf_compute_energy, mf_close_db


See also

mf_features, mf_db_generation, mf_read_db, mf_set_db, mf_get_db, mf_close_db



Copyright © 1996-1997 MVTec Software GmbH