4.51 sddsfindin2dgrid

• description: sddsfindin2dgrid searches a two-dimensional grid of data and returns the grid coordinates where two specified columns are closest to requested values. The requested values may be supplied directly with -atValues or read from an SDDS file with -valuesFile. Optional interpolation refines the location, and -inverse performs the reverse operation, interpolating data values from supplied grid coordinates.
• examples:
    sddsfindin2dgrid data.sdds locations.sdds -gridVariables=x,y -findLocationOf=Fx,Fy -atValues=0.1,0.2 -interpolate  
    sddsfindin2dgrid grid.sdds out.sdds -gridVariables=Qx,Qy -findLocationOf=R11,R12 -valuesFile=targets.sdds -mode=reuseFirstPage  
    sddsfindin2dgrid grid.sdds values.sdds -gridVariables=x,y -findLocationOf=Fx,Fy -valuesFile=positions.sdds -inverse  
    

• synopsis:
    sddsfindin2dgrid [input] [output] [-pipe=[input][,output]]  
      -gridVariables=gridColumnName1,gridColumnName2  
      -findLocationOf=columnName1,columnName2  
      {-valuesFile=filename | -atValues=value1,value2}  
      [-presorted] [-interpolate]  
      [-mode={onePairPerPage|reuseFirstPage|all}]  
      [-inverse]  
    

• switches:
  • -gridVariables=gridColumnName1,gridColumnName2 – names of columns giving grid coordinates.
  • -findLocationOf=columnName1,columnName2 – columns for which to locate or interpolate values.
  • {-valuesFile=filename | -atValues=value1,value2} – supply target pairs directly or from a file.
  • -presorted – declare that grid variables are sorted to speed the search.
  • -interpolate – interpolate within grid cells for sub-grid accuracy.
  • -mode={onePairPerPage|reuseFirstPage|all} – control how value pairs are used for multipage data.
  • -inverse – interpolate data values for supplied grid coordinates.
  • -pipe[=input][,output] – standard SDDS Toolkit pipe option.
• files:
  • input – SDDS file containing the grid data.
  • output – SDDS file receiving the resulting coordinates or values.
• see also:
  • sdds2dinterpolate()
  • sddssnap2grid()
• author: M. Borland, ANL/APS.