Welcome to opstool’s documentation!

opstool is a useful toolbox package aims to pre-processing, visualization, analysis-aided, etc., for openseespy. The package is still under development.

To use, install opstool from opstool-PyPI:

pip install --upgrade opstool

The restriction on the python version mainly depends on openseespy, it is recommended that you use Anaconda to avoid library version incompatibilities.

Installation

• Installation
  • Installation
    • Installing opstool
    • Dependencies
  • Changelog
    • v0.8.7
    • v0.8.6
    • v0.8.5
    • v0.8.4
    • v0.8.3
    • v0.8.0
    • v0.7.3
    • v0.7.2
    • v0.7.1
    • v0.7.0
    • v0.6.0
    • v0.5.0
    • v0.4.2
    • v0.4.1
    • v0.4.0
    • v0.3.0
    • v0.2.0
    • v0.1.0
    • v0.0.7
    • v0.0.6
    • v0.0.5

Visualization

• Visualization
  • OpenSeesPy Model Visualization
    • ✅Visualization based on plotly
      • Display OpenSeesPy Geometry Model
      • Display Eigen Analysis
      • Display Response Data
        • Visualize node response
        • Display Frame Element Response
    • ✅Visualization based on pyvista
      • Display OpenSeesPy Geometry Model
      • Display Eigen Analysis
      • Display Response Data
        • Display Frame Element Response
    • ✅Fiber Section Visualization
      • OpenSeesPy Model Creation
      • Visualization of fiber section geometry information
      • Fiber section responses visualization
      • plot forces-deformations relationship
  • Quick Model and Eigenmodes Visualization
    • Example

Fiber Section Mesh

• Fiber Section Mesh
  • Fiber Section Mesh
    • ✅RC section mesh
      • Generate geometric objects
      • Generate mesh
      • add rebars
      • Get the section properties
      • centering or rotate the section
      • View the section mesh
      • plot and get stresses
      • Generate py or tcl file
      • Generate openseespy cmds implicitly
    • ✅Composite Section Mesh
    • ✅Variable section mesh

Pre-processing

• Pre-processing
  • Convert tcl code to OpenSeesPy commands
  • Automatic Unit Conversion
    • Truss example
    • Results
      • Structure Frequency
      • Node 4 Displacement
      • Node 2 Reactions

Analysis

• Analysis
  • Smart Analysis
  • Moment Curvature Analysis

Demos

• Demos
  • OpenSeesPy Model Visualization
    • 3D Frame Visualization
    • Cable Stayed Bridge Visualization
    • Dam Visualization
    • Pier Visualization
    • Beam Section Rendering
      • Create section
      • Create Model
      • Save Model Data
      • Beam Section Rendering
    • Local Axes and Loads Demonstration
      • Local axes
      • Loads
    • 2D model and eigenvalue visualization based on matplotlib
      • 2D Frame Model
      • 2D Solid Model
    • 606 m Mega-tall Building
    • Elements Removal Visualization
      • Model
      • Gravity analysis
      • Elements removal
  • Fiber Section Mesh Generation
    • Plain Section
    • RC Rectangular Section
    • RC Hollow Rectangular Section
    • RC Round End Section
    • Concrete Filled Steel Tube Section

API Reference

• API Reference
  • Model Visualization
    • Fast model and eigenvalue visualization
      • plot_model
        • plot_model()
      • plot_eigen
        • plot_eigen()
      • Example
    • Get OpenSeesPy data for the current domain
      • GetFEMdata
        • GetFEMdata.get_eigen_data()
        • GetFEMdata.get_fiber_data()
        • GetFEMdata.get_fiber_resp_step()
        • GetFEMdata.get_frame_resp_step()
        • GetFEMdata.get_model_data()
        • GetFEMdata.get_node_react_step()
        • GetFEMdata.get_node_resp_step()
        • GetFEMdata.get_resp_step()
        • GetFEMdata.reset_eigen_state()
        • GetFEMdata.reset_model_state()
        • GetFEMdata.reset_steps_state()
        • GetFEMdata.save_resp_all()
    • Visualization based on Plotly
      • OpsVisPlotly
        • OpsVisPlotly.deform_anim()
        • OpsVisPlotly.deform_vis()
        • OpsVisPlotly.eigen_anim()
        • OpsVisPlotly.eigen_vis()
        • OpsVisPlotly.frame_resp_vis()
        • OpsVisPlotly.model_vis()
        • OpsVisPlotly.react_vis()
        • OpsVisPlotly.set_color()
        • OpsVisPlotly.show()
        • OpsVisPlotly.write_html()
    • Visualization based on Pyvista
      • OpsVisPyvista
        • OpsVisPyvista.deform_anim()
        • OpsVisPyvista.deform_peak_vis()
        • OpsVisPyvista.deform_vis()
        • OpsVisPyvista.eigen_anim()
        • OpsVisPyvista.eigen_vis()
        • OpsVisPyvista.frame_resp_vis()
        • OpsVisPyvista.model_vis()
        • OpsVisPyvista.react_vis()
        • OpsVisPyvista.set_anti_aliasing()
        • OpsVisPyvista.set_color()
    • Fiber section visualization in the OpenSeesPy domain
      • Geometric Visualization
        • plot_fiber_sec()
      • Response Visualization
        • FiberSecVis
    • Output model data as tikz code in latex
      • save_tikz()
      • Example
  • Section Fiber Mesh
    • Section Meshing
      • SecMesh
        • SecMesh.add_rebars()
        • SecMesh.assign_group()
        • SecMesh.assign_group_color()
        • SecMesh.assign_mesh_size()
        • SecMesh.assign_ops_matTag()
        • SecMesh.centring()
        • SecMesh.display_all_results()
        • SecMesh.get_area()
        • SecMesh.get_fiber_data()
        • SecMesh.get_frame_props()
        • SecMesh.get_group()
        • SecMesh.get_iy()
        • SecMesh.get_iz()
        • SecMesh.get_j()
        • SecMesh.get_sec_props()
        • SecMesh.get_stress()
        • SecMesh.mesh()
        • SecMesh.opspy_cmds()
        • SecMesh.rotate()
        • SecMesh.to_file()
        • SecMesh.view()
      • Example
    • Create Rebar Data
      • Rebars
        • Rebars.add_rebar_circle()
        • Rebars.add_rebar_line()
        • Rebars.get_rebars_num()
      • Example
    • Geometric Offset
      • Closed polygon offset
        • offset()
        • poly_offset()
      • Non-closed line segment offset
        • line_offset()
    • Create section material
      • add_material()
    • Create Polyline Section Geometry
      • add_polygon()
    • Create circular section geometry
      • add_circle()
    • variable section meshing
      • Create variable geometry for variable sections
        • var_line_string()
      • Variable Section Visualization
        • vis_var_sec()
      • Get the location of the Lobatto integration sections
        • get_lobatto_loc()
      • Get the location of the Legendre integration sections
        • get_legendre_loc()
    • Section Library
      • section_library
        • section_library.I_section()
        • section_library.L_flip_section()
        • section_library.L_section()
        • section_library.T_flip_section()
        • section_library.T_section()
        • section_library.box_section()
        • section_library.channel_section()
        • section_library.circular_end_hollow_section()
        • section_library.circular_end_section()
        • section_library.circular_section()
        • section_library.octagonal_box_section()
        • section_library.octagonal_hollow_section()
        • section_library.octagonal_section()
        • section_library.pipe_section()
        • section_library.rect_section()
        • section_library.trapezoid_section()
      • Example
  • Preprocessing
    • Convert tcl code to OpenSeesPy commands
      • tcl2py()
    • Generate a gravity load pattern from the mass of the current domain
      • gen_grav_load()
    • Arbitrary Unit Conversion
      • UnitSystem
      • Example
    • Create Beam Element Geometric Transformation Tag
      • beam_geom_transf()
  • Analysis
    • SmartAnalyze
      • SmartAnalyze
        • SmartAnalyze.StaticAnalyze()
        • SmartAnalyze.TransientAnalyze()
        • SmartAnalyze.static_split()
        • SmartAnalyze.transient_split()
    • Moment Curvature Analysis of Section
      • MomentCurvature
        • MomentCurvature.analyze()
        • MomentCurvature.bilinearize()
        • MomentCurvature.get_M()
        • MomentCurvature.get_M_phi()
        • MomentCurvature.get_curvature()
        • MomentCurvature.get_fiber_data()
        • MomentCurvature.get_limit_state()
        • MomentCurvature.get_moment()
        • MomentCurvature.get_phi()
        • MomentCurvature.plot_M_phi()
        • MomentCurvature.plot_fiber_responses()
      • Example
  • OpenSeesPy Examples
    • Predefined OpenSeesPy models load
      • load_ops_examples()