# TrimeshTools - collection of tools for 3D modeling with Trimesh
[](https://pypi.org/project/trimeshtools/)
[](https://github.com/Smoren/trimeshtools-pypi/releases)
[](https://pepy.tech/projects/trimeshtools)
[](https://github.com/Smoren/trimeshtools-pypi/actions)
[](https://github.com/Smoren/trimeshtools-pypi/blob/master/LICENSE)
## Overview
`trimeshtools-pypi` is a minimalistic Python library designed to extend the capabilities of the popular `trimesh` library.
It provides a limited set of tools for basic 3D mesh manipulation, including operations for combining, moving, rotating,
and visualizing 3D models. This library aims to simplify common mesh processing tasks, making it easier for developers
and researchers to work with 3D data in Python.
## Key Features
* **Mesh Combination**: Seamlessly perform boolean union operations and concatenate multiple meshes.
* **Advanced Deformation**: Apply various deformation techniques such as bending, spiral bending, and twisting to meshes.
* **Precise Editing**: Subdivide meshes for increased detail and accurately cut meshes using defined planes.
* **Transformations**: Easily move meshes to specific positions (center, floor, custom bounds) and apply rotations or mirroring transformations.
* **Geometric Figure Creation**: Generate complex 3D shapes like Archimedean spirals and rounded boxes.
* **Surface Operations**: Utilize the `Surface` class for advanced operations, including creating surfaces from vertices, paths, Z-functions, and parametric functions, as well as thickening surfaces.
* **Visualization**: Conveniently display meshes in a 3D viewer, with optional axis visualization.
* **Mesh Repair Utilities**: Includes functions to fix common mesh issues such as merging vertices, removing duplicate faces, and correcting normals.
## Installation
To install `trimeshtools-pypi`, you can use pip:
```bash
pip install trimeshtools-pypi
```
## Usage
Here are some basic examples of how to use `trimeshtools-pypi`.
### Combining Meshes
```python
import trimesh
from trimeshtools.combine import union_meshes, concatenate_meshes
# Create some sample meshes
mesh1 = trimesh.creation.box()
mesh2 = trimesh.creation.sphere()
# Perform a union operation
combined_mesh_union = union_meshes(mesh1, mesh2)
# Concatenate meshes
combined_mesh_concat = concatenate_meshes(mesh1, mesh2)
```
### Deforming Meshes
```python
import trimesh
from trimeshtools.deform import bend_mesh, spiral_bend_mesh, twist_mesh
# Create a sample mesh
mesh = trimesh.creation.box()
# Bend the mesh
bent_mesh = bend_mesh(mesh.copy(), radius=10)
# Spiral bend the mesh
spiral_bent_mesh = spiral_bend_mesh(mesh.copy(), bend_amount=0.5)
# Twist the mesh
twisted_mesh = twist_mesh(mesh.copy(), num_rotations=3)
```
### Editing Meshes
```python
import trimesh
from trimeshtools.edit import subdivide_shape, cut_mesh
import numpy as np
# Create a sample mesh
mesh = trimesh.creation.box()
# Subdivide the mesh
subdivided_mesh = subdivide_shape(mesh.copy(), iterations=1)
# Cut the mesh
plane_origin = [0, 0, 0]
plane_normal = [0, 0, 1]
mesh_above, mesh_below = cut_mesh(mesh.copy(), plane_origin, plane_normal)
```
### Moving Meshes
```python
import trimesh
from trimeshtools.move import move_to_center, move_to_floor, move_to_bound
# Create a sample mesh
mesh = trimesh.creation.box()
# Move to center
centered_mesh = move_to_center(mesh.copy())
# Move to floor
floored_mesh = move_to_floor(mesh.copy())
# Move to specific bound
bound_mesh = move_to_bound(mesh.copy(), x=1, y=-1, z=0)
```
### Rotating Meshes
```python
import trimesh
from trimeshtools.rotate import create_rotation_matrix_for_x, create_mirror_matrix
import numpy as np
# Create a sample mesh
mesh = trimesh.creation.box()
# Create rotation matrix and apply
rotation_matrix = create_rotation_matrix_for_x(np.radians(45))
rotated_mesh = mesh.copy().apply_transform(rotation_matrix)
# Create mirror matrix and apply
mirror_matrix = create_mirror_matrix(x=True)
mirrored_mesh = mesh.copy().apply_transform(mirror_matrix)
```
### Showing Meshes
```python
import trimesh
from trimeshtools.show import show_mesh
# Create a sample mesh
mesh = trimesh.creation.box()
# Show the mesh
show_mesh(mesh)
```
### Surface Operations
```python
import trimesh
import numpy as np
from trimeshtools.surface import Surface
# Create a surface from vertices
vertices = np.array([
[0, 0, 0],
[1, 0, 0],
[0, 1, 0],
[1, 1, 0]
])
surface_from_vertices = Surface.from_vertices(vertices)
# Create a surface from a z-function
def custom_z_function(X, Y):
return np.sin(X) + np.cos(Y)
surface_from_function = Surface.from_z_function(
custom_z_function, x_range=(0, 2*np.pi), y_range=(0, 2*np.pi), steps_count=50
)
# Thicken a surface
thickened_surface = surface_from_vertices.thicken(0.1)
```
## Dependencies
`trimeshtools-pypi` relies on the following core libraries:
* `trimesh`: A powerful Python library for 3D meshes and geometry.
* `numpy`: The fundamental package for scientific computing with Python.
* `scipy`: Scientific computing tools for Python, used for Delaunay triangulation in surface creation.
* `shapely`: A Python library for manipulation and analysis of planar geometric objects, used for creating spiral meshes.
These dependencies will be automatically installed when you install `trimeshtools-pypi` using pip.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/Smoren/trimeshtools-pypi",
"name": "trimeshtools",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "repo, repository, crud",
"author": "Smoren",
"author_email": "ofigate@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a9/5b/8c14ad0b692ec3a20552241faad1d8e258e1585098e733f0c9b617b93813/trimeshtools-0.1.1.tar.gz",
"platform": null,
"description": "# TrimeshTools - collection of tools for 3D modeling with Trimesh\n\n[](https://pypi.org/project/trimeshtools/)\n[](https://github.com/Smoren/trimeshtools-pypi/releases)\n[](https://pepy.tech/projects/trimeshtools)\n[](https://github.com/Smoren/trimeshtools-pypi/actions)\n[](https://github.com/Smoren/trimeshtools-pypi/blob/master/LICENSE)\n\n## Overview\n\n`trimeshtools-pypi` is a minimalistic Python library designed to extend the capabilities of the popular `trimesh` library. \nIt provides a limited set of tools for basic 3D mesh manipulation, including operations for combining, moving, rotating, \nand visualizing 3D models. This library aims to simplify common mesh processing tasks, making it easier for developers \nand researchers to work with 3D data in Python.\n\n## Key Features\n\n* **Mesh Combination**: Seamlessly perform boolean union operations and concatenate multiple meshes.\n* **Advanced Deformation**: Apply various deformation techniques such as bending, spiral bending, and twisting to meshes.\n* **Precise Editing**: Subdivide meshes for increased detail and accurately cut meshes using defined planes.\n* **Transformations**: Easily move meshes to specific positions (center, floor, custom bounds) and apply rotations or mirroring transformations.\n* **Geometric Figure Creation**: Generate complex 3D shapes like Archimedean spirals and rounded boxes.\n* **Surface Operations**: Utilize the `Surface` class for advanced operations, including creating surfaces from vertices, paths, Z-functions, and parametric functions, as well as thickening surfaces.\n* **Visualization**: Conveniently display meshes in a 3D viewer, with optional axis visualization.\n* **Mesh Repair Utilities**: Includes functions to fix common mesh issues such as merging vertices, removing duplicate faces, and correcting normals.\n\n## Installation\n\nTo install `trimeshtools-pypi`, you can use pip:\n```bash\npip install trimeshtools-pypi\n```\n\n## Usage\n\nHere are some basic examples of how to use `trimeshtools-pypi`.\n\n### Combining Meshes\n\n```python\nimport trimesh\nfrom trimeshtools.combine import union_meshes, concatenate_meshes\n\n# Create some sample meshes\nmesh1 = trimesh.creation.box()\nmesh2 = trimesh.creation.sphere()\n\n# Perform a union operation\ncombined_mesh_union = union_meshes(mesh1, mesh2)\n\n# Concatenate meshes\ncombined_mesh_concat = concatenate_meshes(mesh1, mesh2)\n```\n\n### Deforming Meshes\n\n```python\nimport trimesh\nfrom trimeshtools.deform import bend_mesh, spiral_bend_mesh, twist_mesh\n\n# Create a sample mesh\nmesh = trimesh.creation.box()\n\n# Bend the mesh\nbent_mesh = bend_mesh(mesh.copy(), radius=10)\n\n# Spiral bend the mesh\nspiral_bent_mesh = spiral_bend_mesh(mesh.copy(), bend_amount=0.5)\n\n# Twist the mesh\ntwisted_mesh = twist_mesh(mesh.copy(), num_rotations=3)\n```\n\n### Editing Meshes\n\n```python\nimport trimesh\nfrom trimeshtools.edit import subdivide_shape, cut_mesh\nimport numpy as np\n\n# Create a sample mesh\nmesh = trimesh.creation.box()\n\n# Subdivide the mesh\nsubdivided_mesh = subdivide_shape(mesh.copy(), iterations=1)\n\n# Cut the mesh\nplane_origin = [0, 0, 0]\nplane_normal = [0, 0, 1]\nmesh_above, mesh_below = cut_mesh(mesh.copy(), plane_origin, plane_normal)\n```\n\n### Moving Meshes\n\n```python\nimport trimesh\nfrom trimeshtools.move import move_to_center, move_to_floor, move_to_bound\n\n# Create a sample mesh\nmesh = trimesh.creation.box()\n\n# Move to center\ncentered_mesh = move_to_center(mesh.copy())\n\n# Move to floor\nfloored_mesh = move_to_floor(mesh.copy())\n\n# Move to specific bound\nbound_mesh = move_to_bound(mesh.copy(), x=1, y=-1, z=0)\n```\n\n### Rotating Meshes\n\n```python\nimport trimesh\nfrom trimeshtools.rotate import create_rotation_matrix_for_x, create_mirror_matrix\nimport numpy as np\n\n# Create a sample mesh\nmesh = trimesh.creation.box()\n\n# Create rotation matrix and apply\nrotation_matrix = create_rotation_matrix_for_x(np.radians(45))\nrotated_mesh = mesh.copy().apply_transform(rotation_matrix)\n\n# Create mirror matrix and apply\nmirror_matrix = create_mirror_matrix(x=True)\nmirrored_mesh = mesh.copy().apply_transform(mirror_matrix)\n```\n\n### Showing Meshes\n\n```python\nimport trimesh\nfrom trimeshtools.show import show_mesh\n\n# Create a sample mesh\nmesh = trimesh.creation.box()\n\n# Show the mesh\nshow_mesh(mesh)\n```\n\n### Surface Operations\n\n```python\nimport trimesh\nimport numpy as np\nfrom trimeshtools.surface import Surface\n\n# Create a surface from vertices\nvertices = np.array([\n [0, 0, 0],\n [1, 0, 0],\n [0, 1, 0],\n [1, 1, 0]\n])\nsurface_from_vertices = Surface.from_vertices(vertices)\n\n# Create a surface from a z-function\ndef custom_z_function(X, Y):\n return np.sin(X) + np.cos(Y)\n\nsurface_from_function = Surface.from_z_function(\n custom_z_function, x_range=(0, 2*np.pi), y_range=(0, 2*np.pi), steps_count=50\n)\n\n# Thicken a surface\nthickened_surface = surface_from_vertices.thicken(0.1)\n```\n\n## Dependencies\n\n`trimeshtools-pypi` relies on the following core libraries:\n\n* `trimesh`: A powerful Python library for 3D meshes and geometry.\n* `numpy`: The fundamental package for scientific computing with Python.\n* `scipy`: Scientific computing tools for Python, used for Delaunay triangulation in surface creation.\n* `shapely`: A Python library for manipulation and analysis of planar geometric objects, used for creating spiral meshes.\n\nThese dependencies will be automatically installed when you install `trimeshtools-pypi` using pip.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n",
"bugtrack_url": null,
"license": null,
"summary": "Trimesh tools collection",
"version": "0.1.1",
"project_urls": {
"Bug Reports": "https://github.com/Smoren/trimeshtools-pypi/issues",
"Documentation": "https://github.com/Smoren/trimeshtools-pypi",
"Homepage": "https://github.com/Smoren/trimeshtools-pypi",
"Source Code": "https://github.com/Smoren/trimeshtools-pypi"
},
"split_keywords": [
"repo",
" repository",
" crud"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "0084d1ccb6a7c32167c5b4fa8a2a596412178910e8525c77c9f63157f70ca63a",
"md5": "c6f4c6a47b6f5cecf9b84cc8dd82fc19",
"sha256": "ea7497eaaf7b265b6e1ee736222b1da270ca389652f12c060d72ceb99997b906"
},
"downloads": -1,
"filename": "trimeshtools-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c6f4c6a47b6f5cecf9b84cc8dd82fc19",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 13685,
"upload_time": "2025-08-31T12:08:18",
"upload_time_iso_8601": "2025-08-31T12:08:18.597356Z",
"url": "https://files.pythonhosted.org/packages/00/84/d1ccb6a7c32167c5b4fa8a2a596412178910e8525c77c9f63157f70ca63a/trimeshtools-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a95b8c14ad0b692ec3a20552241faad1d8e258e1585098e733f0c9b617b93813",
"md5": "168e3461175e9cb531dc167376ca1b9b",
"sha256": "19cd9dd1a84a020e5acc4fcafccc3b22b6e482a51998e3232ffefefb6f5678ed"
},
"downloads": -1,
"filename": "trimeshtools-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "168e3461175e9cb531dc167376ca1b9b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 14062,
"upload_time": "2025-08-31T12:08:19",
"upload_time_iso_8601": "2025-08-31T12:08:19.585508Z",
"url": "https://files.pythonhosted.org/packages/a9/5b/8c14ad0b692ec3a20552241faad1d8e258e1585098e733f0c9b617b93813/trimeshtools-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-31 12:08:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Smoren",
"github_project": "trimeshtools-pypi",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "trimeshtools"
}
JSON
