Skip to main content
Version: 2026R1

create_material_plot

LayupPlotDict.create_material_plot(name=None, id=None, active=True, scope_entire_model=True, data_scope=[], show_on_solids=False, show_ply_offsets=False, ply_offset_scale_factor=1.0, add_to_active_set=True, locked=False, component='E1', use_all_available_fields=True, field_variable_names=[], shear_angle_enabled=False, temperature_enabled=False)​

Create a Material Plot object.

  • Parameters:
    • name: Name of the plot.
    • id: ID for the plot.
    • active: Whether the plot is active.
    • scope_entire_model: If True, then the scope of this plot is the entire model. If not, then set to false and use the data_scope to specify a sub scope.
    • data_scope: Object(s) defining the scope for which data is computed and returned. Applicable are: Element Set, Oriented Selection Set, Modeling Ply, Sampling Point.
    • show_on_solids: True or False (default). Whether to show the results on the shell or solid model (if present).
    • show_ply_offsets: True or False (default). Whether to display ply-wise visualizations with ply offsets.
    • ply_offset_scale_factor: Scale factor for the offsets of the visualized plies if show_ply_offsets=True.
    • component: Specifies the component.
    • use_all_available_fields: True (default) or False. Whether to enable all available field variables in the evaluation.
  • Returns: The plot object.

Example: : Create a material plot with Data Scope set to Element Set “All_Elements” showing the Young Modulus E2:


>>> E2_plot = db.active_model.layup_plots.create_material_plot(name="E2_Plot", data_scope=[db.active_model.element_sets['All_Elements']], component = 'E2')