From description to model
Why RIA asks what it asks, the steps a model goes through, when the design waits for your sign-off, and which figures are assumed before your data arrives.
A model needs four things: what you decide, what limits you, what each choice is worth, and the one number to push up or down. You give them to RIA, eode's assistant, in the model's conversation (New model). RIA asks only about what your description and your data leave open, one question at a time, and writes what you agree on the model's record.
What eode reads from your description
| You write | eode takes it as |
|---|---|
| "We bake sourdough loaves and croissants" | The things you decide how much of |
| "One oven, 40 hours a week" | A limit every plan must respect |
| "Loaves sell for 8, croissants for 4" | What each choice is worth |
| "We want the most weekly profit" | The Objective: the number every plan is scored on, maximized or minimized |
Anything it can't settle becomes a question in the conversation. Where a question offers answers, you click one or say what's true in your own words. The objective comes as a Your objective card for you to accept or change, and missing numbers can come as a Your figures card. See Describe your business.
The seven steps
RIA works through a model in seven steps. The record names the one it's on, such as Step 3 of 7: Data:
| Step | What gets settled |
|---|---|
| Scope | The decision, the time the plan covers and its level of detail |
| Your description | The parts of your business the model needs, in your words |
| Data | A number for each part: from your data, from you, or an assumption RIA states |
| Objective | What to maximize or minimize |
| Check | The design read back to you before anything is built |
| Your plan | The model is built and solved once: your baseline |
| Summary | What was built, its key figures and where each came from |
When nothing waits on you, RIA moves on to the next step by itself. Whatever does wait is listed under Needs you on the record (Answer what needs you).
What you start from
| You give | eode does |
|---|---|
| A description | Works from your words alone. Where they give no figure, RIA asks for one or states the one it assumes. You can load your data later. |
| A workbook or dataset | RIA reads your sheets first and writes on the record what it took each one to be. It asks only about what your sheets leave open, and never for a figure a sheet already holds. Problems it finds in your rows are listed under What the data check found. See Start from a workbook. |
A design document (.pdf or .docx) | RIA reads it on every turn alongside what you say. Build model on its chip starts a build from the document without waiting for RIA's questions. See Attach a design document. |
Why the design is read back first
At the Check step, RIA reads the design back to you, decision by decision, before anything is built. The record lists every place it didn't take your words as they were, tagged Changed, Assumed, Left out or Asked, and you settle each one. Build appears only once nothing there waits on you. A misunderstanding costs you a sentence, not a rebuild. See Review the design.
Some models draft a design for your sign-off and pause before building; others build first. A paused build tells you in the conversation the values it estimated and what of your description the model doesn't carry yet. Tell RIA the design is right to carry on, or send it back with a note (Sign off a paused build).
Assumed figures
A model built from a description alone holds only the figures you gave. Where a part still needs one, RIA says so: it asks you, or states the figure it assumes, and the record tags it Assumed before you build. After the build, the record's Summary says where every figure came from. Results on assumed figures show the shape of the answer, not your answer, until your own figures replace them.
What you get at the end
- A solved Base, your baseline: Read your baseline.
- Your model, described: the model as a workbook, PDF or Markdown file to share (Download your model, described).
- Each figure with where it came from, in the record's Summary (The model's evidence).