4.10 sdds2dinterpolate

• description: sdds2dinterpolate interpolates scalar data on a two–dimensional grid. The program reads an SDDS file containing coordinates and one or more dependent quantities. Data are interpolated using either natural–neighbour or cubic spline algorithms at a regular grid or at locations supplied in another file.
• examples:
  sdds2dinterpolate input.sdds output.sdds -independentColumn=xcolumn=x,ycolumn=y \  
    -dependentColumn=field -outDimension=xdimension=40,ydimension=40 \  
    -algorithm=nn -npoints=10 -weight=1e-6  
    

• synopsis:
  sdds2dinterpolate [<input>] [<output>] [-pipe[=input][,output]] \  
    [-independentColumn=xcolumn=<xName>,ycolumn=<yName>[,errorColumn=<name>]] \  
    [-dependentColumn=<zName>[,<zName>...]] \  
    [-scale=circle|square] [-outDimension=xdimension=<nx>,ydimension=<ny>] \  
    [-range=xminimum=<xmin>,xmaximum=<xmax>,yminimum=<ymin>,ymaximum=<ymax>] \  
    [-zoom=<factor>] [-dimensionThin=xdimension=<nx>,ydimension=<ny>] \  
    [-clusterThin=<distance>] [-preprocess] \  
    [-algorithm=nn|csa[,linear|sibson|nonSibson][,average=<nppc>][,sensitivity=<value>]] \  
    [-weight=<value>] [-vertex=<id>] [-npoints=<number>] [-verbose] [-merge] \  
    [-file=<pointsFile>[,<xName>,<yName>]] [-majorOrder=row|column]  
    

• switches:
  • -pipe[=input][,output] — Standard SDDS Toolkit pipe option.
  • -independentColumn=xcolumn=<name>,ycolumn=<name>[,errorColumn=<name>] — Names of the columns containing the independent variables and, optionally, a column of errors.
  • -dependentColumn=<name>[,<name>...] — Dependent columns to be interpolated.
  • -scale=circle|square — Scale the interpolation region to a unit circle or unit square.
  • -outDimension=xdimension=<nx>,ydimension=<ny> — Number of grid points in the x and y directions.
  • -range=xminimum=<xmin>,xmaximum=<xmax>,yminimum=<ymin>,ymaximum=<ymax> — Explicit limits of the interpolation grid.
  • -zoom=<factor> — Multiply the automatically determined grid range by the given factor.
  • -dimensionThin=xdimension=<nx>,ydimension=<ny> — Average data within the specified cell dimensions before interpolation.
  • -clusterThin=<distance> — Replace clusters of points closer than the given distance by a single point.
  • -preprocess — Output thinned data without performing interpolation.
  • -algorithm=nn|csa[,linear|sibson|nonSibson][,average=<nppc>][,sensitivity=<value>] — Select the interpolation algorithm and its parameters. The nn method uses natural neighbours with optional linear, sibson or nonSibson weighting rules. The csa method performs cubic spline approximation and accepts the average and sensitivity qualifiers.
  • -weight=<value> — Minimum interpolation weight allowed.
  • -vertex=<id> — Output diagnostic information for the specified vertex.
  • -npoints=<number> — Number of points used by the interpolator.
  • -verbose — Produce additional diagnostic output.
  • -merge — Merge all input pages before processing.
  • -file=<pointsFile>[,<xName>,<yName>] — Read interpolation locations from an external SDDS file. Optional names specify the x and y columns.
  • -majorOrder=row|column — Set the output data order.
• author: H. Shang, R. Soliday, L. Emery, M. Borland, ANL/APS.