# SolidsPy: 2D-Finite Element Analysis with Python
![](https://raw.githubusercontent.com/AppliedMechanics-EAFIT/SolidsPy/master/docs/img/wrench.png)
[![PyPI download](https://img.shields.io/pypi/v/solidspy.svg)](https://pypi.python.org/pypi/continuum_mechanics)
[![Documentation Status](https://readthedocs.org/projects/solidspy/badge/?version=latest)](https://solidspy.readthedocs.io/en/latest/)
[![Downloads frequency](https://img.shields.io/pypi/dm/solidspy)](https://pypistats.org/packages/solidspy)
[![image](https://zenodo.org/badge/48294591.svg)](https://zenodo.org/badge/latestdoi/48294591)
A simple finite element analysis code for 2D elasticity problems. The code uses
as input simple-to-create text files defining a model in terms of nodal,
element, material and load data.
- Documentation: <http://solidspy.readthedocs.io>
- GitHub: <https://github.com/AppliedMechanics-EAFIT/SolidsPy>
- PyPI: <https://pypi.org/project/solidspy/>
- Free and open source software: [MIT license](http://en.wikipedia.org/wiki/MIT_License)
## Features
- It is based on an open-source environment.
- It is easy to use.
- The code allows to find displacement, strain and stress solutions
for arbitrary two-dimensional domains discretized into finite
elements and subject to point loads.
- The code is organized in independent modules for pre-processing,
assembly and post-processing allowing the user to easily modify it
or add features like new elements or analyses pipelines.
- It was created with academic and research purposes.
- It has been used to tech the following courses:
- Introduction to Solid Mechanics.
- Computational Modeling.
- Introduction to the Finite Element Methods.
- Introduction to Soil Mechanics.
## Installation
The code is written in Python and it depends on `numpy`, and `scipy` and. It
has been tested under Windows, Mac, Linux and Android.
To install *SolidsPy* open a terminal and type:
pip install solidspy
To specify through a GUI the folder where the input files are stored you will
need to install [easygui](http://easygui.readthedocs.org/en/master/).
To easily generate the required SolidsPy text files out of a
[Gmsh](http://gmsh.info/) model you will need [meshio](https://github.com/nschloe/meshio).
These two can be installed with:
pip install easygui
pip install meshio
## How to run a simple model
For further explanation check the [docs](http://solidspy.readthedocs.io/en/latest/).
Let's suppose that we have a simple model represented by the following files
(see [tutorials/square example](http://solidspy.readthedocs.io/en/latest/tutorials/square_example.html)
for further explanation).
- `nodes.txt`
```
0 0.00 0.00 0 -1
1 2.00 0.00 0 -1
2 2.00 2.00 0 0
3 0.00 2.00 0 0
4 1.00 0.00 -1 -1
5 2.00 1.00 0 0
6 1.00 2.00 0 0
7 0.00 1.00 0 0
8 1.00 1.00 0 0
```
- `eles.txt`
```
0 1 0 0 4 8 7
1 1 0 4 1 5 8
2 1 0 7 8 6 3
3 1 0 8 5 2 6
```
- `mater.txt`
```
1.0 0.3
```
- `loads.txt`
```
3 0.0 1.0
6 0.0 2.0
2 0.0 1.0
```
Run it in Python as follows:
``` python
import matplotlib.pyplot as plt # load matplotlib
from solidspy import solids_GUI # import our package
disp = solids_GUI() # run the Finite Element Analysis
plt.show() # plot contours
```
For Mac users it is suggested to use an IPython console to run the example.
## License
This project is licensed under the [MIT license](http://en.wikipedia.org/wiki/MIT_License).
The documents are licensed under [Creative Commons Attribution License](http://creativecommons.org/licenses/by/4.0/).
## Citation
To cite SolidsPy in publications use
> Nicolás Guarín-Zapata, Juan Gomez (2023). SolidsPy: Version 1.1.0
> (Version v1.1.0). Zenodo. <https://doi.org/10.5281/zenodo.7694030>
A BibTeX entry for LaTeX users is
```bibtex
@software{solidspy,
title = {SolidsPy: 2D-Finite Element Analysis with Python},
version = {1.1.0},
author = {Guarín-Zapata, Nicolás and Gómez, Juan},
year = 2023,
keywords = {Python, Finite elements, Scientific computing, Computational mechanics},
abstract = {SolidsPy is a simple finite element analysis code for 2D elasticity
problems. The code uses as input simple-to-create text files defining a model
in terms of nodal, element, material and load data.},
url = {https://github.com/AppliedMechanics-EAFIT/SolidsPy},
doi = {https://doi.org/10.5281/zenodo.7694030}
}
```
Raw data
{
"_id": null,
"home_page": "https://github.com/AppliedMechanics-EAFIT/SolidsPy",
"name": "solidspy",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "finite-elements fem scientific-computing",
"author": "Nicolas Guarin-Zapata <nguarinz@eafit.edu.co>, Juan Gomez <jgomezc1@eafit.edu.co>",
"author_email": "nguarinz@eafit.edu.co",
"download_url": "https://files.pythonhosted.org/packages/e1/08/8e44037de6c971c7ad4157928ad79eadb401d2d223a3efcb1d7137439434/solidspy-1.1.0.post1.tar.gz",
"platform": null,
"description": "# SolidsPy: 2D-Finite Element Analysis with Python\r\n\r\n![](https://raw.githubusercontent.com/AppliedMechanics-EAFIT/SolidsPy/master/docs/img/wrench.png) \r\n[![PyPI download](https://img.shields.io/pypi/v/solidspy.svg)](https://pypi.python.org/pypi/continuum_mechanics)\r\n[![Documentation Status](https://readthedocs.org/projects/solidspy/badge/?version=latest)](https://solidspy.readthedocs.io/en/latest/)\r\n[![Downloads frequency](https://img.shields.io/pypi/dm/solidspy)](https://pypistats.org/packages/solidspy)\r\n[![image](https://zenodo.org/badge/48294591.svg)](https://zenodo.org/badge/latestdoi/48294591)\r\n\r\nA simple finite element analysis code for 2D elasticity problems. The code uses\r\nas input simple-to-create text files defining a model in terms of nodal,\r\nelement, material and load data.\r\n\r\n- Documentation: <http://solidspy.readthedocs.io>\r\n- GitHub: <https://github.com/AppliedMechanics-EAFIT/SolidsPy>\r\n- PyPI: <https://pypi.org/project/solidspy/>\r\n- Free and open source software: [MIT license](http://en.wikipedia.org/wiki/MIT_License)\r\n\r\n## Features\r\n\r\n- It is based on an open-source environment.\r\n- It is easy to use.\r\n- The code allows to find displacement, strain and stress solutions\r\n for arbitrary two-dimensional domains discretized into finite\r\n elements and subject to point loads.\r\n- The code is organized in independent modules for pre-processing,\r\n assembly and post-processing allowing the user to easily modify it\r\n or add features like new elements or analyses pipelines.\r\n- It was created with academic and research purposes.\r\n- It has been used to tech the following courses:\r\n - Introduction to Solid Mechanics.\r\n - Computational Modeling.\r\n - Introduction to the Finite Element Methods.\r\n - Introduction to Soil Mechanics.\r\n\r\n## Installation\r\n\r\nThe code is written in Python and it depends on `numpy`, and `scipy` and. It\r\nhas been tested under Windows, Mac, Linux and Android.\r\n\r\nTo install *SolidsPy* open a terminal and type:\r\n\r\n pip install solidspy\r\n\r\nTo specify through a GUI the folder where the input files are stored you will\r\nneed to install [easygui](http://easygui.readthedocs.org/en/master/).\r\n\r\nTo easily generate the required SolidsPy text files out of a\r\n[Gmsh](http://gmsh.info/) model you will need [meshio](https://github.com/nschloe/meshio).\r\n\r\nThese two can be installed with:\r\n\r\n pip install easygui\r\n pip install meshio\r\n\r\n## How to run a simple model\r\n\r\nFor further explanation check the [docs](http://solidspy.readthedocs.io/en/latest/).\r\n\r\nLet's suppose that we have a simple model represented by the following files\r\n(see [tutorials/square example](http://solidspy.readthedocs.io/en/latest/tutorials/square_example.html)\r\nfor further explanation).\r\n\r\n- `nodes.txt`\r\n\r\n```\r\n 0 0.00 0.00 0 -1\r\n 1 2.00 0.00 0 -1\r\n 2 2.00 2.00 0 0\r\n 3 0.00 2.00 0 0\r\n 4 1.00 0.00 -1 -1\r\n 5 2.00 1.00 0 0\r\n 6 1.00 2.00 0 0\r\n 7 0.00 1.00 0 0\r\n 8 1.00 1.00 0 0\r\n```\r\n\r\n\r\n- `eles.txt`\r\n\r\n```\r\n 0 1 0 0 4 8 7\r\n 1 1 0 4 1 5 8\r\n 2 1 0 7 8 6 3\r\n 3 1 0 8 5 2 6\r\n```\r\n\r\n\r\n- `mater.txt`\r\n\r\n```\r\n 1.0 0.3\r\n```\r\n\r\n\r\n- `loads.txt`\r\n\r\n```\r\n 3 0.0 1.0\r\n 6 0.0 2.0\r\n 2 0.0 1.0\r\n```\r\n\r\n\r\nRun it in Python as follows:\r\n\r\n``` python\r\nimport matplotlib.pyplot as plt # load matplotlib\r\nfrom solidspy import solids_GUI # import our package\r\ndisp = solids_GUI() # run the Finite Element Analysis\r\nplt.show() # plot contours\r\n```\r\n\r\nFor Mac users it is suggested to use an IPython console to run the example.\r\n\r\n## License\r\n\r\nThis project is licensed under the [MIT license](http://en.wikipedia.org/wiki/MIT_License).\r\nThe documents are licensed under [Creative Commons Attribution License](http://creativecommons.org/licenses/by/4.0/).\r\n\r\n## Citation\r\n\r\nTo cite SolidsPy in publications use\r\n\r\n> Nicol\u00e1s Guar\u00edn-Zapata, Juan Gomez (2023). SolidsPy: Version 1.1.0\r\n> (Version v1.1.0). Zenodo. <https://doi.org/10.5281/zenodo.7694030>\r\n\r\nA BibTeX entry for LaTeX users is\r\n\r\n```bibtex\r\n@software{solidspy,\r\n title = {SolidsPy: 2D-Finite Element Analysis with Python},\r\n version = {1.1.0},\r\n author = {Guar\u00edn-Zapata, Nicol\u00e1s and G\u00f3mez, Juan},\r\n year = 2023,\r\n keywords = {Python, Finite elements, Scientific computing, Computational mechanics},\r\n abstract = {SolidsPy is a simple finite element analysis code for 2D elasticity\r\n problems. The code uses as input simple-to-create text files defining a model\r\n in terms of nodal, element, material and load data.},\r\n url = {https://github.com/AppliedMechanics-EAFIT/SolidsPy},\r\n doi = {https://doi.org/10.5281/zenodo.7694030}\r\n}\r\n```\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A simple Finite Element program",
"version": "1.1.0.post1",
"project_urls": {
"Homepage": "https://github.com/AppliedMechanics-EAFIT/SolidsPy"
},
"split_keywords": [
"finite-elements",
"fem",
"scientific-computing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e1088e44037de6c971c7ad4157928ad79eadb401d2d223a3efcb1d7137439434",
"md5": "b22726001f0c760b682d0b81fee5f755",
"sha256": "8e3c065394bdb30478bbd3bffe739318cfc34c7f1ecabb873fb35cdee29e2480"
},
"downloads": -1,
"filename": "solidspy-1.1.0.post1.tar.gz",
"has_sig": false,
"md5_digest": "b22726001f0c760b682d0b81fee5f755",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 30777,
"upload_time": "2023-11-04T14:39:57",
"upload_time_iso_8601": "2023-11-04T14:39:57.765618Z",
"url": "https://files.pythonhosted.org/packages/e1/08/8e44037de6c971c7ad4157928ad79eadb401d2d223a3efcb1d7137439434/solidspy-1.1.0.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-04 14:39:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AppliedMechanics-EAFIT",
"github_project": "SolidsPy",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "solidspy"
}