4.114 sddszerofind

• description: sddszerofind finds the locations of zeroes in a single column of an SDDS file. This is done by finding successive rows for which a sign change occurs in the ”dependent column”, or any row for which an exact zero is present in this column. For each of the ”independent columns”, the location of the zero is determined by linear interpolation. Hence, the program is really interpolating multiple columns at locations of zeros in a single column. This single column is in a sense being looked at as a function of each of the interpolated columns.
• examples: Find zeroes of a Bessel function, J₀(z):
  sddszerofind J0.sdds J0.zero -zeroesOf=J0 -columns=z  
      

  Find zeroes of a Bessel function, J₀(z), and simultaneously interpolate J₁(z) at the zero locations:

  sddszerofind J0.sdds J0.zero -zeroesOf=J0 -columns=z,J1  
      

  (This isn’t the most accurate way to interpolate J₁(z), of course.)

• synopsis:
  sddszerofind [-pipe=[input][,output]] [inputfile] [outputfile]  
    -zeroesOf=columnName [-columns=columnNames]  
    [-offset=value] [-slopeOutput]  
    [-majorOrder=row|column]  
      

• switches:
  • -pipe[=input][,output] — The standard SDDS Toolkit pipe option.
  • -zeroesOf=columnName — Specifies the name of the dependent quantity for which zeroes will be found.
  • -columns=columnNames — Specifies the names of the independent quantities for which zero locations will be interpolated. Generally, there is only one of these. columnNames is a comma-separated list of optionally wildcarded names.
  • -offset=value — Specifies a value to add to the values of the -zeroesOf column prior to finding the zeroes.
  • -slopeOutput — Specifies that additional columns will be created containing the slopes of the dependent quantity as a function of each independent quantity. This can be useful, for example, if one wants to pick out only positive-going zero-crossings.
  • -majorOrder=row or -majorOrder=column — Specifies the organization of data in the output file.
• files: inputFile contains the data to be searched for zeroes. outputFile contains columns for each of the independent quantities and a column for the dependent quantity. Normally, each dependent quantity is represented by a single column of the same name. If output of slopes is requested, additional columns will be present, having names of the form columnNameSlope.

  If inputFile contains multiple pages, each is treated separately and is delivered to a separate page of outputFile.

• see also:
  • sddsinterp()
• author: M. Borland, ANL/APS.