# PyCG: Toolbox for CG-related visualizations and computations
[![Publish to PyPI.org](https://github.com/heiwang1997/pycg/actions/workflows/publish.yml/badge.svg)](https://github.com/heiwang1997/pycg/actions/workflows/publish.yml)
[![Documentation Status](https://readthedocs.org/projects/pycg/badge/?version=latest)](https://pycg.readthedocs.io/en/latest/?badge=latest)
PyCG is there for people to accelerate their 3D visualizations and computations, aiming at implementing complicated functions with as few lines as possible.
The toolbox is created from the perspective of researchers and would hopefully accelerate your daily pipeline.
## Install
```shell
pip install -U python-pycg
```
**DONT READ MORE!!!!!! DONT READ MORE!!!! STOP NOW!!!!**
HAHA. Actually I really want you to read this -- to install a full-fledged version, use:
```bash
pip install -U python-pycg[all] -f https://pycg.huangjh.tech/packages/index.html
```
> Note that the need for the extra index URL if for our [customized version of Open3D, `named open3d_pycg_cpu`](https://github.com/heiwang1997/Open3D) (with support for multi-window camera/light synchronization, animation maker and visualizer, scalar analyzer, etc).
For developers, clone this repository and install it if you want to use newest features:
```shell
git clone --recursive https://github.com/heiwang1997/pycg
pip install open3d_pycg_cpu -f https://pycg.huangjh.tech/packages/index.html
pip install -e .[all] # Most modern, but some static analyzing tool (e.g. pylance) will fail!
# Now it will create weird __editable__.*.pth files!
python setup.py develop # Deprecated by the community, but it works better.
```
## Using PyCG
PyCG contains many submodules which could be easily imported via `from pycg import xxx`.
These different modules span a wide range of functionalities from visualizing 3D assets to creating nice html tables for comparing results.
Please refer to the individual documentation of each submodule to get started.
- 3D Visualization `pycg.vis`
- Render 3D Scenes `pycg.render`
- Handling 3D Transformations `pycg.isometry`
- Compress Videos `pycg.video`
- Compress PDF Files `pycg.pdf`
- Experiment Utilities `pycg.exp`
- Manipulating Images `pycg.image`
- ... and so on to be added!
## Gallery
![](docs/demo/render.png)
<video src="https://github.com/heiwang1997/pycg/raw/master/docs/demo/scene_show.mp4" controls autoplay></video>
<video src="https://github.com/heiwang1997/pycg/raw/master/docs/demo/selection.mp4" controls autoplay></video>
<video src="https://github.com/heiwang1997/pycg/raw/master/docs/demo/animation_light.mp4" controls autoplay></video>
<video src="https://github.com/heiwang1997/pycg/raw/master/docs/demo/animation_arrow.mp4" controls autoplay></video>
Raw data
{
"_id": null,
"home_page": "https://github.com/heiwang1997/pycg",
"name": "python-pycg",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "pycg, graphics, 3d, visualization",
"author": "Jiahui Huang",
"author_email": "huangjh.work@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/31/e8/dd15a05a271480a02af6650dba8a658440bd52cc517d17b405a776b10323/python_pycg-0.9.2.tar.gz",
"platform": null,
"description": "# PyCG: Toolbox for CG-related visualizations and computations\n\n[![Publish to PyPI.org](https://github.com/heiwang1997/pycg/actions/workflows/publish.yml/badge.svg)](https://github.com/heiwang1997/pycg/actions/workflows/publish.yml)\n[![Documentation Status](https://readthedocs.org/projects/pycg/badge/?version=latest)](https://pycg.readthedocs.io/en/latest/?badge=latest)\n\nPyCG is there for people to accelerate their 3D visualizations and computations, aiming at implementing complicated functions with as few lines as possible.\nThe toolbox is created from the perspective of researchers and would hopefully accelerate your daily pipeline.\n\n## Install\n\n```shell\npip install -U python-pycg\n```\n\n**DONT READ MORE!!!!!! DONT READ MORE!!!! STOP NOW!!!!**\n\nHAHA. Actually I really want you to read this -- to install a full-fledged version, use:\n```bash\npip install -U python-pycg[all] -f https://pycg.huangjh.tech/packages/index.html\n```\n\n> Note that the need for the extra index URL if for our [customized version of Open3D, `named open3d_pycg_cpu`](https://github.com/heiwang1997/Open3D) (with support for multi-window camera/light synchronization, animation maker and visualizer, scalar analyzer, etc).\n\nFor developers, clone this repository and install it if you want to use newest features:\n```shell\ngit clone --recursive https://github.com/heiwang1997/pycg\npip install open3d_pycg_cpu -f https://pycg.huangjh.tech/packages/index.html\npip install -e .[all] # Most modern, but some static analyzing tool (e.g. pylance) will fail!\n # Now it will create weird __editable__.*.pth files!\npython setup.py develop # Deprecated by the community, but it works better.\n```\n\n## Using PyCG\n\nPyCG contains many submodules which could be easily imported via `from pycg import xxx`.\nThese different modules span a wide range of functionalities from visualizing 3D assets to creating nice html tables for comparing results.\nPlease refer to the individual documentation of each submodule to get started.\n\n- 3D Visualization `pycg.vis`\n- Render 3D Scenes `pycg.render`\n- Handling 3D Transformations `pycg.isometry`\n- Compress Videos `pycg.video`\n- Compress PDF Files `pycg.pdf`\n- Experiment Utilities `pycg.exp`\n- Manipulating Images `pycg.image`\n- ... and so on to be added!\n\n## Gallery\n\n![](docs/demo/render.png)\n\n<video src=\"https://github.com/heiwang1997/pycg/raw/master/docs/demo/scene_show.mp4\" controls autoplay></video>\n\n<video src=\"https://github.com/heiwang1997/pycg/raw/master/docs/demo/selection.mp4\" controls autoplay></video>\n\n<video src=\"https://github.com/heiwang1997/pycg/raw/master/docs/demo/animation_light.mp4\" controls autoplay></video>\n\n<video src=\"https://github.com/heiwang1997/pycg/raw/master/docs/demo/animation_arrow.mp4\" controls autoplay></video>\n",
"bugtrack_url": null,
"license": null,
"summary": "PyCG: Toolbox for CG-related visualizations and computations",
"version": "0.9.2",
"project_urls": {
"Homepage": "https://github.com/heiwang1997/pycg"
},
"split_keywords": [
"pycg",
" graphics",
" 3d",
" visualization"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c94b6bf4f83bebb9bfa17bec64fe0384ff042524c071421a96ebff1803209835",
"md5": "adc2d79c4fc7428cc08a28fdb317391f",
"sha256": "1a6a158f4d9ed217895304b75939233521046d0839ba7e64438656f0d4ab88f9"
},
"downloads": -1,
"filename": "python_pycg-0.9.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "adc2d79c4fc7428cc08a28fdb317391f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 31351391,
"upload_time": "2024-11-01T21:56:16",
"upload_time_iso_8601": "2024-11-01T21:56:16.255943Z",
"url": "https://files.pythonhosted.org/packages/c9/4b/6bf4f83bebb9bfa17bec64fe0384ff042524c071421a96ebff1803209835/python_pycg-0.9.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "31e8dd15a05a271480a02af6650dba8a658440bd52cc517d17b405a776b10323",
"md5": "c3ab5ee87048f3d517bcb46e75e612e1",
"sha256": "4a561db943c2a95457f122ff8bc6caecf108da2948d392f8657e15cca329856f"
},
"downloads": -1,
"filename": "python_pycg-0.9.2.tar.gz",
"has_sig": false,
"md5_digest": "c3ab5ee87048f3d517bcb46e75e612e1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 31348501,
"upload_time": "2024-11-01T21:56:19",
"upload_time_iso_8601": "2024-11-01T21:56:19.454618Z",
"url": "https://files.pythonhosted.org/packages/31/e8/dd15a05a271480a02af6650dba8a658440bd52cc517d17b405a776b10323/python_pycg-0.9.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-01 21:56:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "heiwang1997",
"github_project": "pycg",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "python-pycg"
}