# Indeterminate Beam
[](https://github.com/JesseBonanno/IndeterminateBeam/releases/tag/v2.2.2)
[](https://github.com/JesseBonanno/IndeterminateBeam/blob/main/LICENSE.txt)
[](https://doi.org/10.21105/jose.00111)
[](https://indeterminatebeam.readthedocs.io/en/main/?badge=main)
[](https://travis-ci.org/JesseBonanno/IndeterminateBeam)
[](https://www.codefactor.io/repository/github/jessebonanno/indeterminatebeam)
[](https://colab.research.google.com/github/JesseBonanno/IndeterminateBeam/blob/main/docs/examples/simple_demo.ipynb)
[](https://mybinder.org/v2/gh/JesseBonanno/IndeterminateBeam/main?filepath=docs%2Fexamples%2Fsimple_demo.ipynb)
[](https://civils.ai/1/free-beam-calculator)
[](https://pepy.tech/project/indeterminatebeam)
IndeterminateBeam is a Python Package aiming to serve as a foundation for civil and structural engineering projects in Python. The module can also serve as a stand-alone program and is useful for determining:
- reaction forces for indeterminate beams
- internal forces for indeterminate beams (shear, bending, axial)
- deflections of beams due to resulting forces
- axial force, shear force, bending moment and deflection diagrams.
The package is based mainly on engineering concepts of statics as described in (Hibbeler, 2013), and Python packages Sympy (Meurer et al., 2017) and Plotly (Plotly Technologies Inc, 2015).
The [package documentation](https://indeterminatebeam.readthedocs.io/en/main/theory.html) provides a brief overview of the theory behind the solutions used to calculate the forces on the indeterminate beam. The full package documentation can be accessed [here](https://indeterminatebeam.readthedocs.io/en/main/).
Text-based examples of the package presented in the [documentation](https://indeterminatebeam.readthedocs.io/en/main/examples.html) can be found on this [Jupyter Notebook](https://colab.research.google.com/github/JesseBonanno/IndeterminateBeam/blob/main/docs/examples/simple_demo.ipynb) and a web-based graphical user interface (GUI) is available at https://civils.ai/1/free-beam-calculator.
## Project Purpose
The purpose of this project is two-fold:
1. Create a [free website](https://civils.ai/1/free-beam-calculator) that has more features than paid and free beam calculators that exist on the web.
2. Provide a foundation for civil and structural engineers who want to create higher order engineering Python programs.
Several (mostly paid) beam calculator websites currently exist online, providing the same service as this package, with web traffic in the hundreds of thousands per month (Similiarweb, 2021). Despite this, no online service exists (to the authors knowledge) that has all the features of `IndeterminateBeam` and is also free.
Similiarly, there are no well-documented indeterminate beam solving Python packages (to the authors knowledge) despite the importance of such a calculation in engineering. Several python finite element analysis (FEA) packages do exist, however they are vastly overcomplicated for someone wanting to only solve for forces on a one-dimensional beam.
This python package was heavily inspired by [beambending](https://github.com/alfredocarella/simplebendingpractice) (Carella, 2019), a module created for educational purposes by Alfredo Carella of the Oslo Metropolitan University. The beambending module, although well documented, can only solve for simply supported beams consisting of a pin and roller support. The [package documentation](https://simplebendingpractice.readthedocs.io/en/latest/?badge=latest) for this project includes a more rigorous overview of the theory behind the basics for solving determinate structures.
## Functionality and Usage
A typical use case of the ```IndeterminateBeam``` package involves the following steps:
1. Create a `Beam` object
2. Create `Support` objects and assign to `Beam`
3. Create `Load` objects and assign to `Beam`
4. Solve for forces on `Beam` object
5. Plot results
You can follow along with the example below in this web-based [Jupyter Notebook](https://colab.research.google.com/github/JesseBonanno/IndeterminateBeam/blob/main/docs/examples/readme_example.ipynb).
Alternatively, you can download the jupyter-notebook for this example [here](https://raw.githubusercontent.com/JesseBonanno/IndeterminateBeam/main/docs/examples/readme_example.ipynb), or the python file for this code [here](https://raw.githubusercontent.com/JesseBonanno/IndeterminateBeam/main/docs/examples/readme_example.py).
The units used throughout the Python package are the base SI units (newtons and metres), but can be updated using the `update_units` method. Units and load direction conventions are described in the [package documentation](https://indeterminatebeam.readthedocs.io/en/main/theory.html#sign-convention).
### Creating a Beam
The creation of a `Beam` instance involves the input of the beam length (m) and optionally the input of the Young's Modulus (E), second moment of area (I), and cross-sectional area (A). E, I and A are optional and by default are the properties of a steel 150UB18.0. For a beam with constant properties, these parameters will only affect the deflections calculated and not the distribution of forces, unless spring supports are specified.
```python
from indeterminatebeam import Beam
# Create 7 m beam with E, I, A as defaults
beam = Beam(7)
# Create 9 m beam with E, I, and A assigned by user
beam_2 = Beam(9, E=2000, I=10**6, A=3000)
```
### Defining Supports
`Support` objects are created separately from the `Beam` object, and are defined by an x-coordinate (m) and the beams translational and rotational degrees of freedom.
Degrees of freedom are represented by a tuple of 3 booleans, representing the x , y , and m directions respectively. A `1` indicates the support is fixed in a direction and a `0` indicates it is free.
Optionally, stiffness can be specified in either of the translational directions, which overrides the boolean specified.
```python
from indeterminatebeam import Support
# Defines a pin support at location x = 5 m
a = Support(5, (1,1,0))
# Defines a roller support at location x = 0 m
b = Support(0, (0,1,0))
# Defines a fixed support at location x = 7 m
c = Support(7, (1,1,1))
# Assign the support objects to a beam object created earlier
beam.add_supports(a,b,c)
```
### Defining loads
`Load` objects are created separately from the `Beam` object, and are generally defined by a force value and then a coordinate value, however this varies slightly for different types of loading classes.
```python
from indeterminatebeam import PointLoadV, PointTorque, DistributedLoadV
# Create a 1000 N point load at x = 2 m
load_1 = PointLoadV(1000, 2)
# Create a 2000 N/m UDL from x = 1 m to x = 4 m
load_2 = DistributedLoadV(2000, (1, 4))
# Defines a 2 kN.m point torque at x = 3.5 m
load_3 = PointTorque(2*10**3, 3.5)
# Assign the load objects to the beam object
beam.add_loads(load_1,load_2,load_3)
```
### Solving for Forces
Once the `Beam` object has been assigned with `Load` and `Support` objects it can then be solved. To solve for reactions and internal forces we call the analyse function.
```python
beam.analyse()
```
### Plotting results
After the beam has been analysed we can plot the results.
```python
fig_1 = beam.plot_beam_external()
fig_1.show()
fig_2 = beam.plot_beam_internal()
fig_2.show()
```
The `plot_beam_external` and `plot_beam_internal` methods collate otherwise seperate plots.
The script above produces the following figures:
## Installing the package
If you want to install the `indeterminatebeam` package, you run this one-liner:
```shell
pip install indeterminatebeam
```
> **NOTE**: You need Python 3 to install this package (you may need to write `pip3` instead of `pip`).
The library dependencies are listed in the file `requirements.txt`, but you only need to look at them if you clone the repository.
If you install the package via `pip`, the listed dependencies should be installed automatically.
## Future Work
The following are areas that can be implemented in future:
- allow for segmental beam properties (E,I,A)
- calculate axial deflections
- Latex or PDF output of calculations
- More indeterminate beams in testing
## Contributing
The guidelines for contributing are specified [here](https://github.com/JesseBonanno/IndeterminateBeam/blob/main/CONTRIBUTING.md).
## Support
The guidelines for support are specified [here](https://github.com/JesseBonanno/IndeterminateBeam/blob/main/SUPPORT.md).
## License
[](https://github.com/JesseBonanno/IndeterminateBeam/blob/main/LICENSE.txt)
Copyright (c) 2020, Jesse Bonanno
## References
1. Carella, A. (2019). BeamBending: A teaching aid for 1-d shear force and bending moment
diagrams. *Journal of Open Source Education, 2*(16), 65. https://doi.org/10.21105/
jose.00065
2. Hibbeler, R. (2013). *Mechanics of materials*. P.Ed Australia. ISBN: 9810694369
3. Meurer, A., Smith, C. P., Paprocki, M., Čertík, O., Kirpichev, S. B., Rocklin, M., Kumar,
A., Ivanov, S., Moore, J. K., Singh, S., Rathnayake, T., Vig, S., Granger, B. E., Muller,
R. P., Bonazzi, F., Gupta, H., Vats, S., Johansson, F., Pedregosa, F., … Scopatz, A.
(2017). SymPy: symbolic computing in Python. *PeerJ Computer Science, 3*, e103.
https://doi.org/10.7717/peerj-cs.103
4. *Similiarweb*, 2021, https://www.similarweb.com/. Accessed 1 Mar 2021.
5. Plotly Technologies Inc. *Collaborative data science*. Montréal, QC, 2015. https://plot.ly."
Raw data
{
"_id": null,
"home_page": "https://github.com/JesseBonanno/IndeterminateBeam",
"name": "indeterminatebeam",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "statics, indeterminate, beam, civil, structural, shear-force, bending-moment, deflection",
"author": "Jesse Bonanno",
"author_email": "jessebonanno@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/7a/76/712ed277217191a5bdb7ee5585507b080f8d49617955e26e8ed7d287f03e/indeterminatebeam-2.2.2.tar.gz",
"platform": null,
"description": "# Indeterminate Beam\r\n\r\n[](https://github.com/JesseBonanno/IndeterminateBeam/releases/tag/v2.2.2)\r\n[](https://github.com/JesseBonanno/IndeterminateBeam/blob/main/LICENSE.txt)\r\n[](https://doi.org/10.21105/jose.00111)\r\n[](https://indeterminatebeam.readthedocs.io/en/main/?badge=main)\r\n[](https://travis-ci.org/JesseBonanno/IndeterminateBeam)\r\n[](https://www.codefactor.io/repository/github/jessebonanno/indeterminatebeam)\r\n[](https://colab.research.google.com/github/JesseBonanno/IndeterminateBeam/blob/main/docs/examples/simple_demo.ipynb)\r\n[](https://mybinder.org/v2/gh/JesseBonanno/IndeterminateBeam/main?filepath=docs%2Fexamples%2Fsimple_demo.ipynb)\r\n[](https://civils.ai/1/free-beam-calculator)\r\n[](https://pepy.tech/project/indeterminatebeam)\r\n\r\n\r\nIndeterminateBeam is a Python Package aiming to serve as a foundation for civil and structural engineering projects in Python. The module can also serve as a stand-alone program and is useful for determining:\r\n\r\n - reaction forces for indeterminate beams\r\n - internal forces for indeterminate beams (shear, bending, axial)\r\n - deflections of beams due to resulting forces\r\n - axial force, shear force, bending moment and deflection diagrams.\r\n\r\nThe package is based mainly on engineering concepts of statics as described in (Hibbeler, 2013), and Python packages Sympy (Meurer et al., 2017) and Plotly (Plotly Technologies Inc, 2015). \r\n\r\nThe [package documentation](https://indeterminatebeam.readthedocs.io/en/main/theory.html) provides a brief overview of the theory behind the solutions used to calculate the forces on the indeterminate beam. The full package documentation can be accessed [here](https://indeterminatebeam.readthedocs.io/en/main/).\r\n\r\nText-based examples of the package presented in the [documentation](https://indeterminatebeam.readthedocs.io/en/main/examples.html) can be found on this [Jupyter Notebook](https://colab.research.google.com/github/JesseBonanno/IndeterminateBeam/blob/main/docs/examples/simple_demo.ipynb) and a web-based graphical user interface (GUI) is available at https://civils.ai/1/free-beam-calculator.\r\n\r\n## Project Purpose\r\n\r\nThe purpose of this project is two-fold:\r\n1.\tCreate a [free website](https://civils.ai/1/free-beam-calculator) that has more features than paid and free beam calculators that exist on the web.\r\n2.\tProvide a foundation for civil and structural engineers who want to create higher order engineering Python programs.\r\n\r\nSeveral (mostly paid) beam calculator websites currently exist online, providing the same service as this package, with web traffic in the hundreds of thousands per month (Similiarweb, 2021). Despite this, no online service exists (to the authors knowledge) that has all the features of `IndeterminateBeam` and is also free.\r\n\r\nSimiliarly, there are no well-documented indeterminate beam solving Python packages (to the authors knowledge) despite the importance of such a calculation in engineering. Several python finite element analysis (FEA) packages do exist, however they are vastly overcomplicated for someone wanting to only solve for forces on a one-dimensional beam.\r\n\r\nThis python package was heavily inspired by [beambending](https://github.com/alfredocarella/simplebendingpractice) (Carella, 2019), a module created for educational purposes by Alfredo Carella of the Oslo Metropolitan University. The beambending module, although well documented, can only solve for simply supported beams consisting of a pin and roller support. The [package documentation](https://simplebendingpractice.readthedocs.io/en/latest/?badge=latest) for this project includes a more rigorous overview of the theory behind the basics for solving determinate structures.\r\n\r\n## Functionality and Usage\r\n\r\nA typical use case of the ```IndeterminateBeam``` package involves the following steps:\r\n\r\n1. Create a `Beam` object\r\n2. Create `Support` objects and assign to `Beam`\r\n3. Create `Load` objects and assign to `Beam`\r\n4. Solve for forces on `Beam` object\r\n5. Plot results\r\n\r\nYou can follow along with the example below in this web-based [Jupyter Notebook](https://colab.research.google.com/github/JesseBonanno/IndeterminateBeam/blob/main/docs/examples/readme_example.ipynb). \r\nAlternatively, you can download the jupyter-notebook for this example [here](https://raw.githubusercontent.com/JesseBonanno/IndeterminateBeam/main/docs/examples/readme_example.ipynb), or the python file for this code [here](https://raw.githubusercontent.com/JesseBonanno/IndeterminateBeam/main/docs/examples/readme_example.py).\r\n\r\nThe units used throughout the Python package are the base SI units (newtons and metres), but can be updated using the `update_units` method. Units and load direction conventions are described in the [package documentation](https://indeterminatebeam.readthedocs.io/en/main/theory.html#sign-convention).\r\n\r\n### Creating a Beam\r\n\r\nThe creation of a `Beam` instance involves the input of the beam length (m) and optionally the input of the Young's Modulus (E), second moment of area (I), and cross-sectional area (A). E, I and A are optional and by default are the properties of a steel 150UB18.0. For a beam with constant properties, these parameters will only affect the deflections calculated and not the distribution of forces, unless spring supports are specified.\r\n\r\n```python\r\nfrom indeterminatebeam import Beam\r\n# Create 7 m beam with E, I, A as defaults\r\nbeam = Beam(7) \r\n# Create 9 m beam with E, I, and A assigned by user\r\nbeam_2 = Beam(9, E=2000, I=10**6, A=3000) \r\n```\r\n\r\n### Defining Supports\r\n`Support` objects are created separately from the `Beam` object, and are defined by an x-coordinate (m) and the beams translational and rotational degrees of freedom.\r\n\r\nDegrees of freedom are represented by a tuple of 3 booleans, representing the x , y , and m directions respectively. A `1` indicates the support is fixed in a direction and a `0` indicates it is free.\r\n\r\nOptionally, stiffness can be specified in either of the translational directions, which overrides the boolean specified.\r\n\r\n```python\r\nfrom indeterminatebeam import Support\r\n# Defines a pin support at location x = 5 m \r\na = Support(5, (1,1,0)) \r\n# Defines a roller support at location x = 0 m\r\nb = Support(0, (0,1,0)) \r\n# Defines a fixed support at location x = 7 m\r\nc = Support(7, (1,1,1)) \r\n# Assign the support objects to a beam object created earlier\r\nbeam.add_supports(a,b,c) \r\n```\r\n\r\n### Defining loads\r\n`Load` objects are created separately from the `Beam` object, and are generally defined by a force value and then a coordinate value, however this varies slightly for different types of loading classes.\r\n\r\n```python\r\nfrom indeterminatebeam import PointLoadV, PointTorque, DistributedLoadV\r\n# Create a 1000 N point load at x = 2 m\r\nload_1 = PointLoadV(1000, 2)\r\n# Create a 2000 N/m UDL from x = 1 m to x = 4 m\r\nload_2 = DistributedLoadV(2000, (1, 4))\r\n# Defines a 2 kN.m point torque at x = 3.5 m\r\nload_3 = PointTorque(2*10**3, 3.5)\r\n# Assign the load objects to the beam object\r\nbeam.add_loads(load_1,load_2,load_3)\r\n```\r\n\r\n### Solving for Forces\r\nOnce the `Beam` object has been assigned with `Load` and `Support` objects it can then be solved. To solve for reactions and internal forces we call the analyse function.\r\n\r\n```python\r\nbeam.analyse() \r\n```\r\n\r\n### Plotting results\r\nAfter the beam has been analysed we can plot the results.\r\n\r\n```python\r\nfig_1 = beam.plot_beam_external()\r\nfig_1.show()\r\n\r\nfig_2 = beam.plot_beam_internal()\r\nfig_2.show()\r\n```\r\n\r\nThe `plot_beam_external` and `plot_beam_internal` methods collate otherwise seperate plots.\r\n\r\nThe script above produces the following figures:\r\n\r\n\r\n\r\n\r\n## Installing the package\r\n\r\nIf you want to install the `indeterminatebeam` package, you run this one-liner:\r\n\r\n```shell\r\npip install indeterminatebeam\r\n```\r\n\r\n> **NOTE**: You need Python 3 to install this package (you may need to write `pip3` instead of `pip`).\r\n\r\nThe library dependencies are listed in the file `requirements.txt`, but you only need to look at them if you clone the repository.\r\nIf you install the package via `pip`, the listed dependencies should be installed automatically.\r\n\r\n## Future Work\r\n\r\nThe following are areas that can be implemented in future:\r\n- allow for segmental beam properties (E,I,A)\r\n- calculate axial deflections\r\n- Latex or PDF output of calculations\r\n- More indeterminate beams in testing\r\n\r\n## Contributing\r\n\r\nThe guidelines for contributing are specified [here](https://github.com/JesseBonanno/IndeterminateBeam/blob/main/CONTRIBUTING.md).\r\n\r\n## Support\r\n\r\nThe guidelines for support are specified [here](https://github.com/JesseBonanno/IndeterminateBeam/blob/main/SUPPORT.md).\r\n\r\n\r\n## License\r\n\r\n[](https://github.com/JesseBonanno/IndeterminateBeam/blob/main/LICENSE.txt)\r\n\r\nCopyright (c) 2020, Jesse Bonanno\r\n\r\n## References\r\n\r\n1. Carella, A. (2019). BeamBending: A teaching aid for 1-d shear force and bending moment\r\ndiagrams. *Journal of Open Source Education, 2*(16), 65. https://doi.org/10.21105/\r\njose.00065\r\n2. Hibbeler, R. (2013). *Mechanics of materials*. P.Ed Australia. ISBN: 9810694369\r\n3. Meurer, A., Smith, C. P., Paprocki, M., \u010cert\u00edk, O., Kirpichev, S. B., Rocklin, M., Kumar,\r\nA., Ivanov, S., Moore, J. K., Singh, S., Rathnayake, T., Vig, S., Granger, B. E., Muller,\r\nR. P., Bonazzi, F., Gupta, H., Vats, S., Johansson, F., Pedregosa, F., \u2026 Scopatz, A.\r\n(2017). SymPy: symbolic computing in Python. *PeerJ Computer Science, 3*, e103.\r\nhttps://doi.org/10.7717/peerj-cs.103\r\n4. *Similiarweb*, 2021, https://www.similarweb.com/. Accessed 1 Mar 2021.\r\n5. Plotly Technologies Inc. *Collaborative data science*. Montr\u00e9al, QC, 2015. https://plot.ly.\"\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A solver for 1D indeterminate beams",
"version": "2.2.2",
"project_urls": {
"Download": "https://github.com/JesseBonanno/IndeterminateBeam/archive/v2.2.2.tar.gz",
"Homepage": "https://github.com/JesseBonanno/IndeterminateBeam"
},
"split_keywords": [
"statics",
" indeterminate",
" beam",
" civil",
" structural",
" shear-force",
" bending-moment",
" deflection"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7a76712ed277217191a5bdb7ee5585507b080f8d49617955e26e8ed7d287f03e",
"md5": "12c40eecebefd590a52a00a4eafb3513",
"sha256": "803c6080c1ddf5931f8f4e79cbb4a9173ad2ad32edcd2a15508014fc9ce8a895"
},
"downloads": -1,
"filename": "indeterminatebeam-2.2.2.tar.gz",
"has_sig": false,
"md5_digest": "12c40eecebefd590a52a00a4eafb3513",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 37815,
"upload_time": "2024-08-18T13:00:17",
"upload_time_iso_8601": "2024-08-18T13:00:17.550561Z",
"url": "https://files.pythonhosted.org/packages/7a/76/712ed277217191a5bdb7ee5585507b080f8d49617955e26e8ed7d287f03e/indeterminatebeam-2.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-18 13:00:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "JesseBonanno",
"github_project": "IndeterminateBeam",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "indeterminatebeam"
}
JSON
