Quodsi Docs

Levers

A lever is a setting you expect to change often. Mark it once, give it a sensible range, and it's ready every time you build a what-if.

Why levers help

On any engagement, a few settings carry the whole conversation: nurses on shift, agents per hour, machines on the line. Those are your levers. Marking them does two things:

You don't need a lever to test something. Any setting in the what-if builder can be changed without one. A lever is a shortcut and a record of intent.

Add a lever

  1. Select an element and open its Levers tab.
  2. Tick the setting. Quodsi fills in a label and a starting range.
  3. Edit the Label so it reads well, such as "Triage nurses".
  4. Choose how to Sweep it: for example, Set to or Multiply by.
  5. Set min, max and step to the range your client would really consider.

Untick a setting to stop using it as a lever. The levers are saved with the model.

When a time setting is swept with Multiply the time by, the number works on the rate. A factor of 2 means twice as fast, which is half the time. Some distributions can't be rate-scaled, and those runs won't change. The tab warns you and suggests a distribution that can, such as exponential.

Where levers are available

ElementLevers tab appears inSettings you can mark
ActivityBasicCapacity, Inbound queue capacity, Outbound queue capacity, each step's Processing time. Priority needs Advanced. Breakdown and cost settings appear when those features are on.
GeneratorBasicInter-arrival duration or Volume, depending on the generator type. Entities per creation, Periodic occurrences and Max entities are for Rate generators and need Intermediate.
ResourceBasic, though resources themselves appear from IntermediateCapacity. Cost settings appear when financial tracking is on.
ConnectorBasicWeight
ModelIntermediateReplications, Run length, Random seed, Warm-up length, and the starting value of each model or entity state of type number, true/false or category

A lever needs a range or a list of values to try. Numbers and times sweep a range. A State's starting value can be a lever too, as described below. A setting that doesn't apply right now stays hidden. For example, Capacity is hidden when a work schedule sets it, and cost settings are hidden until financial tracking is on. If nothing applies, the tab says No levers apply to this element's current settings.

A hidden setting keeps any lever you already made. It stays listed, greyed, with the reason, so you can edit or untick it.

State starting values as levers

A state's starting value can be a lever. Use it when a value you set once drives the model, such as a mode that switches a route or a starting stock level. Only model and entity states of type number, true/false or category qualify. See Changing a starting value in a what-if for which states, and when a change has no effect.

Use levers in a what-if

In New what-if, your levers appear first in the choose a step menu. Picking one fills in the setting, how it's swept and its values.

If the model has levers and the what-if is empty, you'll also see Add all my levers. It adds a change for each lever at once. If that's more scenarios than a study can hold, Quodsi tries them one at a time instead.

Where else levers show up

Example

In a clinic model, the client will only consider two to five triage nurses. On the Nurse resource, tick Capacity, label it "Triage nurses", and set min 2, max 5, step 1. Now every what-if starts from a range the client has already agreed to. A study run on that lever shows where one more nurse stops helping.

Common mistakes

Next