Contents

Previous

Next

Subchapters

Current Chapters-> tpaddzone tpcolors tpcontour tpdataset tpdims tpexport tpframe tpget tpget3D tphist tpmacrofile tpmacrostring tpmapcopy tpmapcount tpopen tpplot tpplottype tpprint tpput tpput3D tprunning tpstart tpsurface tpsymbols tpvarname tpvarnum tpxyzaxes tpzone tpzonename tpzonenum wtecplot rtecplot pltgui

Parent Chapters-> Omatrix6 graphics tecplot tpaddzone

Search Tools-> contents reference index search

Adding a Zone to an Existing Dataset

Syntax	zoneNumber = tpaddzone(I,J)
	zoneNumber = tpaddzone(I,J,K)
	zoneNumber = tpaddzone(I,J,K, name)
See Also	tpdataset , tpzone , tpframe , tpmapcopy , tpput , tpget , tpopen

Description
Add a new zone to the dataset of the currently active Tecplot frame. The arguments I, J, and K must be integer scalars that specify the I, J and K values of the new zone. If the variable K is not specified, K is set to 1. The return value zoneNumber is an integer scalar that specifies the number of the zone that was created. If present, the argument name must be a character row vector which is used as the name of the zone created.

Examples
If from the Tecplot menu you select "File | New Layout" and then select "Data | Create Zone | Rectangular", Tecplot will create a new data set that contains 1 zone and variables X, Y, and Z. If at the O-Matrix prompt you enter
   tpaddzone(3,4)
O-Matrix will echo 2 in the command window which is the number of the new zone created and Tecplot will now have a new zone with IMax = 3, and JMax = 4, and KMax = 1.

If at the O-Matrix prompt you enter
   tpopen
   tpdataset({"Sample 1", "Sample 2", "Sample 3"})
O-Matrix will create a new dataset with 3 variables Sample 1, Sample 2, and Sample 3. If you continue by entering
   tpaddzone(20, 1, 1, "Experiment 1")
   tpaddzone(20, 1, 1, "Experiment 2")
O-Matrix will add 2 zones to the data set with names Experiment 1, and Experiment 2, each with I = 20, J = 1, and K = 1.

See the tpmapcopy function for additional examples that use the tpaddzone function.