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
{
"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 eroll: 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.minSeparationeoptions.edgeClearancefissano le distanze. stock[].maxLengthlimita 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/nestcontrolla 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.
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.
Domande frequenti
Esiste un’API per il piazzamento?
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?
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?
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?
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?
Quanto tessuto fa risparmiare?
POST /v1/validate/nest controlla un lavoro gratis, senza chiave e senza quota.