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
{
"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 aroll: 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.minSeparationaoptions.edgeClearancenastavují odstupy. stock[].maxLengthomezí 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/nestzkontroluje 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.
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.
Časté dotazy
Existuje API pro tvorbu střihových layoutů?
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: "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?
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?
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í?
Kolik materiálu ušetří?
POST /v1/validate/nest zkontroluje zakázku zdarma, bez klíče a bez kvóty.