Metadata-Version: 2.4
Name: gvd-openseespy
Version: 0.1.0
Summary: Modified OpenSeesPy distribution including the GVDHysteretic uniaxial material
Author: Mohammadmahdi Gholami
License-Expression: LicenseRef-OpenSees
Project-URL: Homepage, https://github.com/mohammadmahdigholami/OpenSeesGVD
Project-URL: Repository, https://github.com/mohammadmahdigholami/OpenSeesGVD
Project-URL: Paper, https://doi.org/10.1016/j.engstruct.2026.123034
Project-URL: Issues, https://github.com/mohammadmahdigholami/OpenSeesGVD/issues
Keywords: OpenSees,OpenSeesPy,GVDHysteretic,timber connections,hysteretic material,seismic analysis
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
Requires-Python: <3.14,>=3.13
Description-Content-Type: text/markdown
License-File: COPYRIGHT
Dynamic: license-file

# GVD-OpenSeesPy

GVD-OpenSeesPy is a modified OpenSeesPy distribution that includes the GVDHysteretic uniaxial material developed for modeling the cyclic behaviour of dowel-type timber connections.

## Installation

Install with:

    pip install gvd-openseespy

## Usage

Use the package as:

    import gvd_openseespy.opensees as ops

    ops.wipe()
    ops.model("basic", "-ndm", 1, "-ndf", 1)

    # Define the GVDHysteretic material using the required parameters
    ops.uniaxialMaterial("GVDHysteretic", 1, ...)

## Current support

This first release currently supports:

- Windows 64-bit
- Python 3.13

The package includes a precompiled OpenSeesPy binary so users do not need to compile OpenSees from source.

## Citation

If you use this material, please cite:

Gholami, M., Viau, C., and Doudak, G. (2026). Proposed new hysteresis model for dowel-type connections of timber lateral load resisting systems. Engineering Structures. https://doi.org/10.1016/j.engstruct.2026.123034

## License and attribution

This package is a modified OpenSees/OpenSeesPy distribution. Users should follow the original OpenSees/OpenSeesPy license terms in addition to citing the associated research paper.
