`App`#

class ansys.mechanical.core.embedding.app.App(db_file=None, private_appdata=False, **kwargs)#: Mechanical embedding Application.

Overview#

Methods

`open`	Open the db file.
`save`	Save the project.
`save_as`	Save the project as.
`new`	Clear to a new application.
`close`	Close the active project.
`exit`	Exit the application.
`execute_script`	Execute the given script with the internal IronPython engine.
`plotter`	Return `ansys.tools.visualization_interface.Plotter` object.
`plot`	Visualize the model in 3d.
`update_globals`	Use to update globals variables.
`print_tree`	Print the hierarchical tree representation of the Mechanical project structure.

Properties

`version`	Returns the version of the app.
`poster`	Returns an instance of Poster.
`DataModel`	Return the DataModel.
`ExtAPI`	Return the ExtAPI object.
`Tree`	Return the Tree object.
`Model`	Return the Model object.
`Graphics`	Return the Graphics object.
`readonly`	Return whether the Mechanical object is read-only.

Attributes

configuration

Special methods

`__repr__`	Get the product info.
`__enter__`	Enter the scope.
`__exit__`	Exit the scope.

Import detail#

from ansys.mechanical.core.embedding.app import App

Property detail#

property App.version#: Returns the version of the app.

property App.poster: ansys.mechanical.core.embedding.poster.Poster#: Returns an instance of Poster.

property App.DataModel#: Return the DataModel.

property App.ExtAPI#: Return the ExtAPI object.

property App.Tree#: Return the Tree object.

property App.Model#: Return the Model object.

property App.Graphics#: Return the Graphics object.

property App.readonly#: Return whether the Mechanical object is read-only.

Attribute detail#

App.configuration#

Method detail#

App.__repr__()#: Get the product info.

App.__enter__()#: Enter the scope.

App.__exit__(exc_type, exc_val, exc_tb)#: Exit the scope.

App.open(db_file)#: Open the db file.

App.save(path=None)#: Save the project.

App.save_as(path)#: Save the project as.

App.new()#: Clear to a new application.

App.close()#: Close the active project.

App.exit()#: Exit the application.

App.execute_script(script: str) → Any#: Execute the given script with the internal IronPython engine.

App.plotter() → None#: Return ansys.tools.visualization_interface.Plotter object.

App.plot() → None#

Visualize the model in 3d.

Requires installation using the viz option. E.g. pip install ansys-mechanical-core[viz]

App.update_globals(globals_dict: Dict[str, Any], enums: bool = True) → None#

Use to update globals variables.

When scripting inside Mechanical, the Mechanical UI will automatically set global variables in python. PyMechanical can not do that automatically, but this method can be used. app.update_globals(globals())

By default, all enums will be imported too. To avoid including enums, set the enums argument to False.

App.print_tree(node=None, max_lines=80, lines_count=0, indentation='')#

Print the hierarchical tree representation of the Mechanical project structure.

Parameters:

node: DataModel object, optional: The starting object of the tree.
max_lines: int, optional: The maximum number of lines to print. Default is 80. If set to -1, no limit is applied.

Raises:

AttributeError: If the node does not have the required attributes.

Examples

>>> import ansys.mechanical.core as mech
>>> app = mech.App()
>>> app.update_globals(globals())
>>> app.print_tree()
... ├── Project
... |  ├── Model
... |  |  ├── Geometry Imports
... |  |  ├── Geometry
... |  |  ├── Materials
... |  |  ├── Coordinate Systems
... |  |  |  ├── Global Coordinate System
... |  |  ├── Remote Points
... |  |  ├── Mesh

>>> app.print_tree(Model, 3)
... ├── Model
... |  ├── Geometry Imports
... |  ├── Geometry
... ... truncating after 3 lines

>>> app.print_tree(max_lines=2)
... ├── Project
... |  ├── Model
... ... truncating after 2 lines

App#