# Geometry3D
## About Geometry3D
Geometry3D is a simple python computational geographics library written in python.
This library focuses on the functions and lacks efficiency which might be improved in future version.
## Core Features
- Basic 3D Geometries: Point, Line, Plane, Segment, Convex Polygon and Convex Polyhedron.
- Simple Object like Cubic, Sphere, Cylinder, Cone, Rectangle, Parallepiped, Parallogram and Circle.
- Basic Attributes Of Geometries: length, area, volume.
- Basic Relationships And Operations Between Geometries: move, angle, parallel, orthogonal, intersection.
- Overload Build-In Functions Such As `__contains__`, `__hash__`, `__eq__`, `__neg__`.
- A Naive Renderer Using `matplotlib`.
Some of the code comes from [sgl](https://github.com/Kingdread/sgl) whose author is really interesting.
## Requirements
* [Python](http://www.python.org) 3
* No additional third-party library is required, it's written in pure python and standard library.
* Matplotlib is needed if you want to use the renderer.
## Documentation
[](https://geometry3d.readthedocs.io/en/latest/?badge=latest)
- [https://geometry3d.readthedocs.io/en/latest](https://geometry3d.readthedocs.io/en/latest/)
- [pdf](https://geometry3d.readthedocs.io/_/downloads/en/latest/pdf/)
## Installation
```bash
pip install Geometry3D
```
## Test
### Unit Tests
```bash
python run_tests.py
```
### Tests
Run .py files under g3d_tests folder.
For example:
```bash
python g3d_tests/test1.py
```
## Usage
See Documentations
## Change Log
[changelog.md](changelog.md)
## License
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
## Contact
gouminghao@gmail.com
Raw data
{
"_id": null,
"home_page": "https://github.com/m-albert/Geometry3D",
"name": "Geometry3D-vendored",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "analytic geometry intersection 3d",
"author": "Minghao Gou",
"author_email": "gouminghao@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a6/79/0f0ed7f9e697ac6e327443e84bd9d3d86a0072cb26ef374b18443b74dc02/Geometry3D_vendored-0.3.0.tar.gz",
"platform": null,
"description": "# Geometry3D\n\n## About Geometry3D\n\nGeometry3D is a simple python computational geographics library written in python.\nThis library focuses on the functions and lacks efficiency which might be improved in future version.\n\n\n## Core Features\n- Basic 3D Geometries: Point, Line, Plane, Segment, Convex Polygon and Convex Polyhedron.\n- Simple Object like Cubic, Sphere, Cylinder, Cone, Rectangle, Parallepiped, Parallogram and Circle. \n- Basic Attributes Of Geometries: length, area, volume.\n- Basic Relationships And Operations Between Geometries: move, angle, parallel, orthogonal, intersection.\n- Overload Build-In Functions Such As `__contains__`, `__hash__`, `__eq__`, `__neg__`.\n- A Naive Renderer Using `matplotlib`.\n\n\n\n\n\n\n\n\n\n\nSome of the code comes from [sgl](https://github.com/Kingdread/sgl) whose author is really interesting.\n\n## Requirements\n\n* [Python](http://www.python.org) 3 \n* No additional third-party library is required, it's written in pure python and standard library. \n* Matplotlib is needed if you want to use the renderer.\n\n## Documentation\n\n[](https://geometry3d.readthedocs.io/en/latest/?badge=latest)\n\n- [https://geometry3d.readthedocs.io/en/latest](https://geometry3d.readthedocs.io/en/latest/)\n\n- [pdf](https://geometry3d.readthedocs.io/_/downloads/en/latest/pdf/)\n\n## Installation\n```bash\npip install Geometry3D\n```\n\n## Test\n### Unit Tests\n```bash\npython run_tests.py\n```\n\n### Tests\nRun .py files under g3d_tests folder.\nFor example:\n```bash\npython g3d_tests/test1.py\n```\n\n## Usage\n\nSee Documentations\n\n## Change Log\n\n[changelog.md](changelog.md)\n\n## License\n\n This program is free software: you can redistribute it and/or modify\n it under the terms of the GNU General Public License as published by\n the Free Software Foundation, either version 3 of the License, or\n (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\n GNU General Public License for more details.\n\n You should have received a copy of the GNU General Public License\n along with this program. If not, see <http://www.gnu.org/licenses/>.\n\n## Contact\ngouminghao@gmail.com\n",
"bugtrack_url": null,
"license": "GPL",
"summary": "A 3D Geometry Lib",
"version": "0.3.0",
"project_urls": {
"Homepage": "https://github.com/m-albert/Geometry3D"
},
"split_keywords": [
"analytic",
"geometry",
"intersection",
"3d"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5877b71da515952ad81bd94f3d123113f102d38f3f1b7487db0dda346bf54efb",
"md5": "ef330b83dc3b006bb0ebb6ccb81de695",
"sha256": "96d7e6b49eca8c251ba65613ccad9675227cc0c4b66241b6896f1b274d691fd7"
},
"downloads": -1,
"filename": "Geometry3D_vendored-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ef330b83dc3b006bb0ebb6ccb81de695",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 48511,
"upload_time": "2024-02-25T18:43:05",
"upload_time_iso_8601": "2024-02-25T18:43:05.282616Z",
"url": "https://files.pythonhosted.org/packages/58/77/b71da515952ad81bd94f3d123113f102d38f3f1b7487db0dda346bf54efb/Geometry3D_vendored-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a6790f0ed7f9e697ac6e327443e84bd9d3d86a0072cb26ef374b18443b74dc02",
"md5": "8f0222503f7c1db2f347633cc70258dc",
"sha256": "16fcacb2d2b0813464b93ec332b08dd7c42d3f17ddf0fb00412818104ee5379e"
},
"downloads": -1,
"filename": "Geometry3D_vendored-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "8f0222503f7c1db2f347633cc70258dc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 38817,
"upload_time": "2024-02-25T18:43:07",
"upload_time_iso_8601": "2024-02-25T18:43:07.319390Z",
"url": "https://files.pythonhosted.org/packages/a6/79/0f0ed7f9e697ac6e327443e84bd9d3d86a0072cb26ef374b18443b74dc02/Geometry3D_vendored-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-25 18:43:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "m-albert",
"github_project": "Geometry3D",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "geometry3d-vendored"
}
JSON
