Przejdź do głównej treści
← CutOptim Engine APIEngine API · nesting · działa już dziś

API nestingu układów krojczych

Tak — istnieje API do tworzenia układów krojczych (markerów). Rozłożenie elementów kroju na rolce tkaniny, skóry lub tekstyliów technicznych tak, aby układ był jak najkrótszy, to zadanie nestingu po rzeczywistym kształcie z jednym otwartym wymiarem, a CutOptim Engine API rozwiązuje je przez HTTP pod POST /v1/optimize/nest. Twój PLM, ERP lub oprogramowanie do produkcji na zamówienie wysyła w JSON kontury elementów i szerokość rolki, a w odpowiedzi dostaje jeden układ: położenie każdego elementu i potrzebną długość — dla odzieży, tapicerstwa, wyrobów skórzanych i tekstyliów technicznych.

To działa już dziś jako tryb marker punktu końcowego nestingu: wiersz materiału z roll: true i bez h. Ten sam silnik rzeczywistych kształtów, który układa elementy na płytach, układa też elementy kroju; zmienia się tylko materiał, z arkusza o stałym rozmiarze na rolkę o stałej szerokości i swobodnej długości.

Wszystkie formaty, silniki, limity i przykłady kodu dla programistów: API do nestingu 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 nie jest częścią publicznego dema — uruchom ten przykład z darmowym kluczem testowym. Utwórz darmowy klucz testowy

  • Działa dziś na POST /v1/optimize/nest — tryb marker, z wierszem materiału roll (w i roll: true, bez h).
  • Zwraca JEDEN arkusz, którego h to najkrótsza znaleziona długość układu, z odstępem od krawędzi — także w metrics.length.
  • Elementy o rzeczywistym kształcie: wielokąty (z otworami) lub pliki SVG i DXF przez parts[].source.
  • Nitka prosta i włos: allowedRotations [0, 180] dla elementu zachowuje kierunek; options.minSeparation i options.edgeClearance ustawiają odstępy.
  • stock[].maxLength ogranicza układ (najwyżej 200000); elementy, które się nie mieszczą, trafiają do unplaced, nigdy na drugi arkusz.
  • lbf odpowiada synchronicznie do wyceny; max jest asynchroniczny (202, potem odpytywanie GET /v1/jobs/{id}) i może tylko skrócić układ lbf.
  • Bezpłatna walidacja: POST /v1/validate/nest sprawdza zlecenie bez klucza i bez limitu.

Rolka to nie arkusz

Arkusz ma dwa stałe boki, a pytanie brzmi, ile arkuszy potrzebuje zlecenie. Rolka ma jeden stały bok — szerokość — a pytanie brzmi, ile długości zużywają elementy. Wyślij wiersz materiału z w i roll: true, bez h, a nesting zwróci JEDEN arkusz o szerokości w, którego h to najkrótsza znaleziona długość, wraz z odstępem od krawędzi na obu końcach; ta sama wartość jest w metrics.length. Długość rolki to to, co się kupuje, więc to liczba, której potrzebuje wycena.

Co wysyłasz i co wraca

Wyślij każdy element kroju jako wielokąt (z opcjonalnymi otworami) albo jako SVG lub DXF przez parts[].source, z ilością. Odpowiedź podaje każde położenie jako sztywne przekształcenie (obrót w stopniach, potem przesunięcie x/y), długość układu oraz każdy element, który się nie zmieścił, w unplaced. Dowolny obiekt meta — Twoje odniesienie do modelu, rozmiaru lub zlecenia krojenia — wraca bez zmian przy każdej ułożonej kopii, dzięki czemu układ zgadza się z Twoim systemem.

Nitka prosta, włos i odstępy

allowedRotations ustawia się dla każdego elementu: [0, 180] zachowuje kierunek nitki prostej lub włosa i nadal pozwala odwrócić element na drugi koniec, a dłuższa lista albo "continuous" pasuje do materiału bez kierunku. options.minSeparation ustawia odstęp między elementami, a options.edgeClearance odstęp przy krawędziach rolki. Opcjonalne stock[].maxLength ogranicza układ do wybranej przez Ciebie długości (najwyżej 200000 w Twojej jednostce): elementy, które się w niej nie mieszczą, wracają w unplaced, a rolka nigdy nie staje się drugim arkuszem.

Natychmiast do wyceny, max do zlecenia krojenia

Domyślny silnik lbf odpowiada synchronicznie — deterministycznie i w ramach żądania, dość szybko, by wycenić układ, gdy klient czeka. Do zlecenia krojenia wyślij to samo ciało z engine: "max" i odpytuj GET /v1/jobs/{id}: startuje od układu lbf i przeznacza ustawiony przez Ciebie budżet czasu (options.timeBudgetMs) na wyszukiwanie w pasie, które może go skrócić, a nigdy nie wydłuża. Odpowiedź ma w obu przypadkach ten sam kształt, a wiersz warnings podaje długość i, przy max, czy wyszukiwanie ją skróciło.

Materiał do pobrania
One-pager API nestingu układów krojczych

Dwustronicowe streszczenie (PDF po angielsku) — problem, co wysyłasz i co dostajesz, przykładowe zapytanie i odpowiedź oraz jak budować na silniku. Gotowe do druku, z kodem QR prowadzącym do tej strony.

PDF2 stronyBezpłatnie
Pobierz PDF

Najczęstsze pytania

Czy istnieje API do tworzenia układów krojczych?
Tak. Rozłożenie elementów kroju na rolce tak, aby układ był jak najkrótszy, to tryb marker punktu końcowego nestingu CutOptim Engine API, POST /v1/optimize/nest. Wysyłasz każdy element jako wielokąt (albo SVG lub DXF) oraz wiersz materiału z szerokością rolki i roll: true, a w odpowiedzi dostajesz jeden układ: położenie każdego elementu i jego długość. Działa produkcyjnie już dziś, dla odzieży, tapicerstwa, skóry i tekstyliów technicznych.
Jak ustalana jest długość układu?
Silnik lbf układa elementy i zwraca potrzebną długość, synchronicznie i deterministycznie. Z engine: "max" zadanie działa asynchronicznie: startuje od tego układu lbf, przeznacza options.timeBudgetMs na szukanie krótszego pasa i nigdy nie zwraca dłuższego. Długość to h jedynego zwróconego arkusza, z odstępem od krawędzi, powtórzone w metrics.length.
Czy mogę zachować kierunek nitki prostej lub włosa?
Tak. Ustaw allowedRotations dla elementu: [0, 180] trzyma element na nitce prostej i pozwala go odwrócić na drugi koniec, a pojedynczy kąt całkowicie go unieruchamia. Elementy z materiału bez kierunku mogą dostać dłuższą listę kątów lub "continuous". options.minSeparation i options.edgeClearance ustawiają odstęp między elementami i przy krawędziach rolki.
Czy mogę ograniczyć długość układu?
Tak. stock[].maxLength ogranicza układ do wybranej przez Ciebie długości, najwyżej 200000 w Twojej jednostce. Elementy, które się w niej nie mieszczą, wracają w unplaced — rolka nigdy nie staje się drugim arkuszem — więc widzisz, co zostało, i decydujesz, co z tym zrobić.
Czy stopniuje wykroje, dopasowuje kratę lub planuje rozkładanie?
Nie. Układa elementy, które wyślesz: nie stopniuje wykroju na rozmiary, nie dopasowuje kraty ani pasków i nie planuje warstw ani rozkładania. Wyślij jako parts każdy rozmiar i ilość, które mają być w układzie, z obiektem meta na własne odniesienia, a odpowiedź powie, gdzie trafia każda kopia.
Ile materiału pozwala zaoszczędzić?
To zależy od elementów i szerokości rolki, dlatego nie podajemy ogólnego procentu. Uczciwą miarą jest długość układu dla tych samych elementów i tej samej szerokości: uruchom zlecenie, porównaj długość z obecnym układem oraz lbf z max. max nigdy nie zwraca dłuższego układu niż lbf. POST /v1/validate/nest sprawdza zlecenie bezpłatnie, bez klucza i bez limitu.

Zastosowanie: tekstylia i tapicerstwo (aplikacja) · Benchmarki