A new view of the formal model. Apparatus layout and beam geometry retained; private instrument identities and scene files excluded.
Design the path. Keep the evidence.
OpticalModeler is an Agent Skill for turning measurement ideas, diagrams and photographed setups into editable Blender optical systems. It connects the optical route to real apertures, mounts and support paths, then keeps the saved scene, checks and final views tied to the same result.
Install with a compatible Agent Skills installer:
npx skills add k-telux/OpticalModeler
Then give your agent the input, what may change, and what you need back:
Use
$thorlabs-blender-optical-path
to reconstruct these photos
on the accepted baseline.
Keep the original files.
Keep fixed upper endpoints.
Deliver an optics-only model,
final views and a checklist.
Mark installed, candidate
and proposed parts.
Prefer a manual install? Copy the skill folder into your agent's skills directory.
| Your goal | Where the work begins |
|---|---|
| Design a new measurement | An empty scene, a source-backed topology and permitted component assets. |
| Reconstruct a diagram or photographs | Authoritative inputs and an explicitly retained baseline. |
| Correct an accepted model | Frozen originals, protected families and declared movable degrees of freedom. |
| Audit an existing scene | Read-only evidence, actual saved geometry and precise findings. |
| Present the accepted result | A separate camera/light copy with geometry and image provenance preserved. |
Keep a fixed upper endpoint fixed. Move an optic with its mount and supports. Treat a proposed camera as proposed. A clearer render supports presentation; it does not close an unknown physical interface.
Six conversations show the decisions that matter, including rejection, correction and the final output:
- A — Diagram to scene. Follow the complete reconstruction, with real public input, final previews and historical evidence.
- B — Photos with missing specifications. Deliver a usable review model while keeping installed identity and estimates separate.
- C — A compact layout, without redesign. Follow a rejected layout through correction, retaining internal vectors and fixed endpoints.
- D — Better light, same instrument. Create a verified presentation copy, with fresh images and unchanged scientific geometry.
- E — One entrance, selected exits. Model a proposed detector and shutter states without inventing internal transfer.
- F — A process exits; evidence is missing. Produce an honest recovery handoff, with a valid record or reproducible blocker.
The laboratory-derived dialogues are edited, anonymized teaching reconstructions. Private photos, exact setup coordinates, important instrument SKUs and the full scene are not distributed. Read the Chinese dialogues →
The optical path. Directed branches, actual working faces, apertures and detector endpoints. Free-space light and guided fiber keep distinct roles.
The physical structure. Real mounting interfaces, table holes, fasteners and continuous supports. Representative checks precede repeated placement; saved-scene checks cover the affected neighbors.
The evidence. One scene lineage, fresh reopen measurements, actual image producers and a consistent manifest. An execution success, source CAD and a well-framed picture each support their own claim.
End-to-end workflow · Photographed reconstruction · Presentation and delivery
| Status | What you can conclude |
|---|---|
| PASS | The declared applicable gates have current evidence. |
| PARTIAL / SCOPED | A stated subset is checked; remaining blockers and limits stay visible. |
| UNVERIFIED | Necessary evidence is missing or inconclusive. |
| BLOCKED | A known requirement fails. |
READY_FOR_USER_REVIEW means the requested handoff is ready for inspection. It does not certify installed hardware, thread preload, alignment, optical performance or laser safety. The cover is a presentation detail from an existing model, with its inherited physical limits preserved. Image provenance · Publication privacy
Explore the historical models and qualification results
- G1/G2: public schematic, final renders and sanitized historical acceptance. Compressed previews are available; private Blend and vendor CAD are excluded.
- Single-run N04 workflow and replay. Static replay stops at
UNVERIFIEDwhere private assets are required. - Multi-run qualification. Scoped, blocked and unverified results remain distinct; there is no whole-system physical PASS.
- MZI preview limitations. Constant zero errors, expected-family hits and small previews do not establish full acceptance.
- Four public-only forward tests. Historical discovery evidence, not modules to stitch into a new system.
Validation, contribution and source boundaries
python scripts/validate_repository.py
The validator checks skill editions, resources, manifests, historical verdicts, PNG metadata and runnable software checks. Keep a private identifier policy outside the repository when publishing laboratory-derived material; inspect pixels and container contents separately. See privacy guidance.
Changelog · Contributing · Third-party notices · Security · Project-memory template
Independent community workflow. Not affiliated with or endorsed by Thorlabs. English is the technical source; Chinese and Japanese entries preserve its evidence rules.
Maintained by telux · MIT License