This page is for AI assistant context only. To use this package, visit community.ntop.com.
Community submission — not verified by nTop. This package was submitted by an outside community member and has not been reviewed or verified by nTop. Treat its accuracy, safety, and compatibility claims with appropriate caution.
Summary
Nests implicit bodies onto a build plate by driving a bundled packer executable through Run Command, then applies the returned rotations and moves. Includes a demo notebook, the packer source, and third-party notices.Package Details
2D Nesting of Parts — nesting implicit bodies on the build plate from inside nTop
> Download this whole folder (not just one file) —nest_pack.exe, the demo
> notebook and the notices below all travel together.
This package contains everything needed to use the 2D Nesting of Parts custom block: the block,
a demo notebook, the packer executable it calls, and a short deck that explains how it works.
What you need
- nTop 6.3.3 or newer. The block is embedded in
2D Nesting on Build Plane Example.ntopand saved on its own as2D Nesting of Parts.ntop; nothing has to be registered. - A writable Work Folder that holds
nest_pack.exe. The exe is self-contained (its own Python, numpy and Pillow): nothing is downloaded, nothing is installed. Windows only. See “Third-party components” below for what it contains. - One permission per Work Folder. The first time nTop sees the command text it asks whether
the notebook may run an external command; allow it once. Parameters travel in
params.csv, so the text only changes when the Work Folder changes.
Contents
Getting started
- Download this folder to somewhere you can write to. That folder is a ready-made Work Folder
because it already holds
nest_pack.exe. - Open
2D Nesting on Build Plane Example.ntopand set the Work Folder variable to that folder’s path. Build; allow the external command when nTop asks. The nine bodies rotate and move onto the plate. - In your own notebook, either embed
2D Nesting of Parts.ntop(Custom Blocks panel → import) or copy theNested Partsblock out of the demo. Wire your bodies as one implicit list, the build plane and build volume box (for example from the EOS M 280 toolkit block), a Part Spacing, and a Work Folder that containsnest_pack.exe.
The block
Inputs:Bodies (list of implicit), Part Spacing (mm, 0 = shadows touch), Build Plane
(plate plane, normal up, parallel to world XY), Build Plate (the build volume box), Work Folder
(text). Output: the bodies rotated about Z and moved onto the plate. Parts that fit nowhere are
parked in a row beside the plate’s +X edge and listed in unplaced.csv.
The packer
nest_pack.py, about 280 lines of numpy and Pillow, built into nest_pack.exe with PyInstaller.
It reads parts.csv, params.csv and the shadow_<i> image archives, resamples each shadow onto
a 0.5 mm grid (coarser when the largest part passes about 110 mm), and does bottom-left fill on a
boolean occupancy grid: a FFT correlation finds every free position in one pass, placed parts are
dilated by the spacing, the smallest nest bounding box wins. Up to four bodies every order is
tried; more get four to six orders under a 240 s budget. Parts that fit nowhere are parked in a
row beside the plate (placed = 0 in placements0.csv, indices in unplaced.csv) so the nest
still builds and the leftovers can go on a second plate. nest_pack.log records everything.
Tested on thirteen geometry cases (single and many bodies, rods, rings, plates with holes, thin
sheets, bodies far from the origin or below the plane, spacing, oversized and too many parts), all
passing.
Third-party components
The packing algorithm (nest_pack.py) is nTop’s own code; no third-party nesting library is used.
nest_pack.exe is that script frozen together with the open-source components below, each under
its own licence (all permissive for redistribution):
The PyInstaller exception allows programs built with it to be distributed under any terms.
uv
is used only to build the exe and is not shipped. The full licence texts, including those of the
libraries numpy bundles, are in THIRD-PARTY-NOTICES.txt.
Limits and notes
- Only the XY footprint is checked; a part taller than the build volume is not rejected.
nest_pack.pydilates each raster by one cell for safety; remove that for closer contact.- Rotation is about Z only, in steps of
Rotation Step; bodies are not re-oriented in 3D. - If the Run Command block sits unbuilt after a recipe import, toggle one of its inputs.
- The demo notebook still lists older block definitions from earlier embeds in its Custom Blocks panel; they can be removed there.
License
This package (the custom block, demo notebook, packer source, deck and scripts) is released under the MIT License — seeLICENSE. The third-party components frozen into nest_pack.exe
keep their own licenses, listed above and in full in THIRD-PARTY-NOTICES.txt.
Built with AI assistance (Claude).

