Text-to-CAD: fuente paramétrica, evidencia geométrica y entrega responsable
Primer modelo Text-to-CAD: bloque paramétrico y un plan de validación honesto
Lee un pequeño modelo cadgen y distingue importación, construcción, inspección y captura del documento resultante.
Qué aprenderás
- Escribir un encargo comprobable
- La llamada construye; importar no construye el modelo
- Revisar el archivo realmente producido
Antes de empezar
- Funciones, módulos y rutas Python básicos
- Unidades y diferencia entre diseño y pieza física
Planificar un ejercicio acotado y distinguir actualidad, inspección, revisión visual y fabricación.
Conclusiones clave
- El cuerpo devuelve una forma, no una ruta o diccionario.
- Llamar al modelo difiere de importar su módulo.
- Mide y captura el documento generado exacto.
Escribir un encargo comprobable
Elige un bloque sin función de 36 mm de ancho, 24 mm de profundidad y 4 mm de altura. Son dimensiones didácticas, no tolerancias de fabricación recomendadas. Registra extensiones esperadas y volumen positivo, excluyendo agujeros, ensamblajes y máquinas del primer ejercicio.
El ejemplo sigue el contrato inspeccionado: una función decorada sin parámetros devuelve una forma build123d y se llama desde la guarda principal. Los parámetros son constantes con nombre. Para variantes reutilizables, usa una fábrica ordinaria invocada desde modelos identificados por separado.
La llamada construye; importar no construye el modelo
La guía dice que el decorador declara salidas y la llamada construye. Ejecutar sample.py debería producir sample.step; importar el módulo no invoca esa construcción. No entregues el script Python a una orden de inspección o captura STEP esperando que genere geometría.
Inspecciona el STEP resultante como documento: refs para hechos y selectores, validate para validez y mediciones dirigidas para las dimensiones. Resolver referencias con éxito no demuestra un sólido cerrado, orientado correctamente y con volumen positivo.
Revisar el archivo realmente producido
Después de construir, captura el STEP e inspecciona orientación, material ausente y características inesperadas. Conserva ruta y resultados juntos. Una captura fallida o inexistente debe ser una limitación visible, no sustituirse por una imagen antigua atractiva.
Es un patrón de ejecución para un entorno correctamente instalado, no una afirmación de haber construido el bloque. Las pruebas ejecutadas cubren solamente el proxy con dependencia falsa. La elaboración del artículo no generó STEP, mallas ni archivos de impresora.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Define dimensiones y exclusiones.
- 2
Guarda el modelo en un directorio nuevo.
- 3
Constrúyelo en el entorno correspondiente.
- 4
Valida, mide y revisa la salida.
Ejemplo para copiar
from cadgen import build123d as bd
from cadgen import step
WIDTH, DEPTH, HEIGHT = 36.0, 24.0, 4.0
@step
def sample():
return bd.Box(WIDTH, DEPTH, HEIGHT)
if __name__ == "__main__":
sample()Preguntas frecuentes
¿Por qué importar sample.py no creó STEP?
La construcción documentada ocurre al llamar al modelo, normalmente desde su entrada principal.
¿Se ejecutó este ejemplo CAD aquí?
No. Se basa en el contrato fijado; solo se ejecutó la prueba separada del proxy.
Fuentes
- Text-to-CAD / skills/cad/SKILL.mdFuente verificada 2026-09-14