compas-nest 0.1.1.dev3__tar.gz → 0.1.1.dev4__tar.gz

{compas_nest-0.1.1.dev3 → compas_nest-0.1.1.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: compas_nest
-Version: 0.1.1.dev3
+Version: 0.1.1.dev4
 Summary: 2D irregular nesting (OpenNest) for COMPAS.
 Author-Email: Petras Vestartas <petrasvestartas@gmail.com>
 Classifier: License :: OSI Approved :: MIT License

compas_nest-0.1.1.dev4/docs/examples/06_pack.md

@@ -0,0 +1,11 @@
+# 06 · Pack (grid array)
+
+Lay parts out in a simple grid/array with `pack` — a deterministic layout, no nesting. It returns a
+`nest_result`, so the same `placed_polylines` / `to_json` / `to_obj` apply.
+
+<!-- TODO: image -->
+![pack](../images/06_pack.png)
+
+```python
+--8<-- "examples/06_pack.py"
+```

compas_nest-0.1.1.dev4/docs/examples/07_text.md

@@ -0,0 +1,11 @@
+# 07 · Text (single-stroke font)
+
+Render text to single-stroke polylines with `text_to_polylines`, using the OpenNest XML engraving
+font (e.g. for sheet-number labels). Arcs are sampled to polyline segments.
+
+<!-- TODO: image -->
+![text](../images/07_text.png)
+
+```python
+--8<-- "examples/07_text.py"
+```

{compas_nest-0.1.1.dev3 → compas_nest-0.1.1.dev4}/docs/examples/index.md

@@ -8,3 +8,5 @@ placed geometry to `data/output/` as JSON (full result) and OBJ (outlines + hole
 3. [Live animation (NFP)](03_nfp_animated.md) — watch the GA layout evolve.
 4. [Clearance offset](04_collision_dataset.md) — add gaps with `offset_geo` / `offset_sheets`.
 5. [Attributes](05_attributes.md) — carry geometry (a centroid point) through placement.
+6. [Pack (grid)](06_pack.md) — simple grid/array layout with `pack` (no nesting).
+7. [Text (font)](07_text.md) — single-stroke text with `text_to_polylines`.

compas_nest-0.1.1.dev4/examples/06_pack.py

@@ -0,0 +1,60 @@
+from pathlib import Path
+
+from compas.colors import Color
+from compas.geometry import Polyline
+from compas_viewer import Viewer
+
+from compas_nest import nest_geo
+from compas_nest import nest_result
+from compas_nest import pack
+
+BLUE: Color = Color.from_hex("#0072B2")
+OUTPUT: Path = Path(__file__).parent.parent / "data" / "output" / "06_pack.json"
+
+# 1. parts (one with a hole) with several copies each
+geo: nest_geo = nest_geo()
+geo.add_part(
+    Polyline([
+        [0, 0, 0],
+        [30, 0, 0],
+        [30, 12, 0],
+        [0, 12, 0],
+        [0, 0, 0],
+    ]),
+    copies=6,
+)
+geo.add_part(
+    Polyline([
+        [0, 0, 0],
+        [20, 0, 0],
+        [20, 20, 0],
+        [0, 20, 0],
+        [0, 0, 0],
+    ]),
+    holes=[
+        Polyline([
+            [6, 6, 0],
+            [14, 6, 0],
+            [14, 14, 0],
+            [6, 14, 0],
+            [6, 6, 0],
+        ]),
+    ],
+    copies=6,
+)
+
+# 2. pack into a simple grid (no nesting): 5 cells per row, 8-unit gaps
+result: nest_result = pack(geo, columns=5, gap_x=8.0, gap_y=8.0)
+
+# 3. view the grid layout (elements blue)
+viewer: Viewer = Viewer()
+for group in result.placed_polylines():
+    for part in group["parts"]:
+        viewer.scene.add(part["outline"], linecolor=BLUE, linewidth=2)
+        for hole in part["holes"]:
+            viewer.scene.add(hole, linecolor=BLUE)
+viewer.show()
+
+# 4. save the placed geometry to JSON (full result) and OBJ (outlines + holes)
+result.to_json(OUTPUT)
+result.to_obj(OUTPUT.with_suffix(".obj"))

compas_nest-0.1.1.dev4/examples/07_text.py

@@ -0,0 +1,23 @@
+from pathlib import Path
+
+from compas.colors import Color
+from compas.data import json_dump
+from compas_viewer import Viewer
+
+from compas_nest import text_to_polylines
+
+BLUE: Color = Color.from_hex("#0072B2")
+OUTPUT: Path = Path(__file__).parent.parent / "data" / "output" / "07_text.json"
+
+# 1. render text to single-stroke polylines (OpenNest XML font), 10-unit cap height
+strokes: list = text_to_polylines("OpenNest\n0 1 2", height=10.0, font="regular")
+
+# 2. view the stroke polylines (blue)
+viewer: Viewer = Viewer()
+for stroke in strokes:
+    viewer.scene.add(stroke, linecolor=BLUE, linewidth=2)
+viewer.show()
+
+# 3. save the polylines to JSON
+OUTPUT.parent.mkdir(parents=True, exist_ok=True)
+json_dump(strokes, OUTPUT)

{compas_nest-0.1.1.dev3 → compas_nest-0.1.1.dev4}/mkdocs.yml

@@ -48,6 +48,8 @@ nav:
       - 03 Live animation (NFP): examples/03_nfp_animated.md
       - 04 Clearance offset: examples/04_collision_dataset.md
       - 05 Attributes: examples/05_attributes.md
+      - 06 Pack (grid): examples/06_pack.md
+      - 07 Text (font): examples/07_text.md
   - API Reference:
       - api/index.md
       - Data structures: api/compas_nest.datastructures.md