2.2.1.13 XYZ2MatLog

Contents

Menu Information

Worksheet: Convert to Matrix: XYZ Log Gridding

Brief Information

Convert XYZ data to matrix with logarithmic gridding

Additional Information

Minimum Origin Version Required: 8.5.1 SR0

Command Line Usage

1. XYZ2MatLog iz:=(col(a),col(b),col(c)) settings.ConvertToMatrix:=2 ovm:=<new: RenkaCline>;

X-Function Execution Options

Please refer to the page for additional option switches when accessing the x-function from script

Variables

Display
Name 		Variable
Name 		I/O
and
Type 		Default
Value 		Description
Input iz

Input

XYZRange

<active>
 Source XYZ worksheet data to convert into matrix by log gridding. If multiple Z columns are specified, each Z column will be converted to a matrix object of the same matrix sheet.
Gridding Settings settings

Input

TreeNode

<unassigned>
 Settings for log gridding XYZ worksheet data. Please refer to More Information section below for more details.
Output Matrix om

Output

MatrixLayer

<new>
 If the associated check-box is selected, this option allows specifying a matrix for the output log gridding data. If the input contains n Z columns, the output matrix sheet will have n objects. Only one of Output Matrix and Output Virtual Matrix can be selected.

See the syntax of Output Notations.

Output Virtual Matrix ovm

Output

Worksheet

<new>
 If the associated check-box is selected, this option allows specifying a worksheet for the output log gridding data. And the output worksheet is arranged as a virtual matrix. Only one of Output Matrix and Output Virtual Matrix can be selected. And if the input contains multiple sets of Z columns, virtual matrix is not supported.

See the syntax of Output Notations.

Description

This X-Function will first calculate the logarithmic values for X and Y values, and then perform XYZ Gridding just as XYZ2Mat does. Both X-Functions have the same input and output settings. This is equivalent to the following two steps:

  1. Calculate the logarithmic values for the input X and Y, get the results as Log(X) and Log(Y) respectively.
  2. Perform XYZ gridding on (Log(X), Log(Y), Z) by using XYZ2Mat X-Function.


For more information, please refer to our User Guide: XYZ Gridding Methods Description

More Information

settings (Gridding Settings)

The settings (Gridding Settings) tree specifies the XYZ gridding settings.

Syntax: settings.Treenode:=<value>

Example: settings.ConvertToMatrix:=2


Treenode Type Default Description
ExamData
(Data Examination) 		XStepTol (Tolerance for Even X Step) doule 1E-8 ExamData (Data Examination)
YStepTol (Tolerancce for Even Y Step) double 1E-8
XPrecision (Tolerance for Duplicate X) double 1E-8
YPrecision (Tolerance for Duplicate Y) double 1E-8
RemoveDuplicate (Replace Duplicate With) int 0
ConvertToMatrix
(Gridding Method and Parameters) 		columns (Columns) int 20 Gridding Method and Parameters
rows (Rows) int 20
QILF (Quadratic Interpolant Locality Factor) double 18
WFLF (Weight Function Locality Factor) double 9
searchradiu (Search Radius) doule 2
averadius double 2
minipoints (Minimum Points) double 10
maxipoints (Maximum Points) double 100
CorrelationSmoothing (Smoothing) int 1
TPSSmoothing (Smoothing) int 0
extrapolation (Extrapolation) int 0
outsizevalue (Outside Value) int 0
tolerance (Tolerance) double 0.005
advanced
(Advanced) 		SelectRange (Range Restriction) treenode
  • xmin (X Minimum): 0
  • xmax (X Maximum): 0
  • ymin (Y Minimum): 0
  • ymax (Y Maximum): 0
 Advanced
noextrapolation
(No Extrapolation outside Boundary) 		int 0 No Extrapolation outside Boundary
previewplottype
(Preview Plot Type) 		int 1 Preview Plot Type

Algorithm

References

Related X-Functions

w2m, m2w, r2m, wexpand2m, xyz_regular, xyz_sparse, xyz_shep, xyz_shep_nag, xyz_renka, xyz_renka_nag, xyz_tps

Keywords:worksheet