2.2.1.14 xyzgrid

1 Menu Information
2 Brief Information
3 Additional Information
4 Command Line Usage
5 X-Function Execution Options
6 Variables
7 Description
8 Algorithm
9 References
10 Related X-Functions

Menu Information

Extract Data Points (context menu of Contour plot) / Click the button in Mini Toolbar

Brief Information

Extract data points from contour plot.

Additional Information

Minimum Origin Version Required: 2016 SR0

Command Line Usage

1. xyzgrid rows:=10 cols:=10; // With contour graph window active

2. xyzgrid rows:=40 cols:=40 xmin:= -100 xmax:=-80 ymin:=30 ymax:= 40 type:=mat; // With contour graph window active

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
Data Points	iz	Input int	0	Specify the methods to extract data points. Option list: 0=grids: by Grids 1=cols: by Columns 2=pick: Pick from Graph
Input	iz	Input XYZRange	<active>	XYZ worksheet data used to generate grids.
Input	iy	Input XYRange		When extract data points by column, specify the XY range for extracted data point.
X Grid Size	rows	Input int	21	Specify the number of grid points along X direction.
Y Grid Size	cols	Input int	21	Specify the number of grid points along Y direction.
X Minimum	xmin	Input double	<auto>	the minimum X value of the output XYZ/matrix data.
X Maximum	xmax	Input double	<auto>	the maximum X value of the output XYZ/matrix data.
Y Minimum	ymin	Input double	<auto>	the minimum Y value of the output XYZ/matrix data.
Y Maximum	ymax	Input double	<auto>	the maximum Y value of the output XYZ/matrix data.
Output to	type	Input int	0	Specify which data form to be outputted. Option list: xyz{0}:XYZ Data Output interpolated contour values in XYZ data form. mat{1}:Matrix Output interpolated contour values in matrix form.
Pick Points	pickpts	Input int		When extract data points by Pick from Graph, specify the points by double-clicking on the graph.
Output	oz	Output XYZRange	[<new>]<new>!(<new>,<new>,<new>)	Specify a worksheet to output the extracted data. See the syntax here.
Output Matrix	om	Output MatrixObject	<new>	Specify a matrix to output the extracted data. See the syntax here.

Description

This X-Function is used to extract data from XYZ contour/XYZ worksheet data.

Algorithm

The values for the specified extracted data points are computed by triangulation and line interpolation as described in algorithm section. Note that contour values outside input data range will be set as missing values.