mirrors/build123d
1
Fork 0
mirror of https://github.com/gumyr/build123d.git synced 2025-12-06 02:30:55 -08:00
Code Issues Projects Releases Packages Wiki Activity Actions

Adding missing tips.rst file

Browse source
This commit is contained in:
Roger Maitland 2023-04-20 11:50:47 -04:00
parent 9c093f569c
commit a267b359aa
1 changed files with 78 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

78
docs/tips.rst Normal file
View file

@ -0,0 +1,78 @@
#####################
Tips & Best Practices
#####################
Although there are countless ways to create objects with build123d, experience
has proven that certain techniques can assist designers in achieving their goals
with the greatest efficiency. The following is a description of these techniques.
*************************
Can't Get There from Here
*************************
Unfortunately, it's a reality that not all parts described using build123d can be
successfully constructed. Designers may have to explore different design approaches
to get the OpenCascade CAD core to successfully build the target object.
For instance, if a multi-section :func:`~operations_part.sweep` operation fails, a
:func:`~operations_part.loft` operation may be a viable alternative in certain
situations. It's crucial to remember that CAD is a complex
field and patience may be required to achieve the desired results.
************
2D before 3D
************
When creating complex 3D objects, it is generally best to start with 2D work before
moving on to 3D. This is because 3D structures are much more intricate, and 3D operations
can be slower and more prone to failure. For designers who come from a Constructive Solid
Geometry (CSG) background, such as OpenSCAD, this approach may seem counterintuitive. On
the other hand, designers from a GUI BREP CAD background, like Fusion 360 or SolidWorks,
may find this approach more natural.
In practice, this means that 3D objects are often created by applying operations like
:func:`~operations_part.extrude` or :func:`~operations_part.revolve` to 2D sketches, as shown below:
.. code:: python
with BuildPart() as my_part:
with BuildSketch() as part_profile:
...
extrude(amount=some_distance)
...
With this structure ``part_profile`` may have many objects that are combined and
modified by operations like :func:`~operations_generic.fillet` before being extruded
to a 3D shape.
**************************
Delay Chamfers and Fillets
**************************
Chamfers and fillets can add complexity to a design by transforming simple vertices
or edges into arcs or non-planar faces. This can significantly increase the complexity
of the design. To avoid unnecessary processing costs and potential errors caused by a
needlessly complicated design, it's recommended to perform these operations towards
the end of the object's design.
************
Parameterize
************
One of the most powerful features of build123d is the ability to design fully
parameterized parts. While it may be faster to use a GUI CAD package for the
initial iteration of a part, subsequent iterations can prove frustratingly
difficult. By using variables for critical dimensions and deriving other dimensions
from these key variables, not only can a single part be created, but a whole set
of parts can be readily available. When inevitable change requests arise, a simple
parameter adjustment may be all that's required to make necessary modifications.
******************
Use Shallow Copies
******************
As discussed in the Assembly section, a :ref:`shallow copy <shallow_copy>` of parts that
are repeated in your design can make a huge difference in performance and usability of
your end design. Objects like fasteners, bearings, chain links, etc. could be duplicated
tens or even hundreds of times otherwise. Use shallow copies where possible but keep in
mind that if one instance of the object changes all will change.