ospgrillage


Nameospgrillage JSON
Version 0.3.1 PyPI version JSON
download
home_page
SummaryBridge deck grillage analysis using OpenSeesPy
upload_time2023-08-29 13:54:33
maintainer
docs_urlNone
author
requires_python>=3.8
licenseMIT
keywords bridge grillage openseespy
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ![ospgrillage logo](https://raw.githubusercontent.com/MonashSmartStructures/ospgrillage/main/docs/source/images/ospgrillage_logo.png)

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![version](https://img.shields.io/github/downloads/MonashSmartStructures/ospgrillage/total?label=version)]() 
![GitHub issues](https://img.shields.io/github/issues/MonashSmartStructures/ospgrillage?logoColor=yellowgreen)
![GitHub pull requests](https://img.shields.io/github/issues-pr/MonashSmartStructures/ospgrillage?color=yellowgreen)
[![PyPI](https://img.shields.io/pypi/v/ospgrillage)]()
![GitHub Workflow Status](https://img.shields.io/github/workflow/status/MonashSmartStructures/ospgrillage/Build%20and%20deploy)
![GitHub Workflow Status](https://img.shields.io/github/workflow/status/MonashSmartStructures/ospgrillage/Deploy%20to%20GitHub%20Pages?label=gh%20page%20build)
![GitHub Workflow Status](https://img.shields.io/github/workflow/status/MonashSmartStructures/ospgrillage/Tests?label=Tests)
![GitHub commit activity](https://img.shields.io/github/commit-activity/m/MonashSmartStructures/ospgrillage)
![GitHub last commit](https://img.shields.io/github/last-commit/MonashSmartStructures/ospgrillage?color=ff69b4)
[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](code_of_conduct.md)
[![codecov](https://codecov.io/gh/MonashSmartStructures/ospgrillage/branch/main/graph/badge.svg?token=dUTOmPBnyP)](https://codecov.io/gh/MonashSmartStructures/ospgrillage)
[![status](https://joss.theoj.org/papers/d44339b03dc4f1add2678167c1a1b6de/status.svg)](https://joss.theoj.org/papers/d44339b03dc4f1add2678167c1a1b6de)
[![DOI](https://zenodo.org/badge/365436121.svg)](https://zenodo.org/badge/latestdoi/365436121)



# Overview

*ospgrillage* is a python wrapper of the *OpenSeesPy* package to speed up the creation of bridge deck grillage models. [OpenSeesPy](openseespydoc.readthedocs.io) is a python interpreter of the well-know Open System for Earthquake Engineering Simulation ([OpenSees](https://opensees.berkeley.edu/)) software framework. *ospgrillage* provides a simple python API which allows users to:

1. Quickly generate and analyze a bridge deck grillage model in the *OpenSeesPy* model space, including many forms of loading and load cases;
2. Export a py file containing the *OpenSeesPy* commands, which on execution, creates the prescribed *OpenSeesPy* grillage model.

The ability to use *ospgrillage* directly to do bridge deck analysis, or to export the *OpenSeesPy* command file for further editing, facilites an enormous range of use cases in both practice and research.

## Documentation

*ospgrillage*'s full documentation can be found [here](https://monashsmartstructures.github.io/ospgrillage/index.html).

## Installation

Install using pip:
```bash
    pip install ospgrillage
```
    
Refer to [installation](https://monashsmartstructures.github.io/ospgrillage/rst/Installation.html) for more information.

## Contributions

Check out our [contributing guide](https://github.com/MonashSmartStructures/ospgrillage/blob/main/.github/CONTRIBUTING.md) to learn more on contributing, coding rules, community Code of Conduct and more.

## Citing

If you use *ospgrillage* in you work, please cite the corresponding JOSS paper:

Ngan J.W. and Caprani, C.C. (2022), "ospgrillage: A bridge deck grillage analysis preprocessor for OpenSeesPy", *Journal of Open Source Software*, 7(77), 4404, [doi.org/10.21105/joss.04404](https://doi.org/10.21105/joss.04404)


# Capabilities

## Modelling

### Bridge Deck Models
-  Beam elements only - a traditional form of model
-  Beam elements with rigid links - a modification of the traditional form for box sections
-  Shell and beam elements - the modern form of modelling, but with more complex results interpretation

### Meshing
-  Single-span decks
-  Skewed (Oblique) and Orthogonal meshes
-  Positive and negative skew angles
-  Allows for skew mesh to be set up to 30 degrees
-  Allows for orthogonal mesh to be set no less than 11 degrees
-  Grillage elements grouped automatically for easy assignment of properties
-  Autodetect edges of spans as supporting nodes
-  Allows for diaphragms / end slabs
-  Allows for unit width properties for transverse slab/members
-  Pinned and roller supports

### Element types
The following *OpenSees* element types are supported:
-  `elasticBeamColumn`
-  `TimoshenkoBeamColumn`  
-  Shell elements

## Materials
-  A JSON materials library file for codified common material properties

## Utilities

### Load types
-  Nodal loads
-  Point loads
-  Line loads
-  Patch loads
-  Compound loads (any combination of the above load types) 

### Analysis
-  Load cases contain arbitrary multiple load types, including compound loads
-  Moving load analysis of arbitrary load types through compound loads

### Post-processing
-  Output results utilise python's `xarray` format
-  Retrieve result envelopes from `xarray` results
-  Query options for moving load 
-  Plotting displacement and force component from the results

# Credits
- Mayer Melhem for producing the documentation illustrations and the design of the *ospgrillage* logo.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "ospgrillage",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "bridge, grillage, openseespy",
    "author": "",
    "author_email": "Monash Smart Structures <colin.caprani@monash.edu>, Jun Wei Ngan <jun.ngan@monash.edu>, Colin <colin.caprani@monash.edu>",
    "download_url": "https://files.pythonhosted.org/packages/59/be/08f6cb6a3c851263bb973eef8bd146f27def91d7fa59a4dd822571bd6c85/ospgrillage-0.3.1.tar.gz",
    "platform": "any",
    "description": "![ospgrillage logo](https://raw.githubusercontent.com/MonashSmartStructures/ospgrillage/main/docs/source/images/ospgrillage_logo.png)\n\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![version](https://img.shields.io/github/downloads/MonashSmartStructures/ospgrillage/total?label=version)]() \n![GitHub issues](https://img.shields.io/github/issues/MonashSmartStructures/ospgrillage?logoColor=yellowgreen)\n![GitHub pull requests](https://img.shields.io/github/issues-pr/MonashSmartStructures/ospgrillage?color=yellowgreen)\n[![PyPI](https://img.shields.io/pypi/v/ospgrillage)]()\n![GitHub Workflow Status](https://img.shields.io/github/workflow/status/MonashSmartStructures/ospgrillage/Build%20and%20deploy)\n![GitHub Workflow Status](https://img.shields.io/github/workflow/status/MonashSmartStructures/ospgrillage/Deploy%20to%20GitHub%20Pages?label=gh%20page%20build)\n![GitHub Workflow Status](https://img.shields.io/github/workflow/status/MonashSmartStructures/ospgrillage/Tests?label=Tests)\n![GitHub commit activity](https://img.shields.io/github/commit-activity/m/MonashSmartStructures/ospgrillage)\n![GitHub last commit](https://img.shields.io/github/last-commit/MonashSmartStructures/ospgrillage?color=ff69b4)\n[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](code_of_conduct.md)\n[![codecov](https://codecov.io/gh/MonashSmartStructures/ospgrillage/branch/main/graph/badge.svg?token=dUTOmPBnyP)](https://codecov.io/gh/MonashSmartStructures/ospgrillage)\n[![status](https://joss.theoj.org/papers/d44339b03dc4f1add2678167c1a1b6de/status.svg)](https://joss.theoj.org/papers/d44339b03dc4f1add2678167c1a1b6de)\n[![DOI](https://zenodo.org/badge/365436121.svg)](https://zenodo.org/badge/latestdoi/365436121)\n\n\n\n# Overview\n\n*ospgrillage* is a python wrapper of the *OpenSeesPy* package to speed up the creation of bridge deck grillage models. [OpenSeesPy](openseespydoc.readthedocs.io) is a python interpreter of the well-know Open System for Earthquake Engineering Simulation ([OpenSees](https://opensees.berkeley.edu/)) software framework. *ospgrillage* provides a simple python API which allows users to:\n\n1. Quickly generate and analyze a bridge deck grillage model in the *OpenSeesPy* model space, including many forms of loading and load cases;\n2. Export a py file containing the *OpenSeesPy* commands, which on execution, creates the prescribed *OpenSeesPy* grillage model.\n\nThe ability to use *ospgrillage* directly to do bridge deck analysis, or to export the *OpenSeesPy* command file for further editing, facilites an enormous range of use cases in both practice and research.\n\n## Documentation\n\n*ospgrillage*'s full documentation can be found [here](https://monashsmartstructures.github.io/ospgrillage/index.html).\n\n## Installation\n\nInstall using pip:\n```bash\n    pip install ospgrillage\n```\n    \nRefer to [installation](https://monashsmartstructures.github.io/ospgrillage/rst/Installation.html) for more information.\n\n## Contributions\n\nCheck out our [contributing guide](https://github.com/MonashSmartStructures/ospgrillage/blob/main/.github/CONTRIBUTING.md) to learn more on contributing, coding rules, community Code of Conduct and more.\n\n## Citing\n\nIf you use *ospgrillage* in you work, please cite the corresponding JOSS paper:\n\nNgan J.W. and Caprani, C.C. (2022), \"ospgrillage: A bridge deck grillage analysis preprocessor for OpenSeesPy\", *Journal of Open Source Software*, 7(77), 4404, [doi.org/10.21105/joss.04404](https://doi.org/10.21105/joss.04404)\n\n\n# Capabilities\n\n## Modelling\n\n### Bridge Deck Models\n-  Beam elements only - a traditional form of model\n-  Beam elements with rigid links - a modification of the traditional form for box sections\n-  Shell and beam elements - the modern form of modelling, but with more complex results interpretation\n\n### Meshing\n-  Single-span decks\n-  Skewed (Oblique) and Orthogonal meshes\n-  Positive and negative skew angles\n-  Allows for skew mesh to be set up to 30 degrees\n-  Allows for orthogonal mesh to be set no less than 11 degrees\n-  Grillage elements grouped automatically for easy assignment of properties\n-  Autodetect edges of spans as supporting nodes\n-  Allows for diaphragms / end slabs\n-  Allows for unit width properties for transverse slab/members\n-  Pinned and roller supports\n\n### Element types\nThe following *OpenSees* element types are supported:\n-  `elasticBeamColumn`\n-  `TimoshenkoBeamColumn`  \n-  Shell elements\n\n## Materials\n-  A JSON materials library file for codified common material properties\n\n## Utilities\n\n### Load types\n-  Nodal loads\n-  Point loads\n-  Line loads\n-  Patch loads\n-  Compound loads (any combination of the above load types) \n\n### Analysis\n-  Load cases contain arbitrary multiple load types, including compound loads\n-  Moving load analysis of arbitrary load types through compound loads\n\n### Post-processing\n-  Output results utilise python's `xarray` format\n-  Retrieve result envelopes from `xarray` results\n-  Query options for moving load \n-  Plotting displacement and force component from the results\n\n# Credits\n- Mayer Melhem for producing the documentation illustrations and the design of the *ospgrillage* logo.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Bridge deck grillage analysis using OpenSeesPy",
    "version": "0.3.1",
    "project_urls": {
        "Documentation": "https://monashsmartstructures.github.io/ospgrillage/",
        "Homepage": "https://monashsmartstructures.github.io/ospgrillage/",
        "Source": "https://github.com/MonashSmartStructures/ospgrillage",
        "Tracker": "https://github.com/MonashSmartStructures/ospgrillage/issues"
    },
    "split_keywords": [
        "bridge",
        " grillage",
        " openseespy"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "517c12718714a118b8e6ae5fc784c869aa96fa21cc1357c282163accf0ad755d",
                "md5": "f15cee664ee5cb3e6fd4b46fd6193749",
                "sha256": "37b6dff1bc325886f0e3bd23201b965b2d5b23bd81fff36f45629c76845110e1"
            },
            "downloads": -1,
            "filename": "ospgrillage-0.3.1-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "f15cee664ee5cb3e6fd4b46fd6193749",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.8",
            "size": 84811,
            "upload_time": "2023-08-29T13:54:32",
            "upload_time_iso_8601": "2023-08-29T13:54:32.488797Z",
            "url": "https://files.pythonhosted.org/packages/51/7c/12718714a118b8e6ae5fc784c869aa96fa21cc1357c282163accf0ad755d/ospgrillage-0.3.1-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "59be08f6cb6a3c851263bb973eef8bd146f27def91d7fa59a4dd822571bd6c85",
                "md5": "bf1ee3720d5cfc5c9c0133fa988870a4",
                "sha256": "e51ccc26409ff9e117550ea9da9544266007a89cb51489e46868a0e5cede42d8"
            },
            "downloads": -1,
            "filename": "ospgrillage-0.3.1.tar.gz",
            "has_sig": false,
            "md5_digest": "bf1ee3720d5cfc5c9c0133fa988870a4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 103501,
            "upload_time": "2023-08-29T13:54:33",
            "upload_time_iso_8601": "2023-08-29T13:54:33.814232Z",
            "url": "https://files.pythonhosted.org/packages/59/be/08f6cb6a3c851263bb973eef8bd146f27def91d7fa59a4dd822571bd6c85/ospgrillage-0.3.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-08-29 13:54:33",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "MonashSmartStructures",
    "github_project": "ospgrillage",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "ospgrillage"
}
        
Elapsed time: 0.11643s