openseespy-viewer 0.1.0

Live visual previewer for OpenSeesPy models

openseespy-viewer

Viewer for openseespy models. Monitors your model file(s) and produces a live 3D drawing that updates each time you save. Works with 2D/3dof and 3D/6dof models.

Installation

pip install openseespy-viewer

Or install from source:

pip install .

Usage

Python API:

from viewer import view

# Single file
view('my_model.py')

# Multiple files
view('nodes.py', 'elements.py', 'boundary.py')

# With custom style options
view('my_model.py', bg_colour='white', node_size=16, ele_width=3)

Command line:

# Basic usage
openseespy-viewer my_model.py

# Multiple files with custom refresh rate
openseespy-viewer nodes.py elements.py --refresh 1.0

# Or via python -m
python -m viewer my_model.py

Screenshots

Press S in the viewer window to save a screenshot. Screenshots are saved to the images/ folder with incrementing names (model_screenshot_001.png, model_screenshot_002.png, etc.). The counter resets each time you restart the viewer. This is useful for sharing your model with AI tools like Claude Code — just ask it to look at the screenshot.

Examples

See the examples/ directory for sample model files.

Dependencies

pip install pyvista numpy watchdog

Feature wish-list

• Plot nodes as they are saved in a watched script
• Add node labels
• Add support for elements
• Add support for fixity conditions
• Add support for variables and expressions in scripts
• Add support for watching multiple files (for models made up of many files)
• Add support for loads
• Add support for nodes created within loop
• Add support for 3D models
• Add support for rotational dofs
• Screenshot capture (press S in viewer)