Access results#

In addition to being the entry point for browsing the contents of a result file, the Solution object provides access to the results themselves. The results are contained in Result objects, which can be returned from dedicated methods.

Here is how you get the displacement result:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Instantiate the displacement result object

>>> displacement = solution.displacement()
>>> # stress, elastic_strain (...) can also be called.

See the following list for the result objects that can be
instantiated.

You can use keyword arguments to further specify other options, including the result type, scope, and time. For detailed examples, see Result keywords.

DPF-Post supports two types of result files:

  • Structural (RST)

  • Thermal/electric (RTH)

Once loaded into a Solution object, a result file offers a variety of Result objects, depending on its type.

You should request only Result objects that are available in a result file. To determine which Result objects are available, see Browse result metadata.

Structural result files#

After loading a Solution object from a structural analysis result (RST) file, you can query these Result objects:

  • displacement

  • stress

  • elastic_strain

  • plastic_strain

  • structural_temperature

Displacement#

Displacement is the DOF solution for a structural analysis. The location argument for a DOF solution must be modal.

You can access the Displacement result object with:

# Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Instantiate the displacement result object

>>> displacement = solution.displacement()

The displacement Result object corresponds to a vector field. To obtain the scalar components (y-components) of this field, access the subresult with:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Instantiate the displacement result object

>>> displacement = solution.displacement()

Get the y displacement result data

>>> u_y = displacement.y
>>> u_y.get_data_at_field()

For more information, see ResultData class.

Stress#

You can access the Stress result object with:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

# Instantiate the stress result object

>>> stress = solution.stress()

A Stress result object corresponds to a tensor field. To obtain the scalar components of this field, such as the normal y-stresses, access the subresult:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Instantiate the stress result object

>>> stress = solution.stress()

Get the yy stress result data

>>> s_yy = stress.yy
>>> s_yy.get_data_at_field()

You can query other components, as well as whole tensor data, accordingly. For more information, see ResultData class.

Strain (elastic, plastic)#

You can access the ElasticStrain and PlasticStrain result objects with:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Instantiate the strain result objects

>>> elastic_strain = solution.elastic_strain()
>>> plastic_strain = solution.plastic_strain()

A Strain result object corresponds to a tensor field. To obtain the scalar components of this field, such as the shear xy-strains, access the subresult:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Instantiate the elastic strain result object

>>> elastic_strain = solution.elastic_strain()

Get the xy elastic strain result data

>>> e_yy = elastic_strain.xy
>>> e_yy.get_data_at_field()

You can query other components, as well as whole tensor data, accordingly. For more information, see ResultData class.

Structural temperature#

You can access the StructuralTemperature result object with:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Instantiate the structural temperature result object

>>> structural_temperature = solution.structural_temperature()

To access the temperature scalar field, use the following:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Instantiate the structural temperature result object

>>> structural_temperature = solution.structural_temperature()

Get the structural temperature result data

>>> temperature = structural_temperature.scalar
>>> temperature.get_data_at_field()

Miscellaneous results#

The Solution object might contain other miscellaneous ansys.dpf.post.misc_results.MecanicMisc result objects that you can access. For example, you can access the nodal_acceleration result object:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Get the nodal acceleration result data

>>> acceleration = solution.misc.nodal_acceleration()

All keyword arguments are available for miscellaneous results, except location. For more information, see Result keywords.

Some subresults might may be available as keyword arguments, such as the scalar components of nodal acceleration:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Get the result data

>>> acceleration = solution.misc.nodal_acceleration(subresult="Y")

To determine available queries, you can browse the metadata in the result file. For more information, see Browse result metadata.

Thermal/electric result files#

After loading a Solution object from a thermal/electric analysis result file (RTH), you can query these Result objects:

  • temperature

  • heat_flux

  • electric_field

  • electric_potential

Temperature#

Temperature is the DOF solution for a thermal analysis.

You can access the Temperature result object with:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.steady_therm)

Instantiate the temperature result object

>>> temperature = solution.temperature()

As inferred above, the location argument for a DOF solution must be nodal. You can access the scalar field directly:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Instantiate the temperature result object

>>> temperature = solution.temperature()

Get the y temperature result data

>>> temp = temperature.scalar
>>> temp.get_data_at_field()

Heat flux#

You can access the HeatFlux result object with:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.steady_therm)

Instantiate the heat_flux result object

>>> heat_flux = solution.heat_flux()

The HeatFlux result object corresponds to a vector field. To obtain the scalar components (x-components) of this field, access the subresult:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Instantiate the temperature result object

>>> heat_flux = solution.heat_flux()

Get the y heat_flux result data

>>> heat_flux_x = heat_flux.x
>>> heat_flux_x.get_data_at_field()

You can query other components accordingly. For more information, see ResultData class.

Electric field#

You can access the ElectricField result object with:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.electric_therm)

Instantiate the electric field result object

>>> electric_field = solution.electric_field()

The `electric_field result object corresponds to a vector field. To obtain the scalar components of this field, such as the x-components, access the subresult:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Instantiate the electric field result object

>>> electric_field = solution.electric_field()

Get the y electricfield result data

>>> electric_field_x = electric_field.x
>>> electric_field_x.get_data_at_field()

For more information, see ResultData class.

Electric potential#

You can access the ElectricPotential result object with:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.steady_therm)

Instantiate the electric potential result object

>>> electric_potential = solution.electric_potential()

The electric_potential result object corresponds to a scalar field. You can access its values with:

Instantiate the solution object

>>> from ansys.dpf import post
>>> from ansys.dpf.post import examples
>>> solution = post.load_solution(examples.multishells_rst)

Instantiate the electric potential result object

>>> electric_potential = solution.electric_potential()

Get the y electric potential result data

>>> ep = electric_potential.scalar
>>> ep.get_data_at_field()