Data Objects

Learn about usage of Data Object in Toncut, using examples and clearly readable tables.

Profile

Profile refers to an optimization profile.

It describes the configuration for algorithms to be used and optimization limits, such as maximum time, maximum number of combination, etc.

An optimization profile allows users to specify the parameters and constraints for an optimization process, ensuring that the algorithms used are tailored to their specific needs and requirements.

The user can define up to 20 profiles, allowing them to test different optimization strategies to achieve the best results.

Attributes

name
string mandatory
The name of the optimization profile.
active
bool mandatory
Set it to true, to activate the profile. It will be used only if it is active.
algorithms
object mandatory
Configuration of algorithms to be used by the profile.
Show Child Attributes
grouping
booldef: true
When activated, this algorithm groups pieces into larger rectangles, which not only speeds up the optimization process but also typically yields better results.

deduction
booldef: true
When activated, this algorithm tries to predict what will be the waste during the optimization process.

If the predicted waste is greater than the best solution found so far, the algorithm stops exploring the current branch and switches to another one.

lastStockItem
booldef: true
Optimization can take longer when there aren’t enough pieces to fill the entire area.

When activated, this algorithm speeds up the optimization process by quickly optimizing the last cuttings.

firstHit
booldef: true
When activated, this algorithm immediately stops optimization of a single cutting as soon as it finds the first solution that fills the entire area.

It's important to note that while this algorithm may generate the best results for a single cutting, it may not always produce the best results for the entire optimization process.
fast
booldef: false
When activated, this algorithm activates a shallow optimization process that is very fast but may produce weaker results.

balance
booldef: true
When activated, this algorithm addresses the issue of greedy optimization.

Small pieces are easier to optimize, so they may all be used in the first cuttings, leaving only large pieces that are difficult to layout optimally.

This can result in perfectly optimized first cuttings but huge waste on the last. To avoid this, the balancing algorithm distributes small, medium, and large pieces throughout all the cuttings.

adaptive
object
The adaptive algorithm is a type of global algorithm. It operates by repeating the optimization process multiple times.

In each subsequent iteration, problematic elements are shifted to earlier cuttings to improve the results.

Show Child Attributes
enabled
booldef: true
Enables or disables the adaptive object.

level
int(2-40)def: 5
The level property describes maximum number of iterations that can be done for each solution.

ai
object
AI is a type of global optimization algorithm that leverages artificial intelligence to discover superior solutions that cannot be achieved by traditional algorithms.

Show Child Attributes
enabled
booldef: false
Enables or disables the ai object.

level
int(0-4)def: 0
The level of the AI algorithm refers to several of its parameters. A higher level means a longer optimization process but also results in a better solution.

Typically, levels 1 or 2 produce satisfactory results.
Each algorithm is ignored if ai algorithm is enabled.
limits
object
Here we can define the conditions for early termination of global and/or single optimization.
Show Child Attributes
maxCombinations
object
Allows to specify the maximum number of combinations within the optimization of a single StockItem.

Show Child Attributes
enabled
bool def: disabled
Enables or disables the criterion.

limit
int
Optimization of a single StockItem will be completed if the number of checked combinations exceeds the given value.

maxTimeSingle
object
Allows to specify the maximum optimization time for a single StockItem.

Show Child Attributes
enabled
bool def: disabled
Enables or disables the criterion.

limit
time
Optimization of a single StockItem will be terminated if it takes longer than the specified time.

maxTime
object
Allows to specify the maximum time for a single optimization.

Show Child Attributes
enabled
bool def: disabled
Enables or disables the criterion.

limit
time
A single optimization will be terminated if it lasts longer than the specified time.

goodEnoughWaste
object
Allows to specify (in percent) the amount of waste (usable and non-usable) that is acceptable. This criterion applies to the optimization of a single StockItem.

Show Child Attributes
enabled
bool def: disabled
Enables or disables the criterion.

limit
percent
Optimization of a single StockItem will be completed when the waste size is lower than the given value.
stockOrder
object
Here we can specify the stock sequence strategy. This is of great importance and can significantly affect the quality of the results.
These settings apply to all algorithms except ai.
Show Child Attributes
order
object
Here we define the main strategy for the order of stock selection.

Show Child Attributes
direction
Directionenum
Stock's sorting
Allowed values
fromLarge

The stock will be sorted by size, from larger to smaller.
fromSmall

The stock will be sorted by size, from smaller to larger.
random

The stock will be in random order.
def: fromLarge
Here we can define if and how the stock will be sorted.
switchToSmall
object
It is a modifier of the fromLarge direction. If waste exceeds the given threshold, the order of the remaining stock will be automatically changed according to fromSmall direction.

Show Child Attributes
enabled
bool def: disabled
Enables or disables the switchToSmall modifier of the fromLarge direction.

minWaste
percent
The waste threshold expressed in percentage. If the waste is larger than the specified value, the switchToSmall modifier will be executed.

randomOrders
object
It is a modifier of the fromSmall direction. It generates specified number of random orders for small stock items.

Show Child Attributes
enabled
bool def: disabled
Enables or disables the randomOrders modifier of the fromSmall direction.

count
int
Number of random orders for the small stock items.

randomDrawCount
int def: 10
It is modifier of the random direction. Defines number of random orders that should be checked.

adaptiveOrder
object
An additional dynamic stock reorder strategy can be enabled here.

This strategy only works in a “forward” manner and does not alter the order of already optimized cuttings.

If the waste of a single cutting exceeds a given threshold, the program will reject it and move the StockItem to the end of the queue. Optimization will then continue with the next StockItem.

Show Child Attributes
enabled
booldef: true
Enables or disables the adaptive reorder strategy.

minWaste
percentdef: 15%
The waste size threshold expressed in percentage. If the waste is larger than specified value, the order of the remaining stock items will be changed.

maxTries
intdef: 3
Maximum number of reorders per cycle.

maxCycles
intdef: 1
Maximum number of cycles. The cycle ends when we are optimizing again a StockItem that was already rejected by this strategy.
advanced
object
Here we can change some advanced settings.
Before you change anything here, make sure you understand what you are doing, as these settings may significantly change the quality of results and also time of the optimization process.
Show Child Attributes
dynamicMethodSwitch
object
This is a simple, yet very effective strategy that shortens optimization time significantly.

If the program cannot find a better solution for the specified time, it will switch optimization process to something that we call “a fast route”.

The “fast route” will be automatically disabled when the time comes.

Show Child Attributes
enabled
bool def: enabled
Enables or disables the dynamicMethodSwitch.

threshold
time
The amount of time during which the program is unable to find a better solution. When this threshold is reached the optimization will switch to the “fast route”.

fastMethodForLastStockItems
object
Optimization of last stock items usually takes more time because of less optimization tools available.

To make this process faster one can enable fast method.

When this option is enabled, the fast method will be activated automatically when total size of available elements is smaller than provided percentage of the StockItem's size.

Show Child Attributes
enabled
booldef: true
Enables or disables the fastMethodForLastStockItems.

threshold
percentdef: 80%
If total size of all available pieces is smaller than the value provided here, then fast method will be activated.

searchDirection
searchDirectionenum
Direction of StockItem's placement
Allowed values
byLength

Horizontally, by length.
byWidth

Vertically, by width (doesn’t make sense for 1D materials).
auto

The direction will be selected automatically.
def: auto
Specifies the direction in which items are placed on the StockItem.
searchPrecision
object
Specifies the accuracy of the search.
The higher the values here, the better results will be found.

Be careful, as setting too high numbers here can make the optimization process much longer.
Show Child Attributes
firstLevel
int def: maximum/all pieces
How many pieces should be checked in the first step.

nextLevels
int def: 1
How many pieces should be checked in the next steps.

Note that value of 2 here is already very high!

The profile object config

{
  "profiles": {
    "name": "fromSmall",
    "active": true,
    "algorithms": {
      "grouping": true,
      "deduction": true,
      "lastStockItem": true,
      "firstHit": true,
      "fast": false,
      "balance": false,
      "forking": {
          "enabled": false,
          "level": 1
      },
      "adaptive": {
          "enabled": true,
          "level": 5
      },
      "ai": {
          "enabled": false,
          "level": 0
      }
    },
    "limits": {
      "maxCombinations": {
          "enabled": false,
          "limit": 5000000
      },
      "maxTimeSingle": {
          "enabled": false,
          "limit": "5s"
      },
      "maxTime": {
          "enabled": false,
          "limit": "0s"
      },
      "goodEnoughWaste": {
          "enabled": false,
          "limit": "0.00%"
      }
    },
    "stockOrder": {
      "order": {
          "direction": "fromSmall",
          "switchToSmall": {
            "enabled": false,
            "minWaste": "0.20%"
          },
          "randomOrders": {
            "enabled": false,
            "count": 5
          },
          "randomDrawCount": 10
      },
      "adaptiveOrder": {
          "enabled": true,
          "minWaste": "0.15%",
          "maxTries": 3,
          "maxCycles": 1
      }
    },
    "advanced": {
      "dynamicMethodSwitch": {
          "enabled": true,
          "threshold": "1s"
      },
      "fastMethodForLastStockItems": {
          "enabled": true,
          "threshold": "0.80%"
      },
      "searchDirection": "auto",
      "searchPrecision": {
          "firstLevel": 2147483647,
          "nextLevels": 1
      }
    }
  }
}

Device

Device object represents a cutting device.

It specifies the features and limitations of the device.

Attributes

id
int mandatory
Unique device id.
title
string mandatory
Device title.
materialKind
MaterialKindenum
Material kind device's made for
Allowed values
1d

1D materials like profiles, pipes, rods, beams, etc.
2d

2D materials like glass, panels, fabric, aluminum, cardboard, etc.
mandatory
Specifies the material kind this device is made for.
slants
object 1D only
Specifies support for miter cuts in 1D materials.
Show Child Attributes
supported
booldef: false
Set it to true if the device supports miter cuts.

leftMeasurement
LeftMeasurementenum
Measurement of the left slant
Allowed values
fromMiddleToLeft
fromMiddleToRight
fromLeft
fromRight
def: fromMiddleToRight
How the left slant's angle is measured.
rightMeasurement
RightMeasurementenum
Measurement of the right slant
Allowed values
fromMiddleToLeft
fromMiddleToRight
fromLeft
fromRight
def: fromMiddleToLeft
How the right slant's angle is measured.
canCrossCuts
bool 2D onlydef: false
Set it to true if the device allows the cuts to cross each other.
fullCutsOnly
bool 2D onlydef: true
Set it to true if only full cuts (from edge to edge) are allowed.
stripCutting
StripCuttingenum
Strip cutting direction
Allowed values
none

No strip cutting.
byLength

Horizontal strips.
byWidth

Vertical strips.
2D onlydef: none
Set it to byLength or byWidth if the device cuts in strips (e.g. for panel saw).
It makes sense only if fullCutsOnly option is set to true.
It may be used together with maxCutDepth option.
minCutWidth
lengthdef: 0
The minimum distance between two cuts.

Setting this value makes sense when cutting glass – you don't want to have two parallel cuts too close to each other, because then breaking off can be significantly more difficult.

Please note that this is not a kerf that can be set in the material group settings.
edgingCuts
EdgingCutsenum
Specifies the edging method
Allowed values
optimal

An optimal edging method ensures precise and accurate cutting of edges, resulting in clean, smooth, and well-defined boundaries while minimizing any unintended removal or distortion of the desired elements.
horizontalFirst

A "HorizontalFirst" edging method involves cutting off the horizontal edges first, followed by the vertical edges.
verticalFirst

A "VerticalFirst" edging method refers to a technique where the vertical edges are cut off before the horizontal edges.
2D onlydef: optimal
Edging method.
originEdgingCuts
OriginEdgingCutsenum
Edging method for the top and left edges.
Allowed values
default

Nothing changes and edges will be cut off as described in edgingCuts property description.
twoFullCuts

Top and left edges will be cut off as full cuts (from edge to edge)
2D onlydef: default
Edging method for the top and left edges.
firstCutDirection
CutDirectionenum
Specifies the direction of the first cut
Allowed values
horizontal

First cut will be horizontal, along the length of the StockItem.
vertical

First cut will be vertical, along the width of the StockItem.
any

Algorithm will decide.
2D onlydef: any
Specifies whether the first cut will be done horizontally or vertically. Note that it is overwritten if strip cutting is turned on.
It's important to note that setting the correct firstCutDirection can be crucial when used in conjunction with the maxCutDepth option.
maxCutDepth
object 2D only
Specifies maximum cut depth level the device is supporting.
The picture below shows what is the cut depth level:
It makes sense only if fullCutsOnly is set to true.
Show Child Attributes
enabled
bool def: disabled
Enables or disables maximum cut depth limit.

limit
int
The cut depth limit.

includeEdging
bool def: disabled
Set it to true if cutting off edges should be included when calculating cut depth.
maxCutLengthByLength
object
Maximum horizontal cut length.
It can also be used when cutting in strips - then it allows to limit the width of the strip.
This option is especially useful when the device is a guillotine.
Show Child Attributes
enabled
booldef: false
Enables or disables maximum horizontal cut length.

limit
length
Maximum cut length.
maxCutLengthByWidth
object 2D only
Maximum vertical cut length.
It can also be used when cutting in strips - then it allows to limit the width of the strip.
This option is especially useful when the device is a guillotine.
Show Child Attributes
enabled
booldef: false
Enables or disables maximum vertical cut length.

limit
length
Maximum cut length.

{
  "devices": [
    {
      "title": "Device 1D",
      "materialKind": "1d",
      "slants": {
          "supported": true,
          "leftMeasurement": "fromMiddleToRight",
          "rightMeasurement": "fromMiddleToLeft"
      },
      "minCutWidth": 0,
      "edgingCuts": "optimal",
      "maxCutLengthByLength": {
          "enabled": false,
          "limit": 10000
      },
      "id": 1
    }
  ]
}

StandardStockItem

The StandardStockItem object is used to define standard dimensions and default characteristics of stock items.

For each material you can define list of standard stock items.

Attributes

id
int mandatory
Unique id of a StandardStockItem.
title
string
Title of a StandardStockItem.
length
length mandatory
Length of a StandardStockItem.
width
length mandatory 2D only
Width of a StandardStockItem.
structure
Structuresset
The structure of the StandardStockItem
Allowed values
none

The material has no structure.
byLength

The structure is horizontal (along length).
byWidth

The structure is vertical (along width).
2D onlydef: []
The structure of the StandardStockItem.
edging
object
Edging configuration.
Show Child Attributes
left
lengthdef: 0
The size of the edge to be cut off on the left side of the StockItem.

right
lengthdef: 0
The size of the edge to be cut off on the right side of the StockItem.

top
length 2D onlydef: 0
The size of the edge to be cut off on the top of the StockItem.

bottom
length 2D onlydef: 0
The size of the edge to be cut off on the bottom of the StockItem.

Material

The Material object defines material group.

Each piece or StockItem must belong to a material group.

Thanks to this, the program knows which pieces are to be placed on which stock items.

Attributes

id
int mandatory
Unique id of a material group.
deviceId
int mandatory
Id of a cutting device used to cut this material group.
title
string mandatory
Title of the material group.
kind
MaterialKindenum
Type of the material
Allowed values
1d

1D materials like profiles, pipes, rods, beams, etc.
2d

2D materials like glass, panels, fabric, aluminum, cardboard, etc.
mandatory
Specifies the type of the material.
width
length mandatory 1D only
Specifies the width of the material.
thickness
length mandatory
Specifies the thickness of the material.
canHaveStructure
bool 2D onlydef: false
Specifies whether the material group can have a structure.
colorable
booldef: false
Specifies whether the pieces can have different colors. It doesn't influence the optimization process.
canRotate
bool 1D onlydef: false
Specifies whether the pieces of this material group can be rotated.
canMirror
bool 1D onlydef: false
Specifies whether the pieces of this material group can be reversed (back to front).
surplus
lengthdef: 0
This setting defines the default surplus for pieces, meaning the amount by which each cut element will be enlarged on all sides.

For instance, if a piece is 300x200 and the surplus is set to 2, the optimizer will use a size of 304x204.

In the case of 1D materials, this applies, of course, only to the length.
surplusEditable
booldef: true
This setting determines whether the surplus can be adjusted in the piece configuration.

If set to false, any surplus specified by the piece will be disregarded and the one defined in material group will be used.
margin
lengthdef: 0
This setting determines the default margin for pieces, which is the amount by which each cut element will be reduced on all sides.

For instance, if a piece is 300x200 and the margin is set to 2, the optimizer will use 296x196.

In the case of 1D materials, this applies, of course, only to the length.
marginEditable
booldef: true
This setting determines whether the margin can be adjusted in the piece configuration.

If set to false, any margin specified by the piece will be disregarded and the one defined in material group will be used.
defaultEdging
lengthdef: 0
Specifies default edging for new stock items.
cuttingDimensions
Dimensionsenum
Piece size used for cutting
Allowed values
net

The size specified by length & width of the piece will be used.

Note that surplus and margin may be applied if they are specified.
gross

The size of the piece will be increased by the thickness of the veneers used.
mandatory2D only
Specifies what should be the piece size that will be used for cutting.
canBeVeneered
bool 2D onlydef: false
Specifies whether pieces of the material group can be veneered.
kerf
length mandatory
Specifies the size of the kerf, i.e. the width of the waste line left by the cutting device.
allowEdgeCuts
booldef: false
Specifies whether it is possible to do something that we call the “edge cutting”.

If you have 2mm to cut off and the kerf is 3mm, then you kind of have to "take off" those 2mm with just the saw blade - that's edge cutting.

It is ignored if minCutWidth property of used cutting device is greater than zero.
reuseWaste
object
It defines the criterion for qualifying waste as usable.
Usable waste is one that goes to the warehouse for later use.
Show Child Attributes
enabled
booldef: true
Enables or disables generation of reusable waste. If disabled, the entire unused material is treated as waste.

minLongerLength
lengthdef: 200
The minimum size of the longer dimension that qualifies the waste as usable.

minShorterLength
length 2D onlydef: 200
The minimum size of the shorter dimension that qualifies the waste as usable.

prefLongerLength
lengthdef: 600
The preferred size of the longer dimension that qualifies the waste as usable.

prefShorterLength
length 2D onlydef: 600
The preferred size of the shorter dimension that qualifies the waste as usable.

edging
object
Specified default edging for the waste that was qualified as usable.

Show Child Attributes
enabled
booldef: false
Enables or disables setting the edging to the StockItem created from the usable waste.

default
lengthdef: 0
The default edging size. Note that edging will be applied to all edges of the new StockItem.
stackCutting
object
It defines the stack cutting rules.
Show Child Attributes
enabled
booldef: false
Enables or disables stack cutting.

stackSize
int
The stack size. Note that stack cutting applies only to stock items with standard dimensions.
standardStockItems
list(StandardStockItem)
The list of standardStockItems for the material group.

{
  "materials": [
    {
      "deviceId": 1,
      "title": "Material 1D",
      "kind": "1d",
      "width": 100,
      "thickness": 100,
      "canRotate": true,
      "canMirror": true,
      "surplus": 0,
      "surplusEditable": true,
      "margin": 0,
      "marginEditable": true,
      "defaultEdging": 0,
      "kerf": 0,
      "allowEdgeCuts": true,
      "reuseWaste": {
          "minLongerLength": 200,
          "edging": {
            "enabled": false,
            "default": 0
          }
      },
      "canBeVeneered": true,
      "id": 3
    }
  ]
}

Veneer

The Veneer object specifies characteristics of a veneer.

Attributes

id
int mandatory
Unique id of the veneer.
title
string mandatory
Title of the veneer.
width
length mandatory
Width of the veneer.
thickness
length mandatory
Thickness of the veneer.
surplus
length mandatory
The surplus is automatically added when the demand for the amount of veneer is calculated. Please note that the surplus is added twice.
maxMaterialThickness
length mandatory
The maximum thickness of the material for which this veneer can be used.

2D input

{
"veneers": [
    {
      "title": "Oak",
      "width": 22,
      "thickness": 1.5,
      "maxMaterialThickness": 18,
      "id": 1
    }
  ]
}

Piece

The Piece object describes piece.

Attributes

id
int mandatory
Unique piece id.
materialId
int mandatory
The ID of the material group from which this piece will be cut.
identifier
string
The user defined identifier of the piece. It must be Code128 barcode compatible.
color
string
Color of the piece.
description
string
Description of the piece.
length
length mandatory
The net length of the piece.

Keep in mind that for 1D shapes, it is always the total length, including slants:
width
length mandatory 2D only
The net width of the piece.
shapeType
ShapeTypeenum
Shape of the piece
Allowed values
none

No shape, the same as rectangle.
rectangle

Just rectangle, so no additional shape definition is necessary.
linear

1D shape with slants. The shape property contains slant values.
def: none
Type of the shape of the piece.
shape
object
Depending on shapeType it may contain different format.

For the moment only LinearShape is supported.
quantity
int mandatory
Specifies quantity of pieces.
structure
Structuresset
Structure of the piece
Allowed values
none

The material has no structure.
byLength

The structure is horizontal (along length).
byWidth

The structure is vertical (along width).
2D onlydef: [none,byLength,byWidth]
Specifies acceptable structures of the piece.
Usually you want to specify only one value here, e.g. byLength.

But, sometimes you don’t care what structure a piece will have – then you can set it to “none,byLength,byWidth”.
priority
Priorityenum
Priority of the piece
Allowed values
normal

The piece is handled normally.
high

The piece has 5x higher value than normal ones.
critical

The piece has 10x higher value than normal ones.
def: normal
Priority of the piece.
surplus
lengthdef: 0
Specifies the surplus, meaning the amount by which the piece size will be enlarged on all sides.

For instance, if a piece is 300x200 and the surplus is set to 2, the optimizer will use a size of 304x204.

In the case of 1D materials, this applies, of course, only to the length.
margin
lengthdef: 0
Specifies the margin, which is the amount by which the piece size will be reduced on all sides.

For instance, if a piece is 300x200 and the margin is set to 2, the optimizer will use 296x196.

In the case of 1D materials, this applies, of course, only to the length.
veneers
object 2D only
Specifies which veneers should be used.
Show Child Attributes
leftVeneerId
int
ID of the veneer to be used on the left edge.

rightVeneerId
int
ID of the veneer to be used on the right edge.

topVeneerId
int
ID of the veneer to be used on the top edge.

bottomVeneerId
int
ID of the veneer to be used on the bottom edge.

{
  "pieces": [
    {
      "materialId": 3,
      "identifier": "",
      "length": 500,
      "shapeType": "linear",
      "quantity": 15,
      "priority": "normal",
      "description": "",
      "surplus": 0,
      "margin": 0,
      "shape": {
          "leftAngle": 45,
          "rightAngle": 25
      },
      "id": 1
    },
    {
      "materialId": 3,
      "identifier": "",
      "length": 532,
      "shapeType": "linear",
      "quantity": 12,
      "priority": "normal",
      "description": "",
      "surplus": 0,
      "margin": 0,
      "shape": {
          "leftAngle": 35,
          "rightAngle": -25
      },
      "id": 2
    }
  ]
}

LinearShape

The LinearShape object describes slant angles for the linear (1D) pieces or waste.

The angles given here are always measured in the same way, regardless of the cutting device settings.

leftAngle
angle mandatory
Left slant angle measured from middle to right.
rightAngle
angle mandatory
Right slant angle measured from middle to left.

StockItem

The StockItem object describes a StockItem.

Attributes

id
int mandatory
Unique StockItem id.
materialId
int mandatory
The ID of the material group the StockItem is made from.
identifier
string
The user defined identifier of the StockItem.
It must be Code128 barcode compatible.
description
string
Description of the StockItem.
priority
StockPriorityenum
Priority of the StockItem
Allowed values
normal

The StockItem is handled normally.
low

The stock is handled with lower priority – the program will try to avoid it.
def: normal
Priority of the StockItem.
length
length mandatory
Length of the StockItem.
width
length mandatory 2D only
Width of the StockItem.
quantity
int mandatory
Specifies quantity of the stock items.
structure
Structureenum
Structure of the StockItem
Allowed values
none

The material has no structure.
byLength

The structure is horizontal (along the length).
byWidth

The structure is vertical (along the width).
2D onlydef: none
Specifies the structure of the StockItem.
edging
object
Edging configuration.
Show Child Attributes
left
lengthdef: 0
The size of the edge to be cut off on the left side of the StockItem.

right
lengthdef: 0
The size of the edge to be cut off on the right side of the StockItem.

top
length 2D onlydef: 0
The size of the edge to be cut off on the top of the StockItem.

bottom
length 2D onlydef: 0
The size of the edge to be cut off on the bottom of the StockItem.

{
  "stock": [
    {
      "materialId": 3,
      "identifier": "",
      "description": "",
      "priority": "normal",
      "length": 6000,
      "quantity": 10,
      "edging": {
          "left": 0,
          "right": 0
      },
      "id": 2
    }
  ]
}

ResultPiece

This object describes location and transformation of a piece
that was placed on a cutting.

Here is how 2D piece is positioned depending on its transformation:

Linear pieces are positioned in a different way. Besides that they have additional transformation (mirror).

Attributes

pieceId
int
ID of the piece.
x
length
X position of the piece.
y
length
Y position of the piece.
rotated
bool
Specifies if the piece was rotated.
mirrored
bool
Specifies if the piece was reversed (back to front).

Temporarily 1D only.

{
  "pieces": [
    {
      "pieceId": 3,
      "x": 0,
      "y": 0,
      "rotated": false,
      "mirrored": false
    },
    {
      "pieceId": 3,
      "x": 820,
      "y": 0,
      "rotated": true,
      "mirrored": false
    },
    {
      "pieceId": 3,
      "x": 1613.2,
      "y": 0,
      "rotated": false,
      "mirrored": false
    },
    {
      "pieceId": 3,
      "x": 2433.2,
      "y": 0,
      "rotated": true,
      "mirrored": false
    }
  ]
}

Waste

The Waste object describes a waste item.

Attributes

x
length
X position of the waste.
y
length
Y position of the waste.
length
length
Length of the waste.
width
length
Width of the waste.
identifier
string
Automatically generated identifier string.
usable
bool
Specifies whether the waste is usable.
shapeType
ShapeTypeenum
Shape of the waste
Allowed values
none

No shape, the same as rectangle.
rectangle

Just rectangle, so no additional shape definition is necessary.
linear

1D shape with slants. The shape CustomProperty contains slant values.
Type of the shape of the waste.
shape
object
Depending on shapeType it may contain different format.

For the moment only LinearShape is supported.

{
  "rest": [
    {
      "x": 0,
      "y": 0,
      "length": 0,
      "width": 100,
      "shapeType": "linear",
      "shape": {
          "leftAngle": "0.00rad",
          "rightAngle": "0.00rad"
      },
      "identifier": "",
      "usable": false
    },
    {
      "x": 5952.8,
      "y": 0,
      "length": 74,
      "width": 100,
      "shapeType": "linear",
      "shape": {
          "leftAngle": "0.26rad",
          "rightAngle": "0.00rad"
      },
      "identifier": "",
      "usable": false
    }
  ]
}

Cut

Cut object describes a cut to be made.

At the moment, we only support straight cuts in the form of segments.

Attributes

startX
length
Start X position of the cut.
startY
length
Start Y position of the cut.
endX
length
End X position of the cut.
endY
length
End Y position of the cut.

{
  "cuts": [
    {
      "startX": 820,
      "startY": 0,
      "endX": 793.2,
      "endY": 100
    },
    {
      "startX": 1613.2,
      "startY": 0,
      "endX": 1613.2,
      "endY": 100
    },
    {
      "startX": 2433.2,
      "startY": 0,
      "endX": 2406.4,
      "endY": 100
    },
    {
      "startX": 3226.4,
      "startY": 0,
      "endX": 3226.4,
      "endY": 100
    }
  ]
}

Cutting

The Cutting object describes single cutting.

Attributes

stockItemId
int
ID of the StockItem for which this cut is made.
quantity
int
It represents the number of times a particular cutting should be performed.
statistics
object
Statistics of the entire cutting.
Show Child Attributes
2d
object
Contains cutting's statistics if the material type is 2D.

Show Child Attributes
field
field
The total surface area of all used stock items.

usedField
field
The total surface area of all used pieces.

wasteField
field
The total waste area.

unusedField
field
The total surface area of usable waste.

cutCount
int
The number of cuts.

cutsLength
length
The total length of all the cuts.

1d
object
Contains cutting's statistics if the material type is 1D.

Show Child Attributes
length
length
The total length of all used stock items.

usedLength
length
The total length of all used pieces.

wasteLength
length
The total waste length.

unusedLength
length
The total length of usable waste.

cutCount
int
The number of cuts.

cutsLength
length
The total length of all the cuts.
pieces
list(ResultPiece)
A list of all pieces placed on the cutting, including their positions and transformations.
rest
list(Waste)
A list of all Waste items, including their positions and sizes.
cuts
list(Cut)
A list of Cut objects.

{
  "cuttings": [
    {
      "stockItemId": 2,
      "quantity": 3,
      "statistics": {
        "1d": {
          "length": 6000,
          "usedLength": 5939.4,
          "wasteLength": 60.6,
          "unusedLength": 0,
          "cutCount": 8,
          "cutsLength": 817.64466576987
        }
      },
      // ...
    }
  ]
}

Data Objects

Show Child Attributes

Show Child Attributes

Show Child Attributes

Show Child Attributes

Show Child Attributes

Show Child Attributes

Show Child Attributes

Show Child Attributes

Show Child Attributes

Show Child Attributes

Directionenum

fromLarge

fromSmall

random

Show Child Attributes

Show Child Attributes

Show Child Attributes

Show Child Attributes

Show Child Attributes

Show Child Attributes

searchDirectionenum

byLength

byWidth

auto

Show Child Attributes

The profile object config

MaterialKindenum

1d

2d

Show Child Attributes

LeftMeasurementenum

fromMiddleToLeft

fromMiddleToRight

fromLeft

fromRight

RightMeasurementenum

fromMiddleToLeft

fromMiddleToRight

fromLeft

fromRight

StripCuttingenum

none

byLength

byWidth

EdgingCutsenum

optimal

horizontalFirst

verticalFirst

OriginEdgingCutsenum

default

twoFullCuts

CutDirectionenum

horizontal

vertical

any

Show Child Attributes

Show Child Attributes

Show Child Attributes

Structuresset

none

byLength

byWidth

Show Child Attributes

MaterialKindenum

1d

2d

Dimensionsenum

net

gross

Show Child Attributes

Show Child Attributes

Show Child Attributes

2D input

ShapeTypeenum

none

rectangle

linear

Structuresset

none

`Direction`enum

`fromLarge`

`fromSmall`

`random`

`searchDirection`enum

`byLength`

`byWidth`

`auto`

`MaterialKind`enum

`1d`

`2d`

`LeftMeasurement`enum

`fromMiddleToLeft`

`fromMiddleToRight`

`fromLeft`

`fromRight`

`RightMeasurement`enum

`fromMiddleToLeft`

`fromMiddleToRight`

`fromLeft`

`fromRight`

`StripCutting`enum

`none`

`byLength`

`byWidth`

`EdgingCuts`enum

`optimal`

`horizontalFirst`

`verticalFirst`

`OriginEdgingCuts`enum

`default`

`twoFullCuts`

`CutDirection`enum

`horizontal`

`vertical`

`any`

`Structures`set

`none`

`byLength`

`byWidth`

`MaterialKind`enum

`1d`

`2d`

`Dimensions`enum

`net`

`gross`

`ShapeType`enum

`none`

`rectangle`

`linear`

`Structures`set

`none`

`byLength`

`byWidth`

`Priority`enum

`normal`

`high`

`critical`

`StockPriority`enum

`normal`

`low`

`Structure`enum

`none`

`byLength`

`byWidth`

`ShapeType`enum

`none`

`rectangle`

`linear`