Rack Maker

Docs
Editor guide

Checks and problems

What the Clearance checks and Problems cards verify (fit, overlaps, overhangs, collisions, weight, power, airflow) and how to fix what fails.

Two kinds of check

Rack Maker checks the project on every change, in two ways:

  • Clearance checks come with the parts. Each catalog part can declare its own checks, such as "Device fits the GB10 cradle" or "Layout fits inside 10U". The more specific a part is, the more it checks.
  • Problems come from Rack Maker itself and apply to every project: parts that overlap, collide or overhang, overloaded shelves, not enough power, and parts that aren't attached properly.

Both show in the right sidebar, and a summary shows in two more places:

  • the Checks cell at the end of the summary row says "clear to print" or "fix before printing"
  • the status bar says "checks pass", or how many checks are failing and how many problems there are. Click it to jump to the list.

Clearance checks

The Clearance checks card lists every check the parts in the project declare. Its header says "all clear" or how many are failing. Each check has a badge:

BadgeMeaning
PASSThe check holds.
FAILThe check doesn't hold.
INFOA note rather than a pass or fail, such as how much room is left.

Under each title, a line gives the numbers behind it, such as the size of the device against the size of the deck, or the headroom in millimetres.

Hover a failing check to highlight the parts it's about in the 3D view and on the elevation. Click a check to select its part and open it in the inspector. When several copies of a part give the same result, such as seven trays that all pass, they share one row.

Clearance checks on a RackMate TL1: two fail.

What gets checked depends on the parts. Some examples from the catalog:

  • Fit: a device fits the tray, cradle or bay it sits on, and a switch fits between the rails or clears the posts.
  • Height: the layout fits inside the rack's height, and devices fit under the unit above.
  • Overlap: no two mounts overlap on the rails, and no two shelves share a step.
  • Clearance: a shelf clears what stands on it, and a caddy clears the carry handles.
  • Your own hardware: the rack's measured hole pitch matches what the parts expect, and a key height has been measured rather than assumed.
  • Printing: a printed part fits the print bed.

If the card says "No checks yet", nothing in the project declares one. The problems below still apply.

Problems

The Problems card appears only when there's something to report. Its header says how many were found. Each problem has a level:

BadgeMeaning
ERRORSomething is wrong with the build. It counts as a problem in the status bar and the summary row.
WARNProbably wrong, worth a look.
INFOFor your information.

Under the message, a short code names the kind of problem. Hover a problem to highlight its parts, and click it to select the first one.

Two shelves on one position: the elevation turns red, and Problems says why.

What Rack Maker checks

CodeLevelWhat it meansHow to fix it
occupancy.overlaperrorTwo parts overlap on the same rails or deck. Mounts that overlap are also red on the elevation and marked COLLIDES in Rack layout.Move one of them to a free position, or make one smaller.
collision.envelopeerrorTwo parts that aren't designed to touch take up the same space, by the number of millimetres given.Move one part, or pick a smaller one.
fit.overhangwarningA part on a deck or shelf is larger than the deck, or sits partly off it.Centre it, move it, rotate it, or put it on a larger deck.
occupancy.out-of-rangeerrorA part runs past the end of the rails, for example above the top of the rack.Move it down, or make the rack taller.
occupancy.capacityerrorA socket holds more parts than it takes, such as two devices on a deck made for one.Move the extra part somewhere else.
load.overwarningThe parts on a shelf or deck weigh more than it's rated for. The message gives both weights in kg.Move heavy parts to another shelf, or use a stronger one.
power.overwarningThe devices can draw more power at full load than the power supplies in the project provide.Add a larger supply, or fewer devices.
airflow.conflictwarningSome devices blow front-to-rear and others rear-to-front.Turn the devices so the air goes one way.
mate.incompatibleerrorA part is attached to a socket it doesn't fit.Replace it with a part that fits, or move it.
mate.bad-positionerrorA part's position on its socket isn't valid.Set a new position in the inspector.
mate.loosewarningA part isn't attached to anything.Place it on something, or remove it.
catalog.missingerrorThe project uses a part revision this browser can't find in the catalog.Reload the page, in case the catalog hadn't finished loading.

A few more codes, such as expr.error or param.unknown, mean a catalog entry has a mistake in it. If you see one, report the entry.

Weight, power and airflow come from the figures on each catalog entry. A device with no weight or power figures adds nothing, so the checks are only as good as the catalog data.

When a check blocks printing

Some checks guard printed parts: if they fail, the part would print wrong. While such a check fails, the Printed parts card says "blocked by a failing check" and holds back the affected files. Fix the check, or choose Export anyway if you know better. See Exports and printing.

Fixing things

A few habits help:

  • Start from the red. Click a failing check or an error to select the part, then change it in the inspector.
  • Measure. Many checks compare against assumed sizes. Enter your own numbers in Measurements, and the checks use them.
  • Try another part. Replace with in the inspector lists everything else that fits the same place.
  • Undo. Ctrl+Z takes back the last change if it made things worse.

Checks run in your browser from the catalog data. They catch what the parts describe, not everything that can go wrong with real hardware, so measure before you print or buy.

On this page