dx-doc 1:4.4.4-7 / usr / share / doc / dx / help / dxall778

#!F-adobe-helvetica-medium-r-normal--18*
#!N 
#!N  #!Rautgrid AutoGrid 
#!N #!N Category #!N #!N  #!Lcatrel,dxall759 h Realization  #!EL  #!N #!N Function #!N #!N 
Maps scattered points onto a grid. #!N #!N Syntax #!CForestGreen #!N 
#!N  #!F-adobe-courier-bold-r-normal--18*   #!N  #!F-adobe-times-bold-r-normal--18*   output #!EF = AutoGrid(  #!F-adobe-times-bold-r-normal--18*   input, densityfactor, 
nearest, #!N radius,exponent,missing #!EF ); #!EF #!N #!N #!EC #!N #!N 
Inputs #!T,1,91,276,461,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name TAB Type TAB Default 
TAB Description #!EF #!N TAB input TAB field or vector list 
TAB none TAB field with positions to regrid #!N TAB densityfactor 
TAB scalar or vector TAB 1.0 TAB densityfactor for grid #!N 
TAB nearest TAB integer or string TAB 1 TAB number of 
nearest neighbors to use #!N TAB radius TAB scalar TAB appropriate 
TAB radius from grid point to consider #!N TAB exponent TAB 
scalar TAB 1.0 TAB weighting exponent #!N TAB missing TAB value 
TAB no default TAB missing value to be inserted if #!N 
TAB - TAB - TAB - TAB necessary #!N TAB - 
TAB - TAB - TAB #!EF #!N #!N Outputs #!T,1,161,321,646  #!F-adobe-times-medium-r-normal--14*   
 #!F-adobe-times-bold-r-normal--18*   #!N TAB Name TAB Type TAB Description #!EF #!N TAB 
output TAB field TAB regridded field #!N TAB - TAB - 
TAB #!EF #!N #!N Functional Details #!N #!N This module uses 
a specified set of scattered points (  #!F-adobe-times-bold-r-normal--18*   input #!EF ) 
to assign data to every position of a grid. This module 
differs from Regrid in that you do not supply a grid; 
one is constructed automatically for you. #!N #!I0 #!N #!N #!I0 
#!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   input #!EF #!EF #!I50 #!N should be either 
(1) a field with a 1-, 2-, or 3-dimensional "positions" component 
or (2) a list of 1-, 2-, or 3-dimensional vectors. In 
the second case, the vectors are interpreted as positions. #!N #!I0 
#!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   densityfactor #!EF #!EF #!I50 #!N specifies how to 
modify the automatically generated grid. By default the automatically generated grid 
will have approximately as many points as there are points in 
 #!F-adobe-times-bold-r-normal--18*   input #!EF , and each cell will be square. If 
 #!F-adobe-times-bold-r-normal--18*   densityfactor #!EF is a single scalar value, then there will 
be  #!F-adobe-times-bold-r-normal--18*   densityfactor #!EF times as many cells in each dimension. 
If  #!F-adobe-times-bold-r-normal--18*   densityfactor #!EF is a vector, then you can modify 
the number of cells in each dimension differentially. #!N #!I0 #!N 
 #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   nearest #!EF #!EF #!I50 #!N must be an integer 
or the string "infinity." An integer value specifies the number of 
nearest points (to each grid point) to be used in computing 
an average data value for that grid point. #!N #!I0 #!N 
 #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   radius #!EF #!EF #!I50 #!N By default, only those 
points within an automatically computed radius will be considered when assigning 
data values to grid positions. This automatically computed radius is twice 
the largest dimension of a cell in the grid. You can 
explicitly set the radius to a value measured in the units 
of the "positions" component of  #!F-adobe-times-bold-r-normal--18*   input #!EF . If you 
specify  #!F-adobe-times-bold-r-normal--18*   radius #!EF ="infinity," then no cutoff in distance will 
be used; all points will contribute to the result at each 
grid point. #!N #!N AutoGrid attaches a "AutoGrid radius" attribute to 
 #!F-adobe-times-bold-r-normal--18*   output #!EF , with a value equal to the radius 
used, or the string "infinity." #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   exponent 
#!EF #!EF #!I50 #!N The averaging method is a weighted average. 
The expression for this average is 1/radius(  #!F-adobe-times-bold-r-normal--18*   (exponent) #!EF ) 
. The default value is 1.0, reducing the expression to the 
reciprocal of the radius. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   missing #!EF 
#!EF #!I50 #!N is used when  #!F-adobe-times-bold-r-normal--18*   radius #!EF is set 
to a value other than "infinity." The parameter specifies how to 
treat those grid points for which no points in  #!F-adobe-times-bold-r-normal--18*   input 
#!EF occur within the specified radius. #!N #!N If  #!F-adobe-times-bold-r-normal--18*   missing 
#!EF  #!F-adobe-times-medium-i-normal--18*   is not set #!EF , the module creates an 
"invalid positions" component, and grid points with no assigned data value 
are invalidated. If  #!F-adobe-times-bold-r-normal--18*   missing #!EF is set, the data value 
is inserted for the missing data values. It must match the 
data component of  #!F-adobe-times-bold-r-normal--18*   input #!EF in rank, type, and shape. 
#!N #!N All components that are position-dependent are treated in the 
same way as the "data" component. #!I0 #!N #!N #!N #!N 
Components #!N #!N Adds a "connections" component. The "positions" and "connections" 
components are those of  #!F-adobe-times-bold-r-normal--18*   grid #!EF while all components in 
 #!F-adobe-times-bold-r-normal--18*   input #!EF that depend on "positions" will be present in 
the output, modified by averaging. #!N #!N Example Visual Programs #!CForestGreen 
#!N #!N  #!F-adobe-courier-bold-r-normal--18*   #!N SIMPLE/AutoGrid.net #!N ConnectingScatteredPoints #!EF #!N #!N #!EC 
#!N #!N See Also #!N #!N  #!Lconnect,dxall797 h Connect  #!EL  ,  #!Lregrid,dxall920 h Regrid  #!EL  ,  #!Linclude,dxall873 h Include  #!EL  
#!N #!N #!N  #!F-adobe-times-medium-i-normal--18*   Next Topic #!EF #!N #!N  #!Lband,dxall779 h Band  #!EL  #!N 
 #!F-adobe-times-medium-i-normal--18*   #!N