feat(product): multi-body parts: a Part holds one Solid or several named bodies

Spike of design-docs/multi-solid-design.md. make_part_rpart(bodies={id: solid})
keeps several solids apart in one Part (not an assembly): Body values with
stable ids, Part.bodies / get_body / body_ids; Part.body raises on a multi-body
part instead of returning one body. Recorded and replayed, pickled for the cell
cache, previewed as one node per body (node/<part>/body:<id>), packaged with a
BRep and topology snapshot per body (solid_cache.bodies; one-body manifests are
byte-identical), drawn as solid child nodes in the package scene, exported to
STEP as one product holding every solid, flattened into assemblies, and weighed
per body by the new measure_part_mass_rmassreport.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
NiJingzhe
2026-11-04 03:57:27 +08:00
parent 093ef71e53
commit b607c85248
41 changed files with 1162 additions and 99 deletions
@@ -424,9 +424,24 @@ void bind_constraints(py::module_& m) {
void bind_part(py::module_& m) {
using namespace sp;
py::class_<Part, py::smart_holder> cls(m, "Part", "Single-body product item wrapping exactly one Solid.");
py::class_<Body, py::smart_holder>(m, "Body", "One named solid of a Part; a multi-body Part keeps several apart.")
.def(py::init([](const py::object& body_id, const py::object& solid, const py::object& name) {
return std::make_shared<Body>(text(body_id, "body_id"), typed<Solid>(solid, "solid must be a Solid"),
optional_name(name));
}),
py::arg("body_id"), py::arg("solid"), py::arg("name") = py::none())
.def_property_readonly("body_id", &Body::body_id)
.def_property_readonly("solid", &Body::solid)
.def_property_readonly("name", [](const Body& self) { return optional_object(self.name()); })
.def("to_dict", [](const Body& self) { return self.to_dict(); })
.def("__repr__", [](const Body& self) {
return "Body(body_id=" + str_repr(self.body_id()) + ", name=" + opt_str_repr(self.name()) + ")";
});
py::class_<Part, py::smart_holder> cls(
m, "Part", "Product item holding one Solid (`body`) or several named bodies (`bodies`), never placed apart.");
cls.def(py::init([](const py::object& part_id, const py::object& body, const py::object& name,
const py::object& material, const py::object& connectors) {
const py::object& material, const py::object& connectors, const py::object& bodies) {
std::optional<Material> material_value;
if (!material.is_none())
material_value = typed<Material>(material, "material must be a Material");
@@ -437,13 +452,25 @@ void bind_part(py::module_& m) {
"connectors must contain Connector values"));
}
}
if (body.is_none() == bodies.is_none())
throw scad::TypeError("give exactly one of body (a Solid) or bodies (several named solids)");
if (!bodies.is_none()) {
return std::make_shared<Part>(text(part_id, "part_id"), body_list(bodies), optional_name(name),
material_value, std::move(connector_values));
}
return std::make_shared<Part>(text(part_id, "part_id"), typed<Solid>(body, "body must be a Solid"),
optional_name(name), material_value, std::move(connector_values));
}),
py::arg("part_id"), py::arg("body"), py::arg("name") = py::none(), py::arg("material") = py::none(),
py::arg("connectors") = py::tuple())
py::arg("part_id"), py::arg("body") = py::none(), py::arg("name") = py::none(),
py::arg("material") = py::none(), py::arg("connectors") = py::tuple(), py::arg("bodies") = py::none())
.def_property_readonly("bodies", [](const Part& self) { return to_tuple(self.bodies()); })
.def_property_readonly("multi_body", &Part::multi_body)
.def("body_ids", [](const Part& self) { return to_tuple(self.body_ids()); })
.def(
"get_body", [](const Part& self, const py::object& id) { return self.get_body(text(id, "body_id")); },
py::arg("body_id"))
.def_property_readonly("part_id", &Part::part_id)
.def_property_readonly("body", &Part::body)
.def_property_readonly("body", &Part::body, "The Solid of a one-body Part; TypeError for a multi-body Part.")
.def_property_readonly("name", [](const Part& self) { return optional_object(self.name()); })
.def_property_readonly(
"material",