Files
NiJingzhe 49f142a434 examples: migrate every model to notebook projects
Each example is now a project directory of notebooks:
- one part notebook per part; part families (four-bar links, planetary and
  BLDC gears, l-link adapter presets) are one notebook used under several
  ids with scad.use(path, id=..., **overrides)
- assembly and sub-assembly notebooks compose children with scad.use
- shared parameters and helpers stay in plain modules (dimensions, common,
  materials, bearings, FEM steps)
- export and acceptance scripts load products with run_notebook and
  capture one .scadpkg per product, then translate from it

main.py side-effect entry points become export.py; intermediate
hypothesis/probe/diag/archive verify scripts are deleted, and only the
final acceptance checks are kept. l_link_motor_mount and
pcg_attractor_canopy join the index. histcad_demo stays translator output
and demo_kit is unchanged.

examples/SDK_DEFECTS.md records the SDK defects found along the way.
test_example_model_contract now checks that every example model is a
notebook with a unique id; the ap242 and phase-A scene tests load the
notebooks.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-02 17:16:51 +08:00

57 lines
2.0 KiB
Python

"""Export the nested gear trains and check the package round trip.
uv run python examples/external_reference_gear_train/export.py
The model is the ``nested_external_reference_gear_trains.py`` notebook. This
script writes the product package, STEP, FreeCAD and the assembly definition
archive to ``out/``, then materializes the package again and checks that the
nested stage still solves.
"""
from pathlib import Path
import simplecadapi as scad
from simplecadapi.runtime import run_notebook
HERE = Path(__file__).resolve().parent
OUT_DIR = HERE / "out"
NAME = "nested_external_reference_gear_trains"
def main() -> None:
OUT_DIR.mkdir(parents=True, exist_ok=True)
run = run_notebook(HERE / f"{NAME}.py")
package_path = OUT_DIR / f"{NAME}.scadpkg"
scad.capture(run.definition, package_path)
step_report = scad.exporter.export_product_package_to_step(
package_path, OUT_DIR / f"{NAME}.step"
)
fcstd_path = OUT_DIR / f"{NAME}.FCStd"
scad.translator.freecad_translator.translate_product_package_to_fcstd(
package_path,
str(fcstd_path),
document_name="NestedExternalReferenceGearTrains",
)
definition_path = scad.export_assembly_definition(
run.definition, OUT_DIR / f"{NAME}.assembly-definition.zip"
)
loaded = scad.load_product_package(package_path)
rebuilt = scad.materialize_definition(loaded)
nested = rebuilt.get_component("train_left").item
report = scad.inspect_assembly_constraints_rconstraintreport(nested)
print(f"root={rebuilt.assembly_id} components={len(rebuilt.components)}")
print(
f"nested={nested.assembly_id} constraints={len(nested.constraints)} "
f"solved={report.solved}"
)
print(f"definition_refs={len(loaded.definition_refs)} content_hash={loaded.content_hash}")
print(f"definition_artifact={definition_path}")
print(f"product_package={package_path}")
print(f"step={step_report.output_path}")
print(f"fcstd={fcstd_path}")
if __name__ == "__main__":
main()