Salta al contenuto principale
← CutOptim Engine APIEngine API · nesting · live oggi

API nesting per piazzamenti tessili

Sì — esiste un’API per il piazzamento (marker). Disporre le sagome su un rotolo di tessuto, pelle o tessile tecnico in modo che il piazzamento sia il più corto possibile è un problema di nesting a forma reale con una dimensione libera, e la CutOptim Engine API lo risolve via HTTP su POST /v1/optimize/nest. Il vostro PLM, ERP o software made-to-order invia i contorni dei pezzi e la larghezza del rotolo in JSON e riceve un piazzamento: la posizione di ogni pezzo e la lunghezza necessaria — per abbigliamento, tappezzeria, pelletteria e tessili tecnici.

È live oggi come modalità marker dell’endpoint di nesting: una riga di materiale con roll: true e senza h. Lo stesso motore a forma reale che dispone le lastre dispone i pezzi; cambia solo il materiale, da un foglio di misura fissa a un rotolo di larghezza fissa e lunghezza libera.

Tutti i formati, i motori, i limiti e gli esempi di codice per sviluppatori: API di nesting CutOptim

POST /v1/optimize/nest
{
  "parts": [
    { "name": "front",
      "polygon": [[0,0],[560,0],[560,700],[420,760],[140,760],[0,700]],
      "qty": 2, "allowedRotations": [0,180] },
    { "name": "sleeve",
      "polygon": [[0,0],[480,0],[420,560],[60,560]],
      "qty": 4, "allowedRotations": [0,180] },
    { "name": "collar",
      "polygon": [[0,0],[500,0],[500,80],[0,80]],
      "qty": 2, "allowedRotations": [0,180] }
  ],
  "stock": [{ "w": 1585, "roll": true }],
  "options": { "minSeparation": 3, "edgeClearance": 5 }
}

Il nesting non è incluso nella demo pubblica — esegui questo esempio con una chiave di test gratuita. Crea una chiave di test gratuita

  • Live oggi su POST /v1/optimize/nest — modalità marker, con una riga di materiale roll (w e roll: true, senza h).
  • Restituisce UN foglio il cui h è la lunghezza minima di piazzamento trovata, con la distanza dal bordo — anche in metrics.length.
  • Pezzi a forma reale: poligoni (con fori), oppure file SVG e DXF tramite parts[].source.
  • Filo e pelo: allowedRotations [0, 180] per pezzo mantiene la direzione; options.minSeparation e options.edgeClearance fissano le distanze.
  • stock[].maxLength limita il piazzamento (al massimo 200000); i pezzi che non rientrano vanno in unplaced, mai su un secondo foglio.
  • lbf risponde in modo sincrono per il preventivo; max è asincrono (202, poi si interroga GET /v1/jobs/{id}) e può solo accorciare il piazzamento lbf.
  • Validazione gratuita: POST /v1/validate/nest controlla un lavoro senza chiave e senza quota.

Un rotolo non è un foglio

Un foglio ha due lati fissi, e la domanda è quanti fogli servono per un lavoro. Un rotolo ha un solo lato fisso — la larghezza — e la domanda è quanta lunghezza consumano i pezzi. Inviate una riga di materiale con w e roll: true, senza h, e il nesting restituisce UN foglio largo w il cui h è la lunghezza minima trovata, con la distanza dal bordo a entrambe le estremità; lo stesso valore è in metrics.length. La lunghezza del rotolo è ciò che si acquista, quindi è il numero che serve a un preventivo.

Cosa inviate e cosa torna

Inviate ogni sagoma come poligono (con fori opzionali), oppure come SVG o DXF tramite parts[].source, con una quantità. La risposta fornisce ogni posizione come trasformazione rigida (una rotazione in gradi, poi una traslazione x/y), la lunghezza del piazzamento e ogni pezzo che non è entrato in unplaced. Qualsiasi oggetto meta — il vostro riferimento di modello, taglia o ordine di taglio — torna invariato su ogni copia posizionata, così il piazzamento si riconcilia con il vostro sistema.

Filo, pelo e distanze

allowedRotations si imposta per pezzo: [0, 180] mantiene la direzione del filo o del pelo e permette comunque di girare il pezzo testa-coda, mentre un elenco più lungo o "continuous" si adatta a un materiale senza direzione. options.minSeparation imposta la distanza tra i pezzi e options.edgeClearance quella ai bordi del rotolo. Un stock[].maxLength opzionale limita il piazzamento a una lunghezza a vostra scelta (al massimo 200000 nella vostra unità): i pezzi che non rientrano tornano in unplaced, e un rotolo non diventa mai un secondo foglio.

Immediato per il preventivo, max per l’ordine di taglio

Il motore predefinito lbf risponde in modo sincrono — deterministico e dentro la richiesta, abbastanza veloce da quotare un piazzamento mentre il cliente attende. Per l’ordine di taglio inviate lo stesso body con engine: "max" e interrogate GET /v1/jobs/{id}: parte dal piazzamento lbf e impiega il budget di tempo che impostate (options.timeBudgetMs) in una ricerca a strisce che può accorciarlo e non lo allunga mai. La risposta ha la stessa forma nei due casi, e una riga warnings indica la lunghezza e, con max, se la ricerca l’ha accorciata.

Risorsa scaricabile
One-pager API nesting per piazzamenti tessili

Una sintesi di due pagine (PDF in inglese): il problema, cosa invii e cosa ricevi, una richiesta e una risposta, e come costruire sul motore. Pronta da stampare, con un QR che rimanda a questa pagina.

PDF2 pagineGratis
Scarica il PDF

Domande frequenti

Esiste un’API per il piazzamento?
Sì. Disporre le sagome su un rotolo in modo che il piazzamento sia il più corto possibile è la modalità marker dell’endpoint di nesting della CutOptim Engine API, POST /v1/optimize/nest. Inviate ogni pezzo come poligono (o SVG o DXF) più una riga di materiale con la larghezza del rotolo e roll: true, e ricevete un piazzamento: la posizione di ogni pezzo e la sua lunghezza. Gira in produzione oggi, per abbigliamento, tappezzeria, pelle e tessili tecnici.
Come viene decisa la lunghezza del piazzamento?
Il motore lbf dispone i pezzi e restituisce la lunghezza necessaria, in modo sincrono e deterministico. Con engine: "max" il lavoro gira in modo asincrono: parte da quel piazzamento lbf, impiega options.timeBudgetMs a cercare una striscia più corta e non ne restituisce mai una più lunga. La lunghezza è l’h dell’unico foglio restituito, con la distanza dal bordo, ed è ripetuta in metrics.length.
Posso mantenere la direzione del filo o del pelo?
Sì. Impostate allowedRotations per pezzo: [0, 180] tiene il pezzo lungo il filo e lo lascia girare testa-coda, e un solo angolo lo fissa del tutto. I pezzi di un materiale senza direzione possono avere un elenco di angoli più lungo o "continuous". options.minSeparation e options.edgeClearance fissano la distanza tra i pezzi e ai bordi del rotolo.
Posso limitare la lunghezza del piazzamento?
Sì. stock[].maxLength limita il piazzamento a una lunghezza a vostra scelta, al massimo 200000 nella vostra unità. I pezzi che non rientrano tornano in unplaced — un rotolo non diventa mai un secondo foglio — così vedete cosa resta fuori e decidete come procedere.
Fa lo sviluppo taglie, l’abbinamento dei quadri o la pianificazione della stesura?
No. Dispone i pezzi che inviate: non sviluppa un modello in taglie, non abbina quadri o righe e non pianifica strati né stesura. Inviate come parts ogni taglia e quantità che volete nel piazzamento, con un oggetto meta per i vostri riferimenti, e la risposta indica dove va ogni copia.
Quanto tessuto fa risparmiare?
Dipende dai pezzi e dalla larghezza del rotolo, quindi non citiamo una percentuale generica. La misura onesta è la lunghezza del piazzamento con gli stessi pezzi e la stessa larghezza: eseguite il lavoro, confrontate la lunghezza con il vostro piazzamento attuale e confrontate lbf con max. max non restituisce mai un piazzamento più lungo di lbf. POST /v1/validate/nest controlla un lavoro gratis, senza chiave e senza quota.

Caso d’uso tessile e tappezzeria (app) · Benchmark