## page was renamed from find_nofitT.e
## page was renamed from find nofit.e
= find_nofit =
(Compiled by DL)

== Requires ==
 * [[make_script.in]] - input file for batch processes such as [[make_scriptF]], [[make_scriptR]], [[make_scriptA]] or [[make_scriptAP]].
Either:
 * LMRK.OOT files -  output by a batch process such as [[make_scriptF]].
Or:
 * PICT.OOT files - output by a batch process such as [[make_scriptR]], [[make_scriptA]] or [[make_scriptAP]].

== Output ==
Either:
 * [[redo.txt]] - list of landmarks which terminated in error, do not correlate with at least one image, or correlate weakly with at least one image.
Or:
 * [[REMOVED.TXT]] - list of landmarks which have been eliminated from at least one image due to low or no correlation.

== Description ==

The batch processes initiated by [[make_scriptF]], [[make_scriptR]], [[make_scriptA]] and [[make_scriptAP]] produce output files LMKNM.OOT or PICNM.OOT, basically listings of the outputs of procedures [[lithos]], [[register]], [[autoregister]] and [[autoregisterP]] respectively for each input landmark or image.  find_nofit looks through these output files for each landmark or picture listed in the [[make_script.in]] file to find places where the landmarks or images may need further work.  

If the entries in the .in file are landmarks ([[make_script.in]]for [[lithos]] runs), the find_nofit procedure identifies:
{{{
!  cat LMKNM.OOT - process still running or terminated in error.
*  cat LMKNM.OOT - maplets not correlating with at least one image.
+  cat LMKNM.OOT - maplets correlating weakly with at least one image.
.  cat LMKNM.OOT - no correlation for at least one overlap.
   cat LMKNM.OOT - low correlation for at least one overlap.
}}}
The cat LMKNM.OOT will produce a listing of the output file for more complete diagnostics.  The program also produces a [[redo.txt]] file listing those landmarks that failed one of the first three tests.  The limit for weak correlation is set by the 'NOFIT=' keyword in [[INIT_LITHOS.TXT]]. 

If the entries in the .in file are images ([[make_script.in]] for [[register]], [[autoregister]] and [[autoregisterP]] runs), the find_nofit procedure identifies:
 * . cat PICNM.OOT  image not correlating with at least one maplet.
The cat PICNM.OOT will produce a listing of the output file for more complete diagnostics.  The program also produces a [[REMOVED.TXT]] file listing those landmarks that were eliminated from one of the images for low or no correlation.

'''Example output from find_nofit:'''
{{{
*  cat EE0017.OOT              <- maplets not correlating with at least one image
   cat EE0019.OOT              <- low correlation for at least one overlap
   cat EE0022.OOT
.  cat EE0027.OOT              <- no correlation for at least one overlap
+  cat EE0034.OOT              <- maplets correlating weakly with at least one image
*  cat EE0042.OOT
*  cat EE0044.OOT
+  cat EE0045.OOT
!  cat EE0051.OOT              <- process still running or terminated in error
!  cat EE0053.OOT
+  cat EE0054.OOT
   cat EE0055.OOT
!  cat EE0063.OOT
   cat EE0067.OOT
   cat EE0069.OOT
   cat EE0081.OOT
}}}

Example [[redo.txt]] file:
{{{
* EE0017              <- maplets not correlating with at least one image
+ EE0034              <- maplets correlating weakly with at least one image
* EE0042
* EE0044
+ EE0045
EE0051                <- low correlation for at least one overlap
EE0053
+ EE0054
EE0063
END
}}}

Example [[REMOVED.TXT]] file:
{{{
AA0001                <- maplet eliminated from an image for low or no correlation
AF0023
}}}