Axes¶
Field Axes¶
Cartesian2DFieldAxes¶
-
class
tecplot.plot.Cartesian2DFieldAxes(plot)[source]¶ (X, Y) axes style control for 2D field plots.
from os import path import tecplot as tp from tecplot.constant import PlotType examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'HeatExchanger.plt') dataset = tp.data.load_tecplot(infile) frame = tp.active_frame() plot = frame.plot(PlotType.Cartesian2D) plot.show_shade = False plot.show_contour = True plot.axes.auto_adjust_ranges = True plot.axes.precise_grid.show = True plot.axes.precise_grid.size = 0.05 plot.view.fit() tp.export.save_png('axes_2d.png', 600, supersample=3)
Attributes
auto_adjust_rangesAutomatically adjust axis ranges to nice values. axis_modeControls automatic adjustment of axis ranges. grid_areaArea bounded by the axes. precise_gridPrecise dot grid. preserve_scalePreserve scale (spacing between ticks) on range change. viewportArea of the frame used by the plot axes. x_axisX-axis style control. xy_ratioX – Y axis scaling ratio. y_axisY-axis style control.
-
Cartesian2DFieldAxes.auto_adjust_ranges¶ Automatically adjust axis ranges to nice values.
Type: booleanAxes limits will be adjusted to have the smallest number of significant digits possible:
>>> plot.axes.auto_adjust_ranges = False
-
Cartesian2DFieldAxes.axis_mode¶ Controls automatic adjustment of axis ranges.
Type: AxisModePossible values:
Independent,XYDependent.If set to
XYDependent, then setting the range of one axis automatically scales the other indicated axes proportionally to maintain the aspect ratio of the plot, effectively zooming in or out. If set toIndependent, adjusting the range of one axis has no effect on other axes. Defaults toIndependentfor XY line plots,XYDependentfor 2D Cartesian plots. Example usage:>>> from tecplot.constant import AxisMode >>> plot.axes.axis_mode = AxisMode.Independent
-
Cartesian2DFieldAxes.grid_area¶ Area bounded by the axes.
Type: GridAreaThis controls the background color and border of the axes:
>>> from tecplot.constant import Color >>> plot.axes.grid_area.fill_color = Color.LightGreen
-
Cartesian2DFieldAxes.precise_grid¶ Precise dot grid.
Type: PreciseGridThis is a set of small dots drawn at the intersection of every minor gridline. In line plots, the axis assignments for the first active mapping govern the precise dot grid. The precise dot grid option is disabled for the 3D Cartesian plots and Line plots when either axis for the first active line mapping uses a log scale:
>>> plot.axes.precise_grid.show = True
-
Cartesian2DFieldAxes.preserve_scale¶ Preserve scale (spacing between ticks) on range change.
Type: booleanThis maintains the axis scaling, i.e. the distance between values along the axis. If
False, the axes length will be preserved when the range changes:>>> plot.axes.preserve_scale = False >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.max = 10 # axis scale is changed (length is preserved)
-
Cartesian2DFieldAxes.viewport¶ Area of the frame used by the plot axes.
Type: Cartesian2DViewportExample usage:
>>> plot.axes.viewport.left = 5 >>> plot.axes.viewport.right = 95 >>> plot.axes.viewport.top = 95 >>> plot.axes.viewport.bottom = 5
-
Cartesian2DFieldAxes.x_axis¶ X-axis style control.
Type: Cartesian2DFieldAxisExample usage:
>>> plot.axes.x_axis.show = False
-
Cartesian2DFieldAxes.xy_ratio¶ X – Y axis scaling ratio.
Type: floatin percentThis requires the axes to be in dependent mode:
>>> from tecplot.constant import AxisMode >>> plot.axes.axis_mode = AxisMode.XYDependent >>> plot.axes.xy_ratio = 2
-
Cartesian2DFieldAxes.y_axis¶ Y-axis style control.
Type: Cartesian2DFieldAxisExample usage:
>>> plot.axes.y_axis.show = False
Cartesian2DFieldAxis¶
-
class
tecplot.plot.Cartesian2DFieldAxis(axes, name, **kwargs)[source]¶ X or Y axis for 2D field plots.
from os import path import tecplot as tp from tecplot.constant import PlotType, AxisMode, AxisTitleMode examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'HeatExchanger.plt') dataset = tp.data.load_tecplot(infile) frame = tp.active_frame() plot = frame.plot(PlotType.Cartesian2D) plot.show_contour = True plot.axes.axis_mode = AxisMode.Independent plot.axes.viewport.right = 75 plot.axes.preserve_scale = False xaxis = plot.axes.x_axis xaxis.title.text = 'Longitudinal (m)' xaxis.title.title_mode = AxisTitleMode.UseText xaxis.min = 3.8 xaxis.max = 5.3 xaxis.grid_lines.show = True xaxis.grid_lines.draw_last = True yaxis = plot.axes.y_axis yaxis.title.text = 'Transverse (m)' yaxis.title.title_mode = AxisTitleMode.UseText yaxis.min = 2.8 yaxis.max = 4.3 yaxis.grid_lines.show = True yaxis.minor_grid_lines.show = True yaxis.minor_grid_lines.draw_last = True tp.export.save_png('axis_2d.png',600, supersample=3)
Attributes
grid_linesMajor grid lines style control. lineAxis line style control. log_scaleUse logarithmic scale for this axis. marker_grid_lineMarker line to indicate a particular position along an axis. maxUpper bound of this axis’ range. minLower bound of this axis’ range. minor_grid_linesMinor grid lines style control. reverseReverse the direction of the axis scale. showEnable drawing of this axis. tick_labelsAxis ticks labels style control. ticksAxis major and minor ticks style control. titleAxis title. variableThe Variableassigned to this axis.variable_indexIndex of the Variableassigned to this axis.Methods
adjust_range_to_nice()Rounds the axis range to the nearest major axis increment. fit_range([consider_blanking])Set range of axis to variable minimum and maximum. fit_range_to_nice([consider_blanking])Set range of axis to nice values near variable minimum and maximum.
-
Cartesian2DFieldAxis.adjust_range_to_nice()¶ Rounds the axis range to the nearest major axis increment.
This method resets the axis-line label values such that all currently displayed label values are set to have the smallest number of significant digits possible.
Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.adjust_range_to_nice()
-
Cartesian2DFieldAxis.fit_range(consider_blanking=True)¶ Set range of axis to variable minimum and maximum.
Note
If the axis dependency is not
Independent, then this action may also affect the range on another axis.Parameters: consider_blanking ( Boolean, optional) – IfTrueand blanking is enabled, the resulting view excludes blanked cells at the edges of the plot. IfFalse, then the resulting view will ignore blanked cells at the edges of the plot. (default:True)Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.fit_range()
-
Cartesian2DFieldAxis.fit_range_to_nice(consider_blanking=True)¶ Set range of axis to nice values near variable minimum and maximum.
This method resets the range to equal the minimum and maximum of the data being plotted, but makes the axis values “nice” by setting labels to have the smallest number of significant digits possible,
Note
If the axis dependency is not independent then this method may also affect the range on another axis.
Parameters: consider_blanking ( Boolean, optional) – IfTrueand blanking is enabled, the resulting view excludes blanked cells at the edges of the plot. IfFalse, then the resulting view will ignore blanked cells at the edges of the plot. (default:True)Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.fit_range_to_nice()
-
Cartesian2DFieldAxis.grid_lines¶ Major grid lines style control.
Type: GridLines2DMajor grid lines are attached to the locations of the major ticks. See
minor_grid_linesfor lines attached to minor ticks. Example usage:>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.grid_lines.show = True
-
Cartesian2DFieldAxis.line¶ Axis line style control.
Type: Cartesian2DAxisLineExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.line_thickness = 0.6
-
Cartesian2DFieldAxis.log_scale¶ Use logarithmic scale for this axis.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> # or "plot.axes.r_axis" for the radial axis in polar plots >>> axis.log_scale = True
-
Cartesian2DFieldAxis.marker_grid_line¶ Marker line to indicate a particular position along an axis.
Type: MarkerGridLine2DExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.marker_grid_line.show = True >>> axis.marker_grid_line.position = 0.5
-
Cartesian2DFieldAxis.max¶ Upper bound of this axis’ range.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.max = 1.0
-
Cartesian2DFieldAxis.min¶ Lower bound of this axis’ range.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.min = 0.0
-
Cartesian2DFieldAxis.minor_grid_lines¶ Minor grid lines style control.
Type: MinorGridLines2DMinor grid lines are attached to the locations of the minor ticks. Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.minor_grid_lines.show = True
-
Cartesian2DFieldAxis.reverse¶ Reverse the direction of the axis scale.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.reverse = True
-
Cartesian2DFieldAxis.show¶ Enable drawing of this axis.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.show = True
-
Cartesian2DFieldAxis.tick_labels¶ Axis ticks labels style control.
Type: TickLabels2DExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.tick_labels.show = False
-
Cartesian2DFieldAxis.ticks¶ Axis major and minor ticks style control.
Type: Ticks2DExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.ticks.line_thickness = 0.8
-
Cartesian2DFieldAxis.title¶ Axis title.
Type: stringThis is the primary label for the axis and usually includes units:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.title.text = 'distance (m)'
-
Cartesian2DFieldAxis.variable¶ The
Variableassigned to this axis.Type: VariableThis is the spatial variable associated with this axis and is usually one of
(X, Y, Z). Example usage:>>> import tecplot as tp >>> fr = tp.active_frame() >>> ds = fr.dataset >>> axes = fr.plot().axes >>> axes.x_axis.variable.name, axes.y_axis.variable.name ('X', 'Y') >>> axes.x_axis.variable = ds.variable('U') >>> axes.y_axis.variable = ds.variable('V') >>> axes.x_axis.variable.name, axes.y_axis.variable.name ('U', 'V')
-
Cartesian2DFieldAxis.variable_index¶ Index of the
Variableassigned to this axis.Type: Index(zero-based)Example usage, interchanging the (x, y) axes:
>>> v0 = plot.axes.x_axis.variable_index >>> v1 = plot.axes.y_axis.variable_index >>> plot.axes.x_axis.variable_index = v1 >>> plot.axes.y_axis.variable_index = v0
Cartesian3DFieldAxes¶
-
class
tecplot.plot.Cartesian3DFieldAxes(plot)[source]¶ (X, Y, Z) axes style control for 3D field plots.
from os import path import tecplot as tp from tecplot.constant import PlotType, Color examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'Sphere.lpk') dataset = tp.load_layout(infile) frame = tp.active_frame() plot = frame.plot() plot.axes.x_axis.show = True plot.axes.y_axis.show = True plot.axes.z_axis.show = True plot.axes.grid_area.fill_color = Color.SkyBlue plot.axes.padding = 20 plot.view.fit() tp.export.save_png('axes_3d.png', 600, supersample=3)
Attributes
aspect_ratio_limitScale limit of the axes aspect ratio. aspect_ratio_resetAxes scale aspect ratio used when aspect_ratio_limitis exceeded.auto_edge_assignmentEnable automatically choosing which edges to label. axis_modeScale dependencies along each axis. grid_areaArea of the viewport used by the axes. orientation_axisGet the 3D Orientation Axes. paddingMargin of axis padding around data. preserve_scalePreserve scale (spacing between ticks) on range change. range_aspect_ratio_limitRange limit of the axes aspect ratio. range_aspect_ratio_resetAxes range aspect ratio used range_aspect_ratio_limitis exceeded.viewportArea of the frame used by the plot axes. x_axisX-axis style control. xy_ratioX – Y axis scaling ratio. xz_ratioX – Z axis scaling ratio. y_axisY-axis style control. z_axisZ-axis style control. Methods
reset_origin([location])Set the origin to the specified location. reset_range()Recalculate and set the ranges for each axis. reset_scale()Recalculate and set the scale factors for each axis.
-
Cartesian3DFieldAxes.aspect_ratio_limit¶ Scale limit of the axes aspect ratio.
Type: floatThis is the limit above which the axes relative scales will be pegged to
aspect_ratio_reset. The following example will set the aspect ratio between scales to 1 if they first exceed a ratio of 10:>>> plot.axes.aspect_ratio_limit = 10 >>> plot.axes.aspect_ratio_reset = 1 >>> plot.axes.reset_scale()
-
Cartesian3DFieldAxes.aspect_ratio_reset¶ Axes scale aspect ratio used when
aspect_ratio_limitis exceeded.Type: floatThis is the aspect ratio used to scale the axes when the data’s aspect ratio exceeds the value set to
aspect_ratio_limit. The following example will set the aspect ratio between scales to 10 if they first exceed a ratio of 15:>>> plot.axes.aspect_ratio_limit = 15 >>> plot.axes.aspect_ratio_reset = 10 >>> plot.axes.reset_scale()
-
Cartesian3DFieldAxes.auto_edge_assignment¶ Enable automatically choosing which edges to label.
Type: boolExample usage:
>>> plot.axes.auto_edge_assignment = True
-
Cartesian3DFieldAxes.axis_mode¶ Scale dependencies along each axis.
Type: AxisModePossible values:
Independent,XYDependent,XYZDependent.If set to
XYDependentorXYZDependent, then setting the range of one axis automatically scales the other indicated axes proportionally to maintain the aspect ratio of the plot, effectively zooming in or out. If set toIndependent, adjusting the range of one axis has no effect on other axes. Defaults toXYZDependentfor 3D Cartesian plots. Both dependent modes allow specifying the axes scaling ratios:>>> from tecplot.constant import AxisMode >>> plot.axes.axis_mode = AxisMode.XYZDependent >>> plot.axes.xy_ratio = 2 >>> plot.axes.xz_ratio = 20
-
Cartesian3DFieldAxes.grid_area¶ Area of the viewport used by the axes.
Type: Cartesian3DGridAreaExample usage:
>>> plot.axes.grid_area.fill_color = Color.LightGreen
-
Cartesian3DFieldAxes.orientation_axis¶ Get the 3D Orientation Axes.
Type: OrientationAxisExample usage:
>>> # Hide the orientation axes >>> plot.axes.orientation_axis.show = False
-
Cartesian3DFieldAxes.padding¶ Margin of axis padding around data.
Type: floatin percent of data extent.Example usage:
>>> plot.axes.padding = 5
-
Cartesian3DFieldAxes.preserve_scale¶ Preserve scale (spacing between ticks) on range change.
Type: booleanThis maintains the axis scaling, i.e. the distance between values along the axis. If
False, the axes length will be preserved when the range changes:>>> plot.axes.preserve_scale = False >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.max = 10 # axis scale is changed (length is preserved)
-
Cartesian3DFieldAxes.range_aspect_ratio_limit¶ Range limit of the axes aspect ratio.
Type: floatThis is the limit above which the axes’ relative ranges will be pegged to
range_aspect_ratio_reset. The following example will set the aspect ratio between ranges to 1 if they first exceed a ratio of 10:>>> plot.axes.range_aspect_ratio_limit = 10 >>> plot.axes.range_aspect_ratio_reset = 1 >>> plot.axes.reset_range()
-
Cartesian3DFieldAxes.range_aspect_ratio_reset¶ Axes range aspect ratio used
range_aspect_ratio_limitis exceeded.Type: floatThis is the aspect ratio used to set the ranges of the axes when the axes’ aspect ratios exceed the value of
range_aspect_ratio_limit. The following example will set the aspect ratio between ranges to 10 if they first exceed a ratio of 15:>>> plot.axes.range_aspect_ratio_limit = 15 >>> plot.axes.range_aspect_ratio_reset = 10 >>> plot.axes.reset_range()
-
Cartesian3DFieldAxes.reset_origin(location=<OriginResetLocation.DataCenter: 0>)¶ Set the origin to the specified location.
Parameters: location ( OriginResetLocation, optional) – Either the center of the data withOriginResetLocation.DataCenter(default) or the center of the viewport withOriginResetLocation.ViewCenter.Example usage:
>>> from tecplot.constant import OriginResetLocation >>> plot.axes.reset_origin(OriginResetLocation.ViewCenter)
-
Cartesian3DFieldAxes.reset_range()¶ Recalculate and set the ranges for each axis.
Example usage:
>>> plot.axes.reset_range()
-
Cartesian3DFieldAxes.reset_scale()¶ Recalculate and set the scale factors for each axis.
Aspect ratio limits are taken into account:
>>> plot.axes.reset_scale()
-
Cartesian3DFieldAxes.viewport¶ Area of the frame used by the plot axes.
Type: ReadOnlyViewportExample usage:
>>> print(plot.axes.viewport.bottom) 5
-
Cartesian3DFieldAxes.x_axis¶ X-axis style control.
Type: Cartesian3DFieldAxisExample usage:
>>> plot.axes.x_axis.show = True
-
Cartesian3DFieldAxes.xy_ratio¶ X – Y axis scaling ratio.
Type: floatin percentThis requires the axes to be in dependent mode:
>>> from tecplot.constant import AxisMode >>> plot.axes.axis_mode = AxisMode.XYDependent >>> plot.axes.xy_ratio = 2
-
Cartesian3DFieldAxes.xz_ratio¶ X – Z axis scaling ratio.
Type: floatin percentThis requires the axes to be in dependent mode:
>>> from tecplot.constant import AxisMode >>> plot.axes.axis_mode = AxisMode.XYZDependent >>> plot.axes.xy_ratio = 2 >>> plot.axes.xz_ratio = 20
-
Cartesian3DFieldAxes.y_axis¶ Y-axis style control.
Type: Cartesian3DFieldAxisExample usage:
>>> plot.axes.y_axis.show = True
-
Cartesian3DFieldAxes.z_axis¶ Z-axis style control.
Type: Cartesian3DFieldAxisExample usage:
>>> plot.axes.z_axis.show = True
Cartesian3DFieldAxis¶
-
class
tecplot.plot.Cartesian3DFieldAxis(axes, name, **kwargs)[source]¶ X, Y or Z axis on 3D field plots.
from os import path import tecplot as tp from tecplot.constant import PlotType, Color, AxisLine3DAssignment examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'RainierElevation.lay') tp.load_layout(infile) frame = tp.active_frame() dataset = frame.dataset plot = frame.plot(PlotType.Cartesian3D) plot.activate() plot.show_contour = True plot.axes.grid_area.filled = False axes = [plot.axes.x_axis, plot.axes.y_axis, plot.axes.z_axis] assignments = [AxisLine3DAssignment.YMinZMax, AxisLine3DAssignment.ZMaxXMin, AxisLine3DAssignment.XMaxYMin] for ax, asgn in zip(axes, assignments): ax.show = True ax.grid_lines.show = False ax.title.show = False ax.line.show = False ax.line.edge_assignment = asgn plot.axes.z_axis.grid_lines.show = True plot.axes.y_axis.min=-2000 plot.axes.y_axis.max=1000 plot.axes.x_axis.min=-9500 plot.axes.x_axis.max=-7200 plot.axes.z_axis.min=0 plot.axes.x_axis.scale_factor=1.9 plot.view.width = 7830 plot.view.alpha = 0 plot.view.theta = -147.5 plot.view.psi = 70 plot.view.position = (1975, 15620, 115930) tp.export.save_png('axis_3d.png', 600, supersample=3)
Attributes
grid_linesMajor grid lines style control. lineAxis line style control. marker_grid_lineMarker line to indicate a particular position along an axis. maxUpper bound of this axis’ range. minLower bound of this axis’ range. minor_grid_linesMinor grid lines style control. scale_factorFactor used for axis scaling. showEnable drawing of this axis. tick_labelsAxis ticks labels style control. ticksAxis major and minor ticks style control. titleAxis title. variableThe Variableassigned to this axis.variable_indexIndex of the Variableassigned to this axis.Methods
adjust_range_to_nice()Rounds the axis range to the nearest major axis increment. fit_range([consider_blanking])Set range of axis to variable minimum and maximum. fit_range_to_nice([consider_blanking])Set range of axis to nice values near variable minimum and maximum.
-
Cartesian3DFieldAxis.adjust_range_to_nice()¶ Rounds the axis range to the nearest major axis increment.
This method resets the axis-line label values such that all currently displayed label values are set to have the smallest number of significant digits possible.
Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.adjust_range_to_nice()
-
Cartesian3DFieldAxis.fit_range(consider_blanking=True)¶ Set range of axis to variable minimum and maximum.
Note
If the axis dependency is not
Independent, then this action may also affect the range on another axis.Parameters: consider_blanking ( Boolean, optional) – IfTrueand blanking is enabled, the resulting view excludes blanked cells at the edges of the plot. IfFalse, then the resulting view will ignore blanked cells at the edges of the plot. (default:True)Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.fit_range()
-
Cartesian3DFieldAxis.fit_range_to_nice(consider_blanking=True)¶ Set range of axis to nice values near variable minimum and maximum.
This method resets the range to equal the minimum and maximum of the data being plotted, but makes the axis values “nice” by setting labels to have the smallest number of significant digits possible,
Note
If the axis dependency is not independent then this method may also affect the range on another axis.
Parameters: consider_blanking ( Boolean, optional) – IfTrueand blanking is enabled, the resulting view excludes blanked cells at the edges of the plot. IfFalse, then the resulting view will ignore blanked cells at the edges of the plot. (default:True)Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.fit_range_to_nice()
-
Cartesian3DFieldAxis.grid_lines¶ Major grid lines style control.
Type: GridLinesMajor grid lines are attached to the locations of the major ticks. See
minor_grid_linesfor lines attached to minor ticks. Example usage:>>> plot.axes.x_axis.grid_lines.show = True
-
Cartesian3DFieldAxis.line¶ Axis line style control.
Type: AxisLine3DExample usage:
>>> plot.axes.x_axis.line.line_thickness = 0.6
-
Cartesian3DFieldAxis.marker_grid_line¶ Marker line to indicate a particular position along an axis.
Type: MarkerGridLineExample usage:
>>> plot.axes.x_axis.marker_grid_line.show = True >>> plot.axes.x_axis.marker_grid_line.position = 0.5
-
Cartesian3DFieldAxis.max¶ Upper bound of this axis’ range.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.max = 1.0
-
Cartesian3DFieldAxis.min¶ Lower bound of this axis’ range.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.min = 0.0
-
Cartesian3DFieldAxis.minor_grid_lines¶ Minor grid lines style control.
Type: MinorGridLinesMinor grid lines are attached to the locations of the minor ticks. Example usage:
>>> plot.axes.x_axis.minor_grid_lines.show = True
-
Cartesian3DFieldAxis.scale_factor¶ Factor used for axis scaling.
Type: floatThis will automatically scale the other axes if axis mode dependent. Setting the axis mode to independent allows each axis to have their own scale factor:
>>> from tecplot.constant import AxisMode >>> plot.axes.axis_mode = AxisMode.Independent >>> plot.axes.x_axis.scale_factor = 1 >>> plot.axes.y_axis.scale_factor = 2 >>> plot.axes.z_axis.scale_factor = 3
-
Cartesian3DFieldAxis.show¶ Enable drawing of this axis.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.show = True
-
Cartesian3DFieldAxis.tick_labels¶ Axis ticks labels style control.
Type: TickLabels3DExample usage:
>>> plot.axes.x_axis.tick_labels.show = False
-
Cartesian3DFieldAxis.ticks¶ Axis major and minor ticks style control.
Type: Ticks3DExample usage:
>>> plot.axes.x_axis.ticks.line_thickness = 0.8
-
Cartesian3DFieldAxis.title¶ Axis title.
Type: stringThis is the primary label for the axis and usually includes units:
>>> plot.axes.x_axis.title.text = 'distance (m)'
-
Cartesian3DFieldAxis.variable¶ The
Variableassigned to this axis.Type: VariableThis is the spatial variable associated with this axis and is usually one of
(X, Y, Z). Example usage:>>> import tecplot as tp >>> fr = tp.active_frame() >>> ds = fr.dataset >>> axes = fr.plot().axes >>> axes.x_axis.variable.name, axes.y_axis.variable.name ('X', 'Y') >>> axes.x_axis.variable = ds.variable('U') >>> axes.y_axis.variable = ds.variable('V') >>> axes.x_axis.variable.name, axes.y_axis.variable.name ('U', 'V')
-
Cartesian3DFieldAxis.variable_index¶ Index of the
Variableassigned to this axis.Type: Index(zero-based)Example usage, interchanging the (x, y) axes:
>>> v0 = plot.axes.x_axis.variable_index >>> v1 = plot.axes.y_axis.variable_index >>> plot.axes.x_axis.variable_index = v1 >>> plot.axes.y_axis.variable_index = v0
Line Axes¶
XYLineAxes¶
-
class
tecplot.plot.XYLineAxes(plot)[source]¶ (X, Y) axes style control for line plots.
The
axesproperty of aXYLinePlotallows access to the severalxandyaxes by index. Linemaps can use any of the five such axes. In this example, we create two sets of data with different scales and the second y-axis is used on the right side of the plot:import numpy as np import tecplot as tp from tecplot.constant import PlotType, Color frame = tp.active_frame() npoints = 100 x = np.linspace(-10,10,npoints) t = x**2 p = 0.1 * np.sin(x) dataset = frame.create_dataset('data', ['Position (m)', 'Temperature (K)', 'Pressure (Pa)']) zone = dataset.add_ordered_zone('zone', (100,)) zone.values('Position (m)')[:] = x zone.values('Temperature (K)')[:] = t zone.values('Pressure (Pa)')[:] = p plot = frame.plot(PlotType.XYLine) plot.activate() plot.delete_linemaps() temp = plot.add_linemap('temp', zone, dataset.variable('Position (m)'), dataset.variable('Temperature (K)')) press = plot.add_linemap('press', zone, dataset.variable('Position (m)'), dataset.variable('Pressure (Pa)')) # Color the line and the y-axis for temperature temp.line.color = Color.RedOrange temp.line.line_thickness = 0.8 ax = plot.axes.y_axis(0) ax.line.color = temp.line.color ax.tick_labels.color = temp.line.color ax.title.color = temp.line.color # set pressure linemap to second x-axis press.y_axis_index = 1 # Color the line and the y-axis for pressure press.line.color = Color.Chartreuse press.line.line_thickness = 0.8 ax = plot.axes.y_axis(1) ax.line.color = press.line.color ax.tick_labels.color = press.line.color ax.title.color = press.line.color tp.export.save_png('axes_line.png', 600, supersample=3)
Attributes
auto_adjust_rangesAutomatically adjust axis ranges to nice values. axis_modeControls automatic adjustment of axis ranges. grid_areaArea bounded by the axes. precise_gridPrecise dot grid. preserve_scalePreserve scale (spacing between ticks) on range change. viewportArea of the frame used by the plot axes. xy_ratioX – Y axis scaling ratio. Methods
x_axis(index)X-axis style control. y_axis(index)Y-axis style control.
-
XYLineAxes.auto_adjust_ranges¶ Automatically adjust axis ranges to nice values.
Type: booleanAxes limits will be adjusted to have the smallest number of significant digits possible:
>>> plot.axes.auto_adjust_ranges = False
-
XYLineAxes.axis_mode¶ Controls automatic adjustment of axis ranges.
Type: AxisModePossible values:
Independent,XYDependent.If set to
XYDependent, then setting the range of one axis automatically scales the other indicated axes proportionally to maintain the aspect ratio of the plot, effectively zooming in or out. If set toIndependent, adjusting the range of one axis has no effect on other axes. Defaults toIndependentfor XY line plots,XYDependentfor 2D Cartesian plots. Example usage:>>> from tecplot.constant import AxisMode >>> plot.axes.axis_mode = AxisMode.Independent
-
XYLineAxes.grid_area¶ Area bounded by the axes.
Type: GridAreaThis controls the background color and border of the axes:
>>> from tecplot.constant import Color >>> plot.axes.grid_area.fill_color = Color.LightGreen
-
XYLineAxes.precise_grid¶ Precise dot grid.
Type: PreciseGridThis is a set of small dots drawn at the intersection of every minor gridline. In line plots, the axis assignments for the first active mapping govern the precise dot grid. The precise dot grid option is disabled for the 3D Cartesian plots and Line plots when either axis for the first active line mapping uses a log scale:
>>> plot.axes.precise_grid.show = True
-
XYLineAxes.preserve_scale¶ Preserve scale (spacing between ticks) on range change.
Type: booleanThis maintains the axis scaling, i.e. the distance between values along the axis. If
False, the axes length will be preserved when the range changes:>>> plot.axes.preserve_scale = False >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.max = 10 # axis scale is changed (length is preserved)
-
XYLineAxes.viewport¶ Area of the frame used by the plot axes.
Type: Cartesian2DViewportExample usage:
>>> plot.axes.viewport.left = 5 >>> plot.axes.viewport.right = 95 >>> plot.axes.viewport.top = 95 >>> plot.axes.viewport.bottom = 5
-
XYLineAxes.x_axis(index)[source]¶ X-axis style control.
Type: XYLineAxisThere are five x-axes for each
XYLinePlot, indexed from 0 to 4 inclusive:>>> plot.axes.x_axis(0).show = True
-
XYLineAxes.xy_ratio¶ X – Y axis scaling ratio.
Type: floatin percentThis requires the axes to be in dependent mode:
>>> from tecplot.constant import AxisMode >>> plot.axes.axis_mode = AxisMode.XYDependent >>> plot.axes.xy_ratio = 2
-
XYLineAxes.y_axis(index)[source]¶ Y-axis style control.
Type: XYLineAxisThere are five y-axes for each
XYLinePlot, indexed from 0 to 4 inclusive:>>> plot.axes.y_axis(0).show = True
XYLineAxis¶
-
class
tecplot.plot.XYLineAxis(axes, name, index)[source]¶ X or Y axis for line plots.
from os import path import tecplot as tp from tecplot.constant import PlotType examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'Rainfall.dat') dataset = tp.data.load_tecplot(infile) plot = tp.active_frame().plot(PlotType.XYLine) plot.activate() for i in range(2): lmap = plot.linemap(i) lmap.show = True lmap.line.line_thickness = 0.6 lmap.y_axis_index = i yax = plot.axes.y_axis(i) yax.line.color = lmap.line.color yax.title.color = lmap.line.color yax.tick_labels.color = lmap.line.color yax.line.line_thickness = 0.6 if i == 0: yax.grid_lines.show = True yax.grid_lines.color = lmap.line.color elif i == 1: yax.minor_grid_lines.show = True yax.minor_grid_lines.color = lmap.line.color tp.export.save_png('axis_line.png', 600, supersample=3)
Attributes
grid_linesMajor grid lines style control. lineAxis line style control. log_scaleUse logarithmic scale for this axis. marker_grid_lineMarker line to indicate a particular position along an axis. maxUpper bound of this axis’ range. minLower bound of this axis’ range. minor_grid_linesMinor grid lines style control. reverseReverse the direction of the axis scale. showEnable drawing of this axis. tick_labelsAxis ticks labels style control. ticksAxis major and minor ticks style control. titleAxis title. Methods
adjust_range_to_nice()Rounds the axis range to the nearest major axis increment. fit_range()Set range of axis to variable minimum and maximum. fit_range_to_nice()Set range of axis to nice values near variable minimum and maximum.
-
XYLineAxis.adjust_range_to_nice()¶ Rounds the axis range to the nearest major axis increment.
This method resets the axis-line label values such that all currently displayed label values are set to have the smallest number of significant digits possible.
Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.adjust_range_to_nice()
-
XYLineAxis.fit_range()¶ Set range of axis to variable minimum and maximum.
Note
If the axis dependency is not
Independent, then this action may also affect the range on another axis.Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.fit_range()
-
XYLineAxis.fit_range_to_nice()¶ Set range of axis to nice values near variable minimum and maximum.
This method resets the range to equal the minimum and maximum of the data being plotted, but makes the axis values “nice” by setting labels to have the smallest number of significant digits possible,
Note
If the axis dependency is not independent then this method may also affect the range on another axis.
Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.fit_range_to_nice()
-
XYLineAxis.grid_lines¶ Major grid lines style control.
Type: GridLines2DMajor grid lines are attached to the locations of the major ticks. See
minor_grid_linesfor lines attached to minor ticks. Example usage:>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.grid_lines.show = True
-
XYLineAxis.line¶ Axis line style control.
Type: Cartesian2DAxisLineExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.line_thickness = 0.6
-
XYLineAxis.log_scale¶ Use logarithmic scale for this axis.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> # or "plot.axes.r_axis" for the radial axis in polar plots >>> axis.log_scale = True
-
XYLineAxis.marker_grid_line¶ Marker line to indicate a particular position along an axis.
Type: MarkerGridLine2DExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.marker_grid_line.show = True >>> axis.marker_grid_line.position = 0.5
-
XYLineAxis.max¶ Upper bound of this axis’ range.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.max = 1.0
-
XYLineAxis.min¶ Lower bound of this axis’ range.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.min = 0.0
-
XYLineAxis.minor_grid_lines¶ Minor grid lines style control.
Type: MinorGridLines2DMinor grid lines are attached to the locations of the minor ticks. Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.minor_grid_lines.show = True
-
XYLineAxis.reverse¶ Reverse the direction of the axis scale.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.reverse = True
-
XYLineAxis.show¶ Enable drawing of this axis.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.show = True
-
XYLineAxis.tick_labels¶ Axis ticks labels style control.
Type: TickLabels2DExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.tick_labels.show = False
PolarLineAxes¶
-
class
tecplot.plot.PolarLineAxes(plot)[source]¶ (R, Theta) axes style control for polar plots.
Example usage:
import numpy as np import tecplot as tp from tecplot.constant import PlotType, ThetaMode frame = tp.active_frame() npoints = 300 r = np.linspace(0, 2000, npoints) theta = np.linspace(0, 10, npoints) dataset = frame.create_dataset('Data', ['R', 'Theta']) zone = dataset.add_ordered_zone('Zone', (300,)) zone.values('R')[:] = r zone.values('Theta')[:] = theta plot = frame.plot(PlotType.PolarLine) plot.activate() plot.axes.r_axis.max = np.max(r) plot.axes.theta_axis.mode = ThetaMode.Radians plot.delete_linemaps() lmap = plot.add_linemap('Linemap', zone, dataset.variable('R'), dataset.variable('Theta')) lmap.line.line_thickness = 0.8 plot.view.fit() tp.export.save_png('axes_polar.png', 600, supersample=3)
Attributes
grid_areaArea bounded by the axes. precise_gridPrecise dot grid. preserve_scalePreserve scale (spacing between ticks) on range change. r_axisRadial axis style control. theta_axisPolar-angle axis style control. viewportArea of the frame used by the plot axes outside the grid area.
-
PolarLineAxes.grid_area¶ Area bounded by the axes.
Type: GridAreaThis controls the background color and border of the axes:
>>> from tecplot.constant import Color >>> plot.axes.grid_area.fill_color = Color.LightGreen
-
PolarLineAxes.precise_grid¶ Precise dot grid.
Type: PreciseGridThis is a set of small dots drawn at the intersection of every minor gridline. In line plots, the axis assignments for the first active mapping govern the precise dot grid. The precise dot grid option is disabled for the 3D Cartesian plots and Line plots when either axis for the first active line mapping uses a log scale:
>>> plot.axes.precise_grid.show = True
-
PolarLineAxes.preserve_scale¶ Preserve scale (spacing between ticks) on range change.
Type: booleanThis maintains the axis scaling, i.e. the distance between values along the axis. If
False, the axes length will be preserved when the range changes:>>> plot.axes.preserve_scale = False >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.max = 10 # axis scale is changed (length is preserved)
-
PolarLineAxes.r_axis¶ Radial axis style control.
Type: RadialLineAxisExample usage:
>>> plot.axes.r_axis.title.text = 'R (meters)'
-
PolarLineAxes.theta_axis¶ Polar-angle axis style control.
Type: PolarAngleLineAxisExample usage:
>>> plot.axes.theta_axis.title.text = 'Theta (radians)'
-
PolarLineAxes.viewport¶ Area of the frame used by the plot axes outside the grid area.
Type: PolarViewportExample usage:
>>> from tecplot.constant import Color >>> plot.axes.viewport.fill_color = Color.LightGreen
RadialLineAxis¶
-
class
tecplot.plot.RadialLineAxis(axes)[source]¶ The R axis for polar plots
See the example shown for the
theta axis.Attributes
clip_dataDo not show data outside the axes area. grid_linesMajor grid lines style control. lineRadial axis line style control. log_scaleUse logarithmic scale for this axis. marker_grid_lineMarker line to indicate a particular position along an axis. maxUpper bound of this axis’ range. minLower bound of this axis’ range. minor_grid_linesMinor grid lines style control. originValue at the origin of the axis. reverseReverse the direction of the axis scale. showEnable drawing of this axis. tick_labelsAxis ticks labels style control. ticksAxis major and minor ticks style control. titleAxis title. Methods
adjust_range_to_nice()Rounds the axis range to the nearest major axis increment. fit_range()Set range of axis to variable minimum and maximum. fit_range_to_nice()Set range of axis to nice values near variable minimum and maximum. reset_to_entire_circle()Set the range of Theta to encompass an entire circle.
-
RadialLineAxis.adjust_range_to_nice()¶ Rounds the axis range to the nearest major axis increment.
This method resets the axis-line label values such that all currently displayed label values are set to have the smallest number of significant digits possible.
Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.adjust_range_to_nice()
-
RadialLineAxis.clip_data¶ Do not show data outside the axes area.
Type: booleanExample usage:
>>> plot.axes.clip_data = True
-
RadialLineAxis.fit_range()¶ Set range of axis to variable minimum and maximum.
Note
If the axis dependency is not
Independent, then this action may also affect the range on another axis.Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.fit_range()
-
RadialLineAxis.fit_range_to_nice()¶ Set range of axis to nice values near variable minimum and maximum.
This method resets the range to equal the minimum and maximum of the data being plotted, but makes the axis values “nice” by setting labels to have the smallest number of significant digits possible,
Note
If the axis dependency is not independent then this method may also affect the range on another axis.
Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.fit_range_to_nice()
-
RadialLineAxis.grid_lines¶ Major grid lines style control.
Type: GridLines2DMajor grid lines are attached to the locations of the major ticks. See
minor_grid_linesfor lines attached to minor ticks. Example usage:>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.grid_lines.show = True
-
RadialLineAxis.line¶ Radial axis line style control.
Type: RadialAxisLine2DExample usage:
>>> plot.axes.r_axis.line.line_thickness = 0.6
-
RadialLineAxis.log_scale¶ Use logarithmic scale for this axis.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> # or "plot.axes.r_axis" for the radial axis in polar plots >>> axis.log_scale = True
-
RadialLineAxis.marker_grid_line¶ Marker line to indicate a particular position along an axis.
Type: MarkerGridLine2DExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.marker_grid_line.show = True >>> axis.marker_grid_line.position = 0.5
-
RadialLineAxis.max¶ Upper bound of this axis’ range.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.max = 1.0
-
RadialLineAxis.min¶ Lower bound of this axis’ range.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.min = 0.0
-
RadialLineAxis.minor_grid_lines¶ Minor grid lines style control.
Type: MinorGridLines2DMinor grid lines are attached to the locations of the minor ticks. Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.minor_grid_lines.show = True
-
RadialLineAxis.origin¶ Value at the origin of the axis.
Type: floatExample usage:
# value at center of plot equal to 10 >>> plot.axes.r_axis.origin = 10 # rotate theta axis 45 degrees clockwise >>> plot.axes.theta_axis.origin = 45
-
RadialLineAxis.reset_to_entire_circle()¶ Set the range of Theta to encompass an entire circle.
Example usage:
>>> plot.axes.r_axis.reset_to_entire_circle()
Raises: TecplotSystemError– Internal error.
-
RadialLineAxis.reverse¶ Reverse the direction of the axis scale.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.reverse = True
-
RadialLineAxis.show¶ Enable drawing of this axis.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.show = True
-
RadialLineAxis.tick_labels¶ Axis ticks labels style control.
Type: RadialTickLabelsExample usage:
>>> plot.axes.r_axis.tick_labels.show = False
-
RadialLineAxis.ticks¶ Axis major and minor ticks style control.
Type: RadialTicksExample usage:
>>> plot.axes.r_axis.ticks.line_thickness = 0.8
PolarAngleLineAxis¶
-
class
tecplot.plot.PolarAngleLineAxis(axes)[source]¶ Theta axis for polar plots.
This example manipulates both the theta and radial axes to produce a star plot. Custom labels are created for each data point:
import numpy as np import tecplot as tp from tecplot.constant import PlotType, ThetaMode, NumberFormat, AxisAlignment np.random.seed(2) npoints = 7 theta = np.linspace(0, npoints, npoints+1) frame = tp.active_frame() dataset = frame.create_dataset('Data', ['Magnitude', 'Property']) for i in range(3): r = list(np.random.uniform(0.01, 0.99, npoints)) r.append(r[0]) zone = dataset.add_ordered_zone('Zone {}'.format(i), (npoints+1,)) zone.values('Magnitude')[:] = r zone.values('Property')[:] = theta plot = frame.plot(PlotType.PolarLine) plot.activate() plot.delete_linemaps() for i, zone in enumerate(dataset.zones()): lmap = plot.add_linemap('Linemap {}'.format(i), zone, dataset.variable('Magnitude'), dataset.variable('Property')) lmap.line.line_thickness = 0.8 r_axis = plot.axes.r_axis r_axis.max = 1 r_axis.line.show = False r_axis.title.position = 85 r_axis.line.alignment = AxisAlignment.WithOpposingAxisValue r_axis.line.opposing_axis_value = 1 theta_axis = plot.axes.theta_axis theta_axis.origin = 1 theta_axis.mode = ThetaMode.Arbitrary theta_axis.min = 0 theta_axis.max = theta.max() theta_axis.period = npoints theta_axis.ticks.auto_spacing = False theta_axis.ticks.spacing = 1 theta_axis.ticks.minor_num_ticks = 0 theta_axis.title.show = False theta_labels = theta_axis.tick_labels.format theta_labels.format_type = NumberFormat.CustomLabel theta_labels.add_custom_labels('A', 'B', 'C', 'D', 'E', 'F', 'G') theta_labels.custom_labels_index = 0 plot.view.fit() tp.export.save_png('star_plot.png', 600, supersample=3)
Attributes
clip_dataDo not show data outside the axes area. grid_linesTheta angle major grid lines. lineAxis line style control. marker_grid_lineTheta angle marker grid line. maxUpper bound of this axis’ range. minLower bound of this axis’ range. minor_grid_linesTheta angle minor grid lines. modeUnits or scale used for the theta axis. originValue at the origin of the axis. periodNumber of (min, max) cycles to include in 360 degrees. reverseReverse the direction of the axis scale. showEnable drawing of this axis. tick_labelsAxis ticks labels style control. ticksAxis major and minor ticks style control. titleAxis title. Methods
adjust_range_to_nice()Rounds the axis range to the nearest major axis increment. fit_range()Set range of axis to variable minimum and maximum. fit_range_to_nice()Set range of axis to nice values near variable minimum and maximum. reset_to_entire_circle()Set the range of Theta to encompass an entire circle. set_range_to_entire_circle()Set theta range to entire circle.
-
PolarAngleLineAxis.adjust_range_to_nice()¶ Rounds the axis range to the nearest major axis increment.
This method resets the axis-line label values such that all currently displayed label values are set to have the smallest number of significant digits possible.
Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.adjust_range_to_nice()
-
PolarAngleLineAxis.clip_data¶ Do not show data outside the axes area.
Type: booleanExample usage:
>>> plot.axes.clip_data = True
-
PolarAngleLineAxis.fit_range()¶ Set range of axis to variable minimum and maximum.
Note
If the axis dependency is not
Independent, then this action may also affect the range on another axis.Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.fit_range()
-
PolarAngleLineAxis.fit_range_to_nice()¶ Set range of axis to nice values near variable minimum and maximum.
This method resets the range to equal the minimum and maximum of the data being plotted, but makes the axis values “nice” by setting labels to have the smallest number of significant digits possible,
Note
If the axis dependency is not independent then this method may also affect the range on another axis.
Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.fit_range_to_nice()
-
PolarAngleLineAxis.grid_lines¶ Theta angle major grid lines.
Type: PolarAngleGridLinesExample usage:
>>> plot.axes.theta_axis.grid_lines.show = True
-
PolarAngleLineAxis.line¶ Axis line style control.
Type: AxisLine2DExample usage:
>>> plot.axes.r_axis.line.line_thickness = 0.6 >>> plot.axes.theta_axis.line.line_thickness = 0.6
-
PolarAngleLineAxis.marker_grid_line¶ Theta angle marker grid line.
Type: PolarAngleMarkerGridLineExample usage:
>>> plot.axes.theta_axis.marker_grid_line.show = True
-
PolarAngleLineAxis.max¶ Upper bound of this axis’ range.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.max = 1.0
-
PolarAngleLineAxis.min¶ Lower bound of this axis’ range.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.min = 0.0
-
PolarAngleLineAxis.minor_grid_lines¶ Theta angle minor grid lines.
Type: PolarAngleMinorGridLinesExample usage:
>>> plot.axes.theta_axis.minor_grid_lines.show = True
-
PolarAngleLineAxis.mode¶ Units or scale used for the theta axis.
Type: ThetaModePossible values:
ThetaMode.Degrees,ThetaMode.Radians,ThetaMode.Arbitrary.Example usage:
>>> from tecplot.constant import ThetaMode >>> plot.axes.theta_axis.mode = ThetaMode.Radians
-
PolarAngleLineAxis.origin¶ Value at the origin of the axis.
Type: floatExample usage:
# value at center of plot equal to 10 >>> plot.axes.r_axis.origin = 10 # rotate theta axis 45 degrees clockwise >>> plot.axes.theta_axis.origin = 45
-
PolarAngleLineAxis.period¶ Number of (min, max) cycles to include in 360 degrees.
Type: floatExample usage:
>>> plot.axes.theta_axis.period = 2
-
PolarAngleLineAxis.reset_to_entire_circle()¶ Set the range of Theta to encompass an entire circle.
Example usage:
>>> plot.axes.r_axis.reset_to_entire_circle()
Raises: TecplotSystemError– Internal error.
-
PolarAngleLineAxis.reverse¶ Reverse the direction of the axis scale.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.reverse = True
-
PolarAngleLineAxis.set_range_to_entire_circle()[source]¶ Set theta range to entire circle.
Example usage:
>>> plot.axes.theta_axis.set_range_to_entire_circle()
-
PolarAngleLineAxis.show¶ Enable drawing of this axis.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.show = True
-
PolarAngleLineAxis.tick_labels¶ Axis ticks labels style control.
Type: TickLabels2DExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.tick_labels.show = False
Sketch Axes¶
SketchAxes¶
-
class
tecplot.plot.SketchAxes(plot)[source]¶ (X, Y) axes style control for sketch plots.
Sketch plots have cartesian x and y axes which can be adjusted using the viewport:
import tecplot as tp from tecplot.constant import PlotType frame = tp.active_frame() plot = frame.plot(PlotType.Sketch) plot.axes.x_axis.show = True plot.axes.y_axis.show = True plot.axes.viewport.left = 10 plot.axes.viewport.right = 90 plot.axes.viewport.bottom = 10 plot.axes.viewport.top = 90 tp.export.save_png('axes_sketch.png', 600, supersample=3)
Attributes
auto_adjust_rangesAutomatically adjust axis ranges to nice values. axis_modeControls automatic adjustment of axis ranges. grid_areaArea bounded by the axes. precise_gridPrecise dot grid. preserve_scalePreserve scale (spacing between ticks) on range change. viewportArea of the frame used by the plot axes. x_axisX-axis style control. xy_ratioX – Y axis scaling ratio. y_axisY-axis style control.
-
SketchAxes.auto_adjust_ranges¶ Automatically adjust axis ranges to nice values.
Type: booleanAxes limits will be adjusted to have the smallest number of significant digits possible:
>>> plot.axes.auto_adjust_ranges = False
-
SketchAxes.axis_mode¶ Controls automatic adjustment of axis ranges.
Type: AxisModePossible values:
Independent,XYDependent.If set to
XYDependent, then setting the range of one axis automatically scales the other indicated axes proportionally to maintain the aspect ratio of the plot, effectively zooming in or out. If set toIndependent, adjusting the range of one axis has no effect on other axes. Defaults toIndependentfor XY line plots,XYDependentfor 2D Cartesian plots. Example usage:>>> from tecplot.constant import AxisMode >>> plot.axes.axis_mode = AxisMode.Independent
-
SketchAxes.grid_area¶ Area bounded by the axes.
Type: GridAreaThis controls the background color and border of the axes:
>>> from tecplot.constant import Color >>> plot.axes.grid_area.fill_color = Color.LightGreen
-
SketchAxes.precise_grid¶ Precise dot grid.
Type: PreciseGridThis is a set of small dots drawn at the intersection of every minor gridline. In line plots, the axis assignments for the first active mapping govern the precise dot grid. The precise dot grid option is disabled for the 3D Cartesian plots and Line plots when either axis for the first active line mapping uses a log scale:
>>> plot.axes.precise_grid.show = True
-
SketchAxes.preserve_scale¶ Preserve scale (spacing between ticks) on range change.
Type: booleanThis maintains the axis scaling, i.e. the distance between values along the axis. If
False, the axes length will be preserved when the range changes:>>> plot.axes.preserve_scale = False >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.max = 10 # axis scale is changed (length is preserved)
-
SketchAxes.viewport¶ Area of the frame used by the plot axes.
Type: Cartesian2DViewportExample usage:
>>> plot.axes.viewport.left = 5 >>> plot.axes.viewport.right = 95 >>> plot.axes.viewport.top = 95 >>> plot.axes.viewport.bottom = 5
-
SketchAxes.x_axis¶ X-axis style control.
Type: SketchAxisExample usage:
>>> plot.axes.x_axis.show = True
-
SketchAxes.xy_ratio¶ X – Y axis scaling ratio.
Type: floatin percentThis requires the axes to be in dependent mode:
>>> from tecplot.constant import AxisMode >>> plot.axes.axis_mode = AxisMode.XYDependent >>> plot.axes.xy_ratio = 2
-
SketchAxes.y_axis¶ Y-axis style control.
Type: SketchAxisExample usage:
>>> plot.axes.y_axis.show = True
SketchAxis¶
-
class
tecplot.plot.SketchAxis(axes, name, **kwargs)[source]¶ X or Y axis for sketch plots.
import tecplot as tp from tecplot.constant import PlotType plot = tp.active_frame().plot(PlotType.Sketch) viewport = plot.axes.viewport viewport.left = 10 viewport.right = 90 viewport.bottom = 10 xaxis = plot.axes.x_axis xaxis.show = True xaxis.min = 0 xaxis.max = 360 xaxis.title.text = 'Angle (Degrees)' xaxis.ticks.auto_spacing = False xaxis.ticks.spacing = 60 tp.export.save_png('axis_sketch.png', 600, supersample=3)
Attributes
grid_linesMajor grid lines style control. lineAxis line style control. log_scaleUse logarithmic scale for this axis. marker_grid_lineMarker line to indicate a particular position along an axis. maxUpper bound of this axis’ range. minLower bound of this axis’ range. minor_grid_linesMinor grid lines style control. showEnable drawing of this axis. tick_labelsAxis ticks labels style control. ticksAxis major and minor ticks style control. titleAxis title. Methods
adjust_range_to_nice()Rounds the axis range to the nearest major axis increment. fit_range()Set range of axis to variable minimum and maximum. fit_range_to_nice()Set range of axis to nice values near variable minimum and maximum.
-
SketchAxis.adjust_range_to_nice()¶ Rounds the axis range to the nearest major axis increment.
This method resets the axis-line label values such that all currently displayed label values are set to have the smallest number of significant digits possible.
Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.adjust_range_to_nice()
-
SketchAxis.fit_range()¶ Set range of axis to variable minimum and maximum.
Note
If the axis dependency is not
Independent, then this action may also affect the range on another axis.Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.fit_range()
-
SketchAxis.fit_range_to_nice()¶ Set range of axis to nice values near variable minimum and maximum.
This method resets the range to equal the minimum and maximum of the data being plotted, but makes the axis values “nice” by setting labels to have the smallest number of significant digits possible,
Note
If the axis dependency is not independent then this method may also affect the range on another axis.
Raises: TecplotSystemError– Internal error.Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.fit_range_to_nice()
-
SketchAxis.grid_lines¶ Major grid lines style control.
Type: GridLines2DMajor grid lines are attached to the locations of the major ticks. See
minor_grid_linesfor lines attached to minor ticks. Example usage:>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.grid_lines.show = True
-
SketchAxis.line¶ Axis line style control.
Type: Cartesian2DAxisLineExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.line_thickness = 0.6
-
SketchAxis.log_scale¶ Use logarithmic scale for this axis.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> # or "plot.axes.r_axis" for the radial axis in polar plots >>> axis.log_scale = True
-
SketchAxis.marker_grid_line¶ Marker line to indicate a particular position along an axis.
Type: MarkerGridLine2DExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.marker_grid_line.show = True >>> axis.marker_grid_line.position = 0.5
-
SketchAxis.max¶ Upper bound of this axis’ range.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.max = 1.0
-
SketchAxis.min¶ Lower bound of this axis’ range.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.min = 0.0
-
SketchAxis.minor_grid_lines¶ Minor grid lines style control.
Type: MinorGridLines2DMinor grid lines are attached to the locations of the minor ticks. Example usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.minor_grid_lines.show = True
-
SketchAxis.show¶ Enable drawing of this axis.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.show = True
-
SketchAxis.tick_labels¶ Axis ticks labels style control.
Type: TickLabels2DExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.tick_labels.show = False
Axis Elements¶
Axis Line¶
AxisLine2D¶
-
class
tecplot.plot.AxisLine2D(axis)[source]¶ Graduated axis line for 2D plots.
Cartesian (x, y) plots use an extension of this class (
Cartesian2DAxisLine). Polar plots use this class directly.from os import path import tecplot as tp from tecplot.tecutil import sv from tecplot.constant import PlotType, Color, AxisAlignment examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'CircularContour.plt') dataset = tp.data.load_tecplot(infile) plot = tp.active_frame().plot(PlotType.Cartesian2D) plot.activate() plot.show_contour = True plot.contour(0).colormap_name = 'Sequential - Yellow/Green/Blue' plot.axes.preserve_scale = True plot.axes.x_axis.fit_range() for ax in plot.axes: line = ax.line line.color = Color.DeepRed line.alignment = AxisAlignment.WithOpposingAxisValue line.opposing_axis_value = 0 ax.title.position = 85 fr = tp.active_page().add_frame() polar_plot = fr.plot(PlotType.PolarLine) polar_plot.activate() fr.transparent = True polar_plot.delete_linemaps() polar_plot.axes.r_axis.show = False polar_plot.axes.r_axis.min = 0.83 t_line = polar_plot.axes.theta_axis.line t_line.line_thickness = 0.6 # these values obtained using 360 EX & Save stylesheet polar_plot.view.magnification = .232 polar_plot.view.extents = (-2.30, -2.14, 2.57, 2.17) tp.export.save_png('axis_line_2d.png', 600, supersample=3)
Attributes
alignmentAxis line placement. colorColor of the axis line. line_thicknessWidth of the axis line to be drawn. offsetAxis line placement with respect to the grid border. opposing_axis_valueAxis line placement with respect to the opposing axis. showDraw the primary axis line on the plot.
-
AxisLine2D.alignment¶ Axis line placement.
Type: AxisAlignmentPossible values:
WithViewport,WithOpposingAxisValue,WithGridMin,WithGridMax,WithGridAreaTop,WithGridAreaBottom,WithGridAreaLeftorWithGridAreaRight.Not all values will be available for every plot type. Example usage:
>>> from tecplot.constant import AxisAlignment >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.alignment = AxisAlignment.WithGridMin
-
AxisLine2D.color¶ Color of the axis line.
Type: ColorExample usage:
>>> from tecplot.constant import Color >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.color = Color.Blue
-
AxisLine2D.line_thickness¶ Width of the axis line to be drawn.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.line_thickness = 0.5
-
AxisLine2D.offset¶ Axis line placement with respect to the grid border.
Type: float(percent of frame height)This is the offset from the grid border-aligned position dictated by properties such as
AxisLine2D.alignment. The example moves the axis line into the plot by 5% of the frame height:>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.offset = -5
-
AxisLine2D.opposing_axis_value¶ Axis line placement with respect to the opposing axis.
Type: floatThe axis alignment must be set to
AxisAlignment.WithOpposingAxisValueto make this property relevant:>>> from tecplot.constant import AxisAlignment >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.alignment = AxisAlignment.WithOpposingAxisValue >>> axis.line.opposing_axis_value = 0.5
Cartesian2DAxisLine¶
-
class
tecplot.plot.Cartesian2DAxisLine(axis)[source]¶ Axis line for 2D field plots.
from os import path import tecplot as tp from tecplot.tecutil import sv from tecplot.constant import PlotType, Color, AxisAlignment examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'CircularContour.plt') dataset = tp.data.load_tecplot(infile) plot = tp.active_frame().plot(PlotType.Cartesian2D) plot.activate() plot.show_contour = True plot.contour(0).colormap_name = 'Sequential - Yellow/Green/Blue' plot.axes.preserve_scale = True plot.axes.x_axis.fit_range() for ax in plot.axes: line = ax.line line.color = Color.DeepRed line.alignment = AxisAlignment.WithOpposingAxisValue line.opposing_axis_value = 0 ax.title.position = 85 tp.export.save_png('axis_line_cartesian2d.png', 600, supersample=3)
Attributes
alignmentAxis line placement. colorColor of the axis line. line_thicknessWidth of the axis line to be drawn. offsetAxis line placement with respect to the grid border. opposing_axis_valueAxis line placement with respect to the opposing axis. positionAxis line placement with respect to the viewport. showDraw the primary axis line on the plot.
-
Cartesian2DAxisLine.alignment¶ Axis line placement.
Type: AxisAlignmentPossible values:
WithViewport,WithOpposingAxisValue,WithGridMin,WithGridMax,WithGridAreaTop,WithGridAreaBottom,WithGridAreaLeftorWithGridAreaRight.Not all values will be available for every plot type. Example usage:
>>> from tecplot.constant import AxisAlignment >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.alignment = AxisAlignment.WithGridMin
-
Cartesian2DAxisLine.color¶ Color of the axis line.
Type: ColorExample usage:
>>> from tecplot.constant import Color >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.color = Color.Blue
-
Cartesian2DAxisLine.line_thickness¶ Width of the axis line to be drawn.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.line_thickness = 0.5
-
Cartesian2DAxisLine.offset¶ Axis line placement with respect to the grid border.
Type: float(percent of frame height)This is the offset from the grid border-aligned position dictated by properties such as
AxisLine2D.alignment. The example moves the axis line into the plot by 5% of the frame height:>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.offset = -5
-
Cartesian2DAxisLine.opposing_axis_value¶ Axis line placement with respect to the opposing axis.
Type: floatThe axis alignment must be set to
AxisAlignment.WithOpposingAxisValueto make this property relevant:>>> from tecplot.constant import AxisAlignment >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.alignment = AxisAlignment.WithOpposingAxisValue >>> axis.line.opposing_axis_value = 0.5
-
Cartesian2DAxisLine.position¶ Axis line placement with respect to the viewport.
Type: floatThe axis alignment must be set to
AxisAlignment.WithViewportto make this property relevant:>>> from tecplot.constant import AxisAlignment >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.alignment = AxisAlignment.WithViewport >>> axis.line.position = 0.5
AxisLine3D¶
-
class
tecplot.plot.AxisLine3D(axis)[source]¶ X, Y or Z axis for 3D field plots.
This represents the line along which ticks and labels are drawn. The color affects the line itself and the associated tick marks but not labels or axis titles:
from os import path import tecplot as tp from tecplot.constant import PlotType, Color examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'Sphere.lpk') dataset = tp.load_layout(infile) frame = tp.active_frame() plot = frame.plot() plot.show_mesh = False plot.axes.grid_area.fill_color = Color.Grey for ax in [plot.axes.x_axis, plot.axes.y_axis, plot.axes.z_axis]: ax.show = True ax.grid_lines.show = False ax.line.color = Color.Cyan ax.line.line_thickness = 0.2 ax.line.show_on_opposite_edge = True plot.view.fit() tp.export.save_png('axis_line_3d.png', 600, supersample=3)
Attributes
colorColor of the axis line. edge_assignmentEdge to use when drawing the primary axis line. line_thicknessWidth of the axis line to be drawn. showDraw the primary axis line on the plot. show_on_opposite_edgeDraw axis line on opposite edge of axes box.
-
AxisLine3D.color¶ Color of the axis line.
Type: ColorExample usage:
>>> from tecplot.constant import Color >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.color = Color.Blue
-
AxisLine3D.edge_assignment¶ Edge to use when drawing the primary axis line.
Type: AxisLine3DAssignmentorNonePossible values:
AxisLine3DAssignment.Automatic(aliased toNone),YMinZMin,YMaxZMin,YMinZMax,YMaxZMax.Example usage:
>>> from tecplot.constant import AxisLine3DAssignment >>> axis.line.edge_assignment = AxisLine3DAssignment.YMinZMin
-
AxisLine3D.line_thickness¶ Width of the axis line to be drawn.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.line_thickness = 0.5
RadialAxisLine2D¶
-
class
tecplot.plot.RadialAxisLine2D(axis)[source]¶ Radial axis line for polar plots.
import numpy as np import tecplot as tp from tecplot.constant import PlotType, Color npoints = 300 r = np.linspace(0, 2000, npoints) theta = np.linspace(0, 700, npoints) frame = tp.active_frame() dataset = frame.create_dataset('Data', ['R', 'Theta']) zone = dataset.add_ordered_zone('Zone', (300,)) zone.values('R')[:] = r zone.values('Theta')[:] = theta plot = frame.plot(PlotType.PolarLine) plot.activate() plot.axes.r_axis.max = np.max(r) plot.delete_linemaps() lmap = plot.add_linemap('Linemap', zone, dataset.variable('R'), dataset.variable('Theta')) lmap.line.line_thickness = 0.8 raxis = plot.axes.r_axis raxis.line.show_both_directions = True raxis.line.show_perpendicular = True plot.view.fit() tp.export.save_png('axis_line_radial.png', 600, supersample=3)
Attributes
alignmentAxis line placement. angleSpecific angle to place the radial axis line. colorColor of the axis line. line_thicknessWidth of the axis line to be drawn. offsetAxis line placement with respect to the grid border. opposing_axis_valueAxis line placement with respect to the opposing axis. showDraw the primary axis line on the plot. show_both_directionsMirror the radial axis 180 degrees from the primary line. show_perpendicularMirror the radial axis 90 degrees from the primary line.
-
RadialAxisLine2D.alignment¶ Axis line placement.
Type: AxisAlignmentPossible values:
WithOpposingAxisValue,WithGridMin,WithGridMax,WithSpecificAngle,WithGridAreaTop,WithGridAreaBottom,WithGridAreaLeftorWithGridAreaRight.Not all values will be available for every plot type. Example usage:
>>> from tecplot.constant import AxisAlignment >>> plot.r_axis.line.alignment = AxisAlignment.WithOpposingAxisValue >>> plot.r_axis.line.opposing_axis_value = 45
-
RadialAxisLine2D.angle¶ Specific angle to place the radial axis line.
Type: floatThe alignment must be set to
AxisAlignment.WithSpecificAngle:>>> from tecplot.constant import AxisAlignment >>> plot.r_axis.line.alignment = AxisAlignment.WithSpecificAngle >>> plot.r_axis.line.angle = 45
-
RadialAxisLine2D.color¶ Color of the axis line.
Type: ColorExample usage:
>>> from tecplot.constant import Color >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.color = Color.Blue
-
RadialAxisLine2D.line_thickness¶ Width of the axis line to be drawn.
Type: floatExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.line_thickness = 0.5
-
RadialAxisLine2D.offset¶ Axis line placement with respect to the grid border.
Type: float(percent of frame height)This is the offset from the grid border-aligned position dictated by properties such as
AxisLine2D.alignment. The example moves the axis line into the plot by 5% of the frame height:>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.offset = -5
-
RadialAxisLine2D.opposing_axis_value¶ Axis line placement with respect to the opposing axis.
Type: floatThe axis alignment must be set to
AxisAlignment.WithOpposingAxisValueto make this property relevant:>>> from tecplot.constant import AxisAlignment >>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.alignment = AxisAlignment.WithOpposingAxisValue >>> axis.line.opposing_axis_value = 0.5
-
RadialAxisLine2D.show¶ Draw the primary axis line on the plot.
Type: booleanExample usage:
>>> # get axis via "plot.axes.x_axis(0)" for line plots >>> # or "plot.axes.x_axis" for field or sketch plots >>> axis.line.show = False
-
RadialAxisLine2D.show_both_directions¶ Mirror the radial axis 180 degrees from the primary line.
Type: booleanIf
RadialAxisLine2D.show_perpendicularisTrue, this will mirror that axis line as well resulting in four axis lines, 90 degrees apart. Example usage:>>> r_axis.line.show_both_directions = True
Ticks and Labels¶
Ticks2D¶
-
class
tecplot.plot.Ticks2D(axis)[source]¶ Tick marks (major and minor) along axes in 2D.
import tecplot as tp from os import path from tecplot.constant import PlotType, AxisMode, AxisAlignment, TickDirection examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'CircularContour.plt') dataset = tp.data.load_tecplot(infile) frame = tp.active_frame() plot = frame.plot(PlotType.Cartesian2D) plot.show_contour = True plot.contour(0).colormap_name = 'Sequential - Yellow/Green/Blue' plot.axes.x_axis.line.show = False yaxis = plot.axes.y_axis yaxis.max = 0.15 yaxis.line.show = False yaxis.line.alignment = AxisAlignment.WithOpposingAxisValue yaxis.line.opposing_axis_value = 0 yaxis.tick_labels.transparent_background = True yaxis.tick_labels.offset = -5 yticks = yaxis.ticks yticks.direction = TickDirection.Centered for ticks in [plot.axes.x_axis.ticks, yticks]: ticks.auto_spacing = False ticks.spacing = 0.5 ticks.minor_num_ticks = 3 ticks.length *= 3 ticks.line_thickness *= 2 plot.view.fit() tp.export.save_png('ticks_2d.png', 600, supersample=3)
Attributes
auto_spacingAutomatically set the spacing between tick marks. directionHow to draw the ticks with respect the axis line. lengthSize of the major tick lines to draw. line_thicknessWidth of the major tick lines to be drawn. minor_lengthSize of the minor tick lines to draw. minor_line_thicknessWidth of the minor tick lines to be drawn. minor_num_ticksNumber of minor ticks between each major tick. showDraw ticks along axis. show_on_border_maxDraw ticks along the upper border of the axes grid. show_on_border_minDraw ticks along the lower border of the axes grid. spacingDistance between major ticks. spacing_anchorValue to place the first major tick mark.
-
Ticks2D.auto_spacing¶ Automatically set the spacing between tick marks.
Type: booleanExample usage:
>>> axis.ticks.auto_spacing = True
-
Ticks2D.direction¶ How to draw the ticks with respect the axis line.
Type: TickDirectionPossible values:
TickDirection.In,TickDirection.OutorTickDirection.Centered:>>> from tecplot.constant import TickDirection >>> axis.ticks.direction = TickDirection.Centered
-
Ticks2D.length¶ Size of the major tick lines to draw.
Type: float(percent of frame height)Example usage:
>>> axis.ticks.length = 2
-
Ticks2D.line_thickness¶ Width of the major tick lines to be drawn.
Type: floatExample usage:
>>> axis.ticks.line_thickness = 0.4
-
Ticks2D.minor_length¶ Size of the minor tick lines to draw.
Type: float(percent of frame height)Example usage:
>>> axis.ticks.minor_length = 1.2
-
Ticks2D.minor_line_thickness¶ Width of the minor tick lines to be drawn.
Type: floatExample usage:
>>> axis.ticks.minor_line_thickness = 0.1
-
Ticks2D.minor_num_ticks¶ Number of minor ticks between each major tick.
Type: intExample usage:
>>> axis.ticks.minor_num_ticks = 3
-
Ticks2D.show_on_border_max¶ Draw ticks along the upper border of the axes grid.
Type: booleanExample usage:
>>> axis.ticks.show_on_border_max = True
-
Ticks2D.show_on_border_min¶ Draw ticks along the lower border of the axes grid.
Type: booleanExample usage:
>>> axis.ticks.show_on_border_min = True
Ticks3D¶
-
class
tecplot.plot.Ticks3D(axis)[source]¶ Tick marks (major and minor) along axes in 3D.
from os import path import tecplot as tp from tecplot.constant import PlotType, TickDirection examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'F18.plt') dataset = tp.data.load_tecplot(infile) frame = tp.active_frame() plot = frame.plot(PlotType.Cartesian3D) plot.activate() plot.show_contour = True plot.contour(0).legend.show = False plot.axes.grid_area.filled = False for axis in plot.axes: axis.show = True axis.grid_lines.show = False axis.ticks.length *= 4 axis.ticks.minor_length *= 4 plot.view.fit() tp.export.save_png('ticks_3d.png', 600, supersample=3)
Attributes
auto_spacingAutomatically set the spacing between tick marks. directionHow to draw the ticks with respect the axis line. lengthSize of the major tick lines to draw. line_thicknessWidth of the major tick lines to be drawn. minor_lengthSize of the minor tick lines to draw. minor_line_thicknessWidth of the minor tick lines to be drawn. minor_num_ticksNumber of minor ticks between each major tick. showDraw ticks along axis. show_on_opposite_edgeDraw ticks along the opposite border of the axes grid. spacingDistance between major ticks. spacing_anchorValue to place the first major tick mark.
-
Ticks3D.auto_spacing¶ Automatically set the spacing between tick marks.
Type: booleanExample usage:
>>> axis.ticks.auto_spacing = True
-
Ticks3D.direction¶ How to draw the ticks with respect the axis line.
Type: TickDirectionPossible values:
TickDirection.In,TickDirection.OutorTickDirection.Centered:>>> from tecplot.constant import TickDirection >>> axis.ticks.direction = TickDirection.Centered
-
Ticks3D.length¶ Size of the major tick lines to draw.
Type: float(percent of frame height)Example usage:
>>> axis.ticks.length = 2
-
Ticks3D.line_thickness¶ Width of the major tick lines to be drawn.
Type: floatExample usage:
>>> axis.ticks.line_thickness = 0.4
-
Ticks3D.minor_length¶ Size of the minor tick lines to draw.
Type: float(percent of frame height)Example usage:
>>> axis.ticks.minor_length = 1.2
-
Ticks3D.minor_line_thickness¶ Width of the minor tick lines to be drawn.
Type: floatExample usage:
>>> axis.ticks.minor_line_thickness = 0.1
-
Ticks3D.minor_num_ticks¶ Number of minor ticks between each major tick.
Type: intExample usage:
>>> axis.ticks.minor_num_ticks = 3
-
Ticks3D.show_on_opposite_edge¶ Draw ticks along the opposite border of the axes grid.
Type: booleanExample usage:
>>> axis.ticks.show_on_opposite_edge = True
RadialTicks¶
-
class
tecplot.plot.RadialTicks(axis)[source]¶ Tick marks (major and minor) along the radial axis.
from os import path import tecplot as tp from tecplot.constant import PlotType, ThetaMode, Color, TickDirection examples_dir = tp.session.tecplot_examples_directory() datafile = path.join(examples_dir, 'SimpleData', 'IndependentDependent.lpk') dataset = tp.load_layout(datafile) plot = tp.active_frame().plot(PlotType.PolarLine) plot.activate() plot.axes.theta_axis.mode = ThetaMode.Radians raxis = plot.axes.r_axis raxis.line.color = Color.Red raxis.tick_labels.offset = -4 raxis.ticks.direction =TickDirection.Centered raxis.ticks.line_thickness = 0.8 raxis.ticks.length = 4 raxis.ticks.minor_length = 4 tp.export.save_png('ticks_radial.png', 600, supersample=3)
Attributes
auto_spacingAutomatically set the spacing between tick marks. directionHow to draw the ticks with respect the axis line. lengthSize of the major tick lines to draw. line_thicknessWidth of the major tick lines to be drawn. minor_lengthSize of the minor tick lines to draw. minor_line_thicknessWidth of the minor tick lines to be drawn. minor_num_ticksNumber of minor ticks between each major tick. showDraw ticks along axis. show_on_all_radial_axesDraw ticks along all radial axis lines. show_on_border_maxDraw ticks along the upper border of the axes grid. show_on_border_minDraw ticks along the lower border of the axes grid. spacingDistance between major ticks. spacing_anchorValue to place the first major tick mark.
-
RadialTicks.auto_spacing¶ Automatically set the spacing between tick marks.
Type: booleanExample usage:
>>> axis.ticks.auto_spacing = True
-
RadialTicks.direction¶ How to draw the ticks with respect the axis line.
Type: TickDirectionPossible values:
TickDirection.In,TickDirection.OutorTickDirection.Centered:>>> from tecplot.constant import TickDirection >>> axis.ticks.direction = TickDirection.Centered
-
RadialTicks.length¶ Size of the major tick lines to draw.
Type: float(percent of frame height)Example usage:
>>> axis.ticks.length = 2
-
RadialTicks.line_thickness¶ Width of the major tick lines to be drawn.
Type: floatExample usage:
>>> axis.ticks.line_thickness = 0.4
-
RadialTicks.minor_length¶ Size of the minor tick lines to draw.
Type: float(percent of frame height)Example usage:
>>> axis.ticks.minor_length = 1.2
-
RadialTicks.minor_line_thickness¶ Width of the minor tick lines to be drawn.
Type: floatExample usage:
>>> axis.ticks.minor_line_thickness = 0.1
-
RadialTicks.minor_num_ticks¶ Number of minor ticks between each major tick.
Type: intExample usage:
>>> axis.ticks.minor_num_ticks = 3
-
RadialTicks.show_on_all_radial_axes¶ Draw ticks along all radial axis lines.
Type: booleanExample usage:
>>> plot.axes.r_axis.line.show_perpendicular = True >>> plot.axes.r_axis.ticks.show_on_all_radial_axes = True
-
RadialTicks.show_on_border_max¶ Draw ticks along the upper border of the axes grid.
Type: booleanExample usage:
>>> axis.ticks.show_on_border_max = True
-
RadialTicks.show_on_border_min¶ Draw ticks along the lower border of the axes grid.
Type: booleanExample usage:
>>> axis.ticks.show_on_border_min = True
TickLabels2D¶
-
class
tecplot.plot.TickLabels2D(axis)[source]¶ Tick labels along axes in 2D.
from datetime import datetime import tecplot as tp from tecplot.constant import (PlotType, AxisMode, AxisAlignment, NumberFormat, Color) # tecplot dates are in days after Midnight, Dec 30, 1899 origin = datetime(1899, 12, 30) start = (datetime(1955, 11, 5) - origin).days stop = (datetime(1985, 10, 26) - origin).days tp.new_layout() plot = tp.active_frame().plot(tp.constant.PlotType.Sketch) plot.activate() plot.axes.viewport.left = 15 plot.axes.viewport.right = 95 xaxis = plot.axes.x_axis xaxis.show = True xaxis.min, xaxis.max = start, stop xaxis.line.alignment = AxisAlignment.WithViewport xaxis.line.position = 50 xaxis.ticks.auto_spacing = False xaxis.ticks.spacing = (stop - start) // 4 xaxis.ticks.spacing_anchor = start xaxis.tick_labels.format.format_type = NumberFormat.TimeDate xaxis.tick_labels.format.datetime_format = 'mmm d, yyyy' xaxis.tick_labels.color = Color.Blue xaxis.tick_labels.angle = 45 tp.export.save_png('tick_labels_2d.png', 600, supersample=3)
Attributes
alignmentAngle at which to render the label text. angleAngle at which to render the label text. colorColor of the tick labels. fontText style control including typeface and size. formatLabel format and style control. offsetRelative offset of the tick labels. showDraw labels for the major tick marks. show_at_axis_intersectionInclude the labels at the intersection of other axes. show_on_border_maxDraw labels along the upper grid area border. show_on_border_minDraw labels along the lower grid area border. stepStep for labels placed on major ticks. transparent_backgroundMake the text box around each label transparent.
-
TickLabels2D.alignment¶ Angle at which to render the label text.
Type: float(degrees) orLabelAlignmentPossible values:
LabelAlignment.ByAngle,LabelAlignment.AlongAxisorLabelAlignment.PerpendicularToAxis.Example usage:
>>> from tecplot.constant import LabelAlignment >>> axis.tick_labels.alignment = LabelAlignment.AlongAxis
-
TickLabels2D.angle¶ Angle at which to render the label text.
Type: float(degrees)The
alignmentattribute must be set toLabelAlignment.ByAngle:>>> from tecplot.constant import LabelAlignment >>> axis.tick_labels.alignment = LabelAlignment.ByAngle >>> axis.tick_labels.angle = 30
-
TickLabels2D.color¶ Color of the tick labels.
Type: ColorExample usage:
>>> from tecplot.constant import Color >>> axis.tick_labels.color = Color.Blue
-
TickLabels2D.font¶ Text style control including typeface and size.
Type: text.FontExample usage:
>>> axis.tick_labels.font.typeface = 'Times'
-
TickLabels2D.format¶ Label format and style control.
Type: LabelFormatExample usage:
>>> axis.tick_labels.format.format_type = NumberFormat.BestFloat
-
TickLabels2D.offset¶ Relative offset of the tick labels.
Type: floatPositive values will be outside the grid area, negative values are inside the grid area:
>>> axis.tick_labels.offset = 5
-
TickLabels2D.show¶ Draw labels for the major tick marks.
Type: booleanExample usage:
>>> axis.tick_labels.show = True
-
TickLabels2D.show_at_axis_intersection¶ Include the labels at the intersection of other axes.
Type: boolExample usage:
>>> axis.tick_labels.show_at_axis_intersection = True
-
TickLabels2D.show_on_border_max¶ Draw labels along the upper grid area border.
Type: boolExample usage:
>>> axis.tick_labels.show_on_border_max = True
-
TickLabels2D.show_on_border_min¶ Draw labels along the lower grid area border.
Type: boolExample usage:
>>> axis.tick_labels.show_on_border_min = True
TickLabels3D¶
-
class
tecplot.plot.TickLabels3D(axis)[source]¶ Tick labels along axes in 3D.
from os import path import tecplot as tp from tecplot.constant import PlotType, Color examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'F18.plt') dataset = tp.data.load_tecplot(infile) frame = tp.active_frame() plot = frame.plot(PlotType.Cartesian3D) plot.activate() plot.show_contour = True plot.contour(0).legend.show = False for ax in [plot.axes.x_axis, plot.axes.y_axis]: xaxis = plot.axes.x_axis ax.show = True ax.title.show = False ax.line.show_on_opposite_edge = True ax.ticks.show_on_opposite_edge = True ax.tick_labels.color = Color.Blue ax.tick_labels.show_on_opposite_edge = True ax.tick_labels.font.typeface = 'Times' ax.tick_labels.font.size = 8 ax.tick_labels.font.italic = True plot.view.fit() tp.export.save_png('tick_labels_3d.png', 600, supersample=3)
Attributes
alignmentAngle at which to render the label text. angleAngle at which to render the label text. colorColor of the tick labels. fontText style control including typeface and size. formatLabel format and style control. offsetRelative offset of the tick labels. showDraw labels for the major tick marks. show_on_opposite_edgeDraw labels on the opposite edge of the grid. stepStep for labels placed on major ticks.
-
TickLabels3D.alignment¶ Angle at which to render the label text.
Type: float(degrees) orLabelAlignmentPossible values:
LabelAlignment.ByAngle,LabelAlignment.AlongAxisorLabelAlignment.PerpendicularToAxis.Example usage:
>>> from tecplot.constant import LabelAlignment >>> axis.tick_labels.alignment = LabelAlignment.AlongAxis
-
TickLabels3D.angle¶ Angle at which to render the label text.
Type: float(degrees)The
alignmentattribute must be set toLabelAlignment.ByAngle:>>> from tecplot.constant import LabelAlignment >>> axis.tick_labels.alignment = LabelAlignment.ByAngle >>> axis.tick_labels.angle = 30
-
TickLabels3D.color¶ Color of the tick labels.
Type: ColorExample usage:
>>> from tecplot.constant import Color >>> axis.tick_labels.color = Color.Blue
-
TickLabels3D.font¶ Text style control including typeface and size.
Type: text.FontExample usage:
>>> axis.tick_labels.font.typeface = 'Times'
-
TickLabels3D.format¶ Label format and style control.
Type: LabelFormatExample usage:
>>> axis.tick_labels.format.format_type = NumberFormat.BestFloat
-
TickLabels3D.offset¶ Relative offset of the tick labels.
Type: floatPositive values will be outside the grid area, negative values are inside the grid area:
>>> axis.tick_labels.offset = 5
-
TickLabels3D.show¶ Draw labels for the major tick marks.
Type: booleanExample usage:
>>> axis.tick_labels.show = True
RadialTickLabels¶
-
class
tecplot.plot.RadialTickLabels(axis)[source]¶ Tick mark labels along the radial axis.
from os import path import tecplot as tp from tecplot.constant import PlotType, ThetaMode, Color examples_dir = tp.session.tecplot_examples_directory() datafile = path.join(examples_dir, 'SimpleData', 'IndependentDependent.lpk') dataset = tp.load_layout(datafile) plot = tp.active_frame().plot(PlotType.PolarLine) plot.activate() plot.axes.theta_axis.mode = ThetaMode.Radians raxis = plot.axes.r_axis raxis.line.color = Color.Red raxis.tick_labels.offset = -4 raxis.tick_labels.color = Color.Red raxis.tick_labels.font.bold = True tp.export.save_png('tick_labels_radial.png', 600, supersample=3)
Attributes
alignmentAngle at which to render the label text. angleAngle at which to render the label text. colorColor of the tick labels. fontText style control including typeface and size. formatLabel format and style control. offsetRelative offset of the tick labels. showDraw labels for the major tick marks. show_at_axis_intersectionInclude the labels at the intersection of other axes. show_on_all_radial_axesDraw labels along all radial axis lines. show_on_border_maxDraw labels along the upper grid area border. show_on_border_minDraw labels along the lower grid area border. stepStep for labels placed on major ticks. transparent_backgroundMake the text box around each label transparent.
-
RadialTickLabels.alignment¶ Angle at which to render the label text.
Type: float(degrees) orLabelAlignmentPossible values:
LabelAlignment.ByAngle,LabelAlignment.AlongAxisorLabelAlignment.PerpendicularToAxis.Example usage:
>>> from tecplot.constant import LabelAlignment >>> axis.tick_labels.alignment = LabelAlignment.AlongAxis
-
RadialTickLabels.angle¶ Angle at which to render the label text.
Type: float(degrees)The
alignmentattribute must be set toLabelAlignment.ByAngle:>>> from tecplot.constant import LabelAlignment >>> axis.tick_labels.alignment = LabelAlignment.ByAngle >>> axis.tick_labels.angle = 30
-
RadialTickLabels.color¶ Color of the tick labels.
Type: ColorExample usage:
>>> from tecplot.constant import Color >>> axis.tick_labels.color = Color.Blue
-
RadialTickLabels.font¶ Text style control including typeface and size.
Type: text.FontExample usage:
>>> axis.tick_labels.font.typeface = 'Times'
-
RadialTickLabels.format¶ Label format and style control.
Type: LabelFormatExample usage:
>>> axis.tick_labels.format.format_type = NumberFormat.BestFloat
-
RadialTickLabels.offset¶ Relative offset of the tick labels.
Type: floatPositive values will be outside the grid area, negative values are inside the grid area:
>>> axis.tick_labels.offset = 5
-
RadialTickLabels.show¶ Draw labels for the major tick marks.
Type: booleanExample usage:
>>> axis.tick_labels.show = True
-
RadialTickLabels.show_at_axis_intersection¶ Include the labels at the intersection of other axes.
Type: boolExample usage:
>>> axis.tick_labels.show_at_axis_intersection = True
-
RadialTickLabels.show_on_all_radial_axes¶ Draw labels along all radial axis lines.
Type: booleanExample usage:
>>> plot.axes.r_axis.line.show_perpendicular = True >>> plot.axes.r_axis.tick_labels.show_on_all_radial_axes = True
-
RadialTickLabels.show_on_border_max¶ Draw labels along the upper grid area border.
Type: boolExample usage:
>>> axis.tick_labels.show_on_border_max = True
-
RadialTickLabels.show_on_border_min¶ Draw labels along the lower grid area border.
Type: boolExample usage:
>>> axis.tick_labels.show_on_border_min = True
Axis Title¶
Axis2DTitle¶
-
class
tecplot.plot.Axis2DTitle(axis)[source]¶ Sketch plot axis label string, font and style control.
import tecplot as tp from tecplot.constant import PlotType, Color plot = tp.active_frame().plot(PlotType.Sketch) viewport = plot.axes.viewport viewport.left = 10 viewport.right = 90 viewport.bottom = 10 xaxis = plot.axes.x_axis xaxis.show = True xaxis.title.text = 'distance (m)' xaxis.title.color = Color.DarkTurquoise xaxis.title.offset = -7 tp.export.save_png('axis_title_sketch.png', 600, supersample=3)
Attributes
colorText color of axis title. fontTypeface and size of the text. offsetTransverse offset of the title from the axis. positionPercent along axis line to place title. showPlace title along the axis. show_on_border_maxDraw title along the upper grid area border. show_on_border_minDraw title along the lower grid area border. textThe text of the title for this axis.
-
Axis2DTitle.color¶ Text color of axis title.
Type: ColorExample usage:
>>> from tecplot.constant import Color >>> axis.title.color = Color.Blue
-
Axis2DTitle.font¶ Typeface and size of the text.
Type: text.FontExample usage:
>>> axis.title.font.size = 5
-
Axis2DTitle.offset¶ Transverse offset of the title from the axis.
Type: floatin percent of frame height.Positive values are outside the axes, negative numbers are inside the axes. Example usage:
>>> axis.title.offset = 5
-
Axis2DTitle.position¶ Percent along axis line to place title.
Type: floatExample usage:
>>> axis.title.position = 50
-
Axis2DTitle.show¶ Place title along the axis.
Type: booleanExample usage:
>>> axis.title.show = False
-
Axis2DTitle.show_on_border_max¶ Draw title along the upper grid area border.
Type: boolExample usage:
>>> axis.title.show_on_border_max = True
DataAxis2DTitle¶
-
class
tecplot.plot.DataAxis2DTitle(axis)[source]¶ Axis label string, font and style control for 2D data plots.
from os import path import tecplot as tp from tecplot.constant import PlotType, SurfacesToPlot, Color, AxisTitleMode examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'F18.plt') dataset = tp.data.load_tecplot(infile) plot = tp.active_frame().plot(PlotType.Cartesian2D) plot.activate() plot.show_contour = True plot.contour(0).variable = dataset.variable('S') plot.contour(0).colormap_name = 'Sequential - Yellow/Green/Blue' plot.contour(0).legend.show = False plot.fieldmap(0).surfaces.surfaces_to_plot = SurfacesToPlot.BoundaryFaces xaxis = plot.axes.x_axis xaxis.title.title_mode = AxisTitleMode.UseText xaxis.title.text = 'Longitudinal (m)' xaxis.title.color = Color.Blue # place the x-axis title at the x-coordinate 10.0 xaxis.title.position = 100 * (10.0 - xaxis.min) / (xaxis.max - xaxis.min) yaxis = plot.axes.y_axis yaxis.title.title_mode = AxisTitleMode.UseText yaxis.title.text = 'Transverse (m)' yaxis.title.color = Color.Blue # place the y-axis title at the y-coordinate 0.0 yaxis.title.position = 100 * (0.0 - yaxis.min) / (yaxis.max - yaxis.min) tp.export.save_png('axis_title_2d.png', 600, supersample=3)
Attributes
colorText color of axis title. fontTypeface and size of the text. offsetTransverse offset of the title from the axis. positionPercent along axis line to place title. showPlace title along the axis. show_on_border_maxDraw title along the upper grid area border. show_on_border_minDraw title along the lower grid area border. textThe text of the title for this axis. title_modeDefine the source for the axis title.
-
DataAxis2DTitle.color¶ Text color of axis title.
Type: ColorExample usage:
>>> from tecplot.constant import Color >>> axis.title.color = Color.Blue
-
DataAxis2DTitle.font¶ Typeface and size of the text.
Type: text.FontExample usage:
>>> axis.title.font.size = 5
-
DataAxis2DTitle.offset¶ Transverse offset of the title from the axis.
Type: floatin percent of frame height.Positive values are outside the axes, negative numbers are inside the axes. Example usage:
>>> axis.title.offset = 5
-
DataAxis2DTitle.position¶ Percent along axis line to place title.
Type: floatExample usage:
>>> axis.title.position = 50
-
DataAxis2DTitle.show¶ Place title along the axis.
Type: booleanExample usage:
>>> axis.title.show = False
-
DataAxis2DTitle.show_on_border_max¶ Draw title along the upper grid area border.
Type: boolExample usage:
>>> axis.title.show_on_border_max = True
-
DataAxis2DTitle.show_on_border_min¶ Draw title along the lower grid area border.
Type: boolExample usage:
>>> axis.title.show_on_border_min = True
-
DataAxis2DTitle.text¶ The text of the title for this axis.
Type: stringThe
title_modeattribute must be set toAxisTitleMode.UseText:>>> from tecplot.constant import AxisTitleMode >>> axis.title.title_mode = AxisTitleMode.UseText >>> axis.title.text = 'distance (m)'
-
DataAxis2DTitle.title_mode¶ Define the source for the axis title.
Type: AxisTitleModePossible values:
AxisTitleMode.UseTextorAxisTitleMode.UseVarName.Example usage:
>>> from tecplot.constant import AxisTitleMode >>> axis.title.title_mode = AxisTitleMode.UseVarName
DataAxis3DTitle¶
-
class
tecplot.plot.DataAxis3DTitle(axis)[source]¶ Axis label string, font and style control for 3D plots.
from os import path import tecplot as tp from tecplot.constant import PlotType, SurfacesToPlot, Color, AxisTitleMode examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'F18.plt') dataset = tp.data.load_tecplot(infile) plot = tp.active_frame().plot(PlotType.Cartesian3D) plot.activate() plot.show_contour = True plot.contour(0).variable = dataset.variable('S') plot.contour(0).colormap_name = 'Sequential - Yellow/Green/Blue' plot.contour(0).legend.show = False plot.fieldmap(0).surfaces.surfaces_to_plot = SurfacesToPlot.BoundaryFaces xaxis = plot.axes.x_axis xaxis.show = True xaxis.title.title_mode = AxisTitleMode.UseText xaxis.title.text = 'Longitudinal (m)' xaxis.title.color = Color.BluePurple xaxis.title.position = 10 yaxis = plot.axes.y_axis yaxis.show = True yaxis.title.title_mode = AxisTitleMode.UseText yaxis.title.text = 'Transverse (m)' yaxis.title.color = Color.BluePurple yaxis.title.position = 90 zaxis = plot.axes.z_axis zaxis.show = True zaxis.title.title_mode = AxisTitleMode.UseText zaxis.title.text = 'Height (m)' zaxis.title.color = Color.BluePurple zaxis.title.offset = 13 plot.view.fit() tp.export.save_png('axis_title_3d.png', 600, supersample=3)
Attributes
colorText color of axis title. fontTypeface and size of the text. offsetTransverse offset of the title from the axis. positionPercent along axis line to place title. showPlace title along the axis. show_on_opposite_edgeDraw the title on the opposite edge of the grid. textThe text of the title for this axis. title_modeDefine the source for the axis title.
-
DataAxis3DTitle.color¶ Text color of axis title.
Type: ColorExample usage:
>>> from tecplot.constant import Color >>> axis.title.color = Color.Blue
-
DataAxis3DTitle.font¶ Typeface and size of the text.
Type: text.FontExample usage:
>>> axis.title.font.size = 5
-
DataAxis3DTitle.offset¶ Transverse offset of the title from the axis.
Type: floatin percent of frame height.Positive values are outside the axes, negative numbers are inside the axes. Example usage:
>>> axis.title.offset = 5
-
DataAxis3DTitle.position¶ Percent along axis line to place title.
Type: floatExample usage:
>>> axis.title.position = 50
-
DataAxis3DTitle.show¶ Place title along the axis.
Type: booleanExample usage:
>>> axis.title.show = False
-
DataAxis3DTitle.show_on_opposite_edge¶ Draw the title on the opposite edge of the grid.
Type: booleanExample usage:
>>> axis.title.show_on_opposite_edge = True
-
DataAxis3DTitle.text¶ The text of the title for this axis.
Type: stringThe
title_modeattribute must be set toAxisTitleMode.UseText:>>> from tecplot.constant import AxisTitleMode >>> axis.title.title_mode = AxisTitleMode.UseText >>> axis.title.text = 'distance (m)'
-
DataAxis3DTitle.title_mode¶ Define the source for the axis title.
Type: AxisTitleModePossible values:
AxisTitleMode.UseTextorAxisTitleMode.UseVarName.Example usage:
>>> from tecplot.constant import AxisTitleMode >>> axis.title.title_mode = AxisTitleMode.UseVarName
RadialAxisTitle¶
-
class
tecplot.plot.RadialAxisTitle(axis)[source]¶ Radial axis label string, font and style control for polar plots.
import numpy as np import tecplot as tp from tecplot.constant import PlotType, Color, AxisTitleMode npoints = 300 r = np.linspace(0, 2000, npoints) theta = np.linspace(0, 1000, npoints) frame = tp.active_frame() dataset = frame.create_dataset('Data', ['R', 'Theta']) zone = dataset.add_ordered_zone('Zone', (300,)) zone.values('R')[:] = r zone.values('Theta')[:] = theta plot = frame.plot(PlotType.PolarLine) plot.activate() plot.axes.r_axis.max = np.max(r) plot.delete_linemaps() lmap = plot.add_linemap('Linemap', zone, dataset.variable('R'), dataset.variable('Theta')) lmap.line.line_thickness = 0.8 raxis = plot.axes.r_axis raxis.line.show_both_directions = True raxis.line.show_perpendicular = True raxis.title.title_mode = AxisTitleMode.UseText raxis.title.text = 'Radial Position (cm)' raxis.title.show_on_all_radial_axes = True raxis.title.color = Color.Blue raxis.title.position = 80 plot.view.fit() tp.export.save_png('axis_title_radial.png', 600, supersample=3)
Attributes
colorText color of axis title. fontTypeface and size of the text. offsetTransverse offset of the title from the axis. positionPercent along axis line to place title. showPlace title along the axis. show_on_all_radial_axesDraw title along all radial axis lines. show_on_border_maxDraw title along the upper grid area border. show_on_border_minDraw title along the lower grid area border. textThe text of the title for this axis. title_modeDefine the source for the axis title.
-
RadialAxisTitle.color¶ Text color of axis title.
Type: ColorExample usage:
>>> from tecplot.constant import Color >>> axis.title.color = Color.Blue
-
RadialAxisTitle.font¶ Typeface and size of the text.
Type: text.FontExample usage:
>>> axis.title.font.size = 5
-
RadialAxisTitle.offset¶ Transverse offset of the title from the axis.
Type: floatin percent of frame height.Positive values are outside the axes, negative numbers are inside the axes. Example usage:
>>> axis.title.offset = 5
-
RadialAxisTitle.position¶ Percent along axis line to place title.
Type: floatExample usage:
>>> axis.title.position = 50
-
RadialAxisTitle.show¶ Place title along the axis.
Type: booleanExample usage:
>>> axis.title.show = False
-
RadialAxisTitle.show_on_all_radial_axes¶ Draw title along all radial axis lines.
Type: booleanExample usage:
>>> plot.axes.r_axis.line.show_perpendicular = True >>> plot.axes.r_axis.title.show_on_all_radial_axes = True
-
RadialAxisTitle.show_on_border_max¶ Draw title along the upper grid area border.
Type: boolExample usage:
>>> axis.title.show_on_border_max = True
-
RadialAxisTitle.show_on_border_min¶ Draw title along the lower grid area border.
Type: boolExample usage:
>>> axis.title.show_on_border_min = True
-
RadialAxisTitle.text¶ The text of the title for this axis.
Type: stringThe
title_modeattribute must be set toAxisTitleMode.UseText:>>> from tecplot.constant import AxisTitleMode >>> axis.title.title_mode = AxisTitleMode.UseText >>> axis.title.text = 'distance (m)'
-
RadialAxisTitle.title_mode¶ Define the source for the axis title.
Type: AxisTitleModePossible values:
AxisTitleMode.UseTextorAxisTitleMode.UseVarName.Example usage:
>>> from tecplot.constant import AxisTitleMode >>> axis.title.title_mode = AxisTitleMode.UseVarName
Grid Area¶
GridArea¶
-
class
tecplot.plot.GridArea(axes)[source]¶ Grid area for polar 2D plots.
from os import path import tecplot as tp from tecplot.constant import PlotType, ThetaMode, Color examples_dir = tp.session.tecplot_examples_directory() datafile = path.join(examples_dir, 'SimpleData', 'IndependentDependent.lpk') dataset = tp.load_layout(datafile) plot = tp.active_frame().plot(PlotType.PolarLine) plot.activate() plot.axes.theta_axis.mode = ThetaMode.Radians plot.axes.grid_area.fill_color = Color.Creme grid_area = plot.axes.grid_area grid_area.filled = True grid_area.fill_color = Color.SkyBlue grid_area.show_border = True tp.export.save_png('grid_area_polar.png', 600, supersample=3)
Attributes
fill_colorAxes area background color. filledFill the axes area background color. show_borderDraw border around axes area.
-
GridArea.fill_color¶ Axes area background color.
Type: ColorThis requires the
filledattribute to beTrue:>>> from tecplot.constant import Color >>> plot.axes.grid_area.filled = True >>> plot.axes.grid_area.fill_color = Color.LightGreen
Cartesian2DGridArea¶
-
class
tecplot.plot.Cartesian2DGridArea(axes)[source]¶ Grid area for cartesian 2D plots.
from os import path import tecplot as tp from tecplot.constant import PlotType, Color examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'SunSpots.plt') dataset = tp.data.load_tecplot(infile) frame = tp.active_frame() plot = frame.plot(PlotType.XYLine) plot.linemap(0).line.color = Color.DarkBlue plot.linemap(0).line.line_thickness = 1.0 grid_area = plot.axes.grid_area grid_area.filled = True grid_area.fill_color = Color.SkyBlue grid_area.show_border = True tp.export.save_png('grid_area_2d.png', 600, supersample=3)
Attributes
border_colorBorder line color. border_thicknessWidth of the border lines to be drawn. fill_colorAxes area background color. filledFill the axes area background color. show_borderDraw border around axes area.
-
Cartesian2DGridArea.border_color¶ Border line color.
Type: ColorExample usage:
>>> from tecplot.constant import Color >>> plot.axes.grid_area.show_border = True >>> plot.axes.grid_area.border_color = Color.LightGreen
-
Cartesian2DGridArea.border_thickness¶ Width of the border lines to be drawn.
Type: floatExample usage:
>>> plot.axes.grid_area.border_thickness = 0.5
-
Cartesian2DGridArea.fill_color¶ Axes area background color.
Type: ColorThis requires the
filledattribute to beTrue:>>> from tecplot.constant import Color >>> plot.axes.grid_area.filled = True >>> plot.axes.grid_area.fill_color = Color.LightGreen
Cartesian3DGridArea¶
-
class
tecplot.plot.Cartesian3DGridArea(axes)[source]¶ Grid area for 3D field plots.
from os import path import tecplot as tp from tecplot.constant import PlotType, SurfacesToPlot, Color examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'Pyramid.plt') dataset = tp.data.load_tecplot(infile) frame = tp.active_frame() plot = frame.plot(PlotType.Cartesian3D) for fmap in plot.fieldmaps(): fmap.contour.show = True fmap.surfaces.surfaces_to_plot = SurfacesToPlot.BoundaryFaces plot.show_contour = True plot.contour(0).legend.show = False for axis in plot.axes: axis.show = True grid_area = plot.axes.grid_area grid_area.fill_color = Color.SkyBlue grid_area.show_border = True grid_area.use_lighting_effect = True plot.view.fit() tp.export.save_png('grid_area_3d.png', 600, supersample=3)
Attributes
fill_colorAxes area background color. filledFill the axes area background color. show_borderDraw border around axes area. use_lighting_effectEnable lighting effect shading on grid area.
-
Cartesian3DGridArea.fill_color¶ Axes area background color.
Type: ColorThis requires the
filledattribute to beTrue:>>> from tecplot.constant import Color >>> plot.axes.grid_area.filled = True >>> plot.axes.grid_area.fill_color = Color.LightGreen
-
Cartesian3DGridArea.filled¶ Fill the axes area background color.
Type: booleanExample usage:
>>> from tecplot.constant import Color >>> plot.axes.grid_area.filled = True >>> plot.axes.grid_area.fill_color = Color.LightGreen
PreciseGrid¶
-
class
tecplot.plot.PreciseGrid(axes)[source]¶ Grid of precise dots aligned with all tick marks.
from os import path import tecplot as tp from tecplot.constant import PlotType, LinePattern, Color examples_dir = tp.session.tecplot_examples_directory() datafile = path.join(examples_dir, 'SimpleData', 'RainierElevation.plt') dataset = tp.data.load_tecplot(datafile) plot = tp.active_frame().plot(PlotType.Cartesian2D) plot.activate() plot.show_contour = True plot.contour(0).colormap_name = 'Elevation - Above Ground Level' xaxis = plot.axes.x_axis plot.axes.preserve_scale = True xaxis.max = xaxis.variable.values(0).max() grid = plot.axes.precise_grid grid.show = True grid.size = 0.05 tp.export.save_png('precise_grid.png', 600, supersample=3)
Attributes
colorColor of the dots for precise grid. showDraw precise grid dots in axes area. sizeSize of the dots for precise grid.
-
PreciseGrid.color¶ Color of the dots for precise grid.
Type: ColorExample usage:
>>> plot.axes.precise_grid.color = Color.DarkBlue
GridLines¶
-
class
tecplot.plot.GridLines(axis)[source]¶ Major grid lines.
from os import path import tecplot as tp from tecplot.constant import LinePattern, Color examples_dir = tp.session.tecplot_examples_directory() datafile = path.join(examples_dir, 'SimpleData', 'Sphere.lpk') dataset = tp.load_layout(datafile) plot = tp.active_frame().plot() plot.axes.grid_area.fill_color = Color.Grey for axis in (plot.axes.x_axis, plot.axes.y_axis): axis.show = True grid_lines = axis.grid_lines grid_lines.show = True grid_lines.line_pattern = LinePattern.LongDash grid_lines.color = Color.Cyan plot.view.fit() tp.export.save_png('grid_lines.png', 600, supersample=3)
Attributes
colorColorof the grid lines to be drawn.line_patternPattern style of the grid lines to be drawn. line_thicknessWidth of the grid lines to be drawn. pattern_lengthSegment length of the repeated line pattern. showDraw grid lines as tick locations.
-
GridLines.color¶ Colorof the grid lines to be drawn.Type: ColorExample usage:
>>> from tecplot.constant import Color >>> grid_lines.color = Color.Blue
-
GridLines.line_pattern¶ Pattern style of the grid lines to be drawn.
Type: LinePatternPossible values:
Solid,Dashed,DashDot,Dotted,LongDash,DashDotDot.Example usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash
-
GridLines.line_thickness¶ Width of the grid lines to be drawn.
Type: floatExample usage:
>>> grid_lines.line_thickness = 0.5
GridLines2D¶
-
class
tecplot.plot.GridLines2D(axis)[source]¶ Major grid lines following the primary tick mark locations.
The lines drawn are determined by the placement of major tick marks along the axis.
from os import path import tecplot as tp from tecplot.constant import LinePattern, Color examples_dir = tp.session.tecplot_examples_directory() datafile = path.join(examples_dir, 'SimpleData', 'IndependentDependent.lpk') dataset = tp.load_layout(datafile) for axis in tp.active_frame().plot().axes: grid_lines = axis.grid_lines grid_lines.show = True grid_lines.line_pattern = LinePattern.LongDash grid_lines.color = Color.Green tp.export.save_png('grid_lines_2d.png', 600, supersample=3)
Attributes
colorColorof the grid lines to be drawn.draw_lastDraw grid behind all other plot elements. line_patternPattern style of the grid lines to be drawn. line_thicknessWidth of the grid lines to be drawn. pattern_lengthSegment length of the repeated line pattern. showDraw grid lines as tick locations.
-
GridLines2D.color¶ Colorof the grid lines to be drawn.Type: ColorExample usage:
>>> from tecplot.constant import Color >>> grid_lines.color = Color.Blue
-
GridLines2D.draw_last¶ Draw grid behind all other plot elements.
Type: booleanExample usage:
>>> axis.grid_lines.draw_last = True
-
GridLines2D.line_pattern¶ Pattern style of the grid lines to be drawn.
Type: LinePatternPossible values:
Solid,Dashed,DashDot,Dotted,LongDash,DashDotDot.Example usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash
-
GridLines2D.line_thickness¶ Width of the grid lines to be drawn.
Type: floatExample usage:
>>> grid_lines.line_thickness = 0.5
MinorGridLines¶
-
class
tecplot.plot.MinorGridLines(axis)[source]¶ Minor grid lines.
from os import path import tecplot as tp from tecplot.constant import LinePattern, Color examples_dir = tp.session.tecplot_examples_directory() datafile = path.join(examples_dir, 'SimpleData', 'Sphere.lpk') dataset = tp.load_layout(datafile) plot = tp.active_frame().plot() plot.axes.grid_area.fill_color = Color.Grey for axis in (plot.axes.x_axis, plot.axes.y_axis): axis.show = True grid_lines = axis.grid_lines grid_lines.show = True minor_grid_lines = axis.minor_grid_lines minor_grid_lines.show = True minor_grid_lines.line_pattern = LinePattern.Dotted minor_grid_lines.color = Color.Cyan plot.view.fit() tp.export.save_png('minor_grid_lines.png', 600, supersample=3)
Attributes
colorColorof the grid lines to be drawn.line_patternPattern style of the grid lines to be drawn. line_thicknessWidth of the grid lines to be drawn. pattern_lengthSegment length of the repeated line pattern. showDraw grid lines as tick locations.
-
MinorGridLines.color¶ Colorof the grid lines to be drawn.Type: ColorExample usage:
>>> from tecplot.constant import Color >>> grid_lines.color = Color.Blue
-
MinorGridLines.line_pattern¶ Pattern style of the grid lines to be drawn.
Type: LinePatternPossible values:
Solid,Dashed,DashDot,Dotted,LongDash,DashDotDot.Example usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash
-
MinorGridLines.line_thickness¶ Width of the grid lines to be drawn.
Type: floatExample usage:
>>> grid_lines.line_thickness = 0.5
MinorGridLines2D¶
-
class
tecplot.plot.MinorGridLines2D(axis)[source]¶ Minor grid lines following the secondary tick mark locations.
The lines drawn are determined by the placement of minor tick marks along the axis. Example usage:
from os import path import tecplot as tp from tecplot.constant import LinePattern, Color examples_dir = tp.session.tecplot_examples_directory() datafile = path.join(examples_dir, 'SimpleData', 'IndependentDependent.lpk') dataset = tp.load_layout(datafile) for axis in tp.active_frame().plot().axes: grid_lines = axis.grid_lines grid_lines.show = True minor_grid_lines = axis.minor_grid_lines minor_grid_lines.show = True minor_grid_lines.line_pattern = LinePattern.Dotted minor_grid_lines.color = Color.Green tp.export.save_png('minor_grid_lines_2d.png', 600, supersample=3)
Attributes
colorColorof the grid lines to be drawn.draw_lastDraw grid behind all other plot elements. line_patternPattern style of the grid lines to be drawn. line_thicknessWidth of the grid lines to be drawn. pattern_lengthSegment length of the repeated line pattern. showDraw grid lines as tick locations.
-
MinorGridLines2D.color¶ Colorof the grid lines to be drawn.Type: ColorExample usage:
>>> from tecplot.constant import Color >>> grid_lines.color = Color.Blue
-
MinorGridLines2D.draw_last¶ Draw grid behind all other plot elements.
Type: booleanExample usage:
>>> axis.grid_lines.draw_last = True
-
MinorGridLines2D.line_pattern¶ Pattern style of the grid lines to be drawn.
Type: LinePatternPossible values:
Solid,Dashed,DashDot,Dotted,LongDash,DashDotDot.Example usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash
-
MinorGridLines2D.line_thickness¶ Width of the grid lines to be drawn.
Type: floatExample usage:
>>> grid_lines.line_thickness = 0.5
PolarAngleGridLines¶
-
class
tecplot.plot.PolarAngleGridLines(axis)[source]¶ Major grid lines along the theta axis.
The lines drawn are determined by the placement of minor tick marks along the axis. Example usage:
from os import path import tecplot as tp from tecplot.constant import PlotType, ThetaMode, LinePattern, Color examples_dir = tp.session.tecplot_examples_directory() datafile = path.join(examples_dir, 'SimpleData', 'IndependentDependent.lpk') dataset = tp.load_layout(datafile) plot = tp.active_frame().plot(PlotType.PolarLine) plot.activate() plot.axes.theta_axis.mode = ThetaMode.Radians plot.axes.grid_area.filled = True plot.axes.grid_area.fill_color = Color.Creme for axis in plot.axes: grid_lines = axis.grid_lines grid_lines.show = True grid_lines.line_pattern = LinePattern.LongDash grid_lines.color = Color.Green for lmap in plot.linemaps(): lmap.show_in_legend = False lmap.line.line_pattern = LinePattern.Solid lmap.line.line_thickness = 0.8 tp.export.save_png('grid_lines_polar.png', 600, supersample=3)
Attributes
colorColorof the grid lines to be drawn.draw_lastDraw grid behind all other plot elements. line_patternPattern style of the grid lines to be drawn. line_thicknessWidth of the grid lines to be drawn. pattern_lengthSegment length of the repeated line pattern. radial_cutoffMinimum radial position of theta grid lines. showDraw grid lines as tick locations.
-
PolarAngleGridLines.color¶ Colorof the grid lines to be drawn.Type: ColorExample usage:
>>> from tecplot.constant import Color >>> grid_lines.color = Color.Blue
-
PolarAngleGridLines.draw_last¶ Draw grid behind all other plot elements.
Type: booleanExample usage:
>>> axis.grid_lines.draw_last = True
-
PolarAngleGridLines.line_pattern¶ Pattern style of the grid lines to be drawn.
Type: LinePatternPossible values:
Solid,Dashed,DashDot,Dotted,LongDash,DashDotDot.Example usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash
-
PolarAngleGridLines.line_thickness¶ Width of the grid lines to be drawn.
Type: floatExample usage:
>>> grid_lines.line_thickness = 0.5
-
PolarAngleGridLines.pattern_length¶ Segment length of the repeated line pattern.
Type: floatExample usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash >>> grid_lines.pattern_length = 3.5
PolarAngleMinorGridLines¶
-
class
tecplot.plot.PolarAngleMinorGridLines(axis)[source]¶ Minor grid lines along the theta axis.
The lines drawn are determined by the placement of minor tick marks along the axis. Example usage:
from os import path import tecplot as tp from tecplot.constant import PlotType, ThetaMode, LinePattern, Color examples_dir = tp.session.tecplot_examples_directory() datafile = path.join(examples_dir, 'SimpleData', 'IndependentDependent.lpk') dataset = tp.load_layout(datafile) plot = tp.active_frame().plot(PlotType.PolarLine) plot.activate() plot.axes.theta_axis.mode = ThetaMode.Radians plot.axes.grid_area.filled = True plot.axes.grid_area.fill_color = Color.Creme for axis in plot.axes: grid_lines = axis.grid_lines grid_lines.show = True minor_grid_lines = axis.minor_grid_lines minor_grid_lines.show = True minor_grid_lines.line_pattern = LinePattern.Dotted minor_grid_lines.color = Color.Green for lmap in plot.linemaps(): lmap.show_in_legend = False lmap.line.line_pattern = LinePattern.Solid lmap.line.line_thickness = 0.8 tp.export.save_png('minor_grid_lines_polar.png', 600, supersample=3)
Attributes
colorColorof the grid lines to be drawn.draw_lastDraw grid behind all other plot elements. line_patternPattern style of the grid lines to be drawn. line_thicknessWidth of the grid lines to be drawn. pattern_lengthSegment length of the repeated line pattern. radial_cutoffMinimum radial position of theta grid lines. showDraw grid lines as tick locations.
-
PolarAngleMinorGridLines.color¶ Colorof the grid lines to be drawn.Type: ColorExample usage:
>>> from tecplot.constant import Color >>> grid_lines.color = Color.Blue
-
PolarAngleMinorGridLines.draw_last¶ Draw grid behind all other plot elements.
Type: booleanExample usage:
>>> axis.grid_lines.draw_last = True
-
PolarAngleMinorGridLines.line_pattern¶ Pattern style of the grid lines to be drawn.
Type: LinePatternPossible values:
Solid,Dashed,DashDot,Dotted,LongDash,DashDotDot.Example usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash
-
PolarAngleMinorGridLines.line_thickness¶ Width of the grid lines to be drawn.
Type: floatExample usage:
>>> grid_lines.line_thickness = 0.5
-
PolarAngleMinorGridLines.pattern_length¶ Segment length of the repeated line pattern.
Type: floatExample usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash >>> grid_lines.pattern_length = 3.5
MarkerGridLine¶
-
class
tecplot.plot.MarkerGridLine(axis)[source]¶ Marker line to indicate a particular position along an axis.
from os import path import tecplot as tp from tecplot.constant import PlotType, Color, PositionMarkerBy examples_dir = tp.session.tecplot_examples_directory() datafile = path.join(examples_dir, 'SimpleData', 'Sphere.lpk') dataset = tp.load_layout(datafile) plot = tp.active_frame().plot(PlotType.Cartesian3D) plot.activate() plot.axes.grid_area.fill_color = Color.Grey plot.axes.x_axis.show = True plot.axes.y_axis.show = True marker = plot.axes.x_axis.marker_grid_line marker.show = True marker.position_by = PositionMarkerBy.Constant marker.position = 1.5 marker.color = Color.Cyan marker = plot.axes.y_axis.marker_grid_line marker.show = True marker.position_by = PositionMarkerBy.Constant marker.position = 0.5 marker.color = Color.Yellow plot.view.fit() tp.export.save_png('marker_grid_line.png', 600, supersample=3)
Attributes
colorColorof the grid lines to be drawn.line_patternPattern style of the grid lines to be drawn. line_thicknessWidth of the grid lines to be drawn. pattern_lengthSegment length of the repeated line pattern. positionPosition of the marker line in axes coordinates. position_byPosition of the marker line in axes coordinates. showDraw grid lines as tick locations.
-
MarkerGridLine.color¶ Colorof the grid lines to be drawn.Type: ColorExample usage:
>>> from tecplot.constant import Color >>> grid_lines.color = Color.Blue
-
MarkerGridLine.line_pattern¶ Pattern style of the grid lines to be drawn.
Type: LinePatternPossible values:
Solid,Dashed,DashDot,Dotted,LongDash,DashDotDot.Example usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash
-
MarkerGridLine.line_thickness¶ Width of the grid lines to be drawn.
Type: floatExample usage:
>>> grid_lines.line_thickness = 0.5
-
MarkerGridLine.pattern_length¶ Segment length of the repeated line pattern.
Type: floatExample usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash >>> grid_lines.pattern_length = 3.5
-
MarkerGridLine.position¶ Position of the marker line in axes coordinates.
Type: floatThe
position_byattribute must be set toPositionMarkerBy.Constant:>>> from tecplot.constant import PositionMarkerBy >>> marker_line = plot.axes.x_axis.marker_grid_line >>> marker_line.position_by = PositionMarkerBy.Constant >>> marker_line.position = 3.14
-
MarkerGridLine.position_by¶ Position of the marker line in axes coordinates.
Type: PositionMarkerBy- Possible values:
PositionMarkerBy.Constantor PositionMarkerBy.SolutionTime.
The position can be set to a constant or to the solution time of the linked frame:
>>> from tecplot.constant import PositionMarkerBy >>> marker_line = plot.axes.x_axis.marker_grid_line >>> marker_line.position_by = PositionMarkerBy.SolutionTime
- Possible values:
MarkerGridLine2D¶
-
class
tecplot.plot.MarkerGridLine2D(axis)[source]¶ Marker line to indicate a particular position along an axis.
from os import path import tecplot as tp from tecplot.constant import PlotType, Color, PositionMarkerBy examples_dir = tp.session.tecplot_examples_directory() datafile = path.join(examples_dir, 'SimpleData', 'IndependentDependent.lpk') dataset = tp.load_layout(datafile) plot = tp.active_frame().plot(PlotType.XYLine) plot.activate() marker = plot.axes.x_axis(0).marker_grid_line marker.show = True marker.position_by = PositionMarkerBy.Constant marker.position = -0.4 marker.color = Color.Blue marker = plot.axes.y_axis(0).marker_grid_line marker.show = True marker.position_by = PositionMarkerBy.Constant marker.position = -0.88 marker.color = Color.Blue tp.export.save_png('marker_grid_line_2d.png', 600, supersample=3)
Attributes
colorColorof the grid lines to be drawn.draw_lastDraw grid behind all other plot elements. line_patternPattern style of the grid lines to be drawn. line_thicknessWidth of the grid lines to be drawn. pattern_lengthSegment length of the repeated line pattern. positionPosition of the marker line in axes coordinates. position_byPosition of the marker line in axes coordinates. showDraw grid lines as tick locations.
-
MarkerGridLine2D.color¶ Colorof the grid lines to be drawn.Type: ColorExample usage:
>>> from tecplot.constant import Color >>> grid_lines.color = Color.Blue
-
MarkerGridLine2D.draw_last¶ Draw grid behind all other plot elements.
Type: booleanExample usage:
>>> axis.grid_lines.draw_last = True
-
MarkerGridLine2D.line_pattern¶ Pattern style of the grid lines to be drawn.
Type: LinePatternPossible values:
Solid,Dashed,DashDot,Dotted,LongDash,DashDotDot.Example usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash
-
MarkerGridLine2D.line_thickness¶ Width of the grid lines to be drawn.
Type: floatExample usage:
>>> grid_lines.line_thickness = 0.5
-
MarkerGridLine2D.pattern_length¶ Segment length of the repeated line pattern.
Type: floatExample usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash >>> grid_lines.pattern_length = 3.5
-
MarkerGridLine2D.position¶ Position of the marker line in axes coordinates.
Type: floatThe
position_byattribute must be set toPositionMarkerBy.Constant:>>> from tecplot.constant import PositionMarkerBy >>> marker_line = plot.axes.x_axis.marker_grid_line >>> marker_line.position_by = PositionMarkerBy.Constant >>> marker_line.position = 3.14
-
MarkerGridLine2D.position_by¶ Position of the marker line in axes coordinates.
Type: PositionMarkerBy- Possible values:
PositionMarkerBy.Constantor PositionMarkerBy.SolutionTime.
The position can be set to a constant or to the solution time of the linked frame:
>>> from tecplot.constant import PositionMarkerBy >>> marker_line = plot.axes.x_axis.marker_grid_line >>> marker_line.position_by = PositionMarkerBy.SolutionTime
- Possible values:
PolarAngleMarkerGridLine¶
-
class
tecplot.plot.PolarAngleMarkerGridLine(axis)[source]¶ The marker grid line for the theta axis.
Attributes
colorColorof the grid lines to be drawn.draw_lastDraw grid behind all other plot elements. line_patternPattern style of the grid lines to be drawn. line_thicknessWidth of the grid lines to be drawn. pattern_lengthSegment length of the repeated line pattern. positionPosition of the marker line in axes coordinates. position_byPosition of the marker line in axes coordinates. radial_cutoffMinimum radial position of theta grid lines. showDraw grid lines as tick locations.
-
PolarAngleMarkerGridLine.color¶ Colorof the grid lines to be drawn.Type: ColorExample usage:
>>> from tecplot.constant import Color >>> grid_lines.color = Color.Blue
-
PolarAngleMarkerGridLine.draw_last¶ Draw grid behind all other plot elements.
Type: booleanExample usage:
>>> axis.grid_lines.draw_last = True
-
PolarAngleMarkerGridLine.line_pattern¶ Pattern style of the grid lines to be drawn.
Type: LinePatternPossible values:
Solid,Dashed,DashDot,Dotted,LongDash,DashDotDot.Example usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash
-
PolarAngleMarkerGridLine.line_thickness¶ Width of the grid lines to be drawn.
Type: floatExample usage:
>>> grid_lines.line_thickness = 0.5
-
PolarAngleMarkerGridLine.pattern_length¶ Segment length of the repeated line pattern.
Type: floatExample usage:
>>> from tecplot.constant import LinePattern >>> grid_lines.line_pattern = LinePattern.LongDash >>> grid_lines.pattern_length = 3.5
-
PolarAngleMarkerGridLine.position¶ Position of the marker line in axes coordinates.
Type: floatThe
position_byattribute must be set toPositionMarkerBy.Constant:>>> from tecplot.constant import PositionMarkerBy >>> marker_line = plot.axes.x_axis.marker_grid_line >>> marker_line.position_by = PositionMarkerBy.Constant >>> marker_line.position = 3.14
-
PolarAngleMarkerGridLine.position_by¶ Position of the marker line in axes coordinates.
Type: PositionMarkerBy- Possible values:
PositionMarkerBy.Constantor PositionMarkerBy.SolutionTime.
The position can be set to a constant or to the solution time of the linked frame:
>>> from tecplot.constant import PositionMarkerBy >>> marker_line = plot.axes.x_axis.marker_grid_line >>> marker_line.position_by = PositionMarkerBy.SolutionTime
- Possible values:
OrientationAxis¶
-
class
tecplot.plot.OrientationAxis(axes)[source]¶ The orientation axis for 3D Field plots.
This is the small (x, y, z) reference axis object which can moved, resized and modified using this class.
By default, all 3D plots show the 3D orientation axis in the upper right of the frame. It can be repositioned by setting
positionas shown below.from os import path import tecplot as tp from tecplot.constant import Color examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, 'SimpleData', 'Sphere.lpk') dataset = tp.load_layout(infile) frame = tp.active_frame() plot = frame.plot() plot.axes.orientation_axis.position = 15, 15 plot.axes.orientation_axis.color = Color.BrightCyan plot.axes.reset_range() plot.view.fit() tp.export.save_png('axes_orientation.png', 600, supersample=3)
Attributes
colorColorof the orientation axes.line_thicknessLine thickness used when drawing the orientation axis as a percentage of frame height. position(x, y)position of the orientation axis as a percentage distance from the lower-left corner of the viewport.showEnable drawing of the orientation axis. show_variable_nameUse variable names instead of ‘X’, ‘Y’ and ‘Z’. sizeSize of the orientation axis as a percentage of frame size (0-100).
-
OrientationAxis.color¶ Colorof the orientation axes.Type: ColorExample usage:
>>> from tecplot.constant import Color >>> plot.axes.orientation_axis.color = Color.Cyan
-
OrientationAxis.line_thickness¶ Line thickness used when drawing the orientation axis as a percentage of frame height.
Type: floatExample usage:
>>> plot.axes.orientation_axis.line_thickness = 0.8
-
OrientationAxis.position¶ (x, y)position of the orientation axis as a percentage distance from the lower-left corner of the viewport.Type: 2-tuple of floats:(x, y)The position is in percent from the lower-left corner of the viewport:
>>> plot.axes.orientation_axis.position = (15, 15)
-
OrientationAxis.show¶ Enable drawing of the orientation axis.
Type: booleanExample usage:
>>> plot.axes.orientation_axis.show = False




































