hw.hg Module#

AxisHorizontal class#

class AxisHorizontal(window: int | Window | None = None, page: int | str | Page | None = None, id: int | str = 0, **kwargs)#

A class representing a AxisHorizontal in XY Chart. Creates a Horizontal Axis for the given window and page. Raises an Exception if those parameters do not point to a valid HyperGraph window.

Parameters:
  • window (Union[int, Window]) – The window of the curve.

  • page (Union[int, Page]) – The page of the curve.

setAttributes(**kwargs)#

Set the attributes of the AxisHorizontal.

Parameters:

kwargs (dict) – Attributes of AxisHorizontal to set.

Raises:

ValueError – If an invalid attribute is provided.

property color: Color#

Sets the color of the axes label

property db10Ref: int#

Sets the dB10 reference value for the axis.

property db20Ref: int#

Sets the dB20 reference value for the axis.

property font: Font#

Sets label font of the axis.

property fontSize: int#

Sets label font size of the axis..

property gridsPerTic: int#

Sets the number of grids between tics on the axis.

property lock: str#

Sets one of the three Lock option states for the axes. The three states include never, always, atImport

property max: float#

Sets the minimum value for the axis.

property min: float#

Sets the minimum value for the axis.

property name: str#

Sets the title of the axis.

property nameVisibility: bool#

Turn off the text displayed in the HyperGraph window.

property precision: int#

Precision specifies the number of digits displayed to the right of the decimal point.

property scaleType: str#

Sets the scale type for the axis. The scale options include: linear, log, dB10, dB20.

property text: str#

Sets new axis label/text displayed in the HyperGraph window.

property textAsDisplayed: str#

Gets display value for text in the HyperGraph window.

property ticFont: Font#

Sets the tics font of the axis.

property ticFontSize: int#

Sets the tics font size of the axis.

property ticFormat: str#

Axis values can be displayed using one of three formats. Supported formats are auto, scientific, fixed.

property ticIncrement: float#

Sets the spacing between tics for the axis.

property ticMethod: str#

Sets the method used for placing tics on the axis. Valid options are ticsPerAxis, ticIncrement.

property ticsPerAxis: int#

Sets the number of tics for the axis.

property type: str#

Gets the type of axis.

property unitMeasurement: str#

Sets unit of measure.

property unitType: str#

Sets unit type.

property visibility: bool#

Sets whether the axis is displayed or hidden.

property visualReverse: bool#

Switch the values and reverse the axis display.

property weighting: str#

Sets the weighting type for the axis. The weighting type options include: none, a, b, c, u.

property id: int#

Returns the ID.

property page: Page#

Returns the Page Object.

property window: Window#

Returns the Window Object.

AxisVertical class#

class AxisVertical(window: int | Window | None = None, page: int | str | Page | None = None, id: int | str = 0, **kwargs)#

A class representing a AxisVertical in XY Chart. Creates a Vertical Axis for the given window and page. Raises an Exception if those parameters do not point to a valid HyperGraph window.

Parameters:
  • window (Union[int, Window]) – The window of the curve.

  • page (Union[int, Page]) – The page of the curve.

setAttributes(**kwargs)#

Set the attributes of the AxisHorizontal.

Parameters:

kwargs (dict) – Attributes of AxisHorizontal to set.

Raises:

ValueError – If an invalid attribute is provided.

property color: Color#

Sets the color of the axes label

property db10Ref: int#

Sets the dB10 reference value for the axis.

property db20Ref: int#

Sets the dB20 reference value for the axis.

property font: Font#

Sets label font of the axis.

property fontSize: int#

Sets label font size of the axis..

property gridsPerTic: int#

Sets the number of grids between tics on the axis.

property lock: str#

Sets one of the three Lock option states for the axes. The three states include never, always, atImport.

property max: float#

Sets the minimum value for the axis.

property min: float#

Sets the minimum value for the axis.

property name: str#

Sets the title of the axis.

property nameVisibility: bool#

Turn off the text displayed in the HyperGraph window.

property precision: int#

Precision specifies the number of digits displayed to the right of the decimal point.

property scaleType: str#

Sets the scale type for the axis. The scale options include: linear, log, dB10, dB20.

property text: str#

Sets new axis label/text displayed in the HyperGraph window.

property textAsDisplayed: str#

Gets display value for text in the HyperGraph window.

property ticFont: Font#

Sets the tics font of the axis.

property ticFontSize: int#

Sets the tics font size of the axis.

property ticFormat: str#

Axis values can be displayed using one of three formats. Supported formats are auto, scientific, fixed.

property ticIncrement: float#

Sets the spacing between tics for the axis.

property ticMethod: str#

Sets the method used for placing tics on the axis. Valid options are tics, increment.

property ticsPerAxis: int#

Sets the number of tics for the axis.

property type: str#

Gets the type of axis.

property unitMeasurement: str#

Sets unit of measure.

property unitType: str#

Sets unit type.

property visibility: bool#

Sets whether the axis is displayed or hidden.

property visualReverse: bool#

Switch the values and reverse the axis display.

property weighting: str#

Sets the weighting type for the axis.The weighting type options include: none, a, b, c, u.

property id: int#

Returns the ID.

property page: Page#

Returns the Page Object.

property window: Window#

Returns the Window Object.

CreateCurvesByFile class#

class CreateCurvesByFile(**kwargs)#

Class representing the CreateCurvesByFile.Provides the user to select single file or multiple files with intersecting data and plot the data from all files simultaneously in the current HyperGraph session. For the Multiple Files, Intersecting data refers to files that contain the same type, request, and component information. The constructor raises an exception if the creation of CreateCurvesByFile object fails.

Parameters:

kwargs (dict) – Attributes of the CreateCurvesByFile object.

run()#

Method to plot the curves based on the information specifed. The method raises an error message for the following cases:

- If the file is not empty.
- If the subcase is null or empty.
- If the yDataType or yRequest or yComponent is null or empty.
- If the yRequestFilter and yRequest gives empty requests list.
- If the yComponentFilter and yComponent gives empty component list.
setAttributes(**kwargs)#

Method to set the CreateCurvesByFile attributes.

Parameters:

kwargs (dict) – Attributes

property chartType#

Attribute to set the chart type for creating the plot. Supported chart types are:

- xy
- complex
- polar
Getter:

Gets the chart type for creating the plot. Returns the string representing the chart type.

Setter:

Sets the chart type for creating the plot.

Type:

str

property curveOptions#

Attribute to get or set the plot options for plotting the curves. It allows the user to modify or update the page, header, footer, horizontal axis, vertical axis, legend and curve properties.

Getter:

Gets the curve options name.

Setter:

Sets the curve options.

Type:

Union[str, CreateCurvesOptions]

property curveOptionsEnabled#

Attribute to enable or disable the use of curve options during plotting the curves.

Getter:

Gets the boolean flag to enable the use of curve options.

Setter:

Sets the boolean flag to enable the use of curve options.

Type:

bool

property file#

The file as a source for creating plot.

Getter:

Returns the name of the file(for Single file) and name of the MultipleFiles(for multiple files)

Setter:

Sets the file or MultipleFiles as a source for creating plots. For Single file, set the Filename or path. For Multiple files, set the MultipleFiles object or name.

Type:

Union[str, MultipleFiles]

property layoutOrganisation#

The attribute to specify how the plotted data is organised on the page layout.The default option is currentPlot if not specified. Options available:

- currentPlot : Every curve is overlaid in the active window. This is the default option.
- onePlotPerRequest : Each selected request is plotted in a new plot with the
corresponding components overlaid.
- For example, if two Y requests and four Y components are selected,
two plots are created with four curves in each plot.
- onePlotPerComponent : Each selected component is plotted in a new plot with the
corresponding requests overlaid.
- For example, if two Y requests and four Y components are selected,
four plots are created with two curves in each plot.
- oneCurvePerPlot : Each curve is plotted in a new plot.
- onePlotPerFile : Curves for each file is plotted in a new plot for multiple files.
This option is valid while plotting multiple files.
Getter:

Returns the layout option to specify how the plotted data is organised on the page.

Setter:

Sets the layout option to specify how the plotted data is organised on the page.

Type:

str

property layoutType#

The attribute to set the layout type (number of windows) on the page. Options available:

0 - One window
1 - Two windows (left and right)
2 - Two windows (top and bottom)
3 - Three windows (one left and two right)
4 - Three windows (two left and one right)
5 - Three windows (two top and one bottom)
6 - Three windows (one top and two bottom)
7 - Three windows (left, middle, and right)
8 - Three windows (top, middle, and bottom)
9 - Four windows
10 - Six windows (three rows of two)
11 - Six windows (two rows of three)
12 - Nine windows
13 - Twelve windows (four rows of three)
14 - Twelve windows (three rows of four)
15 - Sixteen windows
16 - Four windows (four rows of one)
17 - Eight windows (four rows of two)
18 - Four windows (one row of four)
19 - Eight windows (two rows of four)
Getter:

Returns the layout type(number of windows) on the page.

Setter:

Sets the layout type(number of windows) on the page.

Type:

int

property subcase#

The subcase specified for creating the plots.

Getter:

Returns the subcase selected for creating the plots.

Setter:

Sets the subcase name or id for creating the plots.

Type:

Union[int, str]

property xComponent#

The ‘x’ source components selected for the specified xRequest for creating the plots.

Getter:

Returns the ‘x’ source components selected for the specified xRequest.

Setter:

Sets the ‘x’ source components selected for the specified xRequest for creating the plots.

Type:

str

property xComponentMatchY#

The boolean flag to match the ‘x’ source component with the ‘y’ source component for creating the plots.

Getter:

Returns the boolean flag to match the ‘x’ source component with the ‘y’ source component for creating the plots.

Setter:

Sets the boolean flag to match the ‘x’ source component with the ‘y’ source component for creating the plots.

Type:

bool

property xDataType#

The ‘x’ source dataType selected for creating the plots.

Getter:

Returns the ‘x’ source dataType name selected for creating the plots.

Setter:

Sets the ‘x’ source dataType name for creating the plots.

Type:

str

property xRequest#

The ‘x’ source request selected for the specified xDataType for creating the plots.

Getter:

Returns the ‘x’ source request selected for the specified xDataType for creating the plots.

Setter:

Sets the ‘x’ source request selected for the specified xDataType for creating the plots.

Type:

str

property xRequestMatchY#

The boolean flag to match the ‘x’ source request with the ‘y’ source request for creating the plots.

Getter:

Returns the boolean flag to match the ‘x’ source request with the ‘y’ source request for creating the plots.

Setter:

Sets the boolean flag to match the ‘x’ source request with the ‘y’ source request for creating the plots.

Type:

bool

property yComponent#

The ‘y’ source components selected for the specified yRequest for creating the plots.

Getter:

Returns the ‘y’ source components selected for the specified yRequest.

Setter:

Sets the ‘y’ source components selected for the specified yRequest for creating the plots.

Type:

Union[list, str]

property yComponentFilter#

The filter used for selecting the ‘y’ source components for creating the plots.

Getter:

Returns the filter used for selecting the ‘y’ source components for creating the plots.

Setter:

Sets the filter used for selecting the ‘y’ source components for creating the plots.

Type:

Union[list, str]

property yComponentSorting#

The sorting order used for sorting the ‘y’ source components for creating the plots. Options available :

- “ascending” : Option to sort the y source components in ascending order.
- “descending” : Option to sort the y source components in descending order.
- “none” : Option to ignore the sorting of the y source components.
Getter:

Returns the sorting order used for sorting the ‘y’ source components for creating the plots.

Setter:

Sets the sorting order used for sorting the ‘y’ source components for creating the plots.

Type:

str

property yDataType#

The ‘y’ source dataType selected for creating the plots.

Getter:

Returns the ‘y’ source dataType name selected for creating the plots.

Setter:

Sets the ‘y’ source dataType name for creating the plots.

Type:

str

property yRequest#

The ‘y’ source requests selected for the specified yDataType for creating the plots.

Getter:

Returns the ‘y’ source requests selected for the specified yDataType.

Setter:

Sets the ‘y’ source requests selected for the specified yDataType for creating the plots.

Type:

Union[list, str]

property yRequestFilter#

The filter used for selecting the ‘y’ source requests for creating the plots.

Getter:

Returns the filter used for selecting the ‘y’ source requests for creating the plots.

Setter:

Sets the filter used for selecting the ‘y’ source requests for creating the plots.

Type:

Union[list, str]

property yRequestSorting#

The sorting order used for sorting the ‘y’ source requests for creating the plots. Options available :

- “ascending” : Option to sort the y source requests in ascending order.
- “descending” : Option to sort the y source requests in descending order.
- “none” : Option to ignore the sorting of the y source requests.
Getter:

Returns the sorting order used for sorting the ‘y’ source requests for creating the plots.

Setter:

Sets the sorting order used for sorting the ‘y’ source requests for creating the plots.

Type:

str

CreateCurvesBySubcase class#

class CreateCurvesBySubcase(**kwargs)#

Class representing the CreateCurvesBySubcase. Provides the user to select multiple subcases with intersecting data and plot the data from all subcases simultaneously in the current HyperGraph session. The constructor raises an exception if the creation of CreateCurvesBySubcase object fails.

Parameters:

kwargs (dict) – Attributes of the CreateCurvesBySubcase object.

run()#

Method to plot the curves based on the information specifed. The method raises an error message for the following cases:

- If the subcaseSet is null or empty.
- If the yDataType or yRequest or yComponent is null or empty.
- If the yRequestFilter and yRequest gives empty requests list.
- If the yComponentFilter and yComponent gives empty component list.
setAttributes(**kwargs)#

Method to set the CreateCurvesBySubcase attributes.

Parameters:

kwargs (dict) – Attributes

property chartType#

Attribute to set the chart type for creating the plot. Supported chart types are

- xy
- complex
- polar
Getter:

Gets the chart type for creating the plot. Returns the string representing the chart type.

Setter:

Sets the chart type for creating the plot.

Type:

str

property layoutOrganisation#

The attribute to specify how the plotted data is organised on the page layout.The default option is currentPlot if not specified. Options available:

- currentPlot : Every curve is overlaid in the active window. This is the default option.
- onePlotPerRequest : Each selected request is plotted in a new plot with the
corresponding components overlaid.
- For example, if two Y requests and four Y components are selected,
two plots are created with four curves in each plot.
- onePlotPerComponent : Each selected component is plotted in a new plot with the
corresponding requests overlaid.
- For example, if two Y requests and four Y components are selected,
four plots are created with two curves in each plot.
- oneCurvePerPlot : Each curve is plotted in a new plot.
- onePlotPerFile : Curves for each file is plotted in a new plot for multiple files.
This option is valid while plotting multiple files.
Getter:

Returns the layout option to specify how the plotted data is organised on the page.

Setter:

Sets the layout option to specify how the plotted data is organised on the page.

Type:

str

property layoutType#

The attribute to set the layout type (number of windows) on the page. Options available:

0 - One window
1 - Two windows (left and right)
2 - Two windows (top and bottom)
3 - Three windows (one left and two right)
4 - Three windows (two left and one right)
5 - Three windows (two top and one bottom)
6 - Three windows (one top and two bottom)
7 - Three windows (left, middle, and right)
8 - Three windows (top, middle, and bottom)
9 - Four windows
10 - Six windows (three rows of two)
11 - Six windows (two rows of three)
12 - Nine windows
13 - Twelve windows (four rows of three)
14 - Twelve windows (three rows of four)
15 - Sixteen windows
16 - Four windows (four rows of one)
17 - Eight windows (four rows of two)
18 - Four windows (one row of four)
19 - Eight windows (two rows of four)
Getter:

Returns the layout type(number of windows) on the page.

Setter:

Sets the layout type(number of windows) on the page.

Type:

int

property subcaseSet#

The subcaseSet as a source for creating the plots.

Getter:

Returns the name of the MultipleSubcases

Setter:

Sets the MultipleSubcases as a source for creating plots. For Multiple subcases, set the MultipleSubcases object or name.

Type:

Union[str, MultipleSubcases]

property xComponent#

The ‘x’ source components selected for the specified xRequest for creating the plots.

Getter:

Returns the ‘x’ source components selected for the specified xRequest.

Setter:

Sets the ‘x’ source components selected for the specified xRequest for creating the plots.

Type:

str

property xComponentMatchY#

The boolean flag to match the ‘x’ source component with the ‘y’ source component for creating the plots.

Getter:

Returns the boolean flag to match the ‘x’ source component with the ‘y’ source component for creating the plots.

Setter:

Sets the boolean flag to match the ‘x’ source component with the ‘y’ source component for creating the plots.

Type:

bool

property xDataType#

The ‘x’ source dataType selected for creating the plots.

Getter:

Returns the ‘x’ source dataType name selected for creating the plots.

Setter:

Sets the ‘x’ source dataType name for creating the plots.

Type:

str

property xRequest#

The ‘x’ source request selected for the specified xDataType for creating the plots.

Getter:

Returns the ‘x’ source request selected for the specified xDataType for creating the plots.

Setter:

Sets the ‘x’ source request selected for the specified xDataType for creating the plots.

Type:

str

property xRequestMatchY#

The boolean flag to match the ‘x’ source request with the ‘y’ source request for creating the plots.

Getter:

Returns the boolean flag to match the ‘x’ source request with the ‘y’ source request for creating the plots.

Setter:

Sets the boolean flag to match the ‘x’ source request with the ‘y’ source request for creating the plots.

Type:

bool

property yComponent#

The ‘y’ source components selected for the specified yRequest for creating the plots.

Getter:

Returns the ‘y’ source components selected for the specified yRequest.

Setter:

Sets the ‘y’ source components selected for the specified yRequest for creating the plots.

Type:

Union[list, str]

property yComponentFilter#

The filter used for selecting the ‘y’ source components for creating the plots.

Getter:

Returns the filter used for selecting the ‘y’ source components for creating the plots.

Setter:

Sets the filter used for selecting the ‘y’ source components for creating the plots.

Type:

Union[list, str]

property yComponentSorting#

The sorting order used for sorting the ‘y’ source components for creating the plots. Options available :

- “ascending” : Option to sort the y source components in ascending order.
- “descending” : Option to sort the y source components in descending order.
- “none” : Option to ignore the sorting of the y source components.
Getter:

Returns the sorting order used for sorting the ‘y’ source components for creating the plots.

Setter:

Sets the sorting order used for sorting the ‘y’ source components for creating the plots.

Type:

str

property yDataType#

The ‘y’ source dataType selected for creating the plots.

Getter:

Returns the ‘y’ source dataType name selected for creating the plots.

Setter:

Sets the ‘y’ source dataType name for creating the plots.

Type:

str

property yRequest#

The ‘y’ source requests selected for the specified yDataType for creating the plots.

Getter:

Returns the ‘y’ source requests selected for the specified yDataType.

Setter:

Sets the ‘y’ source requests selected for the specified yDataType for creating the plots.

Type:

Union[list, str]

property yRequestFilter#

The filter used for selecting the ‘y’ source requests for creating the plots.

Getter:

Returns the filter used for selecting the ‘y’ source requests for creating the plots.

Setter:

Sets the filter used for selecting the ‘y’ source requests for creating the plots.

Type:

Union[list, str]

property yRequestSorting#

The sorting order used for sorting the ‘y’ source requests for creating the plots. Options available :

- “ascending” : Option to sort the y source requests in ascending order.
- “descending” : Option to sort the y source requests in descending order.
- “none” : Option to ignore the sorting of the y source requests.
Getter:

Returns the sorting order used for sorting the ‘y’ source requests for creating the plots.

Setter:

Sets the sorting order used for sorting the ‘y’ source requests for creating the plots.

Type:

str

CreateCurvesOptions class#

class CreateCurvesOptions(name: str, **kwargs)#

Class representing the CreateCurvesOptions. Provides the user to create different configurations of the curves options for ploting. The curve options include the page, header, footer, horizontal axis, vertical axis, legend and curve properties.

Parameters:

kwargs (dict) – Attributes of the CreateCurvesOptions object.

setAttributes(**kwargs)#

Method to set the CreateCurvesOptions attributes.

Parameters:

kwargs (dict) – Attributes

property curveEndIndex#

Attribute to get or set the end index (last data point index) in the curve.

Getter:

Gets the curve end index

Setter:

Sets the curve end index

Type:

int

property curveIndexIncrement#

Attribute to get or set the index increment (number of points to advance while reading a subrange) in the curve.

Getter:

Gets the curve index increment

Setter:

Sets the curve index increment

Type:

int

property curveLabel#

Attribute to get or set the curve label.

Getter:

Gets the curve label.

Setter:

Sets the curve label.

Type:

str

property curveLabelPrefix#

Attribute to get or set the curve label prefix.

Getter:

Gets the curve label prefix

Setter:

Sets the curve label prefix

Type:

str

property curveLabelScheme#

Attribute to get or set the curve label scheme.

Getter:

Gets the curve label scheme.

Setter:

Sets the curve label scheme.

Type:

str

property curveLabelSuffix#

Attribute to get or set the curve label suffix.

Getter:

Gets the curve label suffix.

Setter:

Sets the curve label suffix.

Type:

str

property curveLineColor#

Attribute that sets the curve line color.

Getter:

Gets the curve line color.

Setter:

Sets the curve line color.

Type:

Union[int, str, tuple, Color]

property curveLineColorScheme#

Attribute to get or set the curve line color scheme. Options available for line color schemes are “default” and “allOneColor”

Getter:

Gets the curve line color scheme.

Setter:

Sets the curve line color scheme.

Type:

str

property curveLineStyle#

Attribute that sets the curve line style.

Getter:

Gets the curve line style.

Setter:

Sets the curve line style.

Type:

int

property curveLineStyleScheme#

Attribute to get or set the curve line style scheme. Options available for line style schemes are “default” and “allOneStyle”

Getter:

Gets the curve line style scheme.

Setter:

Sets the curve line style scheme.

Type:

str

property curveLineThickness#

Attribute that sets the curve line thickness.

Getter:

Gets the curve line thickness.

Setter:

Sets the curve line thickness.

Type:

int

property curveLineThicknessScheme#

Attribute to get or set the curve line thickness scheme. Options available for line thickness schemes are “default” and “allOneThickness”

Getter:

Gets the curve line thickness scheme.

Setter:

Sets the curve line thickness scheme.

Type:

str

property curveShowLabel#

Attribute that manages the display of the curve label.

Getter:

Gets the boolean flag to display the curve label.

Setter:

Sets the boolean flag to display the curve label.

Type:

bool

property curveShowLabelPrefix#

Attribute that manages the display of the curve label prefix.

Getter:

Gets the boolean flag to display the curve label prefix.

Setter:

Sets the boolean flag to display the curve label prefix.

Type:

bool

property curveShowLabelSuffix#

Attribute that manages the display of the curve label suffix.

Getter:

Gets the boolean flag to display the curve label suffix.

Setter:

Sets the boolean flag to display the curve label suffix.

Type:

bool

property curveStartIndex#

Attribute to get or set the start index (first data point index) in the curve. Default value is 1.

Getter:

Gets the curve start index

Setter:

Sets the curve start index

Type:

int

property curveSymbolColor#

Attribute to get or set the curve symbol color.

Getter:

Gets the curve symbol color.

Setter:

Sets the curve symbol color.

Type:

Union[int, str, tuple, Color]

property curveSymbolFrequency#

Attribute to get or set the curve symbol frequency.

Getter:

Gets the curve symbol frequency.

Setter:

Sets the curve symbol frequency.

Type:

int

property curveSymbolScheme#

Attribute to get or set the curve symbol scheme. Options available for line thickness schemes are “default” and “allOneSymbol”

Getter:

Gets the curve symbol scheme.

Setter:

Sets the curve symbol scheme.

Type:

str

property curveSymbolStyle#

Attribute that sets the curve symbol style. Options available are any value between 0 to 9 representing the symbol style.

Getter:

Gets the curve symbol style.

Setter:

Sets the curve symbol style.

Type:

int

property curveUseMath#

Attribute to enable the use of math expressions on curves with the support of ‘x’ and ‘y’ vectors.

Getter:

Gets the flag to enable the math expressions.

Setter:

Sets the flag to enable the math expressions.

Type:

bool

property curveXexpression#

Attribute to get or set the math expression for the curve ‘x’ vector.

Getter:

Gets the math expression for the curve ‘x’ vector.

Setter:

Sets the math expression for the curve ‘x’ vector.

Type:

str

property curveXoffset#

Attribute to get or set the curve X scale offset.

Getter:

Gets the curve X scale offset.

Setter:

Sets the curve X scale offset.

Type:

float

property curveXscale#

Attribute to get or set the curve X scale value.

Getter:

Gets the curve X scale value.

Setter:

Sets the curve X scale value.

Type:

float

property curveYexpression#

Attribute to get or set the math expression for the curve ‘y’ vector.

Getter:

Gets the math expression for the curve ‘y’ vector.

Setter:

Sets the math expression for the curve ‘y’ vector.

Type:

str

property curveYoffset#

Attribute to get or set the curve Y scale offset.

Getter:

Gets the curve Y scale offset.

Setter:

Sets the curve Y scale offset.

Type:

float

property curveYscale#

Attribute to get or set the curve Y scale.

Getter:

Gets the curve Y scale.

Setter:

Sets the curve Y scale.

Type:

float

property footerAlignment#

Attribute to get and set the footer alignment.

Getter:

Gets the footer alignment.

Setter:

Sets the footer alignment. Options available are “left”, “center”, “right”.

Type:

str

property footerLabelScheme#

Attribute to get or set the footer label scheme.

Getter:

Returns the footer label scheme.

Setter:

Sets the footer label scheme. Options available are “default” or “custom”.

Type:

str

property footerPrimaryFont#

Attribute to get and set the footer label primary font.

Getter:

Gets the footer label primary font

Setter:

Sets the footer label primary font

Type:

hw.font

property footerPrimaryFontSize#

Attribute to get and set the footer label primary font size.

Getter:

Gets the footer label primary font size.

Setter:

Sets the footer label primary font size.

Type:

int

property footerText#

Attribute to get or set the footer label text.

Getter:

Returns the footer label text.

Setter:

Sets the footer label text.

Type:

str

property footerVisibility#

Attribute to get or set the visibility of the footer

Getter:

Returns the boolean flag for the footer visibility.

Setter:

Sets the boolean flag for the footer visibility.

Type:

bool

property headerAlignment#

Attribute to get or set the header alignment.

Getter:

Returns the header alignment.

Setter:

Sets the header alignment.

Type:

str

property headerLabelScheme#

Attribute to get or set the header label scheme.

Getter:

Returns the header label scheme.

Setter:

Sets the header label scheme. Options available are “default” or “custom”.

Type:

str

property headerPrimaryFont#

Attribute to get or set the header primary font.

Getter:

Returns the header font.

Setter:

Sets the header font.

Type:

hw.font object

property headerPrimaryFontSize#

Attribute to get or set the header primary font size.

Getter:

Returns the header font size.

Setter:

Sets the header font size.

Type:

int

property headerText#

Attribute to get or set the header text.

Getter:

Returns the header text.

Setter:

Sets the header text.

Type:

str

property headerVisibility#

Attribute to get or set the visibility of the header

Getter:

Returns the boolean flag for the header visibility.

Setter:

Sets the boolean flag for the header visibility.

Type:

bool

property horizontalAxisFont#

Attribute to get and set the horizontal axis font.

Getter:

Gets the horizontal axis font.

Setter:

Sets the horizontal axis font.

Type:

hw.font

property horizontalAxisFontSize#

Attribute to get and set the horizontal axis font size.

Getter:

Gets the horizontal axis font size.

Setter:

Sets the horizontal axis font size.

Type:

int

property horizontalAxisReference#

Attribute to get and set the horizontal axis reference.

Getter:

Gets the horizontal axis reference.

Setter:

Sets the horizontal axis reference.

Type:

float

property horizontalAxisScaleType#

Attribute to get and set the horizontal axis scale type. Options available for the scale types are “linear”, “log”, “db20”, “db10”

Getter:

Gets the horizontal axis scale type.

Setter:

Sets the horizontal axis scale type.

Type:

str

property horizontalAxisText#

Attribute to get and set the horizontal axis text.

Getter:

Gets the horizontal axis text.

Setter:

Sets the horizontal axis text.

Type:

str

property horizontalAxisWeighting#

Attribute to get and set the horizontal axis weighting. Options available for weighting are “none”, “a”, “b”, “c”, “u”

Getter:

Gets the horizontal axis weighting.

Setter:

Sets the horizontal axis weighting.

Type:

str

property legendFont#

Attribute to get and set the legend font.

Getter:

Gets the legend font.

Setter:

Sets the legend font.

Type:

hw.font

property legendFontSize#

Attribute to get and set the legend font size.

Getter:

Gets the legend font size.

Setter:

Sets the legend font size.

Type:

int

property legendPlacement#

Attribute to get and set the label placement position.Options available are “insidelefttop”, “insideleftbottom”, “insiderighttop”, “insiderightbottom”, “outsidetop”, “outsidebottom”, “outsideleft”, “outsideright”

Getter:

Gets the label placement.

Setter:

Sets the label placement.

Type:

bool

property legendVisibility#

Attribute to get and set the label visibility.

Getter:

Gets the label visibility.

Setter:

Sets the label visibility.

Type:

bool

property name#

Attribute to get the name for the CreateCurvesOptions object.

Getter:

Gets the name of the CreateCurvesOptions.

Type:

str

property pageFont#

Attribute to get or set the page font.

Getter:

Returns the page font.

Setter:

Sets the page font.

Type:

hw.font object

property pageFontSize#

Attribute to get or set the page font size.

Getter:

Returns the page font size.

Setter:

Sets the page font size.

Type:

int

property pagePublishTitle#

Attribute to publish the page title

Getter:

Returns the boolean flag indicating whether the page title is published.

Setter:

Sets the boolean flag indicating whether the page title is published.

Type:

bool

property pageTitle#

Attribute to get or set the page title.

Getter:

Returns the page title.

Setter:

Sets the page title to a new value.

Type:

str

property pageTitleScheme#

Attribute to get or set the page title scheme.

Getter:

Returns the page title scheme.

Setter:

Sets the page title scheme to a new value. Use either “default” or “custom”.

Type:

str

property verticalAxisFont#

Attribute to get and set the vertical axis font.

Getter:

Gets the vertical axis font.

Setter:

Sets the vertical axis font.

Type:

hw.font

property verticalAxisFontSize#

Attribute to get and set the vertical axis font size.

Getter:

Gets the vertical axis font size.

Setter:

Sets the vertical axis font size.

Type:

int

property verticalAxisReference#

Attribute to get and set the vertical axis reference.

Getter:

Gets the vertical axis reference.

Setter:

Sets the vertical axis reference.

Type:

float

property verticalAxisScaleType#

Attribute to get and set the vertical axis scale type. Options available for the scale types are “linear”, “log”, “db20”, “db10”

Getter:

Gets the vertical axis scale type.

Setter:

Sets the vertical axis scale type.

Type:

str

property verticalAxisText#

Attribute to get and set the vertical axis text.

Getter:

Gets the vertical axis text.

Setter:

Sets the vertical axis text.

Type:

str

property verticalAxisWeighting#

Attribute to get and set the vertical axis weighting. Options available for weighting are “none”, “a”, “b”, “c”, “u”

Getter:

Gets the vertical axis weighting.

Setter:

Sets the vertical axis weighting.

Type:

str

CurveXY class#

class CurveXY(window: int | Window | None = None, page: int | str | Page | None = None, id: int | str = 0, id_type: str | None = None, **kwargs)#

A class representing a Curve in XY Chart. Create a CurveXY for the given window and page. Raises an Exception if those parameters do not point to a valid HyperGraph XY plot (Line Chart) window.

Parameters:
  • window (Union[int, Window]) – The window of the curve.

  • page (Union[int, Page]) – The page of the curve.

setAttributes(**kwargs)#

Set the attributes for CurveXY.

Parameters:

kwargs (dict) – Attributes of CurveXY to set.

Raises:

ValueError – If an invalid attribute is provided.

property label: str#

Sets the label for the curve.

property labelAsDisplayed: str#

Gets the label as it is displayed.

property layer: int#

Sets the layer ID of the curve.

property lineColor: Color#

Sets the color of the line.

property lineStyle: int#

Sets the style of the line.

property lineThickness: int#

Sets the line thickness of the curve.

property prefix: str#

Sets the prefix for the label.

property prefixAsDisplayed: str#

Sets the prefix as it is displayed.

property reference: bool#

Sets a reference for the curve.

property shadeAlpha: float#

Sets the alpha value for shading.

property shadeArea: bool#

Sets the shaded area for the curve.

property shadeColor: Color#

Sets the color for shading.

property shadeSecondCurve: str#

Sets the second curve for shading.

property shadeStyle: str#

Sets the style for shading.

property showLabel: bool#

Controls the visibility of the label.

property showPrefix: bool#

Controls the visibility of the prefix.

property showSuffix: bool#

Controls the visibility of the suffix.

property suffix: str#

Sets the suffix for the label.

property suffixAsDisplayed: str#

Sets the suffix as it is displayed.

property symbolColor: Color#

Sets the symbol color of the curve.

property symbolFrequency: int#

Sets the frequency of the symbol.

property symbolScaleSize: float#

Sets the scale size of the symbol.

property symbolStyle: int#

Sets the style of the symbol.

property visibility: bool#

Controls the visibility of the curve.

property xAxisAssignment: str#

Sets the axis assignment for the X-datasource (vector).

property xComponent: str#

Sets the component for the X-datasource (vector).

property xDataType: str#

Sets the data type for the X-datasource (vector).

property xExpression: str#

Sets the expression for the X-datasource (vector).

property xFile: str#

Sets the file for the X-datasource (vector).

property xFirstValue: float#

Sets the first value for the X-datasource (vector).

property xFreeze: bool#

Freezes the X-datasource (vector).

property xMaximum: float#

Sets the maximum value for the X-datasource (vector).

property xMinimum: float#

Sets the minimum value for the X-datasource (vector).

property xOffset: float#

Sets the X-offset for the X-datasource (vector).

property xRequest: str#

Sets the X-request for the X-datasource (vector).

property xScale: float#

Sets the scale for the X-datasource (vector).

property xSource: str#

Sets the source for the X-datasource (vector).

property xSubcase: str#

Sets the subcase for the X-datasource (vector).

property xUnitsMeasure: str#

Sets the units of measure for the X-datasource (vector).

property xUnitsType: str#

Sets the units type for the X-datasource (vector).

property xUserExpression: str#

Sets the user expression for the X-datasource (vector).

property yAxisAssignment: str#

Sets the axis assignment for the Y-datasource (vector).

property yComponent: str#

Sets the Y-component for the Y-datasource (vector).

property yDataType: str#

Sets the data type for the Y-datasource (vector).

property yExpression: str#

Sets the expression for the Y-datasource (vector).

property yFile: str#

Sets the file for the Y-datasource (vector).

property yFirstValue: float#

Sets the first value for the Y-datasource (vector).

property yFreeze: bool#

Freezes the Y-datasource (vector).

property yMaximum: float#

Sets the maximum value for the Y-datasource (vector).

property yMinimum: float#

Sets the minimum value for the Y-datasource (vector).

property yOffset: float#

Sets the offset for the Y-datasource (vector).

property yRequest: str#

Sets the request for the Y-datasource (vector).

property yScale: float#

Sets the scale for the Y-datasource (vector).

property ySource: str#

Sets the source for the Y-datasource (vector).

property ySubcase: str#

Sets the subcase for the Y-datasource (vector).

property yUnitsMeasure: str#

Sets the units of measure for the Y-datasource (vector).

property yUnitsType: str#

Sets the units type for the Y-datasource (vector).

property yUserExpression: str#

Sets the user expression for the Y-datasource (vector).

mathAdd(name, parameter={}, **kwargs)#

Create new instance of stackmath operation and adds an operation to the curve. Raises an Exception parameter does not points to a valid stackmath operation.

Parameters:
  • name (str) – The name of the stackmath operation.

  • parameter (dict) – A dictionary containing parameters for the operation.

  • kwargs (dict) – Additional keyword arguments.

Returns:

New instance of MathXY.

Return type:

MathXY

mathCopy(*args)#

Returns the complete math stack of the curve and its attributes.

Parameters:

args – The list of name/ID of the operation.

Returns:

Complete math stack of the curve and its attributes.

Return type:

dict

mathCut(*args)#

Removes the stackmath operation from the stack and returns a dictionary of all removed operation with attributes.

Parameters:

args – The list of name/ID of stackmath operation to be removed.

Returns:

Complete math stack of the curve and its attributes.

Return type:

dict

mathDown(name)#

Move a stackmath operation one level down. Raises an Exception parameter does not point to a valid stackmath operation.

Parameters:

name (str or int) – The name/ID of the operation.

mathEdit(value, parameter={}, **kwargs)#

Edit the attributes of a stackmath operation. Raises an Exception parameter does not point to a valid stackmath operation.

Parameters:
  • value – The name/ID/MathXY object of the operation.

  • parameter (dict) – A dictionary containing parameters for the operation.

  • kwargs (dict) – Additional keyword arguments.

Returns:

None

Return type:

None

mathGetParameters(name)#

Returns all the attributes of the stackmath operation. Raises an Exception parameter does not point to a valid stackmath operation.

Parameters:

name (str or int) – The name/ID of the operation.

Returns:

All the attributes of the stackmath operation.

Return type:

dict

mathPaste(inputdict, after=-1)#

Creates stackmath operation from the math Dictionary and add it to the end of stack or after a ID.

Parameters:
  • inputdict – The dict of stackmath operation and attributes.

  • after – The name/ID of the operation after which we need to add the new inputdict.

mathRemove(val: str | int)#

Removes a stackmath operation. Raises an Exception parameter does not point to a valid stackmath operation.

Parameters:

val – The name/ID of the operation.

mathRemoveAll()#

Removes all stackmath operation.

mathUp(name)#

Move a stackmath operation one level up. Raises an Exception parameter does not point to a valid stackmath operation.

Parameters:

name (str or int) – The name/ID of the operation.

property id: int#

Returns the ID.

property mathRef: str#

The math-reference of the curve.

Getter:

Math reference of the curve.

Type:

str

property page: Page#

Returns the Page Object.

property window: Window#

Returns the Window Object.

property xValues: list#

The x values of the curve.

Getter:

Returns x values of the curve.

Setter:

Sets x values of the curve.

Type:

list

property xyValues#

The x and y values of the curve.

Getter:

Returns x and y values of the curve.

Type:

tuple

property yValues: list#

The y values of the curve.

Getter:

Returns y values of the curve.

Setter:

Sets y values of the curve.

Type:

list

CurveComplex class#

class CurveComplex(window: int | Window | None = None, page: int | str | Page | None = None, id: int | str = 0, id_type: str | None = None, **kwargs)#

A class representing a Curve in Complex Chart.Create a CurveComplex for the given window and page. Raises a Exception parmater doesn’t points to a valid Hypergraph Plot window

Parameters:
  • window ((Union[int, Window])) – The window of the curve.

  • page ((Union[int, Page])) – The page of the curve.

setAttributes(**kwargs)#

Set the attributes for CurveComplex.

Parameters:

kwargs (dict) – Attributes of CurveComplex to set.

Raises:

ValueError – If an invalid attribute is provided.

property label: str#

Sets the label for the curve.

property labelAsDisplayed: str#

Gets the label as it is displayed.

property layer: int#

Sets the layer ID of the curve.

property lineColor: Color#

Sets the color of the line.

property lineStyle: int#

Sets the style of the line.

property lineThickness: int#

Sets the line thickness of the curve.

property prefix: str#

Sets the prefix for the label.

property prefixAsDisplayed: str#

Gets the prefix as it is displayed.

property shadeAlpha: float#

Sets the alpha value for shading.

property shadeArea: bool#

Sets the shaded area for the curve.

property shadeColor: Color#

Sets the color for shading.

property shadeSecondCurve: str#

Sets the second curve for shading.

property shadeStyle: str#

Sets the style for shading.

property showLabel: bool#

Controls the visibility of the label.

property showPrefix: bool#

Controls the visibility of the prefix.

property showSuffix: bool#

Controls the visibility of the suffix.

property suffix: str#

Sets the suffix for the label.

property suffixAsDisplayed: str#

Gets the suffix as it is displayed.

property symbolColor: Color#

Sets the symbol color of the curve.

property symbolFrequency: int#

Sets the frequency of the symbol.

property symbolScaleSize: float#

Sets the scale size of the symbol.

property symbolStyle: int#

Sets the style of the symbol.

property visibility: bool#

Controls the visibility of the curve.

property xAxisAssignment: str#

Sets the axis assignment for the X-datasource (vector).

property xComponent: str#

Sets the component for the X-datasource (vector).

property xDataType: str#

Sets the data type for the X-datasource (vector).

property xExpression: str#

Sets the expression for the X-datasource (vector).

property xFile: str#

Sets the file for the X-datasource (vector).

property xFirstValue: float#

Sets the first value for the X-datasource (vector).

property xFreeze: bool#

Freezes the X-datasource (vector).

property xMaximum: float#

Gets the maximum value for the X-datasource (vector).

property xMinimum: float#

Gets the minimum value for the X-datasource (vector).

property xOffset: float#

Sets the X-offset for the X-datasource (vector).

property xRequest: str#

Sets the X-request for the X-datasource (vector).

property xScale: float#

Sets the scale for the X-datasource (vector).

property xSource: str#

Sets the source (‘file’, ‘math’ or ‘value’) for the X-datasource (vector).

property xSubcase: str#

Sets the subcase for the X-datasource (vector).

property xUnitsMeasure: str#

Sets the units of measure for the X-datasource (vector).

property xUnitsType: str#

Gets the units type for the X-datasource (vector).

property xUserExpression: str#

Sets the user expression for the X-datasource (vector).

property ypAxisAssignment: str#

Sets the axis assignment for the YP-datasource (vector).

property ypComponent: str#

Sets the YP-component for the YP-datasource (vector).

property ypDataType: str#

Sets the data type for the YP-datasource (vector).

property ypExpression: str#

Sets the expression for the YP-datasource (vector).

property ypFile: str#

Sets the file for the YP-datasource (vector).

property ypFirstValue: float#

Sets the first value for the YP-datasource (vector).

property ypFreeze: bool#

Freezes the YP-datasource (vector).

property ypMaximum: float#

Gets the maximum value for the YP-datasource (vector).

property ypMinimum: float#

Gets the minimum value for the YP-datasource (vector).

property ypOffset: float#

Sets the offset for the YP-datasource (vector).

property ypRequest: str#

Sets the request for the YP-datasource (vector).

property ypScale: float#

Sets the scale for the YP-datasource (vector).

property ypSource: str#

Sets the source (‘file’, ‘math’ or ‘value’) for the YP-datasource (vector).

property ypSubcase: str#

Sets the subcase for the YP-datasource (vector).

property ypUnitsMeasure: str#

Sets the units of measure for the YP-datasource (vector).

property ypUnitsType: str#

Gets the units type for the YP-datasource (vector).

property ypUserExpression: str#

Sets the user expression for the YP-datasource (vector).

property ymAxisAssignment: str#

Sets the axis assignment for the YM-datasource (vector).

property ymComponent: str#

Sets the YM-component for the YM-datasource (vector).

property ymDataType: str#

Sets the data type for the YM-datasource (vector).

property ymExpression: str#

Sets the expression for the YM-datasource (vector).

property ymFile: str#

Sets the file for the YM-datasource (vector).

property ymFirstValue: float#

Sets the first value for the YM-datasource (vector).

property ymFreeze: bool#

Freezes the YM-datasource (vector).

property ymMaximum: float#

Gets the maximum value for the YM-datasource (vector).

property ymMinimum: float#

Gets the minimum value for the YM-datasource (vector).

property ymOffset: float#

Sets the offset for the YM-datasource (vector).

property ymRequest: str#

Sets the request for the YM-datasource (vector).

property ymScale: float#

Sets the scale for the YM-datasource (vector).

property ymSource: str#

Sets the source (‘file’, ‘math’ or ‘value’) for the YM-datasource (vector).

property ymSubcase: str#

Sets the subcase for the YM-datasource (vector).

property ymUnitsMeasure: str#

Sets the units of measure for the YM-datasource (vector).

property ymUnitsType: str#

Gets the units type for the YM-datasource (vector).

property ymUserExpression: str#

Sets the user expression for the YM-datasource (vector).

property yrAxisAssignment: str#

Sets the axis assignment for the YR-datasource (vector).

property yrComponent: str#

Sets the YR-component for the YR-datasource (vector).

property yrDataType: str#

Sets the data type for the YR-datasource (vector).

property yrExpression: str#

Sets the expression for the YR-datasource (vector).

property yrFile: str#

Sets the file for the YR-datasource (vector).

property yrFirstValue: float#

Sets the first value for the YR-datasource (vector).

property yrFreeze: bool#

Freezes the YR-datasource (vector).

property yrMaximum: float#

Gets the maximum value for the YR-datasource (vector).

property yrMinimum: float#

Gets the minimum value for the YR-datasource (vector).

property yrOffset: float#

Sets the offset for the YR-datasource (vector).

property yrRequest: str#

Sets the request for the YR-datasource (vector).

property yrScale: float#

Sets the scale for the YR-datasource (vector).

property yrSource: str#

Sets the source (‘file’, ‘math’ or ‘value’) for the YR-datasource (vector).

property yrSubcase: str#

Sets the subcase for the YR-datasource (vector).

property yrUnitsMeasure: str#

Sets the units of measure for the YR-datasource (vector).

property yrUnitsType: str#

Gets the units type for the YR-datasource (vector).

property yrUserExpression: str#

Sets the user expression for the YR-datasource (vector).

property yiAxisAssignment: str#

Sets the axis assignment for the YI-datasource (vector).

property yiComponent: str#

Sets the YI-component for the YI-datasource (vector).

property yiDataType: str#

Sets the data type for the YI-datasource (vector).

property yiExpression: str#

Sets the expression for the YI-datasource (vector).

property yiFile: str#

Sets the file for the YI-datasource (vector).

property yiFirstValue: float#

Sets the first value for the YI-datasource (vector).

property yiFreeze: bool#

Freezes the YI-datasource (vector).

property yiMaximum: float#

Gets the maximum value for the YI-datasource (vector).

property yiMinimum: float#

Gets the minimum value for the YI-datasource (vector).

property yiOffset: float#

Sets the offset for the YI-datasource (vector).

property yiRequest: str#

Sets the request for the YI-datasource (vector).

property yiScale: float#

Sets the scale for the YI-datasource (vector).

property yiSource: str#

Sets the source (‘file’, ‘math’ or ‘value’) for the YI-datasource (vector).

property yiSubcase: str#

Sets the subcase for the YI-datasource (vector).

property yiUnitsMeasure: str#

Sets the units of measure for the YI-datasource (vector).

property yiUnitsType: str#

Gets the units type for the YI-datasource (vector).

property yiUserExpression: str#

Sets the user expression for the YI-datasource (vector).

property id: int#

Returns the ID.

property mathRef: str#

The math-reference of the curve

Getter:

math reference of the curve.

Type:

str

property page: Page#

Returns the Page Object.

property window: Window#

Returns the Window Object.

property xValues: list#

The x values of the complex curve.

Getter:

Returns x values of the complex curve.

Setter:

Sets x values of the complex curve.

Type:

list

property y2Values: list#

The y2 values of the complex curve.

Getter:

Returns y2 values of the complex curve.

Setter:

Sets y2 values of the complex curve.

Type:

list

property yiValues: list#

The yi values of the complex curve.

Getter:

Returns yi values of the complex curve.

Setter:

Sets yi values of the complex curve.

Type:

list

property ymValues: list#

The ym values of the complex curve.

Getter:

Returns ym values of the complex curve.

Setter:

Sets ym values of the complex curve.

Type:

list

property ypValues: list#

The yp values of the complex curve.

Getter:

Returns yp values of the complex curve.

Setter:

Sets yp values of the complex curve.

Type:

list

property yrValues: list#

The yr values of the complex curve.

Getter:

Returns yr values of the complex curve.

Setter:

Sets yr values of the complex curve.

Type:

list

CurvePolar class#

class CurvePolar(mode: str = 'pm', window: int | Window | None = None, page: int | str | Page | None = None, id: int | str = 0, id_type: str | None = None, **kwargs)#

A class representing a Curve in Polar Chart. Creates a CurvePolar for the given window and page. Raises an Exception if those parameters do not point to a valid HyperGraph Polar Plot window.

Parameters:
  • window (Union[int, Window]) – The window of the curve.

  • page (Union[int, Page]) – The page of the curve.

setAttributes(**kwargs)#

Set the attributes for CurvePolar.

Parameters:

kwargs (dict) – Attributes of CurvePolar to set.

Raises:

ValueError – If an invalid attribute is provided.

property label: str#

Sets the label for the curve.

property labelAsDisplayed: str#

Gets the label as it is displayed.

property layer: int#

Sets the layer ID of the curve.

property lineColor: Color#

Sets the color of the line.

property lineStyle: int#

Sets the style of the line.

property lineThickness: int#

Sets the line thickness of the curve.

property prefix: str#

Sets the prefix for the label.

property prefixAsDisplayed: str#

Gets the prefix as it is displayed.

property showLabel: bool#

Controls the visibility of the label.

property showPrefix: bool#

Controls the visibility of the prefix.

property showSuffix: bool#

Controls the visibility of the suffix.

property suffix: str#

Sets the suffix for the label.

property suffixAsDisplayed: str#

Gets the suffix as it is displayed.

property symbolColor: Color#

Sets the symbol color of the curve.

property symbolFrequency: int#

Sets the frequency of the symbol.

property symbolScaleSize: float#

Sets the scale size of the symbol.

property symbolStyle: int#

Sets the style of the symbol.

property visibility: bool#

Controls the visibility of the curve.

property tiptotailVisibility: bool#

Controls the tip-to-tail visibility of the curve.

property fAxisAssignment: str#

Sets the axis assignment for the F-datasource (vector).

property fComponent: str#

Sets the component for the F-datasource (vector).

property fDataType: str#

Sets the data type for the F-datasource (vector).

property fExpression: str#

Sets the expression for the F-datasource (vector).

property fFile: str#

Sets the file for the F-datasource (vector).

property fFreeze: bool#

Freezes the F-datasource (vector).

property fRequest: str#

Sets the F-request for the F-datasource (vector).

property fSource: str#

Sets the source (‘file’, ‘math’ or ‘value’) for the F-datasource (vector).

property fSubcase: str#

Sets the subcase for the F-datasource (vector).

property fUnitsMeasure: str#

Sets the units of measure for the F-datasource (vector).

property fUnitsType: str#

Gets the units type for the F-datasource (vector).

property fUserExpression: str#

Sets the user expression for the F-datasource (vector).

property ypAxisAssignment: str#

Sets the axis assignment for the YP-datasource (vector).

property ypComponent: str#

Sets the YP-component for the YP-datasource (vector).

property ypDataType: str#

Sets the data type for the YP-datasource (vector).

property ypExpression: str#

Sets the expression for the YP-datasource (vector).

property ypFile: str#

Sets the file for the YP-datasource (vector).

property ypFirstValue: float#

Sets the first value for the YP-datasource (vector).

property ypFreeze: bool#

Freezes the YP-datasource (vector).

property ypMaximum: float#

Gets the maximum value for the YP-datasource (vector).

property ypMinimum: float#

Gets the minimum value for the YP-datasource (vector).

property ypOffset: float#

Sets the offset for the YP-datasource (vector).

property ypRequest: str#

Sets the request for the YP-datasource (vector).

property ypScale: float#

Sets the scale for the YP-datasource (vector).

property ypSource: str#

Sets the source (‘file’, ‘math’ or ‘value’) for the YP-datasource (vector).

property ypSubcase: str#

Sets the subcase for the YP-datasource (vector).

property ypUnitsMeasure: str#

Sets the units of measure for the YP-datasource (vector).

property ypUnitsType: str#

Gets the units type for the YP-datasource (vector).

property ypUserExpression: str#

Sets the user expression for the YP-datasource (vector).

property ymAxisAssignment: str#

Sets the axis assignment for the YM-datasource (vector).

property ymComponent: str#

Sets the YM-component for the YM-datasource (vector).

property ymDataType: str#

Sets the data type for the YM-datasource (vector).

property ymExpression: str#

Sets the expression for the YM-datasource (vector).

property ymFile: str#

Sets the file for the YM-datasource (vector).

property ymFirstValue: float#

Sets the first value for the YM-datasource (vector).

property ymFreeze: bool#

Freezes the YM-datasource (vector).

property ymMaximum: float#

Gets the maximum value for the YM-datasource (vector).

property ymMinimum: float#

Gets the minimum value for the YM-datasource (vector).

property ymOffset: float#

Sets the offset for the YM-datasource (vector).

property ymRequest: str#

Sets the request for the YM-datasource (vector).

property ymScale: float#

Sets the scale for the YM-datasource (vector).

property ymSource: str#

Sets the source (‘file’, ‘math’ or ‘value’) for the YM-datasource (vector).

property ymSubcase: str#

Sets the subcase for the YM-datasource (vector).

property ymUnitsMeasure: str#

Sets the units of measure for the YM-datasource (vector).

property ymUnitsType: str#

Gets the units type for the YM-datasource (vector).

property ymUserExpression: str#

Sets the user expression for the YM-datasource (vector).

property yrAxisAssignment: str#

Sets the axis assignment for the YR-datasource (vector).

property yrComponent: str#

Sets the YR-component for the YR-datasource (vector).

property yrDataType: str#

Sets the data type for the YR-datasource (vector).

property yrExpression: str#

Sets the expression for the YR-datasource (vector).

property yrFile: str#

Sets the file for the YR-datasource (vector).

property yrFirstValue: float#

Sets the first value for the YR-datasource (vector).

property yrFreeze: bool#

Freezes the YR-datasource (vector).

property yrMaximum: float#

Gets the maximum value for the YR-datasource (vector).

property yrMinimum: float#

Gets the minimum value for the YR-datasource (vector).

property yrOffset: float#

Sets the offset for the YR-datasource (vector).

property yrRequest: str#

Sets the request for the YR-datasource (vector).

property yrScale: float#

Sets the scale for the YR-datasource (vector).

property yrSource: str#

Sets the source (‘file’, ‘math’ or ‘value’) for the YR-datasource (vector).

property yrSubcase: str#

Sets the subcase for the YR-datasource (vector).

property yrUnitsMeasure: str#

Sets the units of measure for the YR-datasource (vector).

property yrUnitsType: str#

Gets the units type for the YR-datasource (vector).

property yrUserExpression: str#

Sets the user expression for the YR-datasource (vector).

property yiAxisAssignment: str#

Sets the axis assignment for the YI-datasource (vector).

property yiComponent: str#

Sets the YI-component for the YI-datasource (vector).

property yiDataType: str#

Sets the data type for the YI-datasource (vector).

property yiExpression: str#

Sets the expression for the YI-datasource (vector).

property yiFile: str#

Sets the file for the YI-datasource (vector).

property yiFirstValue: float#

Sets the first value for the YI-datasource (vector).

property yiFreeze: bool#

Freezes the YI-datasource (vector).

property yiMaximum: float#

Gets the maximum value for the YI-datasource (vector).

property yiMinimum: float#

Gets the minimum value for the YI-datasource (vector).

property yiOffset: float#

Sets the offset for the YI-datasource (vector).

property yiRequest: str#

Sets the request for the YI-datasource (vector).

property yiScale: float#

Sets the scale for the YI-datasource (vector).

property yiSource: str#

Sets the source (‘file’, ‘math’ or ‘value’) for the YI-datasource (vector).

property yiSubcase: str#

Sets the subcase for the YI-datasource (vector).

property yiUnitsMeasure: str#

Sets the units of measure for the YI-datasource (vector).

property yiUnitsType: str#

Gets the units type for the YI-datasource (vector).

property yiUserExpression: str#

Sets the user expression for the YI-datasource (vector).

getXYvalues()#

Method to get the x and y values of the polar curve.

Getter:

Returns x and y values of the polar curve.

Type:

numpy array

property id: int#

Returns the ID.

property mathRef#

The math-reference of the curve

Getter:

math reference of the curve.

Type:

str

property mode#

Method to retrieve the mode of the polar curve.

Getter:

Returns the mode of the polar curve.

Type:

str

property page: Page#

Returns the Page Object.

property window: Window#

Returns the Window Object.

property yiValues#

The yi values of the polar curve.

Getter:

Returns yi values of the polar curve.

Setter:

Sets yi values of the polar curve.

Valuelist:

list

property ymValues#

The ym values of the polar curve.

Getter:

Returns ym values of the polar curve.

Setter:

Sets ym values of the polar curve.

Type:

list

property ypValues#

The yp values of the polar curve.

Getter:

Returns yp values of the polar curve.

Setter:

Sets yp values of the polar curve.

Type:

list

property yrValues#

The yr values of the polar curve.

Getter:

Returns yr values of the polar curve.

Setter:

Sets yr values of the polar curve.

Type:

list

CurveBar class#

class CurveBar(window: int | Window | None = None, page: int | str | Page | None = None, id: int | str = 0, id_type: str | None = None, **kwargs)#

A class representing a Curve in Bar Chart. Creates a CurveBar for the given window and page. Raises an Exception if those parameters do not point to a valid HyperGraph Bar Plot window.

Parameters:
  • window (Union[int, Window]) – The window of the curve.

  • page (Union[int, Page]) – The page of the curve.

setAttributes(**kwargs)#

Set the attributes for CurveBar.

Parameters:

kwargs (dict) – Attributes of CurveBar to set.

Raises:

ValueError – If an invalid attribute is provided.

property label: str#

Sets the label for the curve.

property labelAsDisplayed: str#

Gets the label as it is displayed.

property layer: int#

Sets the layer ID of the curve.

property barColor: Color#

Sets the bar color of the bars.

property barFillStyle: int#

Sets the bar fill style of the bars.

property barViewStyle: str#

Sets the bar view style of the bars.

property reference: bool#

Sets a reference for the curve.

property lineColor: Color#

Sets the color of the line.

property lineStyle: int#

Sets the style of the line.

property lineThickness: int#

Sets the line thickness of the curve.

property prefix: str#

Sets the prefix for the label.

property prefixAsDisplayed: str#

Gets the prefix as it is displayed.

property showLabel: bool#

Controls the visibility of the label.

property showPrefix: bool#

Controls the visibility of the prefix.

property showSuffix: bool#

Controls the visibility of the suffix.

property suffix: str#

Sets the suffix for the label.

property suffixAsDisplayed: str#

Gets the suffix as it is displayed.

property symbolColor: Color#

Sets the symbol color of the curve.

property symbolFrequency: int#

Sets the frequency of the symbol.

property symbolScaleSize: float#

Sets the scale size of the symbol.

property symbolStyle: int#

Sets the style of the symbol.

property valueaxis: bool#

Controls the value axis of the curve.

property visibility: bool#

Controls the visibility of the curve.

property yAxisAssignment: str#

Sets the axis assignment for the Y-datasource (vector).

property yComponent: str#

Sets the Y-component for the Y-datasource (vector).

property yDataType: str#

Sets the data type for the Y-datasource (vector).

property yExpression: str#

Sets the expression for the Y-datasource (vector).

property yFile: str#

Sets the file for the Y-datasource (vector).

property yFirstValue: float#

Sets the first value for the Y-datasource (vector).

property yFreeze: bool#

Freezes the Y-datasource (vector).

property yMaximum: float#

Sets the maximum value for the Y-datasource (vector).

property yMinimum: float#

Sets the minimum value for the Y-datasource (vector).

property yOffset: float#

Sets the offset for the Y-datasource (vector).

property yRequest: str#

Sets the request for the Y-datasource (vector).

property yScale: float#

Sets the scale for the Y-datasource (vector).

property ySource: str#

Sets the source for the Y-datasource (vector).

property ySubcase: str#

Sets the subcase for the Y-datasource (vector).

property yUnitsMeasure: str#

Sets the units of measure for the Y-datasource (vector).

property yUnitsType: str#

Sets the units type for the Y-datasource (vector).

property yUserExpression: str#

Sets the user expression for the Y-datasource (vector).

property yValues: str#

The y values of the curve.

property barViewStyle#

The view style of the bar curve.

Getter:

Returns view style of the complex curve.

Setter:

Sets view style of the complex curve.

Style:

str - desired bar view style. Valid values are ‘bar’ and ‘line’.

property id: int#

Returns the ID.

property mathRef#

The math-reference of the curve

Getter:

math reference of the curve.

Type:

str

property page: Page#

Returns the Page Object.

property window: Window#

Returns the Window Object.

DataFile class#

class DataFile(file: str)#

Class representing a DataFile. Provides methods to interact with the data contained within it. The constructor raises an exception if file name or path is not valid or doesn’t exist.

Parameters:

file (str) – The file name or path for the data file.

setAttributes(**kwargs)#

Set the attributes of the DataFile.

Parameters:

kwargs (dict) – Attributes of DataFile to set.

Raises:

ValueError – If an invalid attribute is provided.

getComponents(datatype: str, includeTime: bool = True, format: str = 'xy')#

Method to get the list of all components for a given datatype.

Getter:

Gets the list of all components for a given datatype.

Type:

list

Parameters:
  • datatype (str) – The name of the data type that is being queried. Components vary by data type. For a list of datatype names, use the method getDataTypes.

  • includeTime (bool) – A param that determines if Time is to be included as a dataType. Defaults to True.

  • format (str) – The chart type for which the components are queried. Options are ‘xy’, ‘complex’, ‘polar’.

getComponentsPerRequest(datatype: str, request: str, includeTime: bool = True, format: str = 'xy')#

Method to get the list of all components for a given datatype and request. It differs from GetComponentList in that it filters out components that are marked by the reader as not containing data.

Getter:

Gets the list of all components for a given datatype and request.

Type:

list

Parameters:
  • datatype (str) – The name of the data type that is being queried. Components vary by datatype.For a list of datatype names, use the method getDataTypes.

  • request (str) – The name of the request to be used as a filter. Components vary by request. For a list of request names, use the method getRequests.

  • includeTime (bool) – A param that determines if Time is to be included as a dataType. Defaults to True.

  • format (str) – The chart type for which the compoenents are queried.

getDataTypes(includeTime: bool = True)#

Method to get the list of all datatypes.

Getter:

Gets the list of all datatypes.

Type:

list

Parameters:

includeTime (bool) – A param that determines if Time is to be included as a dataType. Defaults to True.

getMetaDataLabel(datatype: str, request: str, component: str, metadata: str)#

Method to get the label of the metadata item associated with a file channel.The channel is identified by the datatype, request, and component parameters. These strings are specific to the particular file.

Getter:

Gets the label of the metadata item associated with a file channel.

Type:

str

Parameters:
  • datatype (str) – The name of the data type that is being queried to specify the channel. For a list of datatype names, use the method getDataTypes.

  • request (str) – The name of the request that is being queried to specify the channel. For a list of request names, use the method getRequests.

  • component (str) – The name of the component that is being queried to specify the channel. For a list of component names, use the method getComponents.

  • metadata (str) – The item of data to retrieve.

getMetaDataList(datatype: str, request: str, component: str)#

Method to get the list of meta data items associated with a file channel.The channel is identified by the datatype, request, and component parameters. These strings are specific to the particular file.

Getter:

Gets the list of meta data items associated with a file channel.

Type:

list

Parameters:
  • datatype (str) – The name of the data type that is being queried to get the channel. For a list of datatype names, use the method getDataTypes.

  • request (str) – The name of the request that is being queried to get the channel. For a list of request names, use the method getRequests.

  • component (str) – The name of the component that is being queried to get the channel. For a list of component names, use the method getComponents.

getMetaDataType(datatype: str, request: str, component: str, metadata: str)#

Method to get the type of the metadata item associated with the file channel.The channel is identified by the datatype, request, and component parameters. These strings are specific to the particular file.

Getter:

Gets the type of the metadata item associated with the file channel.

Type:

str

Parameters:
  • datatype (str) – The name of the data type that is being queried to specify the channel. For a list of datatype names, use the method getDataTypes.

  • request (str) – The name of the request that is being queried to specify the channel. For a list of request names, use the method getRequests.

  • component (str) – The name of the component that is being queried to specify the channel. For a list of component names, use the method getComponents.

  • metadata (str) – The item of data to retrieve.

getMetaDataValue(datatype: str, request: str, component: str, metadata: str)#

Method to get an item of meta data associated with a file channel.The channel is identified by the datatype, request, and component parameters. These strings are specific to the particular file.

Getter:

Gets an item of meta data associated with a file channel.

Type:

str

Parameters:
  • datatype (str) – The name of the data type that is being queried to specify the channel. For a list of datatype names, use the method getDataTypes.

  • request (str) – The name of the request that is being queried to specify the channel. For a list of request names, use the method getRequests.

  • component (str) – The name of the component that is being queried to specify the channel. For a list of component names, use the method getComponents.

  • metadata (str) – The item of data to retrieve.

getRequests(datatype: str, includeTime: bool = True)#

Method to get the list of all requests for a given datatype.

Getter:

Gets the list of all requests for a given datatype.

Type:

list

Parameters:
  • datatype (str) – The name of the data type that is being queried. Requests vary by data type. For a list of datatype names, use the method getDataTypes.

  • includeTime (bool) – A param that determines if Time is to be included as a dataType. Defaults to True.

getSubcaseIds()#

Method to get the list of the IDs of all subcases.

Getter:

Gets the list of the IDs of all subcases.

Type:

list

getSubcaseLabels()#

Method to get the list of the labels of all subcases.

Getter:

Gets the list of the labels of all subcases.

Type:

list

getTimeChannelComponent(datatype: str, request: str, component: str)#

Method to get the component name of the time channel associated with a specified data channel.

Getter:

Gets the component name of the time channel associated with a specified data channel.

Type:

str

Parameters:
  • datatype (str) – The name of the data type that is being queried to specify the data channel. For a list of datatype names, use the method getDataTypes.

  • request (str) – The name of the request that is being queried to specify the data channel. For a list of request names, use the method getRequests.

  • component (str) – The name of the component that is being queried to specify the data channel. For a list of component names, use the method getComponents.

getTimeChannelDataType(datatype: str, request: str, component: str)#

Method to get the datatype name of the time channel associated with a specified data channel. The data channel is specified by the datatype, request, and component parameters.

Getter:

Gets the datatype name of the time channel associated with a specified data channel.

Type:

str

Parameters:
  • datatype (str) – The name of the data type that is being queried to get the channel. For a list of datatype names, use the method getDataTypes.

  • request (str) – The name of the request that is being queried to get the channel. For a list of request names, use the method getRequests.

  • component (str) – The name of the component that is being queried to get the channel. For a list of component names, use the method getComponents.

getTimeChannelRequest(datatype: str, request: str, component: str)#

Method to get the request name of the time channel associated with a specified data channel.

Getter:

Gets the request name of the time channel associated with a specified data channel.

Type:

str

Parameters:
  • datatype (str) – The name of the data type that is being queried to specify the data channel. For a list of datatype names, use the method getDataTypes.

  • request (str) – The name of the request that is being queried to specify the data channel. For a list of request names, use the method getRequests.

  • component (str) – The name of the component that is being queried to specify the data channel. For a list of component names, use the method getComponents.

property readerVersion#

The reader version for the data file.

Getter:

Returns the reader version for the data file.

Setter:

Sets the reader version for the data file.

Type:

float

property subcase#

The subcase for the data file.

Getter:

Returns the name of the current subcase.

Setter:

Sets the subcase name or id.

Type:

Union[int, str]

DataFileQuery class#

class DataFileQuery(file: str, dataType: str = '', requests: str | list = [], components: str | list = [], includeTime: str = True, **kwargs)#

Class representing a DataFileQuery for querying data from a file. The constructor raises an exception if file name or path is not valid or doesn’t exist.

Parameters:
  • file (str) – The name or path for the data file.

  • (Optional) (includeTime) – The dataType selected for the data file query. Defaults to empty string.

  • (Optional) – The requests selected for the data file query. Defaults to empty string or list.

  • (Optional) – The components selected for the data file query. Defaults to empty string or list.

  • (Optional) – A param that determines if Time is to be included as a dataType. Defaults to True.

setAttributes(**kwargs)#

Set the attributes of the DataFile.

Parameters:

kwargs (dict) – Attributes of DataFile to set.

Raises:

ValueError – If an invalid attribute is provided.

getChannelInfo()#

Method to get the file channel information for the data file query.

Getter:

Gets the file channel information for the data file query.

Type:

dictionary

run(outputType: str)#

Method to get the data vectors for the data file query.

Getter:

Gets the data vectors for the data file query.

Type:

numpy array or pandas dataframe

Parameters:

outputType (str) – The type of output type (numpy or pandas).

setAttributes(**kwargs)#

Method to set the data file query attributes.

Parameters:

kwargs (dict) – Attributes

property components#

The components for the data file query.

Getter:

Returns the components for the data file query.

Setter:

Sets the components for the data file query. To get all components use the wildcard string ‘all’.

Type:

Union[list, str]

property dataType#

The dataType for the data file query.

Getter:

Returns the dataType for the data file query.

Setter:

Sets the dataType for the data file query.

Type:

str

property includeTime#

The flag that determines if Time is to be included as a dataType.

Getter:

Returns the flag whether time is included.

Setter:

Sets the flag whether time is included.

Type:

str

property readerVersion#

The reader version for the data file query.

Getter:

Returns the reader version for the data file query.

Setter:

Sets the reader version for the data file query.

Type:

float

property requests#

The requests for the data file query.

Getter:

Returns the requests for the data file query.

Setter:

Sets the requests for the data file query. To get all requests use the wildcard string ‘all’.

Type:

Union[list, str]

property sort#

The sorting order for the data file query.

Getter:

Returns the sorting order for the data file query.

Setter:

Sets the sorting order for the data file query. Supported are ‘requestAllComponents’ and ‘componentAllRequests’.

Type:

str

property subcase#

The subcase for the data file query.

Getter:

Returns the subcase for the data file query.

Setter:

Sets the subcase name or id for the data file query.

Type:

Union[int, str]

DatumHorizontal class#

class DatumHorizontal(window: int | Window | None = None, page: int | str | Page | None = None, id: int | str = 0, **kwargs)#

A class representing a DatumHorizontal in XY Chart. Creates a Horizontal Datum for the given window and page. Raises an Exception if those parameters do not point to a valid HyperGraph window.

Parameters:
  • window (Union[int, Window]) – The window of the curve.

  • page (Union[int, Page]) – The page of the curve.

setAttributes(**kwargs)#

Set the attributes of the DatumHorizontal.

Parameters:

kwargs (dict) – Attributes of DatumHorizontal to set.

Raises:

ValueError – If an invalid attribute is provided.

property associatedAxis: str#

Sets the associated axis for the datum.

property font: Font#

Sets the font of the datum label.

property fontSize: int#

Sets the font size of the datum label.

property label: str#

Sets the label (displayed text) of the datum.

property labelAsDisplayed: str#

Gets the label (displayed text) of the datum.

property labelLocation: str#

Sets the label location for the datum. The label location includes: upperLeft, upperCenter, upperRight, lowerLeft, lowerCenter, lowerRight.

property layer: int#

Sets the layer ID of the datum.

property lineColor: Color#

Gets the line color of the datum.

property lineStyle: int#

Sets the line style of the datum.

property lineThickness: int#

Sets the line thickness of the datum.

property name: str#

Sets the title of the datum.

property position: str or float#

Sets the value/expression (position) of the datum.

property positionValue: float#

Gets the value (position) of the datum.

property type: str#

Gets the type of the Datum.

property visibility: bool#

Sets whether the datum is displayed or hidden.

property id: int#

Returns the ID.

property page: Page#

Returns the Page Object.

property window: Window#

Returns the Window Object.

DatumVertical class#

class DatumVertical(window: int | Window | None = None, page: int | str | Page | None = None, id: int | str = 0, **kwargs)#

A class representing a DatumVertical in XY Chart. Creates a Vertical Datum for the given window and page. Raises an Exception if those parameters do not point to a valid HyperGraph window.

Parameters:
  • window (Union[int, Window]) – The window of the curve.

  • page (Union[int, Page]) – The page of the curve.

setAttributes(**kwargs)#

Set the attributes of the DatumVertical.

Parameters:

kwargs (dict) – Attributes of DatumVertical to set.

Raises:

ValueError – If an invalid attribute is provided.

property associatedAxis: str#

Sets the associated axis for the datum.

property font: Font#

Sets the font of the datum label.

property fontSize: int#

Sets the font size of the datum label.

property label: str#

Sets the label (displayed text) of the datum.

property labelAsDisplayed: str#

Gets the label (displayed text) of the datum.

property labelLocation: str#

Sets the label location for the datum. The label location includes: upperLeft, upperCenter, upperRight, lowerLeft, lowerCenter, lowerRight.

property layer: int#

Sets the layer ID of the datum.

property lineColor: Color#

Gets the line color of the datum.

property lineStyle: int#

Sets the line style of the datum.

property lineThickness: int#

Sets the line thickness of the datum.

property name: str#

Sets the title of the datum.

property position: str or float#

Sets the value/expression (position) of the datum.

property positionValue: float#

Gets the value (position) of the datum.

property type: str#

Gets the type of the Datum.

property visibility: bool#

Sets whether the datum is displayed or hidden.

property id: int#

Returns the ID.

property page: Page#

Returns the Page Object.

property window: Window#

Returns the Window Object.

ExportCurves class#

class ExportCurves(**kwargs)#

Bases: object

Class providing functionality to export plot data in several different formats.

export()#

Exports plot data.

isoMmeTrimCurveLabel(startCharacterId, endCharacterId)#

To enter a start and end point to remove data outside of the specified range.

setAttributes(**kwargs)#

Set the attributes of the ExportCurves object.

Parameters:

kwargs (dict) – Attributes of ExportCurves object to set.

Raises:

ValueError – If an invalid attribute is provided.

property exportAxisValues#

Enables the export of original curve values over dB scaled values.

property file#

Attribute to set or get the export file name.

Getter:

Gets the capture image file name.

Setter:

Sets the capture image file name.

Type:

str

property format#

The type of format that you want to set for the export file. The different types include: Excel, Column, XY Data, X GRAPH, Summary, Adams Spline, Altair Binary, CSV Blocks, DAC, RPC, and Excel Europe.

Getter:

Gets the export format.

Setter:

Sets the export format.

Type:

str

property isoMmeDeleteExistingFiles#

Option to delete any existing files in the channel directory upon export.

property range#

The range of curves to export. Valid values include are all, plot, page or a list representing a range of pages.

Header class#

class Header(window: int | Window | None = None, page: int | str | Page | None = None, **kwargs)#

A class representing a Header in XY Chart. Returns a Header for the given window and page. RRaises an Exception if those parameters do not point to a valid HyperGraph window.

Parameters:
  • window (Union[int, Window]) – The window of the curve.

  • page (Union[int, Page]) – The page of the curve.

setAttributes(**kwargs)#

Set the attributes of the Header.

Parameters:

kwargs (dict) – Attributes of Header to set.

Raises:

ValueError – If an invalid attribute is provided.

property alignment: str#

Sets the text alignment for the Header. The options includes: left, right, center.

property color: Color#

Sets the text color of the Header.

property fontPrimary: Font#

Sets the font primary font of the Header.

property fontPrimarySize: int#

Sets the primary font size of the Header.

property fontSecondary: Font#

Sets the secondary font of the Header.

property fontSecondarySize: int#

Sets the secondary font size of the Header.

property fontTertiary: Font#

Sets the tertiary font of the Header.

property fontTertiarySize: int#

Sets the tertiary font size of the Header.

property text: str#

Sets the text of the Header.

property textAsDisplayed: str#

Gets the label (displayed text) of the Header.

property type: str#

Gets the type of the title.

property visibility: bool#

Sets whether the Header is displayed or hidden.

property id: int#

Returns the ID.

property page: Page#

Returns the Page Object.

property window: Window#

Returns the Window Object.

Legend class#

class Legend(window: int | Window | None = None, page: int | str | Page | None = None, **kwargs)#

A class representing a Legend in XY Chart. Returns a Legend for the given window and page. Raises an Exception if those parameters do not point to a valid HyperGraph window.

Parameters:
  • window (Union[int, Window]) – The window of the curve.

  • page (Union[int, Page]) – The page of the curve.

setAttributes(**kwargs)#

Set the attributes of the Legend.

Parameters:

kwargs (dict) – Attributes of Legend to set.

Raises:

ValueError – If an invalid attribute is provided.

property autoPositioning: str#

Automatically positions the legend within the modeling window..

property backgroundColor: Font#

Sets the legend background to the specified color.

property borderColor: int#

Sets the legend border to the specified color.

property borderStyle: int#

Sets the border line style of the legend.

property curveTextColor: int#

Sets the curve color for legend.

property font: int#

Sets the font of the legend.

property fontSize: Color#

Sets the font size of the legend.

property leaderPosition: int#

Sets the leader position for the legend. The leader position includes: left, below, none.

property placement: int#

Sets the legend placement in the modeling window. Options include: insideLeftTopCorner, insideLeftBottomCorner, insideRightTopCorner, insideRightBottomCorner, outsideTop, outsideBottom, outsideLeft, outsideRight, insideUserDefined.

property visibility: bool#

Sets whether the legend is displayed or hidden.

property xCoordinate: int#

Sets the X relative position of the legend.

property yCoordinate: int#

Sets the Y relative position of the legend.

property id: int#

Returns the ID.

property page: Page#

Returns the Page Object.

property window: Window#

Returns the Window Object.

MathXY class#

class MathXY(curve, id: int = 1)#

Returns a stackmath operation object, defined by curve and ID. Raises an Exception if those parameters do not point to a valid curve in a HyperGraph XY plot (Line Chart) window.

Parameters:
  • curve (Union[int, CurveXY]) – The curve for the stackmath operation.

  • id (int) – The id of the stackmath operation.

setAttributes(**kwargs)#

Set the attributes of the stackmath object.

Parameters:

kwargs (dict) – Attributes of stackmath object to set.

Raises:

ValueError – If an invalid attribute is provided.

property curve: CurveXY#

Returns the CurveXY Object.

Getter:

Returns the CurveXY Object.

Type:

CurveXY

property enabled: bool#

Enable/disable stackmath operation.

Getter:

Enable stackmath operation.

Setter:

Disable stackmath operation.

Type:

int

property id: int#

Get the ID of the stackmath operation.

Getter:

Returns the ID.

Type:

int

property operation: bool#

Returns name of the stackmath operation

Getter:

Enable stackmath operation.

MultipleFiles class#

class MultipleFiles(**kwargs)#

Class representing the MultipleFiles. Provides the user to select multiple files with intersecting data (for example, multiple runs of a test) and create a FileSet in the current HyperGraph session. Intersecting data refers to files that contain the same type, request, and component information. The constructor raises an exception if the creation of MultipleFiles fails.

Parameters:

kwargs (dict) – Attributes of the MultipleFiles object.

createFileSet()#

Method to create the File set from the Multiple Files. The method raises an error message for the following cases:

- If the directory path is not specified.
- If the directory path is not valid.
- If the fileList is empty.
- If the none of the files mentioned in the fileSet exists in the directory.
- If the creation of File Set failed.
Getter:

Gets the information for the FileSet created.

Type:

dict

setAttributes(**kwargs)#

Method to set the MultipleFiles attributes.

Parameters:

kwargs (dict) – Attributes

property curveAttributes#

The attribute for selecting the color scheme and line style for the curves. Options available:

- standard: Uses the standard HyperGraph method of cycling through
the eight colors and five line styles available.
- byFile: Uses the standard HyperGraph method of cycling through
the eight colors and five line styles available,
combining and alternating all curves from the file.
- bySelection: Uses the standard HyperGraph method of cycling through
the eight colors and five line styles available, combining
and alternating all curves depending on the selection.
- For one request and “n” components, HyperGraph cycles
through the combination of request and components.
- If “n” requests and one component, HyperGraph cycles
through the combination of component and requests.
- If “n” requests and “n” components, HyperGraph cycles
through the combination of requests and components.
Getter:

Returns the attribute for selecting the color scheme and line style for the curves.

Setter:

Sets the attribute for selecting the color scheme and line style for the curves.

Type:

str

property directory#

The directory path from where the multiple files are to be selected from.

Getter:

Returns the directory path from where the multiple files are to be selected from.

Setter:

Sets the directory path from where the multiple files are to be selected from.

Type:

str

property fileList#

The list of files selected from the directory. The fileList should contain the relative path for the files with respect to directory.

Getter:

Returns the list of files selected from the directory.

Setter:

Sets the list of files selected from the directory.

Type:

list

property ignoreStringFirstAppearanceString#

The attribute to specify the sub string to be ignored in the strings in requests for the MultipleFiles. This attribute is valid only when the ignoreStrings is specified as untilFirstAppearanceOfaString.

Getter:

Returns the sub string to be ignored in the strings in requests for the MultipleFiles.

Setter:

Sets the sub string to be ignored in the strings in requests for the MultipleFiles.

Type:

str

property ignoreStringFirstNcharacters#

The attribute to specify the number of characters to be ignored in the strings in requests for the MultipleFiles. This attribute is valid only when the ignoreStrings is specified as firstNcharacters.

Getter:

Returns the number of characters to be ignored in the strings in requests for the MultipleFiles.

Setter:

Sets the number of characters to be ignored in the strings in requests for the MultipleFiles.

Type:

int

property ignoreStrings#

The attribute to ignore strings in requests for the MultipleFiles. Options available:

- none: Option to not ignore strings in requests.
- untilFirstBlankspace: Option to ignore a string until the first blank space in the string.
- firstNcharacters: Option to ignore the first ‘N’ number of characters in the string.
To specify the number of characters, use the attribute ignoreStringFirstNcharacters.
- untilFirstAppearanceOfaString: Option to ignore the sub string till its first appearance.
To specify the sub string to ignore, use the attribute ignoreStringFirstAppearanceString.
Getter:

Returns the option to ignore strings in requests for the MultipleFiles.

Setter:

Sets the option to ignore strings in requests for the MultipleFiles.

Type:

str

property labelPrefixSuffix#

The label to allow you to add “extensions” to the curve name based on the filename, path, and different directory levels. Options available : [‘none’,’file’,’root’,’path’,’dir1’,’dir2’,’dir3’]

Getter:

Returns the label to allow you to add “extensions” to the curve name.

Setter:

Sets the label to allow you to add “extensions” to the curve name.

Type:

str

property name#

The name for the multiple files set. The default set name is File Selection 1 if not defined.

Getter:

Returns the name for the multiple files set.

Setter:

Sets the name for the multiple files set.

Type:

str

property typePrefixSuffix#

The flag to add the extension type selected to the beginning or end of the standard HyperGraph curve naming convention. Options available : [“prefix”, “suffix”, “none”]

Getter:

Returns the flag to add the extension type selected to the beginning or end of the curve name.

Setter:

Sets the flag to add the extension type selected to the beginning or end of the curve name.

Type:

str

MultipleSubcases class#

class MultipleSubcases(**kwargs)#

Class representing the MultipleSubcases. Provides the user to select multiple subcases with intersecting data (for example, multiple subcases in a simulation file) and create a SubcaseSet in the current HyperGraph session. Intersecting data refers to subcases that contain the same type, request, and component information. The constructor raises an exception if the creation of MultipleSubcases fails.

Parameters:

kwargs (dict) – Attributes of the MultipleSubcases object.

createSubcaseSet()#

Method to create the Subcase set from the file. The method raises an error message for the following cases:

- If the subcase set name is empty.
- If the file path for the subcase set is not specified.
- If the file does not exist.
- If the subcase list is empty.
Getter:

Gets the information for the SubcaseSet created.

Type:

dict

setAttributes(**kwargs)#

Method to set the MultipleSubcases attributes.

Parameters:

kwargs (dict) – Attributes

property attach#

The flag to define if the subcases should be plottet separately or attached in the subcase order. Options available : [“none”, “attachxvectorsonly”, “attachxandyvectors”]

Getter:

Returns the flag if the subcases should be plottet separately or attached in the subcase order.

Setter:

Sets the flag if the subcases should be plottet separately or attached in the subcase order.

Type:

str

property name#

The name for the multiple subcase set. The default set name is Multiple_Subcase_1 if not defined.

Getter:

Returns the name for the multiple subcase set.

Setter:

Sets the name for the multiple subcase set.

Type:

str

property subcaseList#

The list of subcases selected from the file.

Getter:

Returns the list of subcases selected from the file.

Setter:

Sets the list of subcases selected from the file.

Type:

list

property typePrefixSuffix#

The flag to add the extension type selected to the beginning or end of the standard HyperGraph curve naming convention. Options available : [“prefix”, “suffix”, “none”]

Getter:

Returns the flag to add the extension type selected to the beginning or end of the curve name.

Setter:

Sets the flag to add the extension type selected to the beginning or end of the curve name.

Type:

str

Note class#

class Note(window: int | Window | None = None, page: int | str | Page | None = None, id: int | str = 0, **kwargs)#

A class representing a Note in XY Chart. Creates a Note for the given window and page. Raises an Exception if those parameters do not point to a valid HyperGraph window.

Parameters:
  • window (Union[int, Window]) – The window of the curve.

  • page (Union[int, Page]) – The page of the curve.

setAttributes(**kwargs)#

Set the attributes of the Note.

Parameters:

kwargs (dict) – Attributes of Note to set.

Raises:

ValueError – If an invalid attribute is provided.

property alignment: str#

Sets the text alignment for the note to left, right, center.

property attachTo: str#

Sets the attachment method for the note.The attachment can be: window, view, curve, coordinates.

property attachmentCurve: int#

Sets the index of the curve to which the note is attached.

property attachmentPoint: int#

Sets the index of the point on the curve to which the note is attached.

property attachmentXcoordinate: str#

Sets the expression for the x value to which the note is attached.

property attachmentYcoordinate: str#

Sets the expression for the y value to which the note is attached.

property autoPosition: bool#

Sets auto-positioned note

property autoPositionOffset: float#

Sets the padding/distance between notes as a percentage of the screen

property autoPositionStrategy: str#

Sets to specify the relative location of the note.The options can be: noOverlap, aboveLeft, aboveCenter, aboveRight, left, center, right, belowLeft, belowCenter, belowRight.

property backgroundColor: Color#

Sets the background border color of the note.

property borderColor: Color#

Sets the text border color of the note.

property borderThickness: int#

Sets the border thickness of the note.

property curveColor: Color#

Sets the note text color same as curve color.

property font: Font#

Sets the font of the note text.

property fontSize: int#

Sets the font size of the note text.

property format: str#

Sets scientific or fixed format in a note.

property formatScalarValues: bool#

Select this option to format scalar values in a note

property minimized: bool#

Sets note represented with an icon.

property minimizedColor: Color#

Sets the minimized icon color.

property minimizedRadius: float#

Sets the minimized icon radius.

property name: str#

Sets the title of the note.

property notePosition: float#

Sets the position of the note.

property placement: str#

Sets position your note in a specific location within the modeling window. Options include: default, leftTopCorner, leftBottomCorner, rightTopCorner, rightBottomCorner, userDefined.

property positionX: float#

Sets X Coordinate field to enter specific coordinates for the note’s placement

property positionY: float#

Sets Y Coordinate field to enter specific coordinates for the note’s placement

property precision: float#

Sets precision of Scientific or Fixed format in a note.

property text: str#

Sets the unevaluated text of the note.

property textAsDisplayed: str#

Gets the evaluated text of the note.

property textColor: int#

Sets the curve color for legend.

property visibility: bool#

Sets whether the note is displayed or hidden.

property id: int#

Returns the ID.

property page: Page#

Returns the Page Object.

property window: Window#

Returns the Window Object.