User Tools

Site Tools


Frida-1: old IDA documentation: command reference, File “Ida.hlp”

Here is the list of the subroutines and what they are doing:

  • i00 : main program
  • i01 : plot
  • i10 : input/output
  • i20 : on-line memory
  • i23 : directories, editing, r/z-handling
  • i25 : file copy, delete, make
  • i30 : file manipulations, auxiliary calculations
  • i32 : general functions and symbolic calculation
  • i40 : manipulations on data / per channel
  • i41 : manipulations on data / per spectrum
  • i42 : manipulations on data / per file
  • i43 : special manipulations on data
  • i50 : operations on data
  • i60 : curves and fit
  • i66 : collection of fit functions
  • i67 : very special fit functions
  • i70 : rescaling operations
  • i71 : Fourier transforms
  • i72 : neutron kinematics, constant-q
  • i73 : density of states
  • i74 : self absorption
  • i75 : nuclear forward scattering
  • i76 : mode coupling integration
  • i77 : full mode coupling model ! LINK ONLY WHEN NEEDED
  • i80 : raw data read / neutron scattering
  • i87 : raw data read / light scattering
  • i94 : simulation / multiple scattering ! LINK ONLY WHEN NEEDED
  • i95 : simulation / optics
*this$file
  Ida.hlp
      last change 3mar94
      contains on-line help for IDA
*Ida
  IDA () main command line.

      Short commands :
          p   = plot
          a   = add to plot
          qui = quit IDA
      Command groups : 
          f*  = files (input, output, ..)
	  d*  = directory (and modification of file headers)
	  e*  = edit parameters
          m*  = manipulations (delete, sum, interpolate, ..)
          o*  = operations (arithmetics)
          t*  = transforms (Fourier, ..)
          _*  = incorporated programs
	  r*  = raw data input
          c*  = curves and fits
          g*  = graphics
          i*  = info
      For lists of command groups, enter the first letter.
    For help on specific commands, try '? ' followed by the command.
       
      The prompt IDA normally is followed by a list of default-files.
    Most commands operate on these files. To operate on other files, 
    enter a new filelist, followed by a command or not.
*f
  IDA> command group f* 
          (files: input, output, creation,
                  reorganisation in on-line-memory)
     fl  = load from disk
     fm  = make
     fc  = copy
     fdel= delete
     fx  = exchange (fc and fdel)
     fw  = write to disk
*fl 
  IDA () fl <filename> : load file(s)

      Load data files into on-line memory.
    Usage : with argument :    load one file
            without argument : loop (reply nothing [RETURN] to exit)
      If File names are given without extension, the program looks first
    for ".dat", then for ".asc". 
      File formats : ILL-CrossX, IDA-binary, or IDA-ASCII

      Source : FileWrite in i2.f, colling LoadSpectrum in i1.f       
*fw
  IDA (file-nos) fw : write file(s)

      Save internal files on external device.
    Any files hold in IDA's on-line memory can be saved, including curves.
    As external filename, any valid path name is accepted. If filenames
    are given without extension, files will be saved as ".dat", except
    if ASCII-format is chosen in which case the extension will be ".asc".
      Recommended storage format is IDA-binary; use IDA-ASCII if data shall
    be send to sites with different operating system.

      Source : FileLoad in i2.f, calling SaveSpectrum in i1.f       
*fdel
  IDA (file-nos) fdel : delete files

      Files are deleted from on-line memory.
    There is no way to recover deleted files. Use "fw" to save results.

      Source : FileKill in i3.f, calling FileDel in i2.f
*fc
  IDA (file-nos) fc : copy files

      Duplicate files in on-line memory.

      Source : FileCopy in i3.f
*fx
  IDA (file-nos) fx : exchange order of files

      Files are copied to the end of the on-line memory, 
    then deleted from their original positions. 

      Source : FileCopy and FileKill in i3.f
*fm
  IDA () fm : make a new file

      Create a new on-line file. 
    This option is used to enter data manually, or to convert foreign formats.
    It includes the older conversion program any2ied.
      For converting foreign data formats, first go through the interactive 
    questions section. Then, the program asks to enter spectra in a format
    you have determined before. At this point, use "\ie <filename>" to read 
    the data points from an external file.

      Source : FileMake in i3.f
*d
  IDA> command group d* 
          (directory of on-line memory, 
           inspection and modification of file headers)
     df  = list of files
     dz  = list of spectra
     dd  = list of data entries
     di  = inspect integer parameters
     dr  = inspect (and modify) real parameters
     dt  = inspect (and modify) text parameters
     dg  = inspect (and modify) graphic parameters
*df
  IDA () df : directory of on-line files

      Source : FileInfo in i2.f
*dz
  IDA (file-nos) dz : directory of spectra

      For given files, list all spectra with their z-values
    and their x-data ranges.

      Source : FileInfo in i2.f
*dd
  IDA (file-nos) dd : directory of data entries

      For given files, ask for spectra and channels to list,

      Source : FileInfo in i2.f
*di
  IDA (file-nos) di : inspect integer parameters

      Source : FileInfo in i2.f
*dr
  IDA (file-nos) dr : inspect (and modify) real parameters

      Source : FileRPar in i3.f
*dt
  IDA (file-nos) dt : inspect (and modify) text parameters

      Source : FileTPar in i3.f
*dg
  IDA (file-nos) dg : inspect (and modify) graphics parameters

      Source : FileGPar in i3.f
*mca
  IDA (file-nos) mca : add channels

      For each spectrum of given input files, channels are grouped 
    together : x and y will be replaced by their average values.
      Groups are to be specified in ordered list format, e.g. if there 
    are 12 channels, "*i3" (which is shorthand for "1,4,7,10") means that 
    there will be four groups containing channels 1-3,4-6,7-9, and 10-12.
      If some spectra of one file are defined on different subranges of a
    common grid, the new groups can be set with respect to the common grid.
    If spectra have different length and there is no common grid, groups 
    must be specified individually for each spectrum.

      Source : OrgChSum in i4.f
*mcd
  IDA (file-nos) mcd : delete channels

      For each spectrum of given input files, some channels can be deleted.
    The channels that shall NOT be deleted are to be specified, either by 
    their numbers in ordered list format, or by their x- or y-values.
    Channel specification from files is decouraged.
      If channels are specified by numbers, all spectra of one file are
    compared in order to decide whether there is a common x-grid; in this
    case, numbers can be specified with respect to the common grid.
    If spectra have different length and there is no common grid, channel
    numbers must be given individually for each spectrum.

      Source : OrgChCut in i4.f
*mco
  IDA (file-nos) mco : sort channels

      Sort each spectrum of given input files in ascending order in x.
    If there is more than one occurence of some x-value, the corresponding
    channels are grouped together, taking the average y-value.

      Source : OrgChSort in i4.f
*msa
  IDA (file-nos) msa : add spectra

      For each input file, replace spectra by groups of spectra.
    For each group, channel by channel, input y are replaced by their
    average values. 
      Groups are to be specified by the number of the first old spectrum
    of each new group, in ordered list format.
      If spectra have different x-grids but the same number of channels,
    it is possible to proceed by channel numbers. New x-values are then 
    set by averaging over input files. It recommended, however, to first
    regroup the data onto a common grid (using "mgr") before using "msa".

      Source : OrgSpectraSum in i4.f
*msd
  IDA (file-nos) msd : delete spectra

      For each input file, delete some spectra. 
    The spectra to be deleted are to be specified in ordered list format.
    Answer "-" (empty list) to escape.

      Source : OrgSpectraCut in i4.f
*mso 
  IDA (file-nos) mso : sort spectra
      
      For each input file, sort spectra by their z-value. The contents
    of the spectra themselves is not changed.

      Source : OrgSpectraSort in i4.f
*msj
  IDA (file-nos) msj : join spectra

      For each input file, group some spectra together. Output spectra
    are build by simply appending input spectra one after each other.
    Optionally, channels can be sorted (same as calling "mco").
    Groups are to be specified the same way as in "msa".
    
      Source : OrgSpectraJoin in i4.f
*msx
  IDA (file-nos) msx : exchange spectra <-> channels

      For each input file, exchange x- and z-coordinate.
    Evidently, all spectra must be defined on a common x-grid.

      Source : OrgSpectraExch in i4.f
*mfs
  IDA (file-nos) mfs : sum spectra of different files

      It supposed that the input files have commensurable z-scales.
    Then, all spectra sharing the same z are averaged to form one
    output spectrum (whether two z's are considered equal is controlled
    by a "tolerance" parameter). 
      The averaging can only be done, if the x-grids are identical.

      Source : OrgFileJoin in i4.f
*mfj
  IDA (file-nos) mfj : append files into one file

      Simply, make one file out of several input files.
    Say, there are 2 files with 3 spectra each : (ABC) and (abc).
    Then, the output file will contain either (ABCabc) (option "file
    after file"), or (AaBbCc) (option "spectrum after spectrum").
      The spectra themselves remain unchanged (except if "msj" is 
    called at the end).

      Source : OrgFileJoin in i4.f
*mfx
  IDA (file-nos) mfx : exchange files <-> spectra

      Suppose, spectra y(x) have been measured for different values
    of two parameters U and V. Originally, spectra with the same U
    may have been grouped into files with a real-parameter r(n)=U,
    and V has a z-coordinate. The operation "mfx" regroups them into
    files with the same real-parameter r(n')=V and a z-coordinate U. 

      Source : OrgFileJoin in i4.f
*mgi
  IDA (file-nos) mgi : new x-grid, interpolate y

      Choose a new x-grid, then determine y(x) on this grid by
    interpolation of input data.
      Options for choosing a grid are :
    > from a file f2
    > > (1:1)        for each output spectrum one spectrum of f2
                     with same z is searched for
    > > (select one) one spectrum of f2 defines the grid for all output
    > regular grid
    > > (lin)        X(i) = X(1) + [X(n)-X(1)]*[(i-1)/(n-1)]
    > > (log)        X(i) = X(1) * [X(n)/X(1)]^[(i-1)/(n-1)]
    > > (1/2-log)    starts logarithmically at X(1)=-X(n), becomes linear
                     around 0 (from -crossover to +crossover), then
                     returns to logarithmic increase until X(n).

      Source : OrgGrid in i4.f
*mge
  IDA (file-nos) mge : new x-grid, extrapolate y

      Choose a new x-grid, then determine y(x) on this grid by
    interpolation and extrapolation. 
      Options for extrapolations include
         > by 0
         > by any other given value
         > by value of nearest neighbours
      Options for choosing a new grid are the same as for mgi (see there).

      Source : OrgGrid in i4.f
*mgr
  IDA (file-nos) mgr : new x-grid, redistribute y

      Choose a new x-grid, then determine y(x) on this grid by
    redistributing histogram intensities of input data.
      Options for choosing a new grid are the same as for mgi (see there).

      Source : OrgGrid in i4.f
*mgd
  IDA (file-nos) mgd : new x-grid, reduce input

      Choose a new x-grid. If there are several x on input which
    fall into the same interval of the new grid, only one x-y pair 
    per interval is retained, the other input data are thrown away.
      This option is needed for producing final output, when experimental 
    data had to be temporarily interpolated onto a finer grid.
      Options for choosing a new grid are the same as for mgi (see there).

      Source : OrgGrid in i4.f
*ox 
  IDA (file-nos) ox <function <2nd argument>> : operate on x

      Replace x by a function of x and possibly a second argument.
    Examples : "6-8 ox / ef" devides x by a constant which will be asked
                             for individually for each of the input files 6-8;
               "7 ox $ x'"   replaces x by x' of another file (the number
                             of which will be asked for)

      Source : OprPoint in i5.f
*oy
  IDA (file-nos) oz <function <2nd argument>> : operate on y

      Replace y by a function of y and possibly a second argument.
    Examples : "6 oy * i"    multiplies y by an argument y'(z) which
                             will be read from another file 
               "1-2 oy $/ d" replace y by dy/y, where dy will be taken
                             from the same input files 1-2 as y

      Source : OprPoint in i5.f
*oz
  IDA (file-nos) oz <function <2nd argument>> : operate on z

      Replace z by a function of z and possibly a second argument.

      Source : OprPoint in i5.f
*oi
  IDA (file-nos) oi : calculate an integral property

      For a spectrum y(x), a property i[y(x)] is calculated.
    Examples: maximum value of y,
              x at maximum of y,
              integral I dx y(x).
    If there is only one input spectrum, the output is a single number.
    If the input file contains several spectra, the output is saved
    as a file containing the spectrum i(z).

      Source : OprIntegral in i5.f
*ot
  IDA (file-nos) ot : clone y(x) into a tensor product y(x,z)

      Suppose you have one spectrum y(x), and you want to manipulate
    this spectrum for different values of a parameter p.
    A convenient way to achieve this is to expand y(x) into a file y(x,z),
    consisting of a set of identical spectra y(x) with z=p.
      You can either read z from another file or specify a regular grid.

      Source : OprTensor in i5.f
*p 
  IDA (file-nos) p <spectra-nos> : plot

      Plot the input files.
    When called for the first time, this command opens a graphic window;
    on later calls, previous plots are cleared.
      Use "a" to add more spectra into existing plot.
      See "g*" commands for more graphic options.

      Source : IdaPlot in i0.f, calling the graphic library g*.f
*a 
  IDA (file-nos) a <spectra-nos> : add

      Add more spectra to existing plot.
      See 'g*' commands for more graphic options.

      Source : IdaPlot in i0.f, calling the graphic library g*.f
*gp
  IDA () gp <ps-filename> : graphic to postscript

      Write the graphic actually shown in the Tektronix window
    in a PostScript file. Works even after the Tektronix window
    has been closed.
      The default filename is l<n>.ps, where <n> is the lowest
    integer for which no such file already exists.
      The PostScript file may subsequently be modified using
    a text editor. Search for the string "Switchboard" for the
    most relevant commands. 

      Source : GraSoftCopy in g2.f
*g:
  IDA () g: : list graphic setup

      List setup of the chosen graphic window.
      Use "gw" to change the window.

      Source : GraChoice in g2.f
*gw
  IDA () gw <window-no> : select graphic window

      A graphic window is here the ensemble of all parameters defining
    a graphic setup, like coordinate bounds, symbol size, and toggles
    between linear/logarithmic scales and so on. It is useful to switch
    between graphic windows when functions of incommensurable coordinates
    with completely different x- and y-bounds are to be plotted.
      Different graphic windows do NOT correspond to different windows
    on the X-terminal.

      Source : GraChoice in g2.f
*cc
  IDA (file-nos) cc : create curve

      Create a curve for fitting the input files. 
    Curves are saved internally like data files; they can be written
    to external files with "fw", they can be plotted with "p" and "a",
    but most other operations are meaningless with curves.

      Source : CuCreate in i6.f
*i
  IDA> command group i* (info on the state of the program)
     ia  = array dimensions'
*eoi