Skip to main content

Software renders implicit surface function f(x,y,z) into aprintable STL.

Project description

Update - 30th June 2024

  • some optimizations to speed up

Update - 22nd June 2024

  • Triangle Lookup Table implemented - no defective surfaces anymore

  • nearly all functions compiled with Numba - faster operation

Update - 27th November 2022

A new, much faster version is available. It uses more numba jit compiled python code and more parallelization.

The first run may be slower due to compilation time.

example image

xyzCad - functional cad software

xyzCad is an ease to use marching cubes based cad software generating 3d printable stl files from a function f(x, y, z) = {True : False}.

x, y and z are the coordinates in 3d space in mm. The function f(x, y, z) returns True or False depending on the arguments x, y and z. True means, there should be solid. False means, there is nothing.

Theory of operation

It looks like the software iterates over alle points in the 3d raster space. But this would be very slow. So the algorithm is a bit more optimized.

  1. At first it searches for two points, one inside the solid (=True), one outside (=False).

  2. Now the surface is searched on a line between the two points.

  3. Rasterization is done over the surface only.

That means only one solid can be created. If two solids without contact to each other are created, only the one found at first will be rendered.

Usage example

Let us create a sphere:

#!/usr/bin/env python3

from numba import njit
from xyzcad import render

@njit
def f(x,y,z):
    r = 10
    return r**2 > x**2 + y**2 + z**2

render.renderAndSave(f, 'sphere.stl', 0.3)

numba just in time compiler makes it a bit faster. render is the xyzcad renderer/compiler. We want a resolution of 0.3 mm. The output file should be sphere.stl. Our sphere will have a radius of r = 10 mm.

Want to Support the project?

Buy your 3d printer filament or parts using my affiliate link:

Amazon

eBay

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xyzcad-0.4.3.tar.gz (21.4 kB view details)

Uploaded Source

Built Distribution

xyzcad-0.4.3-py3-none-any.whl (20.4 kB view details)

Uploaded Python 3

File details

Details for the file xyzcad-0.4.3.tar.gz.

File metadata

  • Download URL: xyzcad-0.4.3.tar.gz
  • Upload date:
  • Size: 21.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.11.6

File hashes

Hashes for xyzcad-0.4.3.tar.gz
Algorithm Hash digest
SHA256 552abeab0b2130a343adde53bfba39631107a43113f2bd5cf3999c907cd8990b
MD5 1ae4613717873fd41ba0110c05fb9742
BLAKE2b-256 2a477f468549c703543aca2b18e575821cc3d2b2e1434ed486ca17c307f5c6ff

See more details on using hashes here.

File details

Details for the file xyzcad-0.4.3-py3-none-any.whl.

File metadata

  • Download URL: xyzcad-0.4.3-py3-none-any.whl
  • Upload date:
  • Size: 20.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.11.6

File hashes

Hashes for xyzcad-0.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 e3691dc67912f0b3d2ad2b72f45b8287272653c33da51fd2090698822d628897
MD5 bb57027e66ab17ee539e1a8ac5ba7fe4
BLAKE2b-256 029ce859153fd5e923a42414d9f8bb5ddbf213236529f20e81ceb82fb62bf36c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page