Macro Commands Summary
Animation Macros
Animate
| Syntax | Description |
|---|---|
$!AddonCommand |
Animates grid plots. Set animation parameters using the AnimateSetup command. |
AnimateSetup
| Syntax | Description |
|---|---|
$!AddonCommand |
Sets up the parameters for playing and recording in grid plot animations. The same parameters are used for recording and playing, although some parameters are ignored when not recording. |
| Parameter | Syntax | Default | Notes |
|---|---|---|---|
FName |
= <string> |
none |
Name of the animation file. Ignored when not recording. |
FType |
= <option> |
Avi |
Type of animate file to create. Valid options are Avi, MPEG4, Png, Bmp, Ps, Tiff, Eps, Wmf, Jpeg. If a single image format is specified (Png, etc.), then each frame of the animation will be output as a single image in the parent directory of the specified file name (FName). The file name of each frame will include the base file name FName parameter and a sequence number. |
Speed |
= <double> |
1.0 |
Animation speed. Applies only to output formats that recognize frame speed. |
Antialias |
= <boolean> |
False |
Perform antialiasing to improve quality True or False |
SuperSampleFactor |
= <integer> |
3 |
Antialiasing super factor. |
Width |
= <integer> |
300 |
Sets the width of the output frame. Ignored when not recording. |
StartPercent |
= <integer> |
0 |
Starting position of the animation as a percentage of total frames. Zero indicates the first frame. |
EndPercent |
= <integer> |
100 |
Ending position of the animation as a percentage of total frames. One hundred indicates the last frame. |
Record |
= <boolean> |
Set to True to record this animation. |
|
Direction |
= <integer> |
1 |
Animation direction: 1 for forward, and -1 for backwards |
CrossPlot
| Syntax | Description |
|---|---|
$!AddonCommand |
Change settings for Cross plots. Has no effect if the Plot type is not 2D or 3D Grid. |
| Parameter | Syntax | Default | Notes |
|---|---|---|---|
Show |
= <boolean> |
None |
Show Cross Plot frame - True or False |
Histogram
| Syntax | Description |
|---|---|
$!AddonCommand |
Change settings for histogram plots. Has no effect if the Plot type is not 2D or 3D Grid. |
| Parameter | Syntax | Default | Notes |
|---|---|---|---|
Show |
= <boolean> |
None |
Show Histogram Plot frame - True or False |
XYAnimate
| Syntax | Description |
|---|---|
$!AddonCommand |
Starts the animation of XY plots. Set animation options using the XYAnimateSetup command. |
XYAnimateSetup
| Syntax | Description |
|---|---|
$!AddonCommand |
Sets up the parameters for playing and recording in XY plot animations. The same parameters are used for recording and playing, although some parameters are ignored when not recording. |
| Parameter | Syntax | Default | Notes |
|---|---|---|---|
Type |
= <option> |
none |
Type of XY plot to be animated XYvariables, XYentities, or Custom |
| Parameter | Syntax | Default | Notes | ||||
|---|---|---|---|---|---|---|---|
FName |
= <string> |
none |
Name of the animation file. Ignored when not recording. |
||||
FType |
= <option> |
Avi |
Type of animate file to create. Valid options are Avi, MPEG4, Png, Bmp, Ps, Tiff, Eps, Wmf, Jpeg. If a single image format is specified (Png, etc.), then each frame of the animation will be output as a single image in the parent directory of the specified file name (FName). The file name of each frame will include the base file name FName parameter and a sequence number. |
||||
Speed |
= <double> |
1.0 |
Animation speed. Applies only to output formats that recognize frame speed. |
||||
AntiAlias |
= <boolean> |
False |
Perform antialiasing to improve quality True or False |
||||
SuperSampleFactor |
= <integer> |
3 |
Antialiasing super sampling factor. |
||||
Width |
= <integer> |
300 |
Sets the width of the output frame. Ignored when not recording. |
||||
ObjectSet |
= <set> |
None |
Set of 1-based Entities/Variable numbers to export if exporting a sequence of images. The set is enclosed in square brackets and indices are separated by commas or a dash to indicate a range. Example: [1,2,4-7]. Each entity/variable is a 1-based index from the list of available entities or variables after any filtering has been applied.
|
||||
StartSelect |
= <integer> |
1 |
Starting entity or variable number (depending on the plot type). This uses a 1-based index from the list of available entities or variables after any filtering has been applied |
||||
StopSelect |
= <integer> |
2 |
Final entity or variable index. |
||||
Record |
= <boolean> |
False |
Set to True to record this animation. |
XYGlobalSettings
| Syntax | Description |
|---|---|
$!AddonCommand |
Sets global options for XY plots |
| Parameter | Syntax | Default | Notes |
|---|---|---|---|
Frameselectionmode |
= <option> |
Sequential |
Sets the frame selection mode. Must be one of the following: Sequential - Variables are assigned based on the ordering in the sidebar (default) Manual - A variable can be assigned to each individual multi-frame. |
File Loading and Saving
These macros handle loading and saving of XY, grid, streamline data files and specialized files.
CMGSetup
| Syntax | Description |
|---|---|
$!AddonCommand |
Sets options for loading CMG data, currently only units. These option must be specified before any data files are loaded and apply globally to all files opened in a session. |
| Parameter | Syntax | Default | Notes |
|---|---|---|---|
Units |
= <string> |
Unit_Si, Unit_Field, Unit_Lab, Unit_Modsi, Unit_Chears, Unit_Gemsi, Unit_GemField, Unit_StarsLab |
CopyXYLineStyles
| Syntax | Description |
|---|---|
$!AddonCommand |
Copies XY Line styles to one or more style sets. |
| Parameter | Syntax | Notes |
|---|---|---|
Variables |
= <string>,<string>,… |
One or more short variable names to copy the settings to |
| Parameter | Syntax | Default | Notes |
|---|---|---|---|
CompStyleSets |
= [<set>] |
None |
Specify one or more Comp style sets. Comp style sets are numbered 1-99. |
CopyToActiveStyleSet |
= <boolean> |
False |
Set to True to copy to the active style set in addition to the Comp style sets specified in the CompStyleSets parameter. |
ShowLines |
= <boolean> |
Show lines. |
|
LineColor |
Line color. Any of the standard colors listed in ColorOption, plus Default. |
||
LinePattern |
= <option> |
Line pattern. Default, Solid, Shortdash, Dashdot, Dotted, Longdash, or Dashdotdot |
|
LinePatternLength |
= <double> |
Line pattern as a percent. If the value does not match one of the preset values on the Plot Options dialog, it converts to the nearest preset value. |
|
LineThickness |
= <double> |
Line thickness as a percent. If the value does not match one of the preset values on the Plot Options dialog, it converts to the nearest preset value. |
|
ShowSymbols |
= <boolean> |
True to show all symbols. |
|
SymbolFill |
= <boolean> |
True to fill all symbols. |
|
SymbolColor |
Symbol color. Any of the standard colors listed in ColorOption, plus Default and Match. |
ExtractCellData
| Syntax | Description |
|---|---|
$!AddonCommand |
Save the data from a group of cells to file. |
| Parameter | Syntax | Default | Notes |
|---|---|---|---|
FName |
= <string> |
File name to save |
|
CellSelection |
= <string> |
Visible |
Visible, Blanked, All, Well or Completion |
Times |
= <string>,<string>, … |
The entry should consist of a list of strings, each containing a single integer value specifying the time step. They should not be date or time strings. |
|
Variable |
= <string>,<string>, … |
Comma-separated list of variable names |
|
Well |
= <string>,<string>,… |
Comma-separated list of well names |
|
Type |
= <string> |
CSV |
Chooses the output format: CSV or Sector |
Name |
= <string> |
Chooses grid from which the macro will pull data for sector output. Use any grid name from active data set |
|
FType |
= <string> |
Chears |
Chooses the file type of sector data output file. Choose Chears, Eclipse, or VIP |
IMin |
= <integer> |
1 |
Chooses minimum I-cell range for sector output. I range can vary between 1 (one) and the Imax of the specified grid (will be clipped if range is exceeded) |
IMax |
= <integer> |
1 |
Chooses maximum I-cell range for sector output |
JMin |
= <integer> |
1 |
Chooses minimum J-cell range for sector output. J range can vary between 1 (one) and the Jmax of the specified grid (will be clipped if range is exceeded) |
JMax |
= <integer> |
1 |
Chooses maximum J-cell range for sector output |
KMin |
= <integer> |
1 |
Chooses minimum K-cell range for sector output. K range can vary between 1 (one) and Kmax of the specified grid (will be clipped if range is exceeded) |
KMax |
= <integer> |
1 |
Chooses maximum K-cell range for sector output |
ShowKAvg |
= <boolean> |
F |
If true, behaves as though KAvg radio button is selected in CSV Extractions by Cell. Type must be CSV. Only one of KAvg and KSum should be set to true. If neither KSum nor KAvg is true, cell data is exported. Note that both KSum and KAvg imply export only sum or average of visible data for full range of I and J. |
ShowKSum |
= <boolean> |
F |
If true, behaves as though KSum radio button is selected in CSV Extractions by Cell. See notes above under Showkavg. |
GalleryDelete
| Syntax | Description |
|---|---|
$!AddonCommand |
This command deletes a plot from the Gallery. |
| Parameter | Syntax | Notes |
|---|---|---|
Name |
= <string> |
Name of Gallery plot to be deleted. |
GalleryDisplay
| Syntax | Description |
|---|---|
$!AddonCommand |
This command displays a plot from the Gallery. |
| Parameter | Syntax | Notes |
|---|---|---|
Name |
= <string> |
Name of Gallery plot to be displayed. |
GallerySave
| Syntax | Description |
|---|---|
$!AddonCommand |
This command saves a plot to the Gallery. |
| Parameter | Syntax | Notes |
|---|---|---|
Name |
= <string> |
Name by which current plot will be known in the Gallery. |
LoadCustomPlot
| Syntax | Description |
|---|---|
$!AddonCommand |
This command allows you to load a *.rsc file containing custom plot data. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
File name of file to load. |
LoadFlowTable
| Syntax | Description |
|---|---|
$!AddonCommand |
This command allows you to load a Chears *.flot flow table file. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
File name of flow table to load. |
LoadGridData
| Syntax | Description |
|---|---|
$!AddonCommand |
| Parameter | Syntax | Notes |
|---|---|---|
Name |
= <string> |
Name of file containing the grid geometry. |
SolutionFile |
= <string> |
Name of file containing solution file. Can be repeated when multiple files are required. For VDB files, use the SolutionFile parameter to specify the case name. |
Appendrule |
= <boolean> |
Indicates whether data are appended to existing grid (True) or a new grid is being loaded (False). |
LoadGridDelta
| Syntax | Description |
|---|---|
$!AddonCommand |
| Parameter | Syntax | Notes |
|---|---|---|
Name |
= <string> |
Name of files used for delta solution. Four names must be included, beginning with the grid file, followed by the two solution files, and ending with the output file name that will hold the delta values. |
DeltaType |
= <string> |
Defines option for computing delta values.
Allowed options are: VC-VR (Default) |
DeltaMagnitude |
= <boolean> |
Defines whether to use delta magnitudes True or False. |
LoadGridTransform
| Syntax | Description |
|---|---|
$!AddonCommand |
This command is used to set the grid transformation values, including coordinate conversion, rotation, and translation. |
| Parameter | Syntax | Notes |
|---|---|---|
ConvertX |
= <double> |
Value by which to scale the X coordinate (default = 1) |
ConvertY |
= <double> |
Value by which to scale the Y coordinate (default = 1) |
ConvertZ |
= <double> |
Value by which to scale the Z coordinate (default = 1) |
DeltaX |
= <double> |
Value by which to shift the X coordinate (default = 0). |
DeltaY |
= <double> |
Value by which to shift the Y coordinate (default = 0). |
CenterX |
= <double> |
X coordinate of the center to which to rotate the grid. |
CenterY |
= <double> |
Y coordinate of the center to which to rotate the grid. |
RotateSin |
= <double> |
Sine value of the angle of rotation. |
RotateCos |
= <double> |
Cosine value of the angle of rotation. |
LoadGridSmoothing
| Syntax | Description |
|---|---|
$!AddonCommand |
This command is used to set the grid smoothing parameters. |
| Parameter | Syntax | Notes |
|---|---|---|
SolveGridRule |
= <option> |
Controls whether to re-process the Rsgrid file, if it exists. - Never, Conditional (if options are different) or Always |
CornerPoint |
= <option> |
Create corner point options - Original, Shift, or Average |
XYTolerance |
= <double> |
Tolerance for XY dimensions. Note: You must also set ZTolerance when setting XYTolerance. |
ZTolerance |
= <double> |
Tolerance for Z dimensions. Note: You must also set XYTolerance when setting ZTolerance. |
LoadGridNNCs
| Syntax | Description |
|---|---|
$!AddonCommand |
This command is used to set the grid smoothing parameters. |
| Parameter | Syntax | Notes |
|---|---|---|
OptimizeNNCs |
= <option> |
Controls whether to load NNC data, if it exists. - Never, Conditional (if not dual-porosity) or Always |
LoadGridInactiveCell
| Syntax | Description |
|---|---|
$!AddonCommand |
This command is used to specify the variable used to identify inactive cells for VIP grid data files. |
| Parameter | Syntax | Notes |
|---|---|---|
InactiveCellCondition |
= <string> |
A string containing the inactive cell condition. The string should consist of a variable name, one of the allowed operator, and a floating point value. The allowed comparison operators are: >, <, and =. The string should be surrounded in double quotation marks. |
Example: In this example, cells with a Kid value less than zero will be treated as inactive cells.
$!AddonCommand
AddonID = 'Tecplot RS'
Command = 'LoadGridInactiveCell InactiveCellCondition="Kid<0.0"'
LoadPaperLayout
| Syntax | Description |
|---|---|
$!AddonCommand |
Loads a saved paper layout template. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Name of file to load. |
LoadPlotStyle
| Syntax | Description |
|---|---|
$!AddonCommand |
Loads plot styles. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Name of file to load. |
LoadRFTLayers
| Syntax | Description |
|---|---|
$!AddonCommand |
Loads RFT layers from CSV file. See section RFT Plot Text and Layer Details for the expected CSV format. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Name of the CSV file to load. |
LoadXYData
| Syntax | Description |
|---|---|
$!AddonCommand |
Macro command for loading XY data, survey wells, or streamline files. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Name of file. |
FType |
= <option> |
Type of file. EclfRft, FrontSim, ChearCSV, ChearsHist, IntersectHist, VIP, XYMultiList, Project, VDB, CMG, VIPObserved or GenericAscii |
Case |
= <string> |
For VDB files only. Name of the case to load. |
| Parameter | Syntax | Notes |
|---|---|---|
Active |
= <boolean> |
Sets this file as the active file: Default: False |
AutoAppendRFT |
= <boolean> |
Automatically append Rft data to the Unsmry file if an Rft data is found. Ignored if the data file type (FType) is not Unsmry. Default: True |
CaseName |
= <string> |
Sets the VDB case name. Ignored if the file type is not VDB. |
DisplayName |
= <string> |
Sets the display name for the XY data. |
LoadDerivedVars |
= <boolean> |
Whether to calculate rates and ratios when loading CMG data files missing these variables. |
QuickLoad |
= <boolean> |
For VDB data, reads only fields, wells, and regions and skips loading completions and network connections. |
StreamlineFile |
= <string> |
Name of file. Indicate streamline file to add. |
Type |
= <string> |
Sets the VDB case type. Ignored if the file type is not VDB. |
PeriodicProductionRates
| Syntax | Description |
|---|---|
$!AddonCommand |
Performs periodic production rate calculations on the active XY dataset and saves the results to the specified CSV file. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
File name to save. |
Entityfilter |
= <option> |
Name of the entity type. Must be one of Wells, Field, Areas, Regions, Usergroups. |
Entities |
= <string, string, …> |
Comma-separated list of entity names. |
Variable |
= <string, string, …> |
Comma-separated list of variable names. |
Period |
= <option> |
Time period. Must be one of Weekly, Biweekly, Monthly, Quarterly, Annually. |
PromptForFolder
| Syntax | Description |
|---|---|
$!AddonCommand |
Displays a dialog where the user can browse for a folder. The selected folder is placed in <MacroVar>. If the user cancels the dialog and no folder is selected, then no changes are made to <MacroVar>. |
| Parameter | Syntax | Notes |
|---|---|---|
VarName |
= <string> |
Receives the selected folder |
| Parameter | Syntax | Notes |
|---|---|---|
Caption |
= <string> |
Dialog caption for the folder selection dialog. |
DefaultFolder |
= <string> |
The dialog’s working directory will be set to this directory. Must be the name of a folder, not a file. An ending file separator character is optional. |
Example:
$!AddonCommand AddonID = 'Tecplot RS'
Command = "PromptForFolder VarName='UserSelectedFolder' Caption='Select
a folder', DefaultFolder='c:\my-data-files\'"
The result of the command above will be placed in the Tecplot macro variable |UserSelectedFolder|
SavePaperLayout
| Syntax | Description |
|---|---|
$!AddonCommand |
Save a paper layout template. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Name of file to save. |
SavePlotStyle
| Syntax | Description |
|---|---|
$!AddonCommand |
Save plot styles. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Name of file to save. |
SaveProjectFile
| Syntax | Description |
|---|---|
$!AddonCommand |
This command is used to save the current files in a project file whose file name is defined by FName. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
SetActiveGrid
| Syntax | Description |
|---|---|
$!AddonCommand |
When multiple grid files have been loaded, this command determines which one is active. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Name of the active grid file (Include full path.) |
SetActiveXYDataset
| Syntax | Description |
|---|---|
$!AddonCommand |
When multiple XY data sets have been loaded, this command determines which one is active. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Name of the active XY data set. (Include full path.) |
SetAsDefault CustomOptions
| Syntax | Description |
|---|---|
$!AddonCommand |
When set to True, the currently loaded .rsc file will be loaded every time Tecplot RS is launched. |
| Parameter | Syntax | Notes |
|---|---|---|
CustomOptions |
= <boolean> |
Available values = True or False |
SetAsDefault PaperLayout
| Syntax | Description |
|---|---|
$!AddonCommand |
When set to True, the currently loaded paper layout will be loaded every time Tecplot RS is launched. |
| Parameter | Syntax | Notes |
|---|---|---|
PaperLayout |
= <boolean> |
Available values = True or False |
SetAsDefault PlotOptions
| Syntax | Description |
|---|---|
$!AddonCommand |
When set to True, the currently loaded .rsstyx file will be loaded every time Tecplot RS is launched. |
| Parameter | Syntax | Notes |
|---|---|---|
PlotOptions |
= <boolean> |
Available values = True or False |
StampOptions
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for showing stamps in 3D grid plots. |
| Parameter | Syntax | Notes |
|---|---|---|
VarNameA |
<string> |
Property used for production wells |
VarNameB |
<string> |
Property used for injection wells |
SymbolFill |
<bool> |
Use solid fill option |
Size |
<integer> |
1, 2, or 3 for small/medium/large |
Show |
<bool> |
Show stamps option |
QuickXY |
<option> |
Set to Enlarged to show enlarged stamp plots, or XYVariables to use the view defined in the XY Variables plot. (default: XYVariables) |
AxisScale |
<option> |
Set to Dataset to use the Y-Axis range for all entities of the same type. Set to Frame to use the range of the variable plotted in a single stamp. Default: Dataset |
SwapGridFile
| Syntax | Description |
|---|---|
$!AddonCommand |
Swaps in a new grid file, substituting it for an already-loaded file. See Swapping Data Files. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Pathname of the grid data file to be swapped in. |
ID |
= <integer> |
Number, starting at 0, of the file in the list that will be swapped out and substituted with the new file. |
SwapXYFile
| Syntax | Description |
|---|---|
$!AddonCommand |
Swaps in a new XY file, substituting it for an already-loaded file. See Swapping Data Files. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Pathname of the XY data file to be swapped in. |
ID |
= <integer> |
Number, starting at 0, of the file in the list that will be swapped out and substituted with the new file. |
UnloadFlowTable
| Syntax | Description |
|---|---|
$!AddonCommand |
This command allows you to unload a selected Chears *.flot flow table from memory. To read the flow table again, it must be reloaded. |
| Parameter | Syntax | Notes |
|---|---|---|
ID |
= <integer> |
Flow table number to unload. |
UnloadGridFile
| Syntax | Description |
|---|---|
$!AddonCommand |
Unloads the specified Grid file. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Name of file (fully pathed) to unload. |
UnloadXYDataset
| Syntax | Description |
|---|---|
$!AddonCommand |
Unloads specified XY data set. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Name of file (fully pathed) to unload. |
Flow Tables
PlotFlowTable
| Syntax | Description |
|---|---|
$!AddonCommand |
Set up options for plotting flow tables. You must call this command one or more times before plotting a flow table. |
| Parameter | Syntax | Notes |
|---|---|---|
ID |
= <integer> |
Flow table number to plot. Before using the Plot macro command, you must at least set the flow table number with this command. |
MultiParam |
= <string, string, string, …> |
The first <string> parameter indicates the name of the code name independent variable to plot, such as WGR. The other <string> parameters are the values of the variable to plot. |
| Parameter | Syntax | Notes |
|---|---|---|
SingleParam |
= <string, string, string, …> |
One or more pairs of strings. The first <string> parameter indicates the name of the code independent variable to set, such as WGR. The next <string> parameter indicates the setting for that variable. |
See also:
Grid Plot Macros
See Also:
Blanking
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for user-defined Cell Value Blanking criteria. |
| Parameter | Syntax | Notes |
|---|---|---|
Include |
= <boolean> |
Turn cell value blanking on or off. True=on. |
Constraint |
= <integer> |
The constraint number (1-6) |
Actives |
= <boolean> |
Controls whether the current constraint is active or not. |
VarA |
= <integer> |
Variable number used to establish blanking criterion. |
ConstrainTop2Mode |
= <option> |
Mode for constraint comparison: UseVar or UseConstant. |
VarB |
= <integer> |
The variable number used in the comparison. Only available if ConstrainTop2Mode = UseVar. |
ValueCutOff |
= <double> |
The value used for comparison. Only available if ConstrainTop2Mode = UseConstant. |
Relop |
= <option> |
Relative operator for comparison: LessThan, GreaterThan, LessThanOrEqual, GreaterThanOrEqual, EqualTo, or NotEqualTo |
BubbleOptions
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for bubbles in grid plots. |
| Parameter | Syntax | Notes |
|---|---|---|
ShowBubbles |
= <boolean> |
Master switch for turning bubbles on/off. |
BubbleNumber |
= <integer> |
The pie slice for which the following options are being set (1-8). |
BubbleVar |
= <option> |
Variable name to be assigned to the pie slice designated by BubbleNumber. |
Color |
Color to be used for the pie slice designated by BubbleNumber. The standard color names, plus Default. |
|
Include |
= <boolean> |
Whether to show the pie slice indicated by BubbleNumber. |
BubbleSize |
= <boolean> |
Whether to use the BubbleVar assigned to the current BubbleNumber to control the size of the bubble |
Multiplier |
= <double> |
Multiplier for the bubble value shown in the BubbleNumber slice. |
FixedSize |
= <boolean> |
Whether the bubbles are a fixed size (true) or dynamic (false) |
Units |
= <option> |
Whether bubble size is expressed in Paperunits or Gridunits. |
SymbolSize |
= <integer> |
Maximum size of the bubbles (1 to 20), in the specified Units. |
Range |
= <boolean> |
Toggle for showing range bubbles when bubble sizing is dynamic (FixedSize is false). |
Scale |
= <option> |
Bubble size is determined by Diameter or Area. |
FontColor |
The color of the bubble labels. |
|
FontUnits |
= <option> |
Units used for sizing the bubble labels. Frame, Grid, or Point. |
Font |
The font used for bubble labels. |
|
Labels |
= <boolean> |
Toggle for including the bubble value label. |
Variable |
= <boolean> |
Toggle for including the bubble variable name label. |
Size |
= <integer> |
Size for the bubble labels. |
Decimals |
= <integer> |
Selects the number of decimals to display on bubble value labels. Actually selects the option in the dialog, so 0 = "best" and 1-5 translate to 0-4 decimal places. |
Delta |
= <boolean> |
Toggle for turning on/off delta bubble values. |
Normalize |
= <boolean> |
Toggle for normalizing delta values. |
Max |
= <double> |
Maximum value to be used when sizing delta bubbles. |
DeltaRerference |
= <integer> |
Index to the loaded data file that is used to compute delta bubble values. |
GridDisplayName
| Syntax | Description |
|---|---|
$!AddonCommand |
Specifies the label to identify the file in legends and paper layouts. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
Name of file. |
Name |
= <string> |
Name to display when file FName is in use. |
GridCompareSetup
| Syntax | Description |
|---|---|
$!AddonCommand |
If the comparison toggle is turned on for a plot, use this command to choose the comparison data sets and options for displaying them. |
| Parameter | Syntax | Notes |
|---|---|---|
CompareDataset |
= <string, string, …> |
Specify one or more file names. Order of files determines how they will appear in legend. Files must be loaded first. |
DataSetOrdering |
= <string, string, …> |
Sets the grid ordering in which datasets will be displayed in the Grid Compare Order dialog. Note that this ordering includes all grids irrespective of whether they are included in the comparison plot. If the current active grid is specified it will be ignored. Any grids not specified will be given a default ordering. All grid names must be currently valid grids. |
Delta |
= <option> |
Set to Original to apply blanking based on original grid values. Set to Delta to apply blanking based on delta grid values. Ignored if Show=false, default=Original |
Show |
=< boolean> |
True to show comparison plots (default = False) |
GridEquations
| Syntax | Description |
|---|---|
$!AddonCommand |
Defines one or more equations to be used to create new grid variables. |
| Parameter | Syntax | Notes |
|---|---|---|
EquationList |
= <string, string, …> |
List of equations defining new variables to be solved from existing values. Note that any existing equations will be removed and replaced with the equations specified in this list. |
Equation |
= <string> |
Appends a single equation to the list of Grid equations to define. |
GridOptions
| Syntax | Description |
|---|---|
$!AddonCommand |
Sets up the options for creating grid plots. |
| Parameter | Syntax | Notes | ||
|---|---|---|---|---|
Variable |
= <string> |
The name of the variable to plot. |
||
InactiveVar |
= <string> |
The name of the variable to plot on the inactive cells. Requires the FillStyle parameter for inactive grid cells (Plotoptions InactiveGrid) to be set to Variable. |
||
TimeStep |
= <integer> |
The time step (1-based) to display. |
||
Delta |
= <boolean> |
Show delta option True or False. |
||
DeltaBlanking |
= <option> |
Set to Original to blank using original variable values, or Delta to blank using delta values. |
||
Planes |
= <option> |
View plane for 2D plots I, J, K, X, Y, Z, R, or Theta. |
||
GlobalIndex |
=<integer> |
Index of plane in global grid, for 2D plots. |
||
DualView |
= <option> |
For dual porosity grids. Controls which grid to show. |
||
DualWells |
= <option> |
For dual porositiy grids. Controls whether to display
only wells that complete in the current grid (Match) or all wells (Both). |
||
LGR |
= <string>,<string> |
LGR selection for 2D plots. The first <string> is the LGR name, the second <string> is the LGR plane index. |
||
LoadInactive |
= <boolean> |
False to unload inactive cells (default), True to load inactive cells. |
||
OWGVariables |
= <string>, <string>, <string> |
Define the three variables used for Oil/Water/Gas (Owg) plots, in that order. |
||
ShowMesh |
= <boolean> |
Show grid mesh True or False. |
||
ShowContours |
= <boolean> |
Show contour fill True or False. |
||
ShowConnect |
= <boolean> |
Show well connections True or False. |
||
ShowShade |
= <boolean> |
Show cell shading True or False. |
||
UseLighting |
= <boolean> |
Use lighting effects True or False. |
||
UseTranslucency |
= <boolean> |
Use surface translucency True or False. |
||
ShowWells |
= <boolean> |
Show wells True or False. |
||
ShowCellLabels |
= <boolean> |
Show cell labels True or False. |
||
ShowNNCs |
= <boolean> |
Show NNCs True or False. |
||
ShowStreams |
= <boolean> |
Show streamlines True or False. |
||
ShowQuick3D |
= <boolean> |
Show quick 3D view True or False. |
||
ShowOWG |
= <boolean> |
Show Owg ternary plot True or False.
Default: False |
||
ShowKSum |
= <boolean> |
Show K-Sum values True or False.
Default: False |
||
ShowKAvg |
= <boolean> |
Show K-Avg values True or False.
Default: False |
||
KAvgType |
= <option> |
Type of average calculation - Arithmetic, Geometric, or Harmonic. |
||
ShowGhost |
= <boolean> |
When inside views are being plotted, option to show ghost grid. |
||
XAxisReverse |
= <boolean> |
Reverse the X-Axis for the current view plane. |
||
YAxisReverse |
= <boolean> |
Reverse the Y-Axis for the current view plane. |
||
CLabelVariable |
= <integer> |
Index of variable used in cell labels. |
||
CLabelSkip |
= <integer> |
Skip interval used for cell labels. |
||
CLabelDecimals |
= <integer> |
Number of decimal places used for cell labels. |
||
TimeStepSkip |
= <integer> |
range from one to 20 |
||
DeltaReference |
= <integer> |
refers to time step number |
||
DeltaMagnitude |
= <boolean> |
Defines whether to use delta magnitudes True or False. |
||
DeltaType |
= <string> |
Defines option for computing delta values. Allowed options are: VC-VR (Default) |
||
InsideView Lighting |
= <boolean> |
Defines whether to display light source shading for the chosen inside view entity (Xyz slice or iso-surfaces only) - True or False. |
||
InsideView Translucency |
= <boolean> |
Defines whether to display surface translucency for the chosen inside view entity (Xyz slice or iso-surfaces only) - True or False. |
||
ShowStandard |
= <boolean> |
Shows a standard 3D view. This is the default 3D view when no other derived views types are selected. Note: ShowStandard, Shoksum, ShowKAvg, ShowKSumDelta, ShowKAvgDelta, ShowOWG, Delta are mutually exclusive. Setting any of these to True will set the others to False. ShowStandard is the default view if no other derived views are selected. Default: True |
||
ShowKSumDelta |
= <boolean> |
Show KSum delta values. These values are computed by calculating KSum at the KSum reference timestep and at the current timestep and showing the delta between the reference and the current timestep.
|
||
ShowKAvgDelta |
=<boolean> |
Show KSum delta values. These values are computed by calculating KAvg at the KAvg reference timestep and at the current timestep and showing the delta between the reference and the current timestep.
|
GridTransform
| Syntax | Description |
|---|---|
$!AddonCommand |
Controls the customization of various attributes of grid plots. Refer to Grid Options to learn more about the controls. |
| Parameter | Syntax | Notes |
|---|---|---|
GridOrientation |
= <option> |
Grid orientation. Left or Right |
ZAxisMultiplier |
= <double> |
Multiplier for the Z-axis. Accepts values from 0.0 to 100.0 inclusive, where 0 indicates automatic factor computation. |
GridThickening |
= <double> |
Defines factor by which Tecplot RS thickens grid, stretching the Z-axis values without distorting surface. Accepts values from 1.0 to 100.0 inclusive. |
DualView |
= <option> |
Defines whether to view Matrix or Fracture grid view, or Both. |
LoadInactive |
= <boolean> |
Defines whether to load inactive cells. True to load cells, False to unload. |
DeltaX |
= <double> |
Value by which to shift the X coordinate (default = 0). |
DeltaY |
= <double> |
Value by which to shift the Y coordinate (default = 0). |
DeltaZ |
= <double> |
Value by which to shift the Z coordinate (default = 0). |
Angle |
= <double> |
Angle by which to rotate the grid, in degrees (default = 0). |
ConvertX |
= <double> |
Value by which to scale the X coordinate (default = 1). |
ConvertY |
= <double> |
Value by which to scale the Y coordinate (default = 1). |
ConvertZ |
= <double> |
Value by which to scale the Z coordinate (default = 1). |
InsideNNCs
| Syntax | Description |
|---|---|
$!AddonCommand |
Controls the display of the NNC inside view. |
| Parameter | Syntax | Notes |
|---|---|---|
Show |
= <boolean> |
Turns the 3D NNC inside view on or off. |
Persist |
= <boolean> |
Turns on or off the persistence of the NNC inside view (allowing other inside views to be seen simultaneously) |
Integrate
| Syntax | Description |
|---|---|
$!AddonCommand |
Performs integration and outputs the results to a CSV file. |
| Parameter | Syntax | Notes |
|---|---|---|
Name |
= <string> |
Fully-qualified pathname of output CSV file. |
SelectBy |
= <option> |
Cell selection option: Visible, Opennode, Closednode |
| Parameter | Syntax | Notes |
|---|---|---|
VarA |
= <string> |
Variable name for volume multiplier. Omit if not using volume multipliers. |
VarB |
= <string> |
Variable name for binning. Omit if not binning values. Use "Time" or "Time Step" to bin by time. |
Value1 |
= <integer> |
Controls the number of bins. Omit or set to 0 when using bin interval or when binning by time. |
Value2 |
= <integer> |
Controls the bin interval. Omit or set to 0 when using number of bins or when binning by time. |
Examples:
$!AddonCommand
AddonID = 'Tecplot RS'
Command = 'Integrate SelectBy=Visible VarB="Soil" Value2=0.1 Name="C:\MyFile_T1_VSOIL_BSOIL.csv"'
$!AddonCommand
AddonID = 'Tecplot RS'
Command = 'Integrate SelectBy=Opennode VarB="Time Step" Name="C:\MyFile_T10_VSOIL.csv"'
$!AddonCommand
AddonID = 'Tecplot RS'
Command = 'Integrate SelectBy=Visible VarA="Poros" VarB="Cdepth" Value1=5 Value2=0 Name="C:\MyFile_sample.csv"'
KDeltaOptions
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for KSum/KAvg Delta serived view derived display |
| Parameter | Syntax | Notes |
|---|---|---|
TimeIndex |
= <integer> |
Specify the reference timestep Default is 0. |
DeltaType |
= <string> |
Defines option for computing delta values. Allow
options are: |
DeltaMagnitude |
= <boolean> |
Defines whether to use delta magnitudes - True Or False. Default: False |
NNCOptions
| Syntax | Description |
|---|---|
$!AddonCommand |
Sets up the options for displaying NNCs in Grid plots. |
| Parameter | Syntax | Notes |
|---|---|---|
NNCValueNum |
= <integer> |
The variable index for flooding NNC faces. |
ShowNNCs |
= <boolean> |
Show NNC option True or False. |
ShowGridMesh |
= <boolean> |
Show mesh on main grid True or False. |
ShowNNCMesh |
= <boolean> |
Show mesh on NNC grid True or False. |
ShowGridFill |
= <boolean> |
Fill mesh on main grid True or False. |
ShowNNCFill |
= <boolean> |
Fill mesh on NNC grid True or False. |
Translucency |
= <integer> |
Translucency as a percentage. |
NNCfaces |
= <option> |
NNC faces to display Upstream, Downstream, Both. |
FillStyle |
= <option> |
Fill style for grid - None, Shade, or Variable. |
LightEffect |
= <boolean> |
Option for shading - Smooth or Paneled. |
Color |
When FillStyle is Shade, this is the shade color used. |
|
UpColor |
Color of grid on upstream faces. |
|
DownColor |
Grid color for downstream faces. |
|
MeshColor |
Grid color for main grid. |
|
NNCThickness |
= <double> |
Thickness of mesh on NNC grids. |
GridThickness |
= <double> |
Thickness of mesh on main grid. |
PlotGrid
| Syntax | Description |
|---|---|
$!AddonCommand |
This command draws a 2D or 3D Grid plot. Precede the command with the Grid Options command to set the desired options. |
| Parameter | Syntax | Notes |
|---|---|---|
Type |
= <option> |
Type of plot to draw - Twod or Threed. |
ResetView
| Syntax | Description |
|---|---|
$!AddonCommand |
Resets the grid plot to the default scale and orientation. |
Update3DView
| Syntax | Description |
|---|---|
$!AddonCommand |
Redraw the plot after making changes to the 3D Inside Views (Ijk slices, well blanking, and other affected entities). See also Inside Views. |
WellOptions
| Syntax | Description |
|---|---|
$!AddonCommand |
Defines the well display options on grid plots. |
| Parameter | Syntax | Notes |
|---|---|---|
DisplayOption |
= <option> |
Option for limiting well display - All or Selected. |
| Parameter | Syntax | Notes |
|---|---|---|
SelectedWells |
= <string, string, …> |
List of well names to display. |
Inside Views
Streamlines and NNCs were originally grid options, not inside views, and the macro language reflects this. See the following sections for further information on these features:
-
GridOptions to enable the display of streamlines and NNCs
-
NNCOptions to set Nnc display appearance
-
StreamLineOptions to set streamline appearance
ArbSlices
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for displaying Inside Views in 3D Grid plots using Arbitrary Slices. |
| Parameter | Syntax | Notes |
|---|---|---|
Show |
= <boolean> |
Show Arbitrary Slices True or False |
Create |
= <name, X1, Y1, X2, Y2> |
Create a new slice definition. 5 strings must be included, each must be surrounded by quotes. The first string is the slice name, followed by the Xy coordinates of the two end points. |
Delete |
= <string, string, string, …> |
Delete slice definitions. Strings indicate the slice names to delete. |
Select |
= <string, string, string, …> |
Identifies the slices selected for display. Names must be enclosed in quotes. |
Clip |
= <boolean> |
Clip slices at endpoints True or False |
Hide |
= <string, string, string, …> |
Identifies slices which are not displayed. Names must be enclosed in quotes. |
ClearAllSlices
| Syntax | Description |
|---|---|
$!AddonCommand |
Clears all slice planes that were previously selected using IJKSlices. |
IJKBlanking
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for displaying Inside Views in 3D Grid plots using IJK Blanking. |
| Parameter | Syntax | Notes |
|---|---|---|
Show |
= <boolean> |
Show IJK Blanked slices True or False |
Invert |
= <boolean> |
Option to invert blanking status - True or False. |
Planes |
= <name, Imin, Imax, Jmin, Jmax, Kmin, Kmax> |
Planes to be shown in slices. First string is the name of the local grid refinement (or Global for the main grid). This must be followed by six values which represent the min and Max range for the I, J, and K planes, respectively. All items must be enclosed in double quotes. |
IJKSlices
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for displaying Inside Views using IJK Slices in 3D Grid plots. |
| Parameter | Syntax | Notes |
|---|---|---|
Show |
= <boolean> |
Show IJK Slices True or False |
IJK |
= <option> |
View planes selection I, J, or K. Follow this with a Sliceplanes option to designate the plane numbers. |
Sliceplanes |
= <string, string, string, …> |
Planes to be shown in slices. First string is the name of the local grid refinement (or Global for the main grid), and remaining values are the plane numbers. All strings must be enclosed in double quotes. |
InsideFaults
| Syntax | Description |
|---|---|
$!AddonCommand $!AddonCommand $!AddonCommand |
Set options for displaying Inside Views of faults in 3D Grid plots. |
| Parameter | Syntax | Notes |
|---|---|---|
Select |
= <string, string, string, …> |
Selects one or more named faults, defined constraints, and/or NNCs, which must be specified as displayed in the Tecplot RS sidebar (see example syntax above) |
Show |
= <boolean> |
Show faults True or False |
Persistent |
= <boolean> |
If True, the Faults Inside View will remain visible when switching to other Inside Views. |
InsideLGRs
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for displaying Inside Views of Local Grid Refinements in 3D Grid plots. |
| Parameter | Syntax | Notes |
|---|---|---|
Show |
= <boolean> |
Show LGRs True or False |
LGR |
= <string, string, string, …> |
LGRs to be shown. Global refers to the global grid. |
Isosurfaces
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for displaying Inside Views in 3D Grid plots using Iso-surfaces. |
| Parameter | Syntax | Notes |
|---|---|---|
Show |
= <boolean> |
Show Iso-surfaces True or False |
Variable |
= <string> |
Specify the variable that defines the iso-surface |
Count |
= <integer> |
Specify the number of iso-surfaces (1 or 2). |
Value1 |
= <double> |
Sets value for first iso-surface |
Value2 |
= <double> |
Sets value for second iso-surface |
WellBlanking
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for displaying Inside Views in 3D grid plots using Well Blanking. |
| Parameter | Syntax | Notes |
|---|---|---|
Show |
= <boolean> |
Show Well Blanked cells True or False |
Include |
= <boolean> |
Option to include cells between completion nodes - True or False. |
DisplayOption |
= <option> |
Option for limiting which wells are displayed - All or Selected. |
Selectedwells |
= <string, string, …> |
List of well names (enclosed in quotes) to include in display. |
XYZSlices
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for displaying Inside Views in 3D Grid plots using XYZ Slices. |
| Parameter | Syntax | Default | Notes |
|---|---|---|---|
Show |
= <boolean> |
Off |
Show XYZ Slices True or False |
XYZ |
= <parameter> |
X |
Slice plane X, Y or Z. |
Planes |
= <integer> |
1 |
Number of planes to display. |
Min |
= <integer> |
25 |
Relative position of first plane, expressed as a percentage from 0 to 100. |
Max |
= <integer> |
75 |
Relative position of last plane, expressed as a percentage from 0 to 100. |
Multi-Frame Macros
MultiFrameOptions
| Syntax | Description |
|---|---|
$!AddonCommand |
Set multiple frame options. |
| Parameter | Syntax | Notes |
|---|---|---|
FrameMode |
= <option> |
Frame mode Single or Multi. |
LinkViews |
= <boolean> |
Link frame views True or False. |
LinkBlanking |
= <boolean> |
Link frames for cell value blanking, pick blanking and inside views True or False. |
LinkLayers |
= <boolean> |
Link layer toggles on frames True or False. |
LinkWells |
= <boolean> |
Link well display on frames True or False. |
Numrows |
= <integer> |
Number of rows of frames (for multi-frame mode). |
NumCols |
= <integer> |
Number of columns of frames. |
Paper Layout
When you design a paper layout template, you can do several operations outside of the RS Manager dialog, particularly those associated with creating text. Please refer to the Tecplot 360 Scripting Guide for details about those macro commands. See also: File Loading and Saving.
PaperLayout
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options from the paper layout dialog. |
| Parameter | Syntax | Notes |
|---|---|---|
ColorNum |
= <integer> |
Integer between 0 and 63, corresponding to Tecplot standard colors |
DesignMode |
= <boolean> |
True or False. When editing the paper templates, you must surround the commands with the On and Off modes to indicate that commands are being applied to the paper layout template rather than the plot frame. |
DynamicText |
= <string> |
Adds dynamic text to the active frame |
Footerheight |
= <integer> |
If a footer is included, the height as a percentage of paper height. |
FooterWidth |
= <integer> |
If a footer is included, the width as a percentage of paper width. |
HeaderHeight |
= <integer> |
If a header is included, the height as a percentage of paper height. |
Headerwidth |
= <integer> |
If a header is included, the width as a percentage of paper width. |
PageNumber |
= <integer> |
Sets the starting page number. |
PaperOrientation |
= <string> |
Landscape or Portrait |
ShowFooter |
= <boolean> |
Include a footer frame True or False. |
ShowHeader |
= <boolean> |
Include a header frame True or False. |
ShowPaper |
= <boolean> |
Set paper display in the Tecplot RS workspace |
Size |
= <string> |
Letter, Double, A4, A3, Custom1 or Custom2 |
Performance
Performance
| Syntax | Description |
|---|---|
$!AddonCommand |
This command allows you to set options affecting Tecplot RS performance. |
| Parameter | Syntax | Notes |
|---|---|---|
GraphicsCache |
= <option> |
Sets the graphics caching mode. All, Lightweight, or None |
Approximation |
= <option> |
Sets the approximation mode - Off, Auto, Noncurrent, or All. |
Plot Options
PlotOptions_Axis
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for plotting axes on Xy plots. |
| Parameter | Syntax | Notes |
|---|---|---|
MajorIntervalMarkers |
= <option> |
Major interval markers. Solid, Ticks, Dotted, or Precise |
MinorIntervalMarkers |
= <option> |
Minor interval markers. Solid, Ticks, Dotted, or Precise |
Color |
Any of the standard colors listed in Standard Options. |
PlotOptions_Cell_Labels
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for labeling cells on grid plots |
| Parameter | Syntax | Notes |
|---|---|---|
Color |
Label color. Any of the standard colors listed in Standard Options. |
|
Size |
= <double> |
Size of cell labels, expressed as a percentage of frame size. |
Box |
= <boolean> |
Include box around label. |
Font |
Label font. Any of the allowable fonts specified in Standard Options. |
PlotOptions_Grid
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for plotting grids. |
| Parameter | Syntax | Permitted Values | Notes |
|---|---|---|---|
MeshColor |
Any of the colors listed in Standard Options, plus Multi. |
Mesh color. |
|
GridThickness |
= <double> |
Thickness of grid mesh. |
|
ContourType |
= <option> |
Lines, Primary, Average, or Continuous |
Contour type. |
ContourLineWidth |
= <double> |
0.1 to 2.0 |
|
ContourLineWidth |
Standard Tecplot RS colors plus Multi (which maps to the contour variable). |
||
ShowContourLabels |
= <boolean> |
True or False |
|
ContourLabelColor |
standard Tecplot RS colors |
||
Font |
standard fonts |
||
ContourLabelSize |
= <double> |
0.1 to 5.0 |
|
ContourLabelSpacing |
= <integer> |
5 to 50 |
|
ShowXYZ |
= <boolean> |
Show the axes on 3D plots |
|
LightEffect |
= <option> |
Paneled or Smooth |
Lighting effect. |
Translucency |
= <integer> |
1 to 100% |
See-through grid translucency. |
ShowGridMesh |
= <boolean> |
Show the mesh on see-through grids |
|
GhostStyle |
= <option> |
Ghostgray, Ghostcolor, or None |
Fill style for see-through grid |
PlotOptions_Gridaxes
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for plotting axes on grid plots. |
Parameter |
Syntax |
Notes |
Color |
Label color. Any of the standard colors listed in Standard Options. |
|
Font |
Label font. |
|
LineColor |
Axis line color. Any of the standard colors listed in Standard Options. |
|
ShowXYZ |
= <boolean> |
Turns on or off the axes display in 3D plots. |
Size |
= <double> |
Label size, ranging from 0.1 to 5.0. |
PlotOptions_Inactivegrid
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options to define the inactive grid cells' style. No defaults apply. |
| Parameter | Syntax | Notes |
|---|---|---|
FillStyle |
= <string> |
Accepts values of Shade, Meshonly, Match, or Variable to control the fill style of displayed inactive cells. |
MeshColor |
Controls the mesh color of inactive cells. |
|
Color |
Controls the fill (shade) color of inactive cells. Applies only when FillStyle is set to Shade. |
|
GridThickness |
=<double> |
Controls the thickness of each line of the mesh as a percentage of the frame size. Acceptable values range from 0.1 to 2.0. |
PlotOptions_Labels
| Syntax | Description |
|---|---|
$!AddonCommand |
Set label options. |
| Parameter | Syntax | Notes |
|---|---|---|
Font |
Any of the allowable fonts specified in Standard Options. |
|
Size |
= <double> |
Size as a percentage of frame. If the value does not match one of the preset values on the Plot Options dialog it converts to the nearest preset value. |
Color |
Any of the standard colors listed in Standard Options. |
PlotOptions_Misc
| Syntax | Description |
|---|---|
$!AddonCommand |
Set time variable and animation options. |
| Parameter | Syntax | Notes |
|---|---|---|
TimeUnits |
= Time, Date |
Set the time variable to either Time or Date. |
AnimationDelay |
= <integer> |
Specify the animation delay (pause between time steps). |
UseFormattedDate |
= <boolean> |
Specify whether to use decimal year as date format. |
UseFormattedTime |
= <boolean> |
Specify whether to use decimal day as time format. |
DateFormat |
= <string> |
Specify a Tecplot RS date format string. For example, "mmm-dd-yyyy". By default, "mm/dd/yy". |
Timeformat |
= <string> |
Specify a Tecplot RS time format string. For example, "[d] hh:mm:ss". By default, "[d] hh:mm". |
PlotOptions_Scaling
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for scaling. |
| Parameter | Syntax | Notes |
|---|---|---|
Variable |
= <string> |
Name of the variable to apply the following settings to. You can use the long or short name, but it must match exactly (excluding upper- or lowercase). |
Interval |
= <integer> |
Assigns the interval between major markers on X or Y axis. Must follow the Variable parameter, although does not have to follow immediately. Range includes values zero (0) and greater. |
MinorCount |
= <integer> |
Assigns the number of minor markers displayed between major markers. As the Interval parameter, MinorCount will be associated with the preceding Variable parameter. Acceptable values range from zero (0) to one hundred (100). |
ReverseYAxis |
= <boolean> |
Reverse Y axis direction of the variable specified in Variable. |
Range |
= <option> |
Scaling range. Frame, Dataset, or Manual |
Min |
= <double> |
Valid only if Range=Manual. |
Max |
= <double> |
Valid only if Range=Manual. |
Scale |
= <double> |
If the value does not match one of the preset values on the Plot Options dialog it converts to the nearest preset value. Use 0 for Log scale. |
Override |
= <boolean> |
True to declare a new string for the units display. |
Units |
= <string> |
Character string to be used for displaying units. |
CutoffLow |
= <boolean> |
True to cutoff contours below a set value. |
CutoffHigh |
= <boolean> |
True to cutoff contours above a set value. |
Low |
= <double> |
Valid only if CutoffLow=True. Sets the cutoff value. |
High |
= <double> |
Valid only if Cutoffhi=True. Sets the cutoff value. |
LegendOrientation |
= <option> |
Specify whether the contour legend should be Vertical or Horizontal. |
Invert |
= <option> |
Option to determine whether color scale is inverted: Conditional, Never, or Always. |
ColorMap |
= <option> |
Color map to be used to draw contours. LargeRainbow, SmallRainbow, TwoColor, or GrayScale |
PlotOptions_Well_Labels
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for labeling wells on grid plots. |
| Parameter | Syntax | Notes |
|---|---|---|
Include |
= <boolean> |
Include well names. |
Color |
Label color. Any of the standard colors listed in Standard Options. |
|
Size |
= <double> |
Size of well labels |
Units |
= <option> |
Units for label size. Grid or Frame |
Font |
Label font. Any of the allowable fonts specified in Standard Options. |
PlotOptions_Well_Options
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for general well display on grid plots. |
| Parameter | Syntax | Notes |
|---|---|---|
WellheadOffset |
= <integer> |
Offset value. |
WellheadPos |
= <option> |
Position option (1 4) |
WellMultiFrame |
= <option> |
Option for displaying wells in multi frames: OneFrame or AllFrames |
WellDisplay2D |
= <option> |
Display option for wells in 2D views. All, Currentplane, or Nodesonly |
PlotOptions_WellSymbols
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for plotting wells and bubbles. |
| Parameter | Syntax | Notes |
|---|---|---|
Type |
= <option> |
Well type. Producer, Injector, Waterinjector, Gasinjector, Shutin, Opennode, or Closednode |
Symbols |
= <option> |
Well symbol. Default, Square, Circle, Diamond, Delta, Gradient, LeftTri, RightTri, Sphere, Cube, or Octahedron |
Color |
Well color. Any of the standard colors listed in Standard Options. |
|
Size |
= <double> |
Size (in percent). |
PlotOptions_Xy
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for Xy plots. |
| Parameter | Syntax | Notes |
|---|---|---|
StyleSet |
= <StyleSet> |
Which of 99 style sets that all following parameters will be applied to. Options are Active or COMP1 through COMP99 |
Variable |
= <string> |
Name of the variable to apply the following settings to. You can use the long or short name, but it must match exactly. |
ShowLines |
= <boolean> |
Show lines. |
LineColor |
Line color. Any of the standard colors listed in Standard Options, plus Default. |
|
LinePattern |
= <option> |
Line pattern. Default, Solid, ShortDash, DashDot, Dotted, LongDash, or DashDotDot |
LinePatternlength |
= <double> |
Line pattern as a percent. If the value does not match one of the preset values on the Plot Options dialog, it converts to the nearest preset value. |
LineThickness |
= <double> |
Line thickness as a percent. If the value does not match one of the preset values on the Plot Options dialog, it converts to the nearest preset value. |
ShowSymbols |
= <boolean> |
True to show all symbols. |
SymbolFill |
= <boolean> |
True to fill all symbols. |
SymbolColor |
Symbol color. Any of the standard colors listed in Standard Options, plus Default and Match. |
|
Symbolshape |
= <option> |
Symbol shape. Default, Square, Circle, Diamond, Delta, Gradient, LeftTri, RightTri, Character |
SymbolSpacing |
= <option> |
Symbol spacing. All, I2, I4, I6, I8, I10, D1, D2, D3, D4, D5 |
SymbolChar |
= <string> |
Symbol character if Symbolshape=Character. |
SymbolSize |
= <double> |
Symbol size. If the value does not match one of the preset values on the Plot Options dialog, it converts to the nearest preset value. |
RSVFile
| Syntax | Description |
|---|---|
$!AddonCommand |
Chooses the RS Variables file to be used for variable renaming and aliasing and for colors and line and symbol styles used in plots. |
| Parameter | Syntax | Notes |
|---|---|---|
Type |
= <RSVType> |
Chooses the file that will be used. Supported types are User (rsvariables.txt), Eclipse, Chears, Vip, Sensor, and CMG. The simulator-specific files are named e.g. rsvariables_chears.txt. |
UpdateOptions
| Syntax | Description |
|---|---|
$!AddonCommand |
Update the plot after changes in Plot Options or Bubble Options dialog. |
Selection_Sets
See Also:
File Loading and Saving.
SelectionSet_Save
| Syntax | Description |
|---|---|
$!AddonCommand |
This command saves or edits a selection set. |
| Parameter | Syntax | Notes |
|---|---|---|
Entity |
= <String, String, …> |
One or more paired entity names and entity numbers. The entity number should be zero in most cases. If the entity represents a well layer or completion, the value should be the completion number. If the entity is from an RFT file, the number represents the time step for that well name. |
Name |
= <String> |
The name to be assigned to the selection set. |
SelectionSet_Delete
| Syntax | Description |
|---|---|
$!AddonCommand |
This command deletes an existing selection set. |
| Parameter | Syntax | Notes |
|---|---|---|
Name |
= <String> |
The name to be assigned to the selection set. |
SelectionSet_Rename
| Syntax | Description |
|---|---|
$!AddonCommand |
This command renames an existing selection set. Two names must be provided the original name and the new name. |
| Parameter | Syntax | Notes |
|---|---|---|
Name |
= <String> |
The original name of the selection set. |
Name |
= <String> |
The new name of the selection set. |
MakeUserGroups
| Syntax | Description |
|---|---|
$!AddonCommand |
This command creates a user group from one or more existing selection sets. |
| Parameter | Syntax | Notes |
|---|---|---|
SumVars |
= <String>, <String>, … |
List the variables for Tecplot RS to include in a summation. |
AvgVars |
= <String>, <String>, … |
List the variables for Tecplot RS to include in an average (OPT). |
NewVars |
= <String>, <String>, … |
List the variables that you wish Tecplot RS to calculate. |
SelectionSets |
= <String>, <String>, … |
List the existing selection sets you wish Tecplot RS to use. |
| Parameter | Syntax | Notes |
|---|---|---|
Active |
= <Boolean> |
Controls whether the group creation affects only the active data set (TRUE) or all loaded data sets (FALSE). Defaults to TRUE. |
MakeWellPatterns
| Syntax | Description |
|---|---|
$!AddonCommand |
This command creates a user group from one or more existing selection sets. |
| Parameter | Syntax | Notes |
|---|---|---|
CumVars |
= <String>, <String>, … |
List the cumulative variables, which show the accumulated production for each time step |
SumVars |
= <String>, <String>, … |
List the variables for Tecplot RS to include in a summation. |
NewVars |
= <String>, <String>, … |
List the variables that you wish Tecplot RS to calculate. |
SelectionSets |
= <String>, <String>, … |
List the existing selection sets you wish Tecplot RS to use. |
XY Plot
These commands are used to make selections for and initiate XY plots, including XY Entities, XY Variables, XY Custom, RFT, and Completion Profiles. See also: File Loading and Saving.
CompareSetup
| Syntax | Description |
|---|---|
$!AddonCommand |
If the comparison toggle is turned on for a plot, use this command to choose the comparison data sets and options for displaying them. |
| Parameter | Syntax | Notes |
|---|---|---|
CompareDataSet |
= <string, string, …> |
Specify one or more file names. Order of files determines how they will appear in legend. Files must be loaded first. If a filename is listed more than once, the duplicates will be ignored. For example: CompareDataSet 'f1.hist' 'f2.hist' is equivalent to: CompareDataSet 'f1.hist' If a filename is the active filename, it will be ignored since the active file cannot be a comparison file. For example: CompareDataSet 'f1.hist' 'f1.usmry' is equivalent to CompareDataSet 'f1.hist' if 'f1.usmry' is the active file. |
DataSetOrdering |
= <string, string, …> |
Sets the ordering in which datasets will be displayed in the Compare XY Data Sets dialog. |
ShowReference |
= <boolean> |
Controls whether the reference data are shown when the Delta option is turned on. |
StyleSet |
= <option> |
Option for handling comparison style set when more files are compared than there are available stylesets Cycle or Repeat |
LegendStyle |
= <option> |
Control how comparison file names appear in the legend Name, NamePlus, or None |
DeltaType |
= <string> |
Defines option for computing delta values. Allowed
options are: |
Normalize |
= <boolean> |
Defines whether to normalize the delta values by Vref True or False. |
DeltaMagnitude |
= <boolean> |
Defines whether to use delta magnitudes True or False. |
|
Macros created prior to the release of Tecplot RS 2009 do not contain the DeltaType, Normalize, and DeltaMagnitude parameters. For compatibility, Tecplot RS assumes these values: DeltaType = VR-VC |
CompletionSetup
| Syntax | Description |
|---|---|
$!AddonCommand |
Sets parameters for completion profiles. |
| Parameter | Syntax | Notes |
|---|---|---|
Well |
= <string> |
Name of layered well to plot. |
Times |
= <integer> |
Time to plot (one-based index). |
ShowPercentages |
= <boolean> |
Show/hide percentages. |
CompletionLabels |
= <option> |
Possible values: None, Depth, KPlane |
XAxis1 |
= <string, string, …> |
X1-axis variable names |
XAxis2 |
= <string, string, …> |
X2-axis variable names |
XAxis3 |
= <string, string, …> |
X3-axis variable names |
Example:
$!AddonCommand
AddonID = 'Tecplot RS'
Command = 'CompletionSetup XAxis1="OPR","GPR","LGR"'
This command will assign variables OPR, GPR, and LGR to be plotted on the X1 axis.
PlotXY
| Syntax | Description |
|---|---|
$!AddonCommand |
This command draws an XY plot of the specified type. Before using this command, you should call the Setup command for the associated plot type. For example, before doing an XY Entities plot, specify the variables and entities to plot with one or more XYEntitiesSetup commands. |
| Parameter | Syntax | Notes |
|---|---|---|
Type |
= <option> |
Type of plot to draw. Must be XYEntities, XYVariables, XYSubsets, XYFreeStyle, RFT, Custom, CustomEntities or Completion. |
| In general, the steps to create the XY FreeStyle plots (XYFreeStyle) are Not recorded in the macro. The only things recorded are the plot type and page number. For this reason, we strongly recommend macro recording be turned off during creation of the XY FreeStyle plots. |
RFTSetup
| Syntax | Description |
|---|---|
$!AddonCommand |
Set parameter options for RFT plots. |
| Parameter | Syntax | Notes |
|---|---|---|
Entity |
= <string, string> |
Paired entity name and entity number. The entity number represents the time step for that well name. |
XAxis |
= <string> |
X-axis variable name. |
YAxis |
= <string> |
Y-axis variable name. |
SolvePTime
| Syntax | Description |
|---|---|
$!AddonCommand |
Finds the time production started, creating a new variable called PTime that stores the time relative to the start of production for each entity. |
Parameter |
Syntax |
Notes |
Variable |
=<string> |
Variable that becomes non-zero when a well or other entity begins production (usually OPR or GPR)s |
Parameter |
Syntax |
Notes |
ApplyToAllFiles |
= <boolean> |
If True, PTime will be calculated for all open files. If False, it is calculated only for the current file. Default: False. |
StreamLineOptions
| Syntax | Description |
|---|---|
$!AddonCommand $!AddonCommand $!AddonCommand $!AddonCommand $!AddonCommand $!AddonCommand $!AddonCommand $!AddonCommand |
Options for controlling the appearance of streamlines in 3D plots. |
| Parameter | Syntax | Notes |
|---|---|---|
SelectBy |
= <option> |
All, Source, Sink, Pair |
ColorBy |
= <option> |
Source, Sink, Pair, Variable, TOF |
Variable |
= <string> |
Variable name for ColorBy option |
Skip |
= <integer> |
1 to 100. Skip interval for thinning the number of streams to display. |
TimePercent |
= <integer> |
0 to 100. Slider position for TOF display. |
LogScale |
= <boolean> |
True or False. Determines whether TOF is scaled logarithmically |
Persistent |
= <boolean> |
If True, causes streamlines to continue to be displayed when another Inside View is selected. |
SelectStreams |
= <string> |
Identifiers for streams to plot. Allowable values depend on SelectBy option. |
UpdateStreamLines
| Syntax | Description |
|---|---|
$!AddonCommand |
Update the plot after changes via StreamLineOptions. |
UpdateStyles
| Syntax | Description |
|---|---|
$!AddonCommand |
Force updating of plot styles. |
XYCustomSetup
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for XY Custom plots. |
| Parameter | Syntax | Notes |
|---|---|---|
Entity |
= <string, string> |
Paired entity name and entity number. The entity number should be zero in most cases. If the entity represents a well layer or completion, the value should be the completion number. If the entity is from an RFT file, the number represents the time step for that well name. |
Compare |
= <boolean> |
Compare data sets. |
Delta |
= <boolean> |
Use delta to compare data sets. Ignored if Compare=False. |
Frame |
= <integar> |
Frame number of the first of (potentially) multiple frames to plot. |
XYDisplayName
| Syntax | Description |
|---|---|
$!AddonCommand |
Specifies the label to identify the file in legends and paper layouts. This is especially useful when working with comparison plots. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= <string> |
File name. |
Name |
= <string> |
Name to display when file FName is in use. |
XYEntitiesSetup
| Syntax | Description |
|---|---|
$!AddonCommand |
Sets options for the XY Entities plot. |
| Parameter | Syntax | Notes |
|---|---|---|
Entity |
= "<name1>","<number1>", |
One or more paired entity names and entity numbers. The entity number should be zero in most cases. If the entity represents a well layer or completion, the value should be the completion number. If the entity is from an RFT file, the number represents the time step for that well name. |
YAxis |
= <string> |
Y-axis variable. |
XAxis |
= <string> |
X-axis variable. |
Sum |
= <boolean> |
Sum option. |
Average |
= <boolean> |
Average option. |
ManualFrameAssignments |
= <string>[,<string>,…] |
Each string is of the from "[frame number], [variable name]". For example, to assign the variable "Api", to multi frame 2, use the following command: ManualFrameAssignments="2,Api" |
XYEquations
| Syntax | Description |
|---|---|
$!AddonCommand |
Defines one or more equations to be used to create new XY variables. |
| Parameter | Syntax | Notes |
|---|---|---|
EquationList |
= <string, string, …> |
List of equations. Note that any existing equations will be removed and replaced with the equations specified in this list. |
Equation |
= <string> |
Appends a single equation to the list of XY equations to define. |
Apply |
= <option> |
Entity type on which equations are to be applied (can be repeated) Wells, Completions, Field, Areas, Regions, FlowStat, QualityData, RFTdata, GatherStat, Aquifer, BlockData, UserGroups, or Other. |
Errorignore |
= <boolean> |
If No (the default), Tecplot RS displays an error message when a division by zero occurs and does not create any new variables. If Yes, the affected data value will be set to 0 (when the number being divided is zero) or -999999 (when the dividend is nonzero). |
| Parameter | Syntax | Notes |
|---|---|---|
ApplyToAllFiles |
= <boolean> |
Default is False. |
Example:
$!AddonCommand
AddonID = 'Tecplot RS'
Command = 'XYEquations EquationList="{wpr}={wpr}/2" ApplyToAllFiles=T Apply=Wells Apply=Field'
XYFiltering
| Syntax | Description |
|---|---|
$!AddonCommand |
Set filtering options for XY plots. |
| Parameter | Syntax | Notes |
|---|---|---|
TypeFilter |
= <option, option, …> |
Type filter can select more than one. Wells, Completions, Field, Areas, Regions, FlowStat, QualityData, RFTdata, GatherStat, Aquifer, BlockData, UserGroups, Nodes, Connections, ConnList, or Other. |
EntityFilter |
= <string, string> |
If further filtering is desired, this lists the entities (paired entity name and entity number). The entity number should be zero in most cases. If the entity represents a well layer, the value represents the completion number. If the entity is from an RFT file, the number represents the time step for that well name. |
XYFreeStyleSetup
| Syntax | Description |
|---|---|
$!AddonCommand |
Specifies the page number for the XY FreeStyle plot. |
| Parameter | Syntax | Notes |
|---|---|---|
PageNumber |
= <integar> |
Specify the page number for the XY FreeStyle plot. |
XYSorting
| Syntax | Description |
|---|---|
$!AddonCommand |
Set sorting options for entities in XY plots. |
| Parameter | Syntax | Notes |
|---|---|---|
SortType |
= <option> |
Sort type ByName, ByType, or ByVariable. |
SortDir |
= <option> |
Sort direction - Ascending, or Descending |
Sortvariable |
= <string> |
If sort type is by variable, the variable name on which sorting is performed. |
XYSubsetSetup
| Syntax | Description |
|---|---|
$!AddonCommand |
Set options for XY Subset plots. |
| Parameter | Syntax | Notes |
|---|---|---|
Entity |
= <string> |
Entity Name |
XAxis |
= <string> |
Name of the variable assigned to the X-Axis. |
YAxis |
= <string> |
Name of the variable assigned to the Y-Axis. |
Sum |
= <boolean> |
Set to True to sum the variable across all entities being plotted. |
Average |
= <boolean> |
Set to True to display the average value for all selected entities. |
XYVariablesSetup
| Syntax | Description |
|---|---|
$!AddonCommand |
Set parameter options for XY Variables plot. |
| Parameter | Syntax | Notes |
|---|---|---|
Entity |
= <string, string> |
Paired entity name and entity number. The entity number will be zero in most cases. If the entity represents a well layer or completion, the value should be the completion number. If the entity is from an RFT file, the number represents the time step for that well name. |
XAxis |
= <string> |
X-axis variable name. |
YAxis1 |
= <string, string, …> |
Y1-axis variable name(s). |
YAxis2 |
= <string, string, …> |
Y2-axis variable name(s). |
YAxis3 |
= <string, string, …> |
Y3-axis variable name(s). |
YAxis4 |
= <string, string, …> |
Y4-axis variable name(s). |
YAxis5 |
= <string, string, …> |
Y5-axis variable name(s). |
Compare |
= <boolean> |
Compare data sets. |
Delta |
= <boolean> |
Show delta. Ignored if Compare=False. |
ManualFrameAssignments |
=<string>[,<string>,…] |
Each string is of the form "[frame number], [entity name], entity layer]". For example, to assign the entity "Oil-3", layer 0, to multi frame 2, use the following command: ManualFrameAssignments="2,Oil-3,0" The layer number must be included even if it is zero. |
WriteXYData
| Syntax | Description |
|---|---|
$!AddonCommand |
This command creates an Ascii text file from the current XY line plot. Before calling this command, you must set up an XY line plot either in the Gui or with other RS macro commands. You may continue to append to the same data file by calling this command more than once with Append=True. Typically you would do this after modifying the XY plot. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= "<string>" |
Template folder. |
Separator |
= <separator> |
One of either Comma, Tab, Space (default Comma). For importing into Excel, Comma is recommended with a .csv filename. |
FName |
= <FileMode> |
Append or Overwrite. Default is Overwrite |
Template_Macros
SaveTemplate
| Syntax | Description |
|---|---|
$!AddonCommand |
This command allows you to save a template to a file. Note, if you wish to save the template file in a folder other than your default template folder, call TemplateFolder first to specify the folder location. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= "<string>" |
File name to use. |
LoadTemplate
| Syntax | Description |
|---|---|
$!AddonCommand |
This command allows you to load a template file. Note, if you wish to load a template that is not in your default template folder, call TemplateFolder first to specify the location of the folder containing the template. |
| Parameter | Syntax | Notes |
|---|---|---|
FName |
= "<string>" |
File name to load. |
TemplateFolder
| Syntax | Description |
|---|---|
$!AddonCommand |
This command allows you to specify the name of the template folder. |
| Parameter | Syntax | Notes |
|---|---|---|
Name |
= "<string>" |
Template folder. |
Standard Options
ColorOption
The standard set of colors that can be specified in macro commands include:
Black |
Olive |
Blue |
Orange |
Brown |
Pink |
Cream |
Purple |
Cyan |
Red |
Gold |
Rose |
Gray |
Sapphire |
Green |
Silver |
Indigo |
Sky |
Lilac |
Teal |
Lime |
Violet |
Maroon |
White |
Navy |
Yellow |
FontOption
The fonts that can be specified in macro commands include:
Courier |
CourierBold |
Helvetica |
HelveticaBold |
Times |
TimesBold |
TimesBoldItalic |
TimesItalic |
Deprecations
The following commands have been deprecated in Tecplot RS. Tecplot RS ignores deprecated commands, so that if the command occurs in an old macro, the macro is not disrupted.
Parameter |
Syntax |
Notes |
Use_RSManagerSettings |
= <boolean> |
Was used to designate whether the Plot Options dialog controlled settings that could be adjusted by selecting "Assign Axis Variables" from the Plot menu. False ignored the settings in the Plot Options dialog in favor of settings made in a now-obsolete Tecplot RS dialog. |