附录 A：Tcl 命令参考（第 1 部分）

PDF 来源

Sentaurus Visual User Guide (W-2024.09) 附录 A：第 220–280 页 原文命令区间：通用属性 → diff_plots

---

通用属性

如果命令中未指定 -name 参数，则 Sentaurus Visual 会生成一个内部名称，该名称在脚本中保持一致。如果生成的名称与脚本中后续定义的同一类型元素（如曲线或切割线）的名称冲突，Sentaurus Visual 将打印错误消息并停止命令执行。

TIP

本节为通用属性介绍，非独立命令。

颜色

在允许指定颜色属性的 Tcl 命令中（如 -color <#rrggbb> 选项），需要提供一个字符串来指定 RGB 系统的红、绿、蓝分量。该字符串以井号（#）开头，每个值以十六进制形式提供。常用颜色也有别名。

表 11 常用颜色

别名	颜色预览	通用格式	别名	颜色预览	通用格式
white		#ffffff	darkMagenta		#800080
black		#000000	yellow		#ffff00
red		#ff0000	olive		#808000
darkRed		#800000	orange		#ffa500
lime		#00ff00	darkOrange		#ff8c00
green		#008000	gray		#a0a0a4
darkGreen		#006400	darkGray		#808080
blue		#0000ff	lightGray		#c0c0c0
darkBlue		#000080	skyblue		#87ceeb
cyan		#00ffff	slategray		#708090
darkCyan		#008080	chocolate		#d2691e
magenta		#ff00ff

字体

对于允许调整字体属性的 Tcl 命令，Sentaurus Visual 定义了特定的字体系列和属性列表。

NOTE

在 XY 图中，字体大小通过 font_size 参数设置；而在 2D 和 3D 图标中，通过 font_factor 参数作为图表框架的因子设置。

表 12 字体系列及其属性

字体系列	属性
Arial	Bold
Courier	Italic
Times	Normal
	Strikeout
	Underline

线型

表 13 线型

线型名称	短形式	描述
solid	_	实线
dot	.	点线
dash	-	虚线
dashdot	-.	点划线
dashdotdot	-..	双点划线

标记

表 14 标记类型

标记类型名称	短形式	描述
circle	o	圆
circlef	of	实心圆
diamond		菱形
diamondf		实心菱形
square		正方形
squaref		实心正方形
plus	+	加号
cross	x	叉号

---

add_custom_button

向"脚本"工具栏添加自定义按钮。

TIP

此命令仅在交互模式下有效。如果同时指定了 -icon 和 -name，则工具栏中只显示图标。

语法

add_custom_button 
-file <stringValue> | -script <stringValue> | -separator
[-desc <stringValue>] [-icon <stringValue>]
[-label <stringValue>] [-name <stringValue>]

返回值

返回 -name 指定的自定义按钮名称。

示例

add_custom_button -script "echo Hello World!" -name Greetings \
-desc "Echoes a Hello World Message."
#-> Greetings

参数说明

参数	说明
-desc <stringValue>	按钮的描述文本。
-file <stringValue>	要执行的 Tcl 文件名。
-icon <stringValue>	用作按钮图标的图形文件。
-label <stringValue>	按钮的标签。
-name <stringValue>	按钮名称。
-script <stringValue>	要执行的 Tcl 脚本。
-separator	添加分隔符。

---

add_frame

向帧缓冲区添加新帧。

TIP

必须先使用 start_movie 命令。

语法

add_frame [-name <stringValue>] [-plot <stringValue>]

返回值

字符串。

示例

add_frame -name Frame1
#-> Frame1

参数说明

参数	说明
-name <stringValue>	新帧名称。
-plot <stringValue>	保存帧的图表。

---

calculate

从 Id-Vd 或 Id-Vg 曲线中提取 FET 参数。

TIP

此命令仅适用于 XY 图。

语法

calculate <stringValue> -op vth | gmmax | idsat | ioff | rout | ron
[-plot <stringValue>]

返回值

Double。

示例

calculate Curve_1 -op ron
#-> 0.0554013

参数说明

参数	说明
<stringValue>	曲线名称。
-op	要提取的参数：vth、gmmax、idsat、ioff、rout、ron。
-plot <stringValue>	图表名称。

---

calculate_field_value

计算场的最小值和最大值，并显示位置标记。

TIP

此命令仅适用于 2D 和 3D 图。

语法

calculate_field_value -min | -max
[-dataset <stringValue> | -plot <stringValue>]
[-field <stringValue>]
[-geom <stringValue>]
[-materials <stringList> | -regions <stringList>]
[-ranges {<x1> <x2> <y1> <y2> [<z1> <z2>]}]

返回值

Double 和坐标值列表。

示例

calculate_field_value -plot Plot_n9_des \
-field Abs(TotalCurrentDensity-V) -min
#-> 0.0206237318885 {271.172 5.39062 0}

参数说明

参数	说明
-min | -max	返回最小值还是最大值。
-dataset | -plot	数据集或图表。
-field	场的名称。
-geom	几何体。
-materials | -regions	材料或区域列表。
-ranges	特定值范围。

---

calculate_scalar

计算标量值。

TIP

此命令仅适用于 XY 图。

语法

calculate_scalar 
(-curves [-plot <stringValue>] | -variables)
-function <stringValue>

返回值

Double。

示例

calculate_scalar -curves -plot Plot_1 \
-function vecmax(<Curve_1>)+vecmin(<Curve_1>)
#-> 0.000351277048757

参数说明

参数	说明
-curves | -variables	曲线函数还是变量函数。
-function	提取标量值的公式。
-plot	图表名称。

---

create_angle

测量由三个点定义的角度。

TIP

此命令仅适用于 2D 图。

语法

create_angle
-point1 {x y} -center {x y} -point2 {x y}
[-plot <stringValue>] [-snap_on | -snap_off]

返回值

字符串（测量角度）。

示例

create_angle -point1 {0.02 -0.04} -center {0.11 -0.04} \
-point2 {0.07 0.04}
#-> 63.4349488229

参数说明

参数	说明
-point1 {x y}	角度的第一个点。
-center {x y}	角度的中心（顶点）。
-point2 {x y}	角度的第二个点。
-plot	图表名称。
-snap_on | -snap_off	吸附到网格功能。

---

create_curve

为 XY 图创建新曲线。

TIP

此命令仅适用于 XY 图。

语法

create_curve
-dataset <stringList> -axisX <stringValue> 
(-axisY <stringValue> | -axisY2 <stringValue>) | 
-function <stringValue>
[-name <stringValue>] [-plot <stringValue>] [-y <intValue>]

返回值

列表。

示例

create_curve -plot Plot_1 -dataset IdVd_example \
-axisX "drain OuterVoltage" \
-axisY "drain TotalCurrent"
#-> Curve_1

参数说明

参数	说明
-dataset | -function	数据集列表或公式。
-axisX	x 轴变量。
-axisY | -axisY2	y 轴或 y2 轴变量。
-name	曲线名称。
-plot	图表名称。
-y	针对哪个轴创建。

---

create_cut_boundary

沿指定结构边界创建切割线。

TIP

此命令仅适用于 2D 图和自由切割面。

语法

create_cut_boundary 
(-materials <stringList> | -regions <stringList>) 
-points <pointList>
[-dataset <stringValue> | -plot <stringValue>] [-name <stringValue>]
[-reverse] [-segments <stringList>]

返回值

字符串（1D 数据集名称）。

示例

create_cut_boundary -plot Plot_2D -regions {R.Gateox R.PolyReox} \
-segments {R.Gateox R.PolyReox} \
-points {"-0.5125 -0.002 0" "-0.6 -0.002 0" "-0.6 0 0"} -name myCut
#->myCut

参数说明

参数	说明
-materials | -regions	材料或区域。
-points	切割线通过的点。
-dataset | -plot	图表或数据集。
-name	切割线名称。
-reverse	反转方向。

---

create_cutline

创建新的切割线。

TIP

此命令仅适用于 2D 和 3D 图。

语法

create_cutline 
-type x | y | z -at <doubleValue> [-axisX x | y | z [-surface]] | 
-type free -points {<x1> <y1> [<z1>] <x2> <y2> [<z2>]}
[-dataset <stringValue> | -plot <stringValue>]
[-materials <stringList> | -regions <stringList>]
[-name <stringValue>]

返回值

字符串（1D 数据集名称）。

示例

create_cutline -plot Plot_2D -type free -points {-0.45 -0.15 0.30 0.80} \
-name myCutlineDataset
#-> myCutlineDataset

参数说明

参数	说明
-at | -points	轴位置或自由点。
-type x | y | z | free	切割线类型。
-dataset | -plot	源数据集或图表。
-materials | -regions	材料或区域。
-name	切割线名称。

---

create_cutplane

创建新的切割面。

TIP

此命令仅适用于 3D 图。

语法

create_cutplane
-type x | y | z | free -at <doubleValue> |
-type free -origin {<x> <y> <z>} -normal {<x> <y> <z>}
[-dataset <stringValue> | -plot <stringValue>] [-name <stringValue>]

返回值

字符串（2D 数据集名称）。

示例

create_cutplane -plot Plot_3D -name Cut1 -type y -at 0.3
#-> Cut1

参数说明

参数	说明
-at | -origin -normal	切割位置或自由面定义。
-type	切割面类型。
-dataset | -plot	源数据集或图表。
-name	切割面名称。

---

create_cutpolyline

使用指定的顶点创建新的切割线。

TIP

此命令仅适用于 2D 图。

语法

create_cutpolyline -points <pointList>
[-dataset <stringValue> | -plot <stringValue>] 
[-materials <stringList> | -regions <stringList>]
[-name <stringValue>]

返回值

字符串。

示例

create_cutpolyline -plot Plot_2D \
-points {"0.05872 -0.260434" "0.46536 -0.034674" "0.26 0.074126"}
#-> C1(2D)

参数说明

参数	说明
-points	切割线通过的点。
-dataset | -plot	源数据集或图表。
-materials | -regions	材料或区域。
-name	切割线名称。

---

create_cutpolyplanes

使用折线创建一系列切割面。

TIP

此命令仅适用于 3D 图。

语法

create_cutpolyplanes
-type x | y | z
-points <pointList>
[-dataset <stringValue> | -plot <stringValue>]
[-geom <stringValue>] [-name <stringValue>]

返回值

字符串（2D 数据集名称）。

示例

create_cutpolyplanes -type x \
-points { {0.3 0.1 0.2} {0.1 0.5 1.6} {2.4 0.5 1.3} } \
-plot Plot_3D -name Cut1
#-> Cut1

参数说明

参数	说明
-type	拉伸轴。
-points	定义折线的顶点。
-dataset | -plot	源数据集或图表。
-geom	几何体。
-name	数据集名称。

---

create_field

使用图表或数据集的数据创建新场。

TIP

此命令仅适用于 2D 和 3D 图。

语法

create_field -function <stringValue> -name <stringValue>
[-dataset <stringValue> | -plot <stringValue> [-geom <stringValue>]]
[-overwrite] [-show]

返回值

字符串。

示例

create_field -name newFld -dataset 3D -function "log(<ElectricField>)"
#-> newFld

参数说明

参数	说明
-function	要计算的函数。
-name	新场的名称。
-dataset | -plot	源图表或数据集。
-overwrite	覆盖已存在的场。
-show	立即显示。

---

create_iso

创建或修改等值几何体。

TIP

此命令仅适用于 2D 和 3D 图。

语法

create_iso -field <stringValue> -value <doubleValue>
[-color <#rrggbb>] [-geom <stringValue>]
[-modify | -name <stringValue>]
[-plot <stringValue>]

返回值

字符串（几何体名称）。

示例

create_iso -plot Plot_3D -geom 3D -field ElectrostaticPotential \
-value 0.0 -name Iso1(3D) -color blue
#-> Iso1(3D)

参数说明

参数	说明
-field	等值所在的场。
-value	等值。
-color	颜色。
-geom	几何体名称。
-modify | -name	创建或修改。
-plot	图表名称。

---

create_plot

创建空 XY 图，或从 2D/3D 数据集创建图表。

语法

create_plot
-1d | -dataset <stringValue> | -duplicate <stringValue>
[-name <stringValue>]
[-ref_plot <stringValue>]
[-tdr_state_index <intValue>]

返回值

字符串。

示例

create_plot -dataset 3D
#-> Plot_3D

参数说明

参数	说明
-1d | -dataset | -duplicate	创建空图、从数据集创建或复制。
-name	图表名称。
-ref_plot	参考图表。
-tdr_state_index	TDR 状态索引。

---

create_projection

创建包含 3D 图轴上最大值或最小值的 2D 图。

TIP

此命令仅适用于 3D 图。

语法

create_projection 
-field <stringValue>
-function max | min
-type x | y | z | free
[-dataset <stringValue> | -plot <stringValue>] [-geom <stringValue>]
[-materials <stringList> | -regions <stringList>]
[-name <stringValue>] [-normal <doubleList>]
[-origin <doubleList>] [-resolution <x>x<y>x<z>]
[-width <doubleValue>] [-window {x1 y1 [z1] x2 y2 [z2]}]

返回值

字符串。

示例

create_projection -plot Plot_3D -field DopingConcentration \
-function max -resolution 50x50x50
-type free -origin {0 0 0} -normal {0.1 0.05 -0.3}
#-> Projection_max(3D)

参数说明

参数	说明
-field	要投影的场。
-function max | min	最大值或最小值投影。
-type	投影轴。
-dataset | -plot	源数据集或图表。
-geom	几何体。
-materials | -regions	材料或区域。
-name	结果图表名称。
-normal	平面法线。
-origin	平面原点。
-resolution	算法分辨率。
-width	域宽度。
-window	窗口范围。

---

create_projection_path

创建从路径上多个平面提取最大值/最小值的 2D 图。

TIP

此命令仅适用于 3D 图。

语法

create_projection_path
-field <stringValue>
-function max | min
-points <pointList>
-type x | y | z
[-dataset <stringValue> | -plot <stringValue>]
[-geom <stringValue>]
[-name <stringValue>]
[-resolution <x>x<y>x<z>]
[-width <doubleList>]

返回值

字符串。

示例

create_projection_path -plot Plot_3D -field DopingConcentration
-type x -function max -resolution 50x50x50 -width {0.1 0.14}
-points {"2.5e-05 -0.0669983 0.0378416" "-0.0950691 -0.0272096"
"0.0251004" "-0.100966 0.00648555 0.0243684"}
#-> Projection_max(3D)

参数说明

参数	说明
-field	要投影的场。
-function	最大值或最小值投影。
-points	定义路径的点。
-type	拉伸轴。
-dataset | -plot	源数据集或图表。
-geom	几何体。
-name	结果图表名称。
-resolution	算法分辨率。
-width	每个平面的宽度。

---

create_ruler

测量两点之间的距离。

TIP

此命令仅适用于 2D 和 3D 图。

语法

create_ruler -id <intValue> -point1 {x y [z]} -point2 {x y [z]}
[-plot <stringValue>] [-snap_on | -snap_off]

返回值

两点之间的距离。

示例

create_ruler -id 2 -point1 {0.1 0.1 0.1} -point2 {0.5 0.5 0.2} -snap_off
#-> 0.574456264654

参数说明

参数	说明
-id	直尺的 ID。
-point1	第一个点。
-point2	第二个点。
-plot	图表名称。
-snap_on | -snap_off	吸附到网格功能。

---

create_streamline

在 2D 或 3D 图上创建新的流线。

TIP

此命令仅适用于 2D 和 3D 图。

语法

create_streamline
-direction forward | backward | both
-field <stringValue>
(-point {<x> <y> [<z>]} | 
-p1 {<x> <y> [<z>]} -p2 {<x> <y> [<z>]} -nofpoints <intValue>)
[-geom <stringValue>]
[-integ_initial_step <doubleValue>]
[-integ_max_propagation <doubleValue>]
[-integ_max_steps <intValue>]
[-integ_terminal_speed <doubleValue>]
[-materials <stringList> | -regions <stringList>]
[-name <stringValue>] [-plot <stringValue>]

返回值

列表。

示例

create_streamline -field ElectricField -point {0.5 0.2} -direction both
#-> Streamline_1

参数说明

参数	说明
-direction	流线方向。
-field	创建流线的场。
-point | -p1 -p2 -nofpoints	起点/终点定义。
-geom	几何体名称。
-integ_initial_step	初始步长。
-integ_max_propagation	最大传播长度。
-integ_max_steps	迭代次数。
-integ_terminal_speed	终端速度阈值。
-materials | -regions	材料或区域。
-name	流线标识符。
-plot	图表名称。

---

create_surface

使用 2D 数据集创建新的 3D 数据集。

TIP

此命令仅适用于 2D 和 3D 表面数据集。

语法

create_surface
[-dataset <stringValue> | -plot <stringValue> [-geom <stringValue>]]
[-factor <doubleValue>] [-field <stringValue>] [-name <stringValue>]
[-range <doubleList>] [-scale linear | logabs | asinh]

返回值

字符串（数据集名称）。

示例

create_surface -plot Plot_2D -geom 2D -field ElectrostaticPotential \
-factor 0.2 -name Surface1(2D)
#-> Surface1(2D)

参数说明

参数	说明
-dataset	数据集。
-factor	坐标乘数。
-field	场。
-geom	几何体。
-name	表面数据集名称。
-plot	图表。
-range	坐标范围。
-scale	比例类型。

---

create_variable

创建新变量。

TIP

此命令仅适用于 XY 图。

语法

create_variable
-dataset <stringValue>
(-function <stringValue> | -values <doubleList>)
-name <stringValue>

返回值

字符串。

示例

create_variable -name nVar -dataset idvd -values {0.1 0.3 0.5 0.7 0.9}
#-> nVar

参数说明

参数	说明
-dataset	数据集。
-function | -values	表达式或值列表。
-name	变量名称。

---

diff_plots

创建图表差异数据集。

TIP

此命令仅适用于 2D 和 3D 图。

语法

diff_plots <stringList> [-display] [-normalized]

返回值

字符串。

示例

diff_plots {Plot1 Plot2}
#-> Plot1-Plot2

参数说明

参数	说明
<stringList>	图表列表。
-display	创建新图表。
-normalized	归一化值。

---

draw_ellipse

在指定位置绘制椭圆。

TIP

此命令仅适用于 XY 图。

语法

draw_ellipse -p1 {<x1> <y1>} -p2 {<x2> <y2>} 
[-plot <stringValue>]

返回值

字符串（椭圆名称）。

示例

draw_ellipse -plot Plot_XY -p1 {0 0.5} -p2 {0.75 0.25}
#-> Ellipse_1

参数说明

参数	说明
-p1	矩形左上角。
-p2	矩形右下角。
-plot	图表名称。

---

draw_line

绘制连接两点的直线。

TIP

此命令仅适用于 XY 和 2D 图。

语法

draw_line -p1 <doubleList> -p2 <doubleList>
[-plot <stringValue>]

返回值

字符串（线条名称）。

示例

draw_line -plot Plot_n9_des -p1 {62.9161 49.8411} -p2 {138.117 60.5841}
#-> Line_1

参数说明

参数	说明
-p1	第一个点。
-p2	第二个点。
-plot	图表名称。

---

draw_rectangle

绘制矩形。

TIP

此命令仅适用于 XY 和 2D 图。

语法

draw_rectangle -p1 <doubleList> -p2 <doubleList>
[-plot <stringValue>]

返回值

字符串（矩形名称）。

示例

draw_rectangle -plot Plot_n9_des -p1 {46.0341 38.0749} \
-p2 {97.1916 112.253}
#-> Plane_1

参数说明

参数	说明
-p1	左上角。
-p2	右下角。
-plot	图表名称。

---

draw_textbox

绘制带有标签的文本框和箭头。

TIP

此命令仅适用于 XY 和 2D 图。

语法

draw_textbox -at <doubleList> -label <stringValue>
[-anchor <doubleList>] [-plot <stringValue>]

返回值

字符串（文本框名称）。

示例

draw_textbox -at {219.458 41.6559} -anchor {219.458 41.1443} -label Text
#-> Text

参数说明

参数	说明
-at	文本框位置。
-label	标签文本。
-anchor	箭头指向位置。
-plot	图表名称。

---

echo

在控制台中打印字符串。

语法

echo [<stringValue>]

返回值

无。

示例

echo "Hello World"
#-> Hello World

---

exit

退出 Sentaurus Visual。

语法

exit [<intValue>]

返回值

无。

示例

exit 1
#-> Exit status: 1

参数说明

参数	说明
<intValue>	退出代码。默认 0。

---

export_curves

将曲线导出为文件。

语法

export_curves -filename <stringValue> -plot <stringValue>
[<stringList>] [-format csv | plx] [-overwrite]

返回值

Integer。

示例

export_curves -plot Plot_1 -filename testFile.csv -format csv
#-> 0

参数说明

参数	说明
-filename	文件名。
-plot	图表。
<stringList>	曲线列表。
-format	格式：csv 或 plx。
-overwrite	覆盖。

---

export_movie

将帧导出为 GIF 电影。

TIP

必须先使用 start_movie 和 add_frame 命令。

语法

export_movie -filename <stringValue>
[-frame_duration <intValue>]
[-frames <stringList>] [-overwrite]

返回值

字符串。

示例

export_movie -filename Movie.gif -frame_duration 2 -overwrite
#-> Movie.gif

参数说明

参数	说明
-filename	电影文件名。
-frame_duration	每帧持续时间（1/100 秒）。
-frames	帧列表。
-overwrite	覆盖。

---

export_settings

导出 Sentaurus Visual 设置到文件。

语法

export_settings <stringValue>

返回值

Integer。

示例

export_settings settings.conf
#-> 0

---

export_variables

将变量导出到文件。

语法

export_variables -dataset <stringValue> -filename <stringValue>
[-overwrite] [<stringList>]

返回值

Integer。

示例

export_variables -dataset Data_1 -filename exportedVars.csv
#-> 0

参数说明

参数	说明
-dataset	数据集。
-filename	文件路径。
-overwrite	覆盖。
<stringList>	变量列表。

---

export_view

将图表导出为图像文件。

语法

export_view <stringValue>
[-format <stringValue>] [-overwrite] [-plots <stringList>]
[-resolution <width>x<height>]

返回值

Integer。

示例

export_view /path/to/examplePlot.bmp -format bmp
#-> 0

参数说明

参数	说明
<stringValue>	文件名。
-format	格式：BMP、EPS、JPEG、JPG、PNG、PPM、TIF、TIFF、XBM、XPM。
-overwrite	覆盖。
-plots	图表列表。
-resolution	输出分辨率。

---

extract_path

提取标量场最小值/最大值的路径。

TIP

此命令仅适用于 2D 和 3D 图。

语法

extract_path <stringValue> -max | -min
[-bottom <doubleValue>] [-geom <stringValue>]
[-materials <stringList> | -regions <stringList>] 
[-plot <stringValue>] [-points <pointList>]
[-start {<x> <y> <z>} -end {<x> <y> <z>}]
[-top <doubleValue>] [-type x | y | z]
[-window {<x1> <y1> [<z1>] <x2> <y2> [<z2])}]

返回值

字符串（几何体名称）。

示例

extract_path ElectrostaticPotential -plot Plot_2D -geom 2D \
-materials {Oxide Silicon} -window {-10.32 0 10 10} -max
#-> PathGeometry_2D

参数说明

参数	说明
<stringValue>	标量场名称。
-max | -min	最大值还是最小值。
-bottom	底面坐标。
-geom	几何体。
-materials | -regions	材料或区域。
-plot	图表。
-points	多边形顶点。
-start -end	3D 路径起点终点。
-top	顶面坐标。
-type	拉伸轴。
-window	窗口。

---

extract_streamlines

从流线中提取场和坐标数据。

TIP

此命令仅适用于 2D 和 3D 图。

语法

extract_streamlines <stringList> [-plot <stringValue>]

返回值

列表（1D 数据集名称）。

示例

extract_streamlines {Streamline} -plot Plot_2D
#-> {Streamline(Plot_2D)}

参数说明

参数	说明
<stringList>	流线列表。
-plot	图表。

---

extract_value

计算多面体的最小/最大场值。

TIP

此命令仅适用于 3D 图。

语法

extract_value -min | -max
[-bottom <doubleValue>] [-dataset <stringValue>]
[-field <stringValue>] [-geom <stringValue>]
[-materials <stringList> | -regions <stringList>]
[-plot <stringValue>] [-points <pointList>]
[-top <doubleValue>] [-type x | y | z]

返回值

Double 和坐标值列表。

示例

extract_value -plot Plot_n10_des -field Abs(TotalCurrentDensity-V) 
-min -type z -top 0.05 -bottom 0
-points {{0 -0.04 0.05} {0 0.04 0.05} {0.1 0.04 0.05} 
{0.1 -0.04 0.05}}
#-> -6.41e+18 {0.00781 0.01 0.00625}

参数说明

参数	说明
-min | -max	最小值还是最大值。
-bottom	底面高度。
-dataset	数据集。
-field	场。
-geom	几何体。
-materials | -regions	材料或区域。
-plot	图表。
-points	多边形顶点。
-top	顶面高度。
-type	拉伸轴。

---

find_values

返回标量场中具有指定值的所有点的位置。

TIP

此命令仅适用于 2D 和 3D 图。

语法

find_values <doubleValue> -field <stringValue>
[-geom <stringValue>] [-plot <stringValue>]
[-window {<x1> <y1> [<z1>] <x2> <y2> [<z2>]}]

返回值

点的位置列表。

示例

find_values 1.0 -field ElectrostaticPotential
#-> {3.53079 -0.0263978 0.392817} {6.41207 -1.7982327 3.289376}

参数说明

参数	说明
<doubleValue>	要查找的值。
-field	标量场。
-geom	几何体。
-plot	图表。
-window	窗口范围。

---

get_angle_prop

返回角度属性。

语法

get_angle_prop
(-center | -color | -orthogonal_on | -pos1 | -pos2 | -precision |
-show_label | -snap_on | -width)
[-plot <stringValue>]

返回值

属性值。

示例

get_angle_prop -color
#-> #000000

参数说明

参数	说明
-center	角度中心。
-color	颜色。
-orthogonal_on	正交移动状态。
-pos1	第一个点。
-pos2	第二个点。
-precision	小数精度。
-show_label	标签状态。
-snap_on	吸附状态。
-width	线条宽度。
-plot	图表。

---

get_axis_prop

返回轴属性。

语法

get_axis_prop -axis x | y | z | y2
(-anchor | -auto_padding | -auto_precision | -auto_spacing | 
-inverted | -label_angle | -label_font_att | -label_font_color |
-label_font_factor | -label_font_family | -label_font_size |
-label_format | -label_padding | -label_precision |
-major_ticks_length | -major_ticks_width | -max | -max_fixed | 
-min | -min_fixed | -minor_ticks_length | -minor_ticks_position |
-minor_ticks_width | -nof_minor_ticks | -padding | -range | 
-show | -show_minor_ticks | -show_label | -show_ticks |
-show_title | -spacing | -ticks_position | -title | 
-title_font_att | -title_font_color | -title_font_factor |
-title_font_family | -title_font_size | -type)
[-plot <stringValue>]

返回值

属性值。

示例

get_axis_prop -axis x -type
#-> linear

参数说明

参数	说明
-axis x | y | z | y2	轴。
-anchor	刻度起点。
-auto_padding	自动填充。
-auto_precision	自动精度。
-auto_spacing	自动间距。
-inverted	反转状态。
-label_angle	标签角度。
-label_font_att	标签字体属性。
-label_font_color	标签颜色。
-label_font_factor	标签大小因子。
-label_font_family	标签字体。
-label_font_size	标签大小。
-label_format	标签格式。
-label_padding	标签填充。
-label_precision	标签精度。
-major_ticks_length	主刻度长度。
-major_ticks_width	主刻度宽度。
-max	最大值。
-max_fixed	最大值固定状态。
-min	最小值。
-min_fixed	最小值固定状态。
-minor_ticks_length	副刻度长度。
-minor_ticks_position	副刻度位置。
-minor_ticks_width	副刻度宽度。
-nof_minor_ticks	副刻度数量。
-padding	填充。
-range	范围。
-show	显示状态。
-show_minor_ticks	副刻度显示。
-show_label	标签显示。
-show_ticks	刻度显示。
-show_title	标题显示。
-spacing	间距。
-ticks_position	刻度位置。
-title	标题。
-title_font_att	标题字体属性。
-title_font_color	标题颜色。
-title_font_factor	标题大小因子。
-title_font_family	标题字体。
-title_font_size	标题大小。
-type	比例类型。
-plot	图表。

---

get_camera_prop

返回相机属性。

TIP

仅适用于 3D 图。

语法

get_camera_prop 
(-dolly_zoom_on | -focal_point | -parallel | -position | -rot_color |
-rot_size | -rot_width | -rotation_point | -setup |
-show_rotation_point | -view_angle | -view_up)
[-plot <stringValue>]

返回值

属性值。

示例

get_camera_prop -position
#-> 3.53079 -0.0263978 0.392817

参数说明

参数	说明
-dolly_zoom_on	dolly 缩放状态。
-focal_point	焦点位置。
-parallel	平行投影状态。
-position	相机位置。
-rot_color	旋转点颜色。
-rot_size	旋转点大小。
-rot_width	旋转点宽度。
-rotation_point	旋转点位置。
-setup	当前设置。
-show_rotation_point	旋转点显示。
-view_angle	视角。
-view_up	view-up 向量。
-plot	图表。

---

get_contour_labels_prop

返回等值线标签属性。

语法

get_contour_labels_prop <stringValue>
(-anchor | -color_bg | -font_att | -font_color | -font_factor | 
-font_family | -format | -level_skip | -precision | -show_bg |
-show_index | -spacing)
[-geom <stringValue>] [-plot <stringValue>]

返回值

属性值。

示例

get_contour_labels_prop DopingConcentration -format
#-> engineering

参数说明

参数	说明
<stringValue>	场名称。
-anchor	锚点。
-color_bg	背景颜色。
-font_att	字体属性。
-font_color	字体颜色。
-font_factor	字体乘数。
-font_family	字体类型。
-format	格式。
-level_skip	级别跳过。
-precision	精度。
-show_bg	背景显示。
-show_index	索引显示。
-spacing	间距。
-geom	几何体。
-plot	图表。

---

get_curve_data

返回曲线轴的数据。

语法

get_curve_data <stringValue> -axisX | -axisY | -scalar
[-plot <stringValue>]

返回值

数据值。

示例

get_curve_data Curve_1 -axisX
#-> 0 0.05 0.1 0.15 0.2 0.25 0.3 0.35 0.4 0.45 0.5

参数说明

参数	说明
<stringValue>	曲线名称。
-axisX | -axisY | -scalar	轴或标量。
-plot	图表。

---

get_curve_prop

返回曲线属性。

TIP

仅适用于 XY 图。

语法

get_curve_prop <stringValue>
(-axis | -color | -deriv | -function | -integ | -label | -line_style |
-line_width | -markers_size | -markers_type | -selected | -show | 
-show_legend | -show_line | -show_markers | -xScale | -xShift |
-yScale | -yShift)
[-plot <stringValue>]

返回值

属性值。

示例

get_curve_prop Curve_1 -deriv
#-> 2

参数说明

参数	说明
<stringValue>	曲线标识符。
-axis	轴对齐。
-color	颜色。
-deriv	导数阶数。
-function	函数。
-integ	积分。
-label	标签。
-line_style	线型。
-line_width	线宽。
-markers_size	标记大小。
-markers_type	标记类型。
-selected	选中状态。
-show	显示状态。
-show_legend	图例显示。
-show_line	线条显示。
-show_markers	标记显示。
-xScale	x 比例。
-xShift	x 偏移。
-yScale	y 比例。
-yShift	y 偏移。
-plot	图表。

---

get_cutline_prop

返回切割线属性。

TIP

适用于 2D 和 3D 图。

语法

get_cutline_prop <stringValue> -plot <stringValue>
(-handles_color | -hide_handles | -label_op | -label_pos | 
-label_size | -line_color | -line_style | -line_width |
-pos1 | -pos2 | -show_handles | -show_label)

返回值

属性值。

示例

get_cutline_prop C1 -plot Plot_2D -pos1
#-> 0.1 2.7891 0

参数说明

参数	说明
<stringValue>	切割线名称。
-plot	图表。
-handles_color	手柄颜色。
-hide_handles	手柄隐藏状态。
-label_op	标签位置。
-label_pos	标签位置。
-label_size	标签大小。
-line_color	线条颜色。
-line_style	线条样式。
-line_width	线条宽度。
-pos1	第一个点。
-pos2	第二个点。
-show_handles	手柄显示。
-show_label	标签显示。

---

get_cutplane_prop

返回切割面属性。

TIP

仅适用于 3D 图。

语法

get_cutplane_prop <stringValue> -plot <stringValue>
(-at | -hide_label | -label_position | -label_size | -normal |
-origin | -show_label)

返回值

属性值。

示例

get_cutplane_prop C1 -plot Plot_3D -at
#-> 0.483

参数说明

参数	说明
<stringValue>	切割面名称。
-plot	图表。
-at	位置值。
-hide_label	标签隐藏状态。
-label_position	标签位置。
-label_size	标签大小。
-normal	法线向量。
-origin	原点向量。
-show_label	标签显示。

---

get_ellipse_prop

返回椭圆属性。

TIP

仅适用于 XY 图。

语法

get_ellipse_prop <stringValue>
( -fill_color | -line_color | -line_style | -line_width | -p1 | -p2 )
[-plot <stringValue>]

返回值

属性值。

示例

get_ellipse_prop Ellipse_1 -plot Plot_1 -line_style
#-> dashdotdot

参数说明

参数	说明
<stringValue>	椭圆对象名称。
-fill_color	填充颜色。
-line_color	线条颜色。
-line_style	线条样式。
-line_width	线条宽度。
-p1	起点。
-p2	终点。
-plot	图表。

---

get_field_prop

返回场属性。

TIP

仅适用于 2D 和 3D 图。

语法

get_field_prop [<stringValue>]
(-contour_labels_on | -custom_levels | -interpolated_values | -label |
-levels | -line_color | -line_width | -max | -max_fixed | -min | 
-min_fixed | -range | -scale | -show | -show_bands)
[-geom <stringValue>] [-plot <stringValue>]

返回值

属性值。

示例

get_field_prop -range
#-> {2.36618e-05 4.36902e+06}

参数说明

参数	说明
<stringValue>	场名称。
-contour_labels_on	等值线标签。
-custom_levels	自定义级别。
-interpolated_values	插值状态。
-label	标签。
-levels	级别。
-line_color	线条颜色。
-line_width	线条宽度。
-max	最大值。
-max_fixed	最大值固定。
-min	最小值。
-min_fixed	最小值固定。
-range	范围。
-scale	比例。
-show	显示状态。
-show_bands	条带显示。
-geom	几何体。
-plot	图表。