Guida Didattica · Librerie Python per Grafica 3D e CAD

CadQuery

CAD parametrico via codice: disegna, estrudi ed esporta modelli 3D pronti per la stampa o la produzione.

0 di 5 passaggi completati

01Fondamenti

Cos'è CadQuery?

CadQuery è una libreria Python per creare modelli CAD (Computer-Aided Design) scrivendo codice invece di disegnare a mano con un mouse, come si farebbe in SolidWorks o Fusion 360. È detto "parametrico" perché puoi cambiare una misura (es. il raggio di un foro) e l'intero modello si aggiorna automaticamente.

📐Schizzo (sketch)Un profilo 2D di partenza, come un rettangolo o un cerchio.
🧱EstrusioneTrasforma il profilo 2D in un solido 3D, "tirandolo" in altezza.
💾Export CADSalva il modello in formati usati dall'industria: STEP, STL.

Il tuo primo solido

import cadquery as cq

blocco = cq.Workplane("XY").box(10, 20, 5)  # larghezza, profondità, altezza
cq.exporters.export(blocco, "blocco.stl")

02Concetti Chiave

📋 Workplane▶

Il "piano di lavoro" su cui disegni: come un foglio virtuale posizionato nello spazio 3D (es. il piano XY), su cui costruisci il tuo schizzo prima di renderlo solido.

✏️ Schizzo (sketch) e contorno▶

Disegni una forma 2D (rettangolo, cerchio, poligono, o un contorno personalizzato) che sarà la base per creare il solido 3D.

forma = cq.Workplane("XY").circle(5) # cerchio di raggio 5
🧱 Estrusione▶

Trasforma un profilo 2D in un solido 3D "tirandolo" per una certa altezza. È l'operazione base per creare la maggior parte degli oggetti CAD semplici.

solido = cq.Workplane("XY").circle(5).extrude(10) # cilindro alto 10
🕳️ Fori e tasche▶

CadQuery offre metodi dedicati per aggiungere fori cilindrici o tasche rettangolari a un solido esistente, in una posizione precisa.

blocco_forato = blocco.faces(">Z").workplane().hole(3) # foro passante di diametro 3
💾 Export STEP/STL▶

STEP è il formato standard per lo scambio di modelli CAD tra software diversi (mantiene la geometria esatta). STL è il formato più usato per la stampa 3D (approssima la forma con triangoli).

cq.exporters.export(solido, "modello.step") cq.exporters.export(solido, "modello.stl")

03Checklist Pratica

Spunta ogni passaggio man mano che lo completi: sbloccherai l'attestato di questa guida al termine.

Esempio per il punto 1

import cadquery as cq

profilo = cq.Workplane("XY").rect(20, 10)  # rettangolo 20x10
1. Crea un profilo 2DDisegna un rettangolo su un Workplane, come nell'esempio sopra.

Esempio per il punto 2

solido = profilo.extrude(15)  # estrude per 15 unità di altezza
print(solido.val().Volume())
2. Estrudi il profilo in un solidoUsa .extrude() sul tuo profilo, come nell'esempio sopra.

Esempio per il punto 3

solido_forato = solido.faces(">Z").workplane().hole(5)
3. Aggiungi un foro al solidoUsa .faces(">Z").workplane().hole() come nell'esempio sopra.

Esempio per il punto 4

cq.exporters.export(solido_forato, "pezzo.stl")
cq.exporters.export(solido_forato, "pezzo.step")
4. Esporta il modello in STL e STEPUsa cq.exporters.export() due volte con estensioni diverse, come nell'esempio sopra.
5. Completa il quiz di verificaScendi in fondo alla guida e rispondi correttamente ad almeno l'80% delle domande.

04Glossario Interattivo

Tocca ogni termine per vederne la definizione.

05Quiz di Verifica

06Esercitazioni Pratiche

Esercizio 1

La staffa forata

Crea un rettangolo 40x20, estrudilo per 5 unità di spessore, poi aggiungi due fori da 4mm alle estremità per il fissaggio con viti. Esporta in STL.

⏱ 25 minuti📦 Script + file .stl generato🖥️ Individuale
Esercizio 2

Il cilindro cavo

Crea un cilindro pieno di raggio 15 e altezza 30. Poi crea un secondo cilindro più piccolo (raggio 10) e sottrailo dal primo per ottenere un tubo cavo. Esporta in STEP.

⏱ 25 minuti📦 Script + file .step generato🖥️ Individuale
Esercizio 3

Trova l'errore: estrusione su un profilo vuoto

Questo codice genera un errore: si chiama .extrude(10) su un Workplane su cui non è stato disegnato nessun profilo (né rect, né circle). Spiega perché CadQuery non può estrudere "il nulla".

⏱ 10 minuti📦 Spiegazione scritta🖥️ Individuale o in coppia

🎓 Attestato di completamento

Completa tutti i 5 passaggi della checklist per sbloccare il tuo attestato in PDF.

0 / 5 passaggi completati