Program: MKLSGRIDMODIFY

  mklsgridmodify........apply modifications to LOCSMITH search grid
 
  call: [newgrid,modifycnt]=mklsgridmodify(lsopt,grid,idlist,mode);
        [newgrid,modifycnt]=mklsgridmodify(lsopt,grid,idlist,'iterate',iterations);
 
               lsopt: (struct)
                      LOCSMITH options structure as returned by MKLSOPT
             
                grid: (struct)
                      a grid structure as returned by MKLSGRIDNEW.
                      This grid will be refined according to the settings
                      in the other parameters.
 
              idlist: this parameter has different meanings for different
                      grid types.
 
                      For triangular grids:
 
                      (struct array)
                      A struture variable that defines the layers and
                      triangles to be modified. The following fields are
                      expected:
                      .layer: (numeric)
                              layer ID, only one per element of IDLIST.
                      .triangle: (numeric array)
                                 list of triangle IDs
 
                      idlist(i).layer defines a layer in which
                      modifications on triangles shall be made. Then
                      idlist(i).triangle is a list of triangle IDs that
                      defines which triangles of the speicifed layer are to
                      be modified.
                      If n layers are to be modified, IDLIST must consist
                      of n elements, each having its own .layer and
                      .triangle fields.
 
                      For cartesian grids:
              
                      (not yet implemented)
 
                mode: (string)
                      The MODE of operation defines what to do with the
                      speciifed layers and triangles. The following modes
                      are available:
                      'kill': removes triangles from the triangle list of a
                              layer. To remove means that treangles are
                              irreversibly deleted from the list!
                      'deactivate': deactivates triangles by setting their
                                    active-flag, but leaving it in the list.
                      'activate': re-activates deactivated triangles by
                                  setting their active flag.
                      'iterate': iterates the triangles (if they are
                                 active). This means that new triangles and
                                 nodes are generated.
 
               iterations: (number)
                           the number of grid iterations to be applied to
                           the grid. This argument is relevant in 'iterate'
                           mode only (grid refinement).
 
  result: grid: (structure array)
                modified LOCSMITH search grid.
          modifycnt: (number)
                     A number counting how may modifications were applied.
                     For precise definition, see MKLSGRIDMODIFYTRI and the
                     respective routine for cartesian grids.
 
  In triangular grids, this routine only modifies the triangles of layers,
  but it does not remove existing layers or construct new layers.
 
  Martin Knapmeyer, 21.09.2004

Read M-File Source Code


eof.