Help for DISP2TP

PURPOSE

    DISP2TP generates an XML tiepoint file for two images from a disparity map

TAE COMMAND LINE FORMAT

    DISP2TP INP=(dspfiles) OUT=outtie RHS=(rhsfiles) XYZ=(xyzfiles) INPTIE=(inpties) CNT=count
     
    where

    dspfiles is one or more input double-band, real-valued VICAR images.
    rhsfiles is one or more VICAR images suitable for creating a PigFileModel.
    outtie   is an output XML text file representing a set of tiepoints.
    xyzfiles is one or more optional input XYZ files mapped to the corresponding dspfile.
    inptie   is one or more optional input XML tiepoint files used to select tiepoints.

        count is the approximate number of tiepoints to be generated.

    Examples
      disp2tp sampdisp.img samprhs.img samptie.xml cnt=42
      disp2tp sampdisp.img samprhs.img samptie.xml sampxyz.img cnt=42 
      disp2tp sampdisp.img samprhs.img samptie.xml inptie=selectie.tie

OPERATION

    DISP2TP generates an XML tiepoint file connecting the left and
    right images from one or more input disparity maps. INP is one or
    more double-band, real-valued VICAR image disparity maps. OUT
    is an xml text file representing the set of tiepoints. The output
    tiepoint file identifies the left and right images using a PIG
    unique ID. The RHS files must be equal in number to INP, and
    correspond in order to the INP files. They are used to determine
    the RHS unique ID for each disparity map. Only the RHS labels are
    used, so either EDR or RDR files can be used.

    If provided, INPTIE is used to select the tiepoints to generate
    from a dspfile. Otherwise, CNT is used to generate a line/sample
    sampling frequency such that approximately CNT tiepoints are
    generated. The tiepoints are selected with approximately uniform
    2-d spacing. The linear sampling frequency is approximately
    sqrt(NL*NS/CNT). However, selected tiepoints are discarded when
    the disparity value is undefined. Tiepoints also are discarded
    when an optional XYZ file is provided and the XYZ is undefined.
    For example, the test cases ask for 100 points but get only 28
    without an XYZ file, and 21 with an XYZ file. A future
    enhancement could count the undefined disparity values (and
    optionally the undefined XYZ values) and scale the requested
    number of tiepoints to yield a tiepoint set size closer to that
    requested.
   
    If there are less INPTIE files than INP files, then the n INPTIE
    files will be associated in order with the first n INP files. XYZ
    files are associated similarly with INP files.

    Following is a minimal example of an XML tiepoint file:

    &lt?xml version="1.0" encoding="UTF-8"?>
    &lttiepoint_file version="1.0">
    &lttiepoint_set>
      &ltreference_frame name="FIXED" index1="22" />
      &ltimages>
        &ltimage unique_id="MLG_436644282DSR_S0220000MCAM01813M1" key="0" />
        &ltimage unique_id="MRG_436644282DSR_S0220000MCAM01813M1" key="1" />
      &lt/images>
      &lttiepoints>
        &lttie type="0" left_key="0" right_key="1">
          &ltleft      line="71" samp="491" />
          &ltprojected line="145.984558" samp="138.428513" />
          &ltright     line="145.984558" samp="138.428513" />
          &ltflags quality="1.0" interactive="0" />
        &lt/tie>
      &lt/tiepoints>
    &lt/tiepoint_set>


RESTRICTIONS

     None known.

WRITTEN BY:            W. L. Bunch

COGNIZANT PROGRAMMER:  W. L. Bunch

REVISIONS: 
  Thu Sep 25 2014
    Initial version

PARAMETERS:

INP

 One or more disparity images.

OUT

 An XML tiepoint file.

RHS

 Required EDR or RDR type image file(s).

XYZ

 Optional xyz file(s).

INPTIE

 Optional XML input tiepoint file(s).

CNT

 The number of tiepoints to generate.

TRAD_MODE

 Selects output tiepoint type.

Cognizant Programmer: