Plan a trim board order
plan_trim_orderRead-onlyIdempotent
Plans board and batten, wainscoting or picture frame molding on one wall: spacing, the cut list (miter long and short points for frames) and how many boards of each retail length to buy, with the total length bought and offcut percentage for each stock length; the length to buy is the one that buys the least total length, then the least offcut, then the fewest boards. The cut plan is first-fit decreasing: feasible, not proven optimal. Lengths accept feet and inches. Returns a link to the full plan on calculiva.com.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| edge | No | board-and-batten: start and end the wall with a space (default) or with a batten. | |
| gapX | No | picture-frame-molding: gap between boxes. Default 4 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| gapY | No | picture-frame-molding: gap between rows. Default 4 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| kerf | No | Saw kerf, charged between two cuts on the same board. Default 1/8 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| rows | No | picture-frame-molding: rows of boxes. Default 1. | |
| edgeX | No | picture-frame-molding: side margin. Default 4 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| style | No | wainscoting: applied molding frames (default) or stiles and rails. | |
| hasCap | No | picture-frame-molding: a chair rail caps the boxes (default true); false = boxes run to the ceiling. | |
| layout | No | board-and-batten: vertical battens (default) or a grid with horizontal rails. | |
| columns | No | picture-frame-molding: boxes across. Default 4. | |
| edgeTop | No | picture-frame-molding: top margin. Default 4 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| project | Yes | board-and-batten, wainscoting (applied frames or stile and rail) or picture-frame-molding (boxes of 45° mitered molding). | |
| openings | No | Up to 4 openings or obstacles on the wall; pieces that land on them are flagged and left out of the cut list. | |
| capHeight | No | picture-frame-molding: height of the underside of the chair rail. Default 36 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| railCount | No | board-and-batten grid: horizontal rails per bay. Default 2. | |
| wallWidth | Yes | Wall width. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| edgeBottom | No | picture-frame-molding: bottom margin. Default 4 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| fullHeight | No | board-and-batten: battens run to the ceiling. Default false. | |
| panelCount | No | wainscoting: number of panels or frames. Omit to use panelWidth. | |
| panelWidth | No | wainscoting: target panel width, used when panelCount is omitted. Default 30 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| wallHeight | Yes | Wall height, floor to ceiling. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| battenCount | No | board-and-batten: number of battens. Omit to use battenSpacing. | |
| battenWidth | No | board-and-batten: actual batten width (a 1x3 is 2 1/2 in). Default 2 1/2 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| memberWidth | No | wainscoting: stile width, or side reveal between frames. Default 3 1/2 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| extraPercent | No | Extra boards to buy, % of the boards in the cut plan. Default 10. | |
| moldingWidth | No | wainscoting applied-frames (default 1 1/4 in) or picture-frame-molding (default 1 in): molding face width. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| topRailWidth | No | board-and-batten top rail, or wainscoting stile-and-rail top rail width. Default 3 1/2 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| battenSpacing | No | board-and-batten: target gap between battens, used when battenCount is omitted. Default 12 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| topRailHeight | No | board-and-batten: height of the top of the top rail from the floor. Default 32 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| chairRailWidth | No | wainscoting: chair rail height (board width). Default 2 1/2 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| revealVertical | No | wainscoting applied-frames: reveal above and below each frame. Default 3 1/2 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| stockLengthsFt | No | Board lengths you can buy, in feet (1 to 8 values, each up to 24). Default: 8, 10, 12 and 16 ft are compared and any of them can be recommended; pass the lengths your store sells to plan on those. | |
| wainscotHeight | No | wainscoting: overall height from the floor, chair rail included. Default 32 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| baseboardHeight | No | Existing baseboard height; "0" if none. Default 5 1/4 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. | |
| bottomRailWidth | No | wainscoting stile-and-rail: bottom rail width. Default 5 1/2 in. Length with its unit, e.g. "12 ft 6 in", "12'6\"", "150 in", "3m80"; a bare number is read as inches. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| buy | Yes | Boards to buy: the best stock length by comparisonRule; null when no length holds the longest piece. | |
| kerf | Yes | ||
| miter | Yes | ||
| layout | Yes | ||
| method | Yes | ||
| cutList | Yes | ||
| optimal | Yes | ||
| project | Yes | ||
| shareUrl | Yes | ||
| warnings | Yes | ||
| linearFeet | Yes | ||
| noStockFits | Yes | ||
| extraPercent | Yes | ||
| wallAreaSqFt | Yes | ||
| comparisonRule | Yes | The ranking used for every "better" statement in this result; a tie recommends nothing. | |
| stockComparison | Yes | ||
| shareUrlComplete | Yes |