Aller au contenu principal
← CutOptim Engine APIEngine API · nesting · disponible aujourd’hui

API de nesting de plans de coupe textile

Oui — il existe une API pour le tracé de plans de coupe (marker). Disposer les pièces d’un patron sur un rouleau de tissu, de cuir ou de textile technique pour que le plan soit le plus court possible est un problème de nesting à forme réelle avec une dimension libre, et la CutOptim Engine API le résout en HTTP sur POST /v1/optimize/nest. Votre PLM, ERP ou logiciel de fabrication sur mesure envoie les contours des pièces et la largeur du rouleau en JSON et reçoit un plan : la position de chaque pièce et la longueur nécessaire — pour l’habillement, l’ameublement, la maroquinerie et les textiles techniques.

C’est disponible aujourd’hui comme mode marker du point d’accès de nesting : une ligne de stock avec roll: true et sans h. Le même moteur à forme réelle qui emboîte les plaques emboîte les pièces ; seul le stock change, d’une feuille de taille fixe à un rouleau de largeur fixe et de longueur libre.

Tous les formats, moteurs, limites et exemples de code pour les développeurs : API d’imbrication (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 }
}

Le nesting n'est pas inclus dans la démo publique — exécutez cet exemple avec une clé de test gratuite. Créer une clé de test gratuite

  • Disponible aujourd’hui sur POST /v1/optimize/nest — mode marker, avec une ligne de stock roll (w et roll: true, sans h).
  • Renvoie UNE feuille dont le h est la longueur de plan la plus courte trouvée, marge de bord comprise — aussi dans metrics.length.
  • Pièces à forme réelle : polygones (avec trous), ou fichiers SVG et DXF via parts[].source.
  • Droit-fil et sens du poil : allowedRotations [0, 180] par pièce conserve le sens ; options.minSeparation et options.edgeClearance fixent les écarts.
  • stock[].maxLength plafonne le plan (au plus 200000) ; les pièces qui n’y tiennent pas vont dans unplaced, jamais sur une seconde feuille.
  • lbf répond de façon synchrone pour le devis ; max est asynchrone (202, puis interroger GET /v1/jobs/{id}) et ne peut que raccourcir le plan lbf.
  • Validation gratuite : POST /v1/validate/nest contrôle un travail sans clé et sans quota.

Un rouleau n’est pas une feuille

Une feuille a deux côtés fixes, et la question est de savoir combien de feuilles un travail demande. Un rouleau a un seul côté fixe — la largeur — et la question est de savoir quelle longueur les pièces consomment. Envoyez une ligne de stock avec w et roll: true, sans h, et le nesting renvoie UNE feuille de largeur w dont le h est la longueur la plus courte trouvée, marge de bord comprise aux deux extrémités ; la même valeur figure dans metrics.length. C’est la longueur de rouleau que l’on achète, donc c’est le chiffre dont un devis a besoin.

Ce que vous envoyez et ce qui revient

Envoyez chaque pièce de patron sous forme de polygone (avec trous facultatifs), ou en SVG ou DXF via parts[].source, avec une quantité. La réponse donne chaque placement comme une transformation rigide (une rotation en degrés, puis une translation x/y), la longueur du plan, et toute pièce qui n’a pas tenu dans unplaced. Tout objet meta — votre référence de modèle, de taille ou d’ordre de coupe — revient tel quel sur chaque exemplaire placé, de sorte que le plan se rapproche de votre propre système.

Droit-fil, sens du poil et espacements

allowedRotations se règle par pièce : [0, 180] conserve le sens du droit-fil ou du poil tout en laissant retourner la pièce bout pour bout, tandis qu’une liste plus longue ou "continuous" convient à une matière sans sens. options.minSeparation fixe l’écart entre les pièces et options.edgeClearance l’écart aux bords du rouleau. Un stock[].maxLength facultatif plafonne le plan à une longueur de votre choix (au plus 200000 dans votre unité) : les pièces qui n’y tiennent pas reviennent dans unplaced, et un rouleau ne devient jamais une seconde feuille.

Instantané pour le devis, max pour l’ordre de coupe

Le moteur lbf par défaut répond de façon synchrone — déterministe et dans la requête, assez vite pour chiffrer un plan pendant que le client attend. Pour l’ordre de coupe, envoyez le même corps avec engine: "max" et interrogez GET /v1/jobs/{id} : il part du plan lbf et consacre le budget de temps que vous fixez (options.timeBudgetMs) à une recherche par bande qui peut le raccourcir et ne l’allonge jamais. La réponse a la même forme dans les deux cas, et une ligne warnings indique la longueur et, avec max, si la recherche l’a raccourcie.

Ressource à télécharger
One-pager de l’API de nesting de plans de coupe textile

Un résumé de deux pages (PDF en anglais) — le problème, ce que vous envoyez et recevez, une requête et une réponse, et comment construire sur le moteur. Prêt à imprimer, avec un QR code vers cette page.

PDF2 pagesGratuit
Télécharger le PDF

Questions fréquentes

Existe-t-il une API pour le tracé de plans de coupe ?
Oui. Disposer les pièces d’un patron sur un rouleau pour que le plan soit le plus court possible est le mode marker du point d’accès de nesting de la CutOptim Engine API, POST /v1/optimize/nest. Vous envoyez chaque pièce comme polygone (ou SVG ou DXF) plus une ligne de stock avec la largeur du rouleau et roll: true, et vous recevez un plan : la position de chaque pièce et sa longueur. Il tourne en production aujourd’hui, pour l’habillement, l’ameublement, le cuir et les textiles techniques.
Comment la longueur du plan est-elle décidée ?
Le moteur lbf place les pièces et renvoie la longueur dont elles ont besoin, de façon synchrone et déterministe. Avec engine: "max", le travail s’exécute de façon asynchrone : il part de ce plan lbf, consacre options.timeBudgetMs à chercher une bande plus courte et n’en renvoie jamais une plus longue. La longueur est le h de l’unique feuille renvoyée, marge de bord comprise, et elle est répétée dans metrics.length.
Puis-je conserver le sens du droit-fil ou du poil ?
Oui. Réglez allowedRotations par pièce : [0, 180] garde la pièce sur le droit-fil et la laisse se retourner bout pour bout, et un seul angle la fixe complètement. Les pièces d’une matière sans sens peuvent recevoir une liste d’angles plus longue ou "continuous". options.minSeparation et options.edgeClearance fixent l’écart entre les pièces et aux bords du rouleau.
Puis-je limiter la longueur du plan ?
Oui. stock[].maxLength plafonne le plan à une longueur de votre choix, au plus 200000 dans votre unité. Les pièces qui n’y tiennent pas reviennent dans unplaced — un rouleau ne devient jamais une seconde feuille — pour que vous voyiez ce qui reste et décidiez quoi en faire.
Fait-elle la gradation, le raccord des carreaux ou la planification du matelassage ?
Non. Elle emboîte les pièces que vous envoyez : elle ne gradue pas un patron en tailles, ne raccorde pas carreaux ou rayures et ne planifie ni les plis ni le matelassage. Envoyez comme parts chaque taille et quantité voulue dans le plan, avec un objet meta pour vos propres références, et la réponse indique où va chaque exemplaire.
Combien de tissu permet-elle d’économiser ?
Cela dépend des pièces et de la largeur du rouleau, donc nous ne citons pas de pourcentage général. La mesure honnête est la longueur du plan avec les mêmes pièces et la même largeur : lancez le travail, comparez la longueur à votre plan actuel et comparez lbf à max. max ne renvoie jamais un plan plus long que lbf. POST /v1/validate/nest contrôle un travail gratuitement, sans clé et sans quota.

Cas d’usage textile et ameublement (app) · Benchmarks