River Logiceode docs

Read a model's record

Open a model and read its record beside the conversation: where it stands, what needs you, what the model will do, its parts and its history.

Needs a model open

Where: Models→a model→The record

A model's page is its conversation with RIA, with The record beside it on the right. The record is what you and RIA have agreed about the model, kept up to date as the conversation goes: where the model stands, what waits on you, what it will do, its parts, and its history. You change the model by talking to RIA; the record shows what each turn changed.

Open a model

  • In the rail, click the model under Models. The rail lists the 10 models you opened most recently; See more... opens the full list.
  • On Models, click the model's row (Models).
  • Press Ctrl/⌘+K and type the model's name (Command palette).

The conversation on the page is the model's own; see Conversations. A model that has nothing agreed yet shows "This model has no record yet. What you agree with RIA in the conversation appears here as its record." in the record's place.

Arrange the record

  • Resize: drag the divider between the conversation and the record. Double-click it for the default width. The width is kept in this browser.
  • Collapse: click the icon at the top right of the record (Collapse the record). The record folds to a narrow strip at the right edge; click the strip (Expand the record) to open it again. While it's folded, a dot on the strip tells you the record has changed. eode remembers the folded record in this browser.

When a part of the record changes, it glows for a moment and says Just changed.

Read the top card

The card at the top of the record has three parts.

Since your last message lists what your latest message to RIA changed, newest turn only. Each line is tagged Added, Changed, Removed or Answered; a change reads "was …, now …", with the new value in bold. Click a line to open the part of the record it changed. A long line shows Read it all. When your message changed nothing, the card says why, for example "Nothing changed: RIA needs your answer to the question below." or "Nothing changed: RIA answered in the chat."

Where it stands is the model's state in one sentence or one figure:

You seeIt means
Your goal's name and its figure, with up to 3 plan figures under itThe model is built and solved.
Built and solved.Solved, with no figure to show yet.
"Your description: waiting for your answers below."The step the model is on waits for you. The step's name changes with it.
"Data: carry on in the chat."Nothing waits on you; tell RIA what's next.
"Your plan: RIA is building the model."A build is running.
The build stopped. / The build found no plan.The build ended without a plan. Why, and what to do, follows.
Back at an earlier version, not built for it yet.You went back to an earlier version.
"The plan was built before a later change, so its result is out of date until it is built again."Something changed after the last build. The figure is labelled Last run.

Follow a build

While a build runs, the card names its stage (Writing the plan…, Building the model…, Solving the model…) and how long it has run. When eode has an estimate, it adds "The engine usually takes about … minutes." A line under it says where the model is built from, such as Building from your workbook or Built from your workbook.

A model can finish Ready, with n open points: limits you stated that the plan doesn't follow. Each point is listed under it: your words, why the plan doesn't follow them, and, where there is one, a form of the limit the plan can follow. Take this form sends that form to RIA as your message.

When the build stops, the card says why in plain words, lists what it needs from you, and offers the next step:

  • Build again sends "Build again." to RIA as your message.
  • Change it with RIA asks RIA, as your message, to propose what to change so the model can be built.
  • Send the check's own words to Help & support opens Help & support with the details filled in, when the build stopped on a part of your description it can't point to.
  • Go back to the version kept before it shows after you went back to an earlier version; see Versions and history.

When the stop is on eode's side, the card says so: "The model RIA built did not pass its own checks. Nothing in your workbook caused this." or "Something went wrong on our side while building. Nothing in your workbook caused this." The check's own wording is folded under The check's own words, for Help & support.

Answer what needs you

Needs you lists every question or task that waits on you, with one count above it, such as "2 answers needed in the chat before the build goes on." With nothing waiting it reads Nothing needs you right now. The list also names a result to run again, a stop that needs you, and an objective RIA proposed: "The objective RIA proposes waits for you to accept it in the chat: …", or, once its card was dismissed, "The objective RIA proposed was closed without an answer; ask RIA in the chat to propose it again: …"

Each item has Go to the chat. On a question, click it and the question appears in the conversation as RIA's message, with its answers numbered, and the cursor moves to the message box so you can reply. Click it twice and the question is still asked once. Questions go in order: while an earlier one waits, a later one's Go to the chat says "Could not put this question in the chat." and names the one that comes first.

On any other item it moves the cursor to the message box. While RIA is answering, the button is off. Clicking the count itself moves you to the message box.

If a card in the conversation is waiting for you (an objective, figures, or a proposal), Go to the chat takes you to that card instead and puts nothing in the conversation. The card says "This card comes first: answer it or dismiss it, then send your message." See RIA's proposals.

See the steps

Under the card, one line names the step the model is on, such as Step 3 of 7: Data. Click it to see all seven: Scope, Your description, Data, Objective, Check, Your plan and Summary, with the current one marked.

Read what the model will do

Under the top card, once the model has a design, come its documents, Your model, described, with Download workbook, Download PDF, Download Markdown, and Download inputs when the model's inputs can be laid out in your own workbook (Start from a workbook).

What this model will do says the model in your words:

RowSays
ObjectiveYour goal. Before it's set: "Not set yet: it is set in step 4 of 7, Objective."
It decidesWhat the plan decides
OverThe time the plan covers
Your workbookThe workbook it reads, when there is one

Under the rows, when they apply:

  • Still unresolved: limits you stated that the model can't follow yet, and why.
  • What the data check found: problems in your data, a few examples of each, and the answers you can give RIA for all of them at once, which apply at the next build.
  • What RIA changed since you last confirmed, with Added, Changed and Removed lines.
  • Build, once nothing waits on you at the Check step. It starts the build.
  • What should change? with Send back, while the design waits for your sign-off. Type what should change and click Send back; the record reads "The design was sent back with your note."

Where it changed, assumed, left out or asked about what you said lists each place RIA didn't take your words as they were, tagged Changed, Assumed, Left out or Asked, each with its own answers. What you told us folds what you said into a list. Your answers lists the questions about your workbook you've answered, by sheet, and whether you answered in the chat or on the record.

When the model has a summary, Summary follows: the decision, the plan's figures and where each came from.

Open the details

Details, at the foot of the record, holds the model's parts. It starts folded. When something in it waits on you, a Needs you tag sits beside it; click the tag to open Details on just those rows.

Inside, under Model record:

  • A line says what is out of date and who changed it, such as "You changed the description …". Each part that's out of date is tagged Out of date.
  • Only what needs you shows just the rows waiting on you; Show everything shows them all again.
  • The parts, each folded to one line: Scope (your description), Parts (what the model is made of), Data (where its numbers come from), Objective, and Check (what RIA checked against what you said, with what's left to answer, such as 2 to answer).
  • History, last.

In Check, a question about your workbook that RIA asks in the conversation reads Waiting for your answer in the chat, with Go to the chat. It works as it does on the top card.

Read the history

History lists the model's turns, newest first. Each turn says when, what you said in a few words ("You said “…”"), and what changed, in the same lines as Since your last message. Ten turns show; Show earlier shows the rest. With nothing recorded yet it reads No updates yet.

At the foot of History, Earlier versions opens the versions of the model you can go back to; see Versions and history. On Models, a row's History opens the model's page with History open.

Download the model's file

Organization admin

Once the model is built, an organization admin sees Download .corz at the very foot of the record. It saves the model's own .corz file; point at it to see which save you'll get. After you go back to an earlier version, a click says Not built for this version yet until the model is built again.

Records of what-ifs, boards and imported models

  • A what-if's page and a board's page keep a record of the same shape: the same top card, the parts that kind has, and its History. See Run a what-if and Workspaces.
  • A model built from a model file shows what its import read instead, with Download the file's inputs.

Limits

  • Since your last message covers your latest message only.
  • History shows 10 turns before Show earlier, and quotes up to 12 words of each of your messages.
  • The top card shows up to 3 plan figures under the goal.
  • The rail lists your 10 most recent models.

On this page