.. _user_guide_plotting:

************
Plot results
************

PyDPF-Post 提供了绘制结果的功能。以下是步骤摘要：

#. 使用结果文件加载 :class:`Simulation <ansys.dpf.post.simulation.Simulation>` 对象。
#. 请求一个 :class:`DataFrame <ansys.dpf.post.dataframe.DataFrame>` 对象，以获取感兴趣的标量字段。
#. 使用 :class:`DataFrame <ansys.dpf.post.dataframe.DataFrame>` 对象的绘图方法来呈现它。

随后的章节提供了一些绘图示例。

Total deformation (总变形) 
--------------------------

您可以用以下方法绘制总变形（位移矢量场的法线）图：

.. code:: python

    # 实例化 solution 对象

    >>> from ansys.dpf import post
    >>> from ansys.dpf.post import examples
    >>> simulation = post.load_simulation(examples.download_crankshaft())

    # 实例化包含位移范数数据的 DataFrame 对象

    >>> displacement_norm = simulation.displacement(norm=True)

    # 绘制数据并保存图像

    >>> displacement_norm.plot(screenshot="crankshaft_disp.png")

.. figure:: ./../images/crankshaft_disp.png
    :width: 300pt

Normal stresses 
-----------------

目前还无法绘制高斯点的原始数据。不过，您可以绘制节点或单元的平均数据。您可以使用以下方法绘制节点 xx 分量应力图：

.. code:: python

    # 实例化 solution 对象

    >>> from ansys.dpf import post
    >>> from ansys.dpf.post import examples
    >>> simulation = post.load_simulation(examples.download_crankshaft())

    # 提取 XX 应力数据

    >>> stress_xx = simulation.stress_nodal(components=["XX"])

    # 绘制数据并保存图像
    
    >>> stress_xx.plot(screenshot="crankshaft_stress_xx.png")

.. figure:: ./../images/crankshaft_stress_xx.png
    :width: 300pt