Welcome to voxelmap’s documentation!

Let’s make 3-D models with Python!

Check out voxelmap’s open-source on GitHub

Ever wanted to make simple 3-D models from numpy arrays? Now you can do that with voxelmap ! Voxelmap is a Python library for making voxel and three-dimensional models from NumPy arrays. It was initially made to streamline 3-D voxel modeling by assigning each integer in an array to a voxel. Now, methods are being developed for mesh representations, such as ImageMesh, voxel-to-mesh transformation and vice-versa.

Check out the Usage section for further information, including how to Installation the project. For some quick examples / templates, check out the next section.

Key Features

Draw voxels from integer arrays	Colormap Block Coloring	3-D Reconstruction
Low-Poly 3-D Mesh Mapping from Image	Voxel Model to 3-D Mesh	3-D Model Numpy Manipulation and Blender Integration

Colab Notebook

While we offer an interactive tutorial via a Colab notebook, we recommend using this site as your primary guide instead. Please note that the Colab notebook is currently out-of-date and may not reflect the most recent features and functionality of Voxelmap. We are continually updating our website to ensure the latest information and resources are available to our users.

Note

This project is under active development.

Contents

• Usage
  • Installation
  • The hashblocks Constructor Variable
  • Draw voxels from integer arrays
  • Draw voxels from coordinate arrays
  • Colormap Block Coloring
    • Colormap Block Coloring with Integer Tagging
  • 3-D Mapping of an Image
  • Low-Poly 3-D Mesh Mapping from Image
  • MarchingMesh : Turning Voxel Models to 3-D Mesh Representations
  • Wavefront (.obj) file to 3-D Sparse Array
    • Cube Model
    • Sphere Model
    • 3-D Model Numpy Manipulation and Blender Integration
  • 3-D Voxel Model Reprocessing
    • Re-color with custom colors
      • using the hashblocks_add() method
      • defining them directly in the hashblocks dictionary
    • Save and Load Methods for voxelmap Model objects
      • Save the ghost dog model
      • Load ghost dog model
• API Reference
  • Global Methods
    • Special
      • objcast
      • matrix_toXY
      • tensor_toXYZ
    • Load and Save
      • load_array
      • save_array
      • tojson
      • load_from_json
    • Array Manipulation
      • resize_array
      • roughen
      • random_kernel_convolve
    • Mapping
      • MarchingMesh
      • MeshView
  • Local Methods to Model class
    • Model
      • Model.__init__()
      • Model.ImageMap()
      • Model.ImageMesh()
      • Model.MarchingMesh()
      • Model.MeshView()
      • Model.build()
      • Model.draw()
      • Model.draw_mpl()
      • Model.hashblocks_add()
      • Model.load()
      • Model.make_intensity()
      • Model.resize_intensity()
      • Model.save()
    • voxelmap

Examples

• Voxel Model to 3-D Mesh
• 3-D Reconstruction
  • Coming Soon : AI-based 3-D Reconstruction

Whitepapers

• ImageMesh : A Convex Hull based 3D Reconstruction Method
  • Abstract
  • Introduction
  • Time Complexity
  • Conclusion