Přejít na hlavní obsah
← CutOptim Engine APIEngine API · nesting · funguje už dnes

API nestingu střihových layoutů

Ano — existuje API pro tvorbu střihových layoutů (markerů). Rozložení střihových dílů na roli látky, kůže nebo technického textilu tak, aby byl layout co nejkratší, je úloha nestingu podle skutečného tvaru s jedním volným rozměrem a CutOptim Engine API ji řeší přes HTTP na POST /v1/optimize/nest. Váš PLM, ERP nebo software pro výrobu na zakázku pošle v JSON obrysy dílů a šířku role a vrátí se jeden layout: umístění každého dílu a potřebná délka — pro oděvy, čalounictví, kožedělné zboží a technické textilie.

Funguje to už dnes jako režim marker nesting endpointu: řádek materiálu s roll: true a bez h. Stejný engine skutečných tvarů, který skládá plechy, skládá i střihové díly; mění se jen materiál, z tabule pevné velikosti na roli pevné šířky a volné délky.

Všechny formáty, enginy, limity a ukázky kódu pro vývojáře: API pro 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 }
}

Nesting není součástí veřejného dema — spusťte tento příklad s bezplatným testovacím klíčem. Vytvořit bezplatný testovací klíč

  • Funguje dnes na POST /v1/optimize/nest — režim marker, s řádkem materiálu roll (w a roll: true, bez h).
  • Vrací JEDNU tabuli, jejíž h je nejkratší nalezená délka layoutu, včetně odstupu od okraje — také v metrics.length.
  • Díly skutečných tvarů: polygony (s otvory) nebo soubory SVG a DXF přes parts[].source.
  • Osnova a spád: allowedRotations [0, 180] u dílu zachová směr; options.minSeparation a options.edgeClearance nastavují odstupy.
  • stock[].maxLength omezí layout (nejvýše 200000); díly, které se nevejdou, jdou do unplaced, nikdy na druhou tabuli.
  • lbf odpovídá synchronně pro nabídku; max je asynchronní (202, pak dotazujte GET /v1/jobs/{id}) a layout lbf může jen zkrátit.
  • Bezplatná validace: POST /v1/validate/nest zkontroluje zakázku bez klíče a bez kvóty.

Role není tabule

Tabule má dvě pevné strany a otázkou je, kolik tabulí zakázka potřebuje. Role má jednu pevnou stranu — šířku — a otázkou je, kolik délky díly spotřebují. Pošlete řádek materiálu s w a roll: true, bez h, a nesting vrátí JEDNU tabuli o šířce w, jejíž h je nejkratší nalezená délka, včetně odstupu od okraje na obou koncích; stejná hodnota je v metrics.length. Délka role je to, co nakupujete, takže je to číslo, které potřebuje nabídka.

Co posíláte a co se vrací

Pošlete každý střihový díl jako polygon (s volitelnými otvory) nebo jako SVG či DXF přes parts[].source, s počtem kusů. Odpověď dává každé umístění jako tuhou transformaci (rotace ve stupních, pak posun x/y), délku layoutu a každý díl, který se nevešel, v unplaced. Libovolný objekt meta — vaše reference modelu, velikosti nebo zakázky střihu — se vrací beze změny u každé umístěné kopie, takže layout sedí s vaším vlastním systémem.

Osnova, spád a odstupy

allowedRotations se nastavuje pro každý díl: [0, 180] zachová směr osnovy nebo spádu a dílu přesto dovolí otočení o půl otáčky, zatímco delší seznam nebo "continuous" vyhovuje materiálu bez směru. options.minSeparation nastavuje odstup mezi díly a options.edgeClearance odstup u okrajů role. Volitelné stock[].maxLength omezí layout na délku podle vaší volby (nejvýše 200000 ve vaší jednotce): díly, které se do ní nevejdou, se vrátí v unplaced a role se nikdy nestane druhou tabulí.

Okamžitě pro nabídku, max pro zakázku střihu

Výchozí engine lbf odpovídá synchronně — deterministicky a v rámci požadavku, dost rychle, aby se layout dal ocenit, zatímco zákazník čeká. Pro zakázku střihu pošlete stejné tělo s engine: "max" a dotazujte GET /v1/jobs/{id}: začne z layoutu lbf a časový rozpočet, který nastavíte (options.timeBudgetMs), využije na hledání po pásech, které ho může zkrátit a nikdy neprodlouží. Odpověď má v obou případech stejný tvar a řádek warnings uvádí délku a u max i to, zda ji hledání zkrátilo.

Materiál ke stažení
One-pager API nestingu střihových layoutů

Dvoustránkové shrnutí (PDF v angličtině) — problém, co posíláte a co dostanete zpět, ukázka požadavku a odpovědi a jak na jádru stavět. Připraveno k tisku, s QR kódem zpět na tuto stránku.

PDF2 stranyZdarma
Stáhnout PDF

Časté dotazy

Existuje API pro tvorbu střihových layoutů?
Ano. Rozložení střihových dílů na roli tak, aby byl layout co nejkratší, je režim marker nesting endpointu CutOptim Engine API, POST /v1/optimize/nest. Každý díl pošlete jako polygon (nebo SVG či DXF) spolu s řádkem materiálu se šířkou role a roll: true a vrátí se jeden layout: umístění každého dílu a jeho délka. Běží v produkci už dnes, pro oděvy, čalounictví, kůži a technické textilie.
Jak se určí délka layoutu?
Engine lbf rozmístí díly a vrátí délku, kterou potřebují, synchronně a deterministicky. S engine: "max" běží zakázka asynchronně: začne z toho layoutu lbf, options.timeBudgetMs využije na hledání kratšího pásu a nikdy nevrátí delší. Délka je h jediné vrácené tabule, včetně odstupu od okraje, a opakuje se v metrics.length.
Mohu zachovat směr osnovy nebo spádu?
Ano. Nastavte allowedRotations pro každý díl: [0, 180] drží díl ve směru osnovy a dovolí ho otočit o půl otáčky, jediný úhel ho zafixuje úplně. Díly z materiálu bez směru mohou dostat delší seznam úhlů nebo "continuous". options.minSeparation a options.edgeClearance nastavují odstup mezi díly a u okrajů role.
Mohu omezit délku layoutu?
Ano. stock[].maxLength omezí layout na délku podle vaší volby, nejvýše 200000 ve vaší jednotce. Díly, které se do ní nevejdou, se vrátí v unplaced — role se nikdy nestane druhou tabulí — takže vidíte, co zbylo, a rozhodnete se, co s tím.
Dělá gradaci střihů, spasování kostek nebo plánování prostírání?
Ne. Skládá díly, které pošlete: negraduje střih do velikostí, nespasuje kostky ani proužky a neplánuje vrstvy ani prostírání. Pošlete jako parts každou velikost a množství, které chcete v layoutu, s objektem meta pro vlastní reference, a odpověď řekne, kam která kopie patří.
Kolik materiálu ušetří?
Záleží na dílech a šířce role, proto neuvádíme paušální procento. Poctivá míra je délka layoutu pro stejné díly a stejnou šířku: spusťte zakázku, porovnejte délku se svým současným layoutem a porovnejte lbf s max. max nikdy nevrátí delší layout než lbf. POST /v1/validate/nest zkontroluje zakázku zdarma, bez klíče a bez kvóty.

Případ užití textil a čalounictví (aplikace) · Benchmarky