Source code for tecplot.plot.ticks

from builtins import super

from ..tecutil import _tecutil
from ..constant import *
from ..exception import *
from ..tecutil import Index, StringList, flatten_args, lock, sv
from .. import session
from .font import Font


class Ticks(session.Style):
    def __init__(self, axis):
        self.axis = axis
        super().__init__(axis._sv, sv.TICKS, **axis._style_attrs)

    @property
    def show(self):
        """Draw ticks along axis.

        :type: `boolean <bool>`

        Example usage::

            >>> axis.ticks.show = True
        """
        return self._get_style(bool, sv.SHOWONAXISLINE)

    @show.setter
    def show(self, value):
        self._set_style(bool(value), sv.SHOWONAXISLINE)

    @property
    def direction(self):
        """How to draw the ticks with respect the axis line.

        :type: `TickDirection`

        Possible values: `TickDirection.In`, `TickDirection.Out` or
        `TickDirection.Centered`::

            >>> from tecplot.constant import TickDirection
            >>> axis.ticks.direction = TickDirection.Centered
        """
        return self._get_style(TickDirection, sv.TICKDIRECTION)

    @direction.setter
    def direction(self, value):
        self._set_style(TickDirection(value), sv.TICKDIRECTION)

    @property
    def length(self):
        """Size of the major tick lines to draw.

        :type: `float` (percent of frame height)

        Example usage::

            >>> axis.ticks.length = 2
        """
        return self._get_style(float, sv.LENGTH)

    @length.setter
    def length(self, value):
        self._set_style(float(value), sv.LENGTH)

    @property
    def line_thickness(self):
        """Width of the major tick lines to be drawn.

        :type: `float`

        Example usage::

            >>> axis.ticks.line_thickness = 0.4
        """
        return self._get_style(float, sv.LINETHICKNESS)

    @line_thickness.setter
    def line_thickness(self, value):
        self._set_style(float(value), sv.LINETHICKNESS)

    @property
    def minor_num_ticks(self):
        """Number of minor ticks between each major tick.

        :type: `int`

        Example usage::

            >>> axis.ticks.minor_num_ticks = 3
        """
        return self._get_style(int, sv.NUMMINORTICKS)

    @minor_num_ticks.setter
    def minor_num_ticks(self, value):
        self._set_style(int(value), sv.NUMMINORTICKS)

    @property
    def minor_length(self):
        """Size of the minor tick lines to draw.

        :type: `float` (percent of frame height)

        Example usage::

            >>> axis.ticks.minor_length = 1.2
        """
        return self._get_style(float, sv.MINORLENGTH)

    @minor_length.setter
    def minor_length(self, value):
        self._set_style(float(value), sv.MINORLENGTH)

    @property
    def minor_line_thickness(self):
        """Width of the minor tick lines to be drawn.

        :type: `float`

        Example usage::

            >>> axis.ticks.minor_line_thickness = 0.1
        """
        return self._get_style(float, sv.MINORLINETHICKNESS)

    @minor_line_thickness.setter
    def minor_line_thickness(self, value):
        self._set_style(float(value), sv.MINORLINETHICKNESS)

    @property
    def spacing(self):
        """Distance between major ticks.

        :type: `float` (axis data units) or `TickSpacing.Automatic`

        Example usage::

            >>> axis.ticks.spacing = 0.2
        """
        auto = self.axis._get_style(bool, sv.AUTOGRID)
        if auto:
            return TickSpacing.Automatic
        else:
            return self.axis._get_style(float, sv.GRSPACING)

    @spacing.setter
    def spacing(self, value):
        if value in (TickSpacing.Automatic, None):
            self.axis._set_style(True, sv.AUTOGRID)
        else:
            self.axis._set_style(False, sv.AUTOGRID)
            self.axis._set_style(float(value), sv.GRSPACING)

    @property
    def spacing_anchor(self):
        """Value to place the first major tick mark.

        :type: `float`

        All ticks will placed around this anchor position::

            >>> axis.ticks.spacing_anchor = 0.05
        """
        return self.axis._get_style(float, sv.GRANCHOR)

    @spacing_anchor.setter
    def spacing_anchor(self, value):
        self.axis._set_style(float(value), sv.GRANCHOR)


[docs]class Ticks2D(Ticks): """Tick marks (major and minor) along axes in 2D. .. code-block:: python :emphasize-lines: 27-28,30-34 from os import path import tecplot as tp from tecplot.constant import PlotType, AxisMode, AxisAlignment, TickDirection examples_dir = tp.session.tecplot_examples_directory() infile = path.join(examples_dir, '2D', 'cstream.plt') dataset = tp.data.load_tecplot(infile) frame = tp.active_frame() plot = frame.plot(PlotType.Cartesian2D) plot.show_contour = True plot.contour(0).variable = dataset.variable('v3') plot.contour(0).colormap_name = 'Sequential - Yellow/Green/Blue' plot.axes.axis_mode = AxisMode.Independent 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.spacing = 0.05 ticks.minor_num_ticks = 0 ticks.length *= 3 ticks.line_thickness *= 2 tp.export.save_png('ticks_2d.png', 600) .. figure:: /_static/images/ticks_2d.png :width: 300px :figwidth: 300px """ @property def show_on_border_min(self): """Draw ticks along the lower border of the axes grid. :type: `boolean <bool>` Example usage:: >>> axis.ticks.show_on_border_min = True """ return self._get_style(bool, sv.SHOWONGRIDBORDERMIN) @show_on_border_min.setter def show_on_border_min(self, value): self._set_style(bool(value), sv.SHOWONGRIDBORDERMIN) @property def show_on_border_max(self): """Draw ticks along the upper border of the axes grid. :type: `boolean <bool>` Example usage:: >>> axis.ticks.show_on_border_max = True """ return self._get_style(bool, sv.SHOWONGRIDBORDERMAX) @show_on_border_max.setter def show_on_border_max(self, value): self._set_style(bool(value), sv.SHOWONGRIDBORDERMAX)
[docs]class RadialTicks(Ticks2D): """Tick marks (major and minor) along the radial axis. .. code-block:: python :emphasize-lines: 18-21 from os import path import tecplot as tp from tecplot.constant import PlotType, ThetaMode, Color, TickDirection exdir = tp.session.tecplot_examples_directory() datafile = path.join(exdir, 'XY', 'line_plots_ind_v_dep_var.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) .. figure:: /_static/images/ticks_radial.png :width: 300px :figwidth: 300px """ @property def show_on_all_radial_axes(self): """Draw ticks along all radial axis lines. :type: `boolean <bool>` Example usage:: >>> plot.axes.r_axis.line.show_perpendicular = True >>> plot.axes.r_axis.ticks.show_on_all_radial_axes = True """ return self._get_style(bool, sv.SHOWONALLAXES) @show_on_all_radial_axes.setter def show_on_all_radial_axes(self, value): self._set_style(bool(value), sv.SHOWONALLAXES)
[docs]class Ticks3D(Ticks): """Tick marks (major and minor) along axes in 3D. .. code-block:: python :emphasize-lines: 21-22 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, '3D', 'crank.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.fill_color = None 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) .. figure:: /_static/images/ticks_3d.png :width: 300px :figwidth: 300px """ @property def show_on_opposite_edge(self): """Draw ticks along the opposite border of the axes grid. :type: `boolean <bool>` Example usage:: >>> axis.ticks.show_on_opposite_edge = True """ return self._get_style(bool, sv.SHOWONOPPOSITEEDGE) @show_on_opposite_edge.setter def show_on_opposite_edge(self, value): self._set_style(bool(value), sv.SHOWONOPPOSITEEDGE)
[docs]class LabelFormat(session.Style): """Tick label string formatting. .. code-block:: python :emphasize-lines: 30-35 from datetime import datetime import tecplot as tp from tecplot.constant import PlotType, AxisMode, AxisAlignment, NumberFormat tp.new_layout() plot = tp.active_frame().plot(tp.constant.PlotType.Sketch) plot.activate() # setup the plot area margins plot.axes.viewport.left = 10 plot.axes.viewport.right = 90 # show the x-axis, set the title, and alignment with the viewport xaxis = plot.axes.x_axis xaxis.show = True xaxis.title.text = 'Negative numbers in parentheses' xaxis.title.offset = 20 xaxis.line.alignment = AxisAlignment.WithViewport xaxis.line.position = 50 # set limits, tick placement and tick label properties xaxis.min, xaxis.max = -5.123e-5, 5.234e-5 xaxis.ticks.spacing = (xaxis.max - xaxis.min) / 6 xaxis.ticks.spacing_anchor = 0 xaxis.tick_labels.angle = 45 xaxis.tick_labels.offset = 3 # format the tick labels in superscript form. example: 1.234x10^5 # format negative numbers to use parentheses instead of a negative sign xformat = xaxis.tick_labels.format xformat.format_type = NumberFormat.SuperScript xformat.precision = 3 xformat.show_negative_sign = False xformat.negative_prefix = '(' xformat.negative_suffix = ')' tp.export.save_png('label_format.png', 600) .. figure:: /_static/images/label_format.png :width: 300px :figwidth: 300px """ def __init__(self, tick_labels): self.tick_labels = tick_labels super().__init__(tick_labels._sv, sv.NUMFORMAT, **tick_labels._style_attrs) @property def format_type(self): """Type of number formatting to use. :type: `NumberFormat` Possible values: `Integer`, `FixedFloat`, `Exponential`, `BestFloat`, `SuperScript`, `CustomLabel`, `LogSuperScript`, `RangeBestFloat`, `DynamicLabel`, `TimeDate`. Example usage:: >>> from tecplot.constant import NumberFormat >>> axis.tick_labels.format.format_type = NumberFormat.BestFloat """ return self._get_style(NumberFormat, sv.FORMATTING) @format_type.setter def format_type(self, value): self._set_style(NumberFormat(value), sv.FORMATTING) @property def custom_labels_index(self): """Index of the custom label to use. :type: `Index` (zero-based) Example usage:: >>> axis.tick_labels.format.custom_labels_index = 0 """ return self._get_style(Index, sv.CUSTOMLABEL) @custom_labels_index.setter def custom_labels_index(self, index): index = (self.num_custom_labels + index) if index < 0 else index self._set_style(Index(index), sv.CUSTOMLABEL) @property def num_custom_labels(self): """Number of custom label sets available to use. :type: `int` Example usage:: >>> print(axis.tick_labels.format.num_custom_labels) 1 """ return _tecutil.CustomLabelsGetNumSets()
[docs] def custom_labels(self, index): """List of labels for custom labels for set specified by index. Example usage:: >>> axis.tick_labels.format.custom_labels(0) ['apples', 'bananas', 'carrots'] """ index = (self.num_custom_labels + index) if index < 0 else index with StringList() as sl: if not _tecutil.CustomLabelsGet(sl, index+1): raise TecplotSystemError() ret = list(sl) return ret
@lock()
[docs] def add_custom_labels(self, *labels): """Append a list of custom labels as a new set. Example usage:: >>> labels = ['apples', 'bananas', 'carrots'] >>> axis.tick_labels.format.add_custom_labels(*labels) >>> print(axis.tick_labels.format.custom_labels(-1)) ['apples', 'bananas', 'carrots'] """ with StringList(*flatten_args(labels)) as sl: if not _tecutil.CustomLabelsAppend(sl): raise TecplotSystemError()
@property def precision(self): """Number digits after decimal for fixed floating point format. :type: `integer <int>` Example usage:: >>> from tecplot.constant import NumberFormat >>> axis.tick_labels.format.format_type = NumberFormat.FixedFloat >>> axis.tick_labels.format.precision = 3 """ return self._get_style(int, sv.PRECISION) @precision.setter def precision(self, value): self._set_style(int(value), sv.PRECISION) @property def remove_leading_zeros(self): """Strip leading zeros in the formatted number. :type: `boolean <bool>` Example usage:: >>> axis.tick_labels.format.remove_leading_zeros = True """ return self._get_style(bool, sv.REMOVELEADINGZEROS) @remove_leading_zeros.setter def remove_leading_zeros(self, value): self._set_style(bool(value), sv.REMOVELEADINGZEROS) @property def show_decimals_on_whole_numbers(self): """Include trailing decimal character with whole numbers. :type: `boolean <bool>` Example usage:: >>> axis.tick_labels.format.show_decimals_on_whole_numbers = True """ return self._get_style(bool, sv.SHOWDECIMALSONWHOLENUMBERS) @show_decimals_on_whole_numbers.setter def show_decimals_on_whole_numbers(self, value): self._set_style(bool(value), sv.SHOWDECIMALSONWHOLENUMBERS) @property def show_negative_sign(self): """Include negative sign for negative values. :type: `boolean <bool>` Example usage:: >>> axis.tick_labels.format.show_negative_sign = True """ return self._get_style(bool, sv.SHOWNEGATIVESIGN) @show_negative_sign.setter def show_negative_sign(self, value): self._set_style(bool(value), sv.SHOWNEGATIVESIGN) @property def negative_prefix(self): """Prefix string to use for negative valued tick labels. :type: `string <str>` This example shows how to use parentheses instead of a negative sign:: >>> axis.tick_labels.format.show_negative_sign = False >>> axis.tick_labels.format.negative_prefix = '(' >>> axis.tick_labels.format.negative_suffix = ')' """ return self._get_style(str, sv.NEGATIVEPREFIX) @negative_prefix.setter def negative_prefix(self, value): self._set_style(str(value), sv.NEGATIVEPREFIX) @property def negative_suffix(self): """Suffix string to use for negative valued tick labels. :type: `string <str>` This example shows how to use parentheses instead of a negative sign:: >>> axis.tick_labels.format.show_negative_sign = False >>> axis.tick_labels.format.negative_prefix = '(' >>> axis.tick_labels.format.negative_suffix = ')' """ return self._get_style(str, sv.NEGATIVESUFFIX) @negative_suffix.setter def negative_suffix(self, value): self._set_style(str(value), sv.NEGATIVESUFFIX) @property def positive_prefix(self): """Prefix string to use for positive valued tick labels. :type: `string <str>` Example usage:: >>> axis.tick_labels.format.positive_prefix = 'increase: ' """ return self._get_style(str, sv.POSITIVEPREFIX) @positive_prefix.setter def positive_prefix(self, value): self._set_style(str(value), sv.POSITIVEPREFIX) @property def positive_suffix(self): """Suffix string to use for positive valued tick labels. :type: `string <str>` Example usage:: >>> axis.tick_labels.format.positive_suffix = ' (m)' """ return self._get_style(str, sv.POSITIVESUFFIX) @positive_suffix.setter def positive_suffix(self, value): self._set_style(str(value), sv.POSITIVESUFFIX) @property def zero_prefix(self): """Prefix string to use for zero valued tick labels. :type: `string <str>` Example usage:: >>> axis.tick_labels.format.zero_prefix = 'origin: ' """ return self._get_style(str, sv.ZEROPREFIX) @zero_prefix.setter def zero_prefix(self, value): self._set_style(str(value), sv.ZEROPREFIX) @property def zero_suffix(self): """Suffix string to use for zero valued tick labels. :type: `string <str>` Example usage:: >>> axis.tick_labels.format.zero_suffix = ' (origin)' """ return self._get_style(str, sv.ZEROSUFFIX) @zero_suffix.setter def zero_suffix(self, value): self._set_style(str(value), sv.ZEROSUFFIX) @property def datetime_format(self): r"""The date/time format to be used. :type: `string <str>` Example usage:: >>> from tecplot.constant import NumberFormat >>> axis.tick_labels.format.format_type = NumberFormat.TimeDate >>> axis.tick_labels.format.datetime_format = 'mmm d, yyyy' The format can be any combination of the following codes. Placing a backslash in front of a y, m, d, or s in the Time/Date formula will keep it from being processed as part of the formula. All characters not part of the Time/Date formula will appear as entered. For example, "\\year yyyy" will appear as "year 2008", as the backslash keeps the first y from being processed as part of the formula. If you use "m" immediately after the "h" or "hh" code or immediately before the "ss" code, the minutes instead of the month will be displayed. =============== ========================= Years: ----------------------------------------- ``yy`` 00-99 ``yyyy`` 1800-9999 --------------- ------------------------- Months: ----------------------------------------- ``m`` 1-12 ``mm`` 01-12 ``mmm`` Jan-Dec ``mmmm`` January-December ``mmmmm`` first letter of the month --------------- ------------------------- Days: ----------------------------------------- ``[d]`` elapsed days ``d`` 1-31 ``dd`` 01-31 ``ddd`` Sun-Sat ``dddd`` Sunday-Saturday ``ddddd`` S,M,T,W,T,F,S --------------- ------------------------- Hours: ----------------------------------------- ``[h]`` elapsed hours ``h`` 0-23 or 1-12 ``hh`` 00-23 or 1-12 ``AM/PM`` AM or PM ``A/P`` AM or PM as "A" or "P" --------------- ------------------------- Minutes: ----------------------------------------- ``[m]`` elapsed minutes ``m`` 0-59 ``mm`` 00-59 --------------- ------------------------- Seconds: --------------- ------------------------- ``s`` 0-59 ``ss`` 00-59 ``.0`` Tenths ``.00`` Hundredths ``.000`` Thousandths =============== ========================= To display the time and date on your plot as a "Sat-Jan-05-2008", enter the following code:: "ddd-mmm-dd-yyyy" To display the time and date on your plot as a "1-3-08", enter the following code:: "m-d-yy" To display the time and date on your plot as a "9:30:05 AM", enter the following code:: "h:mm:ss AM" To display an elapsed time, such as "3:10:15", enter the following code:: "[d]:hh:mm" """ return self._get_style(str, sv.TIMEDATEFORMAT) @datetime_format.setter def datetime_format(self, value): self._set_style(str(value), sv.TIMEDATEFORMAT)
class TickLabels(session.Style): def __init__(self, axis): self.axis = axis super().__init__(axis._sv, sv.TICKLABEL, **axis._style_attrs) @property def show(self): """Draw labels for the major tick marks. :type: `boolean <bool>` Example usage:: >>> axis.tick_labels.show = True """ return self._get_style(bool, sv.SHOWONAXISLINE) @show.setter def show(self, value): self._set_style(bool(value), sv.SHOWONAXISLINE) @property def angle(self): """Angle at which to render the label text. :type: `float` (degrees) or `LabelAlignment` Possible values: `LabelAlignment.AlongAxis` or `LabelAlignment.PerpendicularToAxis`. Example usage:: >>> from tecplot.constant import LabelAlignment >>> axis.tick_labels.angle = LabelAlignment.AlongAxis """ angle_alignment = self._get_style(LabelAlignment, sv.LABELALIGNMENT) if angle_alignment is LabelAlignment.ByAngle: return self._get_style(float, sv.ANGLE) else: return angle_alignment @angle.setter def angle(self, value): if value in (LabelAlignment.AlongAxis, LabelAlignment.PerpendicularToAxis): self._set_style(value, sv.LABELALIGNMENT) else: self._set_style(LabelAlignment.ByAngle, sv.LABELALIGNMENT) self._set_style(float(value), sv.ANGLE) @property def color(self): """Color of the tick labels. :type: `Color` Example usage:: >>> from tecplot.constant import Color >>> axis.tick_labels.color = Color.Blue """ return self._get_style(Color, sv.COLOR) @color.setter def color(self, value): self._set_style(Color(value), sv.COLOR) @property def offset(self): """Relative offset of the tick labels. :type: `float` Positive values will be outside the grid area, negative values are inside the grid area:: >>> axis.tick_labels.offset = 5 """ return self._get_style(float, sv.OFFSET) @offset.setter def offset(self, value): self._set_style(float(value), sv.OFFSET) @property def step(self): """Step for labels placed on major ticks. :type: `int` A value of 1 will place a label on every major tick mark:: >>> axis.tick_labels.step = 1 """ return self._get_style(int, sv.SKIP) @step.setter def step(self, value): self._set_style(int(value), sv.SKIP) @property def format(self): """Label format and style control. :type: `LabelFormat` Example usage:: >>> axis.tick_labels.format.format_type = NumberFormat.BestFloat """ return LabelFormat(self) @property def font(self): """Text style control including typeface and size. :type: `Font <plot.Font>` Example usage:: >>> axis.tick_labels.font.typeface = 'Times' """ return Font(self)
[docs]class TickLabels2D(TickLabels): """Tick labels along axes in 2D. .. code-block:: python 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.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) .. figure:: /_static/images/tick_labels_2d.png :width: 300px :figwidth: 300px """ @property def show_on_border_max(self): """Draw labels along the upper grid area border. :type: `bool` Example usage:: >>> axis.tick_labels.show_on_border_max = True """ return self._get_style(bool, sv.SHOWONGRIDBORDERMAX) @show_on_border_max.setter def show_on_border_max(self, value): self._set_style(bool(value), sv.SHOWONGRIDBORDERMAX) @property def show_on_border_min(self): """Draw labels along the lower grid area border. :type: `bool` Example usage:: >>> axis.tick_labels.show_on_border_min = True """ return self._get_style(bool, sv.SHOWONGRIDBORDERMIN) @show_on_border_min.setter def show_on_border_min(self, value): self._set_style(bool(value), sv.SHOWONGRIDBORDERMIN) @property def show_at_axis_intersection(self): """Include the labels at the intersection of other axes. :type: `bool` Example usage:: >>> axis.tick_labels.show_at_axis_intersection = True """ return self._get_style(bool, sv.SHOWATAXISINTERSECTION) @show_at_axis_intersection.setter def show_at_axis_intersection(self, value): self._set_style(bool(value), sv.SHOWATAXISINTERSECTION) @property def transparent_background(self): """Make the text box around each label transparent. :type: `bool` Example usage:: >>> axis.tick_labels.transparent_background = True """ return not self._get_style(bool, sv.ERASEBEHINDLABELS) @transparent_background.setter def transparent_background(self, value): self._set_style(not bool(value), sv.ERASEBEHINDLABELS)
[docs]class RadialTickLabels(TickLabels2D): """Tick mark labels along the radial axis. .. code-block:: python :emphasize-lines: 16-18 from os import path import tecplot as tp from tecplot.constant import PlotType, ThetaMode, Color exdir = tp.session.tecplot_examples_directory() datafile = path.join(exdir, 'XY', 'line_plots_ind_v_dep_var.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) .. figure:: /_static/images/tick_labels_radial.png :width: 300px :figwidth: 300px """ @property def show_on_all_radial_axes(self): """Draw labels along all radial axis lines. :type: `boolean <bool>` Example usage:: >>> plot.axes.r_axis.line.show_perpendicular = True >>> plot.axes.r_axis.tick_labels.show_on_all_radial_axes = True """ return self._get_style(bool, sv.SHOWONALLAXES) @show_on_all_radial_axes.setter def show_on_all_radial_axes(self, value): self._set_style(bool(value), sv.SHOWONALLAXES)
[docs]class TickLabels3D(TickLabels): """Tick labels along axes in 3D. .. code-block:: python :emphasize-lines: 22-26 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, '3D_Volume', 'isosurfaces.plt') dataset = tp.data.load_tecplot(infile) frame = tp.active_frame() plot = frame.plot(PlotType.Cartesian3D) plot.activate() plot.show_contour = True 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) .. figure:: /_static/images/tick_labels_3d.png :width: 300px :figwidth: 300px """ @property def show_on_opposite_edge(self): """Draw labels on the opposite edge of the grid. :type: `boolean <bool>` Example usage:: >>> axis.tick_labels.show_on_opposite_edge = True """ return self._get_style(bool, sv.SHOWONOPPOSITEEDGE) @show_on_opposite_edge.setter def show_on_opposite_edge(self, value): self._set_style(bool(value), sv.SHOWONOPPOSITEEDGE)