Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
  • Welcome
  • Products
  • Support
  • About
  • More
  • Cancel
GeoStudio | PLAXIS
  • Product Communities
GeoStudio | PLAXIS
GeoStudio | PLAXIS Wiki Export and format plots from PLAXIS Output
    • Sign In
    • -Geotechnical Analysis Wiki
      • +GeoStudio
      • -PLAXIS
        • +Software and License - PLAXIS
        • +Documentation - PLAXIS
        • +API / Python scripting - PLAXIS
        • +Known issues - PLAXIS
        • +Models - PLAXIS
        • -Tips and Tricks
          • 3D Extrusion along a curved path
          • 3D Output: show results for shadings or contour lines
          • 64 bit User Defined Soil model
          • After a consolidation analysis I have excess pore pressures in "drained" material sets. Why?
          • An error occurred in the application – What to do
          • Application of commands: echo
          • Application of commands: Groupfiltered and Apply
          • Application of commands: Referring to objects through their index
          • Calculation Kernel Convergence log
          • Can I import a geometry in PLAXIS 2D?
          • Can I reuse existing PLAXIS 3D geometrical objects in a new project?
          • Change temporary folder for intermediate calculation data files
          • Closing PLAXIS after your calculation is finished
          • CodeMeter network error during calculation (IPv4/v6 conflict)
          • Codemeter Network Installation
          • Codemeter USB Stick behaviour
          • Command line reference
          • Compliant base and free field boundaries: check on input signal
          • Composite liner approach in PLAXIS 2D
          • Connect a node-to-node anchor with an embedded beam row halfway
          • Considerations for modelling a thick slab as a plate
          • Consolidation: Minimum Pore Pressures and Degree of Consolidation analysis may give spurious displacements of boundary nodes
          • Conversion from 2D Version 8/9
          • Conversion of PLAXIS 2D files
          • Copy/Array command in Plaxis 2D
          • Create centerline for Structural Forces in Volumes
          • Create rock bolts accurately in PLAXIS 3D
          • Creating axial force curve for Fixed End anchors
          • Deactivated loads are still visible in PLAXIS Output
          • Definition of a bending moment as load
          • Definition of Hoek-Brown model parameters in Plaxis
          • Drained Settlement Vs. Consolidation: Differences at Failure in Output
          • Drift correction for dynamic input signal from file
          • During a calculation some plastic points disappear. How is that possible?
          • Dynamic Load with Perpendicular Distribution
          • Encrypted scripting server vulnerable to replay attacks
          • End bearing of plates
          • Energy saving while running multiple calculations
          • Error when generating 3D mesh
          • Export and format plots from PLAXIS Output
          • Export or reuse geometry for New Analysis
          • Extended command syntax for mesh generation
          • Fixed and Compliant base: what input motion is required?
          • Fixities and deformation boundary conditions
          • Force envelope results explained
          • Fundamentals of pseudo-static analysis in PLAXIS
          • General modeling guidelines - recommendations
          • Graphics card issues
          • Groundwater flow analysis in PLAXIS – Brief overview
          • How do I import a geometry in PLAXIS 3D?
          • How does Plaxis deal with water pressures during dynamic calculations?
          • How does Reset displacements to zero work?
          • How does the option volumetric strain work?
          • How to activate a dynamic load
          • How to change the PLAXIS model width
          • How to check undrained shear strength using Undrained A?
          • How to convert PLAXIS V21 material database to the V22 format
          • How to define and edit a material via the command line
          • How to get a load - displacement curve using SumMstage
          • How to prescribe a dynamic displacement
          • How to run a Limit Equilibrium Method analysis from PLAXIS 2D
          • How to select more than 10 nodes to be used for a curve
          • How to setup the number of steps stored in PLAXIS Input
          • How to setup tied degrees of freedom
          • How to use command log files
          • How to validate a material via the GUI and command line
          • Hydraulic conductivity input in PLAXIS using van Genuchten functional forms in a groundwater flow analysis
          • I use PLAXIS and it says I do not have the proper entitlements
          • Improving speed of mesh generation in combination with stage generation
          • In Plaxis Curves it is possible to plot Force Fx, Fy and Fz. What are these parameters?
          • Initial degree of saturation for soil activated during staged construction
          • InputSettings object in Output
          • Inspect intermediate step results in PLAXIS Output
          • Install latest 2D version and 2D AE for converting older files
          • Is it possible to apply a distributed load on tunnel lining in PLAXIS 2D?
          • Is PLAXIS 3D 64-bit?
          • Is PLAXIS 3D enabled for multicore?
          • Iterative settings: desired minimum and maximum
          • Iterative settings: Influence of Arc length control
          • Iterative settings: Max unloading steps (arc length control)
          • Key not bound to machine
          • Language reset in PLAXIS 2D and 3D
          • Launch PLAXIS 2D calculations via DOS commands
          • Load activation in time
          • Local axis and its colour indication
          • Macros using the commands runner
          • Material datasets for plates: sheet pile wall in bending
          • Materials overview in the Model explorer
          • Memory usage in dynamic calculations
          • Mesh alignment in flow problems
          • Mesh generation might not work under Windows 7 due to security settings
          • Modelling a tapered pile
          • Modelling Rock mass using discrete discontinuities vs Jointed Rock
          • Modelling soil-structure interaction: interfaces
          • Modelling technique: Vacuum consolidation
          • Modifying boundary conditions
          • Multicore CPU and 32/64-bit
          • NATM Tunneling - Beta Method: Incomplete Staged construction method vs. Deconfinement method
          • Node-to-Node anchors as an alternative for Fixed-End anchors
          • Non-consecutive order of step numbers in Plaxis
          • Obtain Object names easily to use in commands
          • Obtaining tabulated data from PLAXIS Input
          • Obtaining time-dependent flow results at specific timestamps in a given time interval in Flow only calculations
          • On different failure criteria for soils
          • On the initialisation of the temperatures of solid elements
          • On the use of dynamic boundary conditions
          • Opening old PLAXIS project gives a popup window. What should I do?
          • Output of flow results through interfaces
          • Output project compatibility
          • Permeability in interfaces
          • Permeability in interfaces: Practical situations
          • Pile modelling in a 2D plane strain model
          • PLAXIS 2D Command compatibility notes
          • PLAXIS 3D 2013 and older PLAXIS files
          • PLAXIS 3D 2016: Fully parametric geometry
          • PLAXIS 3D Command compatibility notes
          • PLAXIS Legacy version and supported CodeMeter drivers
          • PLAXIS Output Phase/Step object compatibility
          • PLAXIS Silent Installation
          • PLAXIS Soil model numbers in command line
          • Plaxis uses SMC files for earthquakes, but what kind of format is this?
          • Points of interest for pile modelling in a 2D plane strain model
          • Problems related to non-associated plasticity
          • Program responds that drivers are out of date, but I have a newer version installed
          • Pseudo static acceleration
          • Re-use materials from other projects
          • Reduction of stiffness does not lead to a change in displacements
          • Regenerate staged construction
          • Run multiple calculations easily
          • Safety analysis and displacements
          • Safety analysis and undrained behaviour
          • Safety analysis and Updated Mesh
          • Safety calculation with a Target Value
          • Saving PLAXIS files for an older version
          • Select points for curves prior to calculation directly in Input
          • Selecting points for curves
          • Set multiple phases to be calculated
          • Showing a list of embedded beams by length
          • Small overlaps curves message in SoilTest optimisation
          • Smart selection of line elements in PLAXIS 2D Input
          • Stiffness units for structural elements in an axisymmetric model
          • Stress relaxation due to creep in concrete structures
          • Stresses in non-porous materials
          • Structural results in tables and curve plots
          • Swept meshing in PLAXIS 3D
          • Tensile behaviour in the Hoek-Brown model
          • Tension cut-off in interfaces for User Defined Soil Models
          • Time step used in dynamic calculation
          • Trim and extend a line in PLAXIS 2D
          • Tunnels in PLAXIS 3D: Extrusions and cutting planes
          • Unable to select points for curves
          • Unable to select structures or nodes
          • Use of wells in PLAXIS 3D
          • Using an accelerogram for Dynamics
          • Using partial geometry for interesting result images in PLAXIS 3D
          • Using PLAXIS Remote scripting with the Python wrapper
          • Waterlevel inspection and editing in PLAXIS 2D
          • Westergaard's added mass for hydrodynamic pressures: a simple case
          • +Working from home with PLAXIS
        • +Publications
        • +Videos - PLAXIS
      • +PLAXIS Monopile Designer
      • +PLAXIS LE
      • +SOILVISION
      • +Geotechnical SELECT Entitlements [GSE]
      • +Subscription Entitlement Service

     
     Questions about this article, topic, or product? Click here. 

    Export and format plots from PLAXIS Output

    Application PLAXIS 2D
    PLAXIS 3D
    Version PLAXIS 2D CONNECT Edition
    PLAXIS 3D CONNECT Edition
    Date created 20 February 2018
    Date modified 01 September 2021

    Versions: 2D 2017.01 and later, 3D 2017 and later

    Introduction

    The PLAXIS Output program offers the possibility of using the command line to configure the plot settings to export a plot to an image file to be used in post-processing. In this article, different options are explained providing information on the relevant options that are available.

    For automation purposes, the equivalent Python commands are provided in the article Export and format plots from PLAXIS Output using Python

    Contents

    • Plot settings
    • ResultTypes
    • PlotType
    • LegendSettings
    • MeshSettings
    • Phase & PhaseBehaviour
    • Other visualization commands
    • Export command
    • Comments

    Plot settings

    To view the current settings applied to the last plot created in Output, one can use the echo Plots[-1] command:

    1_echo_plot

    Figure 1. Current settings of Plots[-1] (last plot created)

    In the picture above you can identify different options that can be edited with the set command using the syntax below:

    Show the rulers in your plot:

    • set Plots[-1].DrawRulers True

    Hide the axes:

    • set Plots[-1].DrawAxes False

    Exclude the legend of the plot:

    • set Plots[-1].DrawLegend False

    2_plot_settings

    Figure 2. Current view of the plot in PLAXIS Output

    Below are some special items in the properties of a plot object that concern every plot to be exported:

    • ResultTypes
    • PlotType
    • LegendSettings
    • MeshSettings

    These will be explained in more details below.

    ResultTypes

    The ResultTypes is the property that controls which result is visualized in the plot. This is related to the numerous options available via the menus, e.g. Deformations, Stresses, Forces, etc.

    Some examples are provided below:

    Set the plot result to Total horizontal displacement ux:

    • set Plots[-1].ResultType ResultTypes.Soil.Ux

    Set the plot result to Incremental vertical cartesian strains: Δεyy:

    • set Plots[-1].ResultType ResultTypes.Soil.dEpsyy

    Set the plot results to Active pore pressures:

    • set Plots[-1].ResultType ResultTypes.Soil.PActive

    3_pactive

    Figure 3. Plot set to show the Active pore pressures

    PlotType

    For every plot you can also switch between the available visualisation options of the results:

    Set the plot type to show the Contour lines instead of the Shadings:

    • set Plots[-1].PlotType "ContourLines"

    Set the plot type to show the Coloured principal directions of a plot. Note that this is relevant to some of the plots, such as the stresses and pore pressure plots:

    • set Plots[-1].PlotType "PrincipalDirections"

    In any case that a typo is made, the error message contains all allowed values for the command.

    4_principaldirection

    Figure 4. Coloured principal direction with legend shown

    5_error_message

    Figure 5. Error message displayed for assistance

    LegendSettings

    This allows for changing the settings of the legend that is next to the plot. For example:

    Change the number of intervals of the legend to 10:

    • set Plots[-1].LegendSettings.Intervals 10

    Set the minimum value of the legend to -160 in project units:

    • set Plots[-1].LegendSettings.MinValue -160

    6_minvalue_legend

    Figure 6. Minimum value specified for legend

    MeshSettings

    Various options about the current visualisation of the mesh are stored in the MeshSettings of a plot. For example:

    Show the Phreatic level in the plot:

    • set Plots[-1].MeshSettings.PhreaticLevel True

    Show the Fixities of the model:

    • set Plots[-1].MeshSettings.Fixities True

    Hide the Cluster contours of the model:

    • set Plots[-1].MeshSettings.ClusterContours False

    7_fixities_no_waterlevel

    Figure 7. Fixities displayed without a phreatic level representation

    Phase and PhaseBehaviour

    Every plot in PLAXIS Output has a Phase property, which corresponds to the phase for which the results are being displayed.

    By default, the Phase property is set to the phase selected in Input when the command is run to view the results, or it is set to the phase selected when a project is opened directly in Output.

    In the GUI (Graphic User Interface) it is possible to switch to any other phase in Output program using the dropdown box from the top bar, however, the internal Phase property of the plot remains unchanged.

    You can query the Phase property using the echo command:

    echo Plots[-1].Phase

    To change the Phase property, you can directly set it using the command:

    set Plots[-1].Phase Phase_x

     

    Along with the Phase property, the PhaseBehaviour property allows for controlling to which phase the Phase property will be set to for the current plot when used in automation.

    The PhaseBehaviour property has two options:

    • projectphase : current Plot object has the same phase as to the one that will be used to export
    • plotphase : current Plot object has its own phase, independent to the one that will be used to export

    By default, the PhaseBehaviour is set to plotphase, which means that any change via the GUI does not make any change to the internal Phase property. The Phase property is used for export options via command line and/or with remote scripting facilities (Python).

    You can change the PhaseBehaviour behaviour with the command:

    set Plots[-1].PhaseBehaviour "projectphase"

     Other visualization commands

    Show/Hide

    An Output plot can contain various objects (soil elements, plate elements, interfaces, loads,etc). In complex models where many objects are included, it is possible to hide or show them in order to make the plot easier for review. A few examples for the hide command are given below. Note that in order to show the objects you can use the show command in place of the hide command.

    • hide Plots[-1] Plates  # hides all plates in the visualisation
    • hide Plots[-1] Plate_1_1  # only hides the specific plate in the visualisation
    • hide Plots[-1] WaterLoads  # hides any external waterloads in the visualisation
    • hide Plots[-1] LineLoads[0][1]  # only hides the line load, e.g. LineLoad_1_2

    Zoom

    In many cases to review the results, the focus needs to be adjusted to a smaller part of the model. On this occasion, the zoom command can be used.
    A few examples for the zoom command  are given below:

    • zoom Plots[-1]  # resets the zoom to show the whole model inside the plot’s size
    • zoom Plots[-1] Plate_2  # zooms to fit Plate_2 into the plot’s visualisation
    • zoom Plots[-1] (0 1)  # zooms the plot centering to point (0 1)
    • zoom Plots[-1] (0 1) (2 2)  # zooms the plot to a bounding box by points (0 1) and (2 2)

    View (3D only)

    The different viewpoints in PLAXIS 3D can be used to view the plot at a certain angle/side. A few examples for the  view command are given below:

    • view Plots[-1] "bottom"
    • view Plots[-1] "default"

    Export command

    After setting up the plot the final step is to use the command line to export the plot to an image file.
    The export command has the following structure:

    • export ObservablePlot "full_path/to_the/file.png"  1920 1080

    An example is given below:

    • export Plots[-1] "C:/Plaxis/Plots/my_plot.png"  1920 1080

    This command will export the lastly created plot (Plots[-1]) to the location specified within the quotation marks using the width of 1920 and height of 1080 pixels.
    Note that the width and height are optional parameters which can be omitted. If those parameters are not mentioned the program will export the plot using 2880 x 2160 pixels.

    Note that the export command for Plots[-1] will use the value of the Phase property according to what the PhaseBehaviour dictates.

    8_exported_plot

    Figure 8. Exported plot

    Pro-tip: When exporting plots for multiple phases, you can first set the .PhaseBehaviour to "projectphase", then change the .Phase property to the relevant phase and run the export command each time. This will ensure that you get the correct exported plot per phase.
    Attached you will find a simple Python script for exporting plots showing the results of total displacements (|u|) per phase.

    Comments

    • More information on Output commands and objects can be found in our Command reference under the Help menu.
    • Not all plot settings are automatically applied to the current plot PLAXIS Output is showing in the plot area
    • Some plot settings require the presence of another setting to be applied correctly. For instance, this is the case of showing the results using the PrincipalDirections as a PlotType. For this, the ResultType should be set to a result that includes this visualisation, as the pore pressures or stresses do, for example.
    • When multiple plots exist in PLAXIS Output, any changes to the plot settings will be applied to the plot specified. Plots[-1] always refer to the lastly created plot.
    • A structural plot is considered a new plot and should be treated as such. In this case, Plot_1 will refer to the soil view (e.g. deformed mesh or deformations plot) and Plot_2 will refer to the structures view of the selected structural element.
      Here Plots[-1] refers to the structural plot.
    • Not all commands are relevant for both PLAXIS 2D and PLAXIS 3D, e.g. ruler option is only available in PLAXIS 2D.
    • output
    • PLAXIS 3D
    • set
    • Export
    • PLAXIS
    • plot
    • PLAXIS 2D
    • Share
    • History
    • More
    • Cancel
    • Micha van der Sloot Created by Bentley Colleague Micha van der Sloot
    • When: Wed, Dec 18 2019 10:40 AM
    • Stefanos Papavasileiou Last revision by Bentley Colleague Stefanos Papavasileiou
    • When: Wed, Mar 30 2022 12:00 PM
    • Revisions: 3
    • Comments: 0
    Recommended
    Related
    Communities
    • Home
    • Getting Started
    • Community Central
    • Products
    • Support
    • Secure File Upload
    • Feedback
    Support and Services
    • Home
    • Product Support
    • Downloads
    • Subscription Services Portal
    Training and Learning
    • Home
    • About Bentley Institute
    • My Learning History
    • Reference Books
    Social Media
    •    LinkedIn
    •    Facebook
    •    Twitter
    •    YouTube
    •    RSS Feed
    •    Email

    © 2023 Bentley Systems, Incorporated  |  Contact Us  |  Privacy |  Terms of Use  |  Cookies