# The editor

How Rischio's editor works: select an element, drag its handles or type its values in SI or US units, add strata, water or loads, and calculate.

The editor has three parts. On the left, the model’s elements, in groups: for a retaining wall, the wall, the backfill, the foundation, the water and the loads. In the middle, the drawing. On the right, two tabs: **Properties** and **Results**.

![The editor with a cantilever wall: its elements on the left, the stem selected on the drawing with its handles, and its properties on the right](https://rischio.io/_astro/editor-light.DnjHymW2_Z1C8tRv.webp)![The editor with a cantilever wall: its elements on the left, the stem selected on the drawing with its handles, and its properties on the right](https://rischio.io/_astro/editor-dark.DcP9_8sd_Z19rYDn.webp)

## Select and change an element

Click an element on the drawing or in the list. **Properties** shows its name and its data, and the drawing shows its handles.

-   **Drag a handle** to change a dimension or a level. Each one says what it changes (“Drag to change the height H”), and a dragged value moves in steps of 5 cm, or 0.1 ft in US customary units.
-   **Type a value** in **Properties**. Each field has its symbol and its unit, and takes a decimal point or a comma, and a [unit of its own](#typing-a-unit). Point at a field’s name and it says what goes in it. A list of more than ten options, such as an H-pile’s sections, finds what you type: “310” leaves the HP 310s. An H section shows its sizes to scale beside its choice, and beside the list while you go through it.
-   Some data are optional, such as a soil’s **Elastic properties** or its **Consolidation**: a switch turns them on. Switched off, their values wait, and come back when it’s switched on again; changing a footing’s shape or a pile’s type and coming back keeps them too.
-   A value that this model doesn’t read isn’t asked, such as a stratum’s saturated unit weight above the water, or a steel pile’s driving conditions in free mode, which only set AASHTO’s φc. One you gave stays, dimmed, with why (“Not used: the stratum is above the water table”), and counts again once the model reads it. It says so as soon as an edit decides it, even while another value is still missing.
-   A value Rischio sets from the rest of the model shows in its element, read-only, with where it comes from: a traffic load’s surcharge $q$ is AASHTO’s $\gamma_s h_{eq}$, the $h_{eq}$ of the wall’s height (Table 3.11.6.4.1-2), and changes as the wall does.
-   What only changes a default sits behind a ⚙ in its element, with what it is now in sight: a steel pile **As a column**, an earthquake’s **kh from kh0** on a wall under AASHTO.
-   A **method** that the data decide (the wall’s earth pressure, an MSE wall’s reinforcement load) starts at **By the data**: once calculated, the field says which method the engine took and why, such as *By the data · Coulomb* over *Short heel: the heel measures 2.50 m; Rankine asks 3.19 m*, without opening anything. The others start at their default, such as the footing’s elastic settlement, or at the design code’s, such as the footing’s bearing equation. Choose another and it’s computed as chosen; the field then reads **Yours**, with the method the data would take. Under a design code, the options it has no factor for don’t appear in the list. One that this model’s data rule out appears dimmed, with why, and can’t be chosen until the data change: AASHTO’s Rankine over a short heel says how long the heel is and how long Rankine asks for, and on an MSE wall the method that isn’t for its reinforcement says so ([Design criteria](https://rischio.io/docs/reference/criteria/#methods-by-the-data)). [Results](https://rischio.io/docs/studio/results/#the-methods) says the same beside the numbers each method moves.

Esc deselects, and so does a click on an empty part of the drawing.

## Add, reorder and delete

The **+** next to a group adds to it. Where the group has one thing to add, such as a footing’s water table, it adds it in one click. Otherwise its menu is titled with where it adds, and what the model already has one of, or has no room for yet, appears dimmed with its reason, naming the element that’s there, such as a second water table in front of a wall (“There’s one already, “River”: change its depth”):

| Tool | What you can add |
| --- | --- |
| Retaining wall | An element on top of the wall (that’s how gabion levels are added), a stratum to the backfill or to the foundation, a water table behind or in front of the wall, a surcharge (uniform, traffic or a line load), an earthquake |
| Footing | A stratum at the bottom, a rock below, a water table |
| Piles | A stratum at the bottom, the ground that settles around the piles (downdrag), a rock below, a water table, a flood’s scour |
| Open channel | Vertices of the cross-section (see below) |

Drag the rows of the strata, or of the wall’s elements, to change their order. **Delete** in **Properties**, or Del, removes the selected element. What a model can’t do without stays: the footing and its load, the pile, the last stratum of a list.

A right-click on an element, on the drawing or in the list, selects it and offers what applies to it: **Move up** and **Move down** in its list, **Delete**, **Zoom to selection** and, on the drawing, **Add note here**. On an empty part of the drawing it puts a note there or zooms to fit. On a tablet, a long press does the same.

### Open channels

The cross-section is a line of vertices. Drag a vertex to move it, click the **+** on a segment to add one, and remove it with **Delete vertex** (Del). A section needs at least three.

With the section selected, the main channel’s two banks show on it, marked **Bank · proposed** while Rischio proposes them. Drag one along the ground to set both; it lands on a vertex. Deleting the vertex a bank stands on hands the banks back to Rischio’s proposal.

The **Vertices and roughness** table has the same points as a spreadsheet: arrow keys to move, F2 to edit, and copy and paste with Excel. The **Profile** inset, in a corner of the drawing, opens the discharge and the slope.

## A stratum’s values

Each stratum’s values are typed: its unit weight, soil type, strength and, where the methods ask for them, its moduli and its consolidation. On piles, a sand also takes its SPT $N_{60}$, the mean of its readings corrected for the hammer’s energy: a drilled shaft’s tip in it takes $1.2\,N_{60}$ ksf (AASHTO 10.8.3.5.2c), and a sand that doesn’t give its $\sigma'_p$ takes it from its $N_{60}$. Field tests and lab results aren’t read: each value is the one the designer types.

**Strata as a table** opens the strata under the drawing: the table button in the bar under the canvas, the one beside a strata group’s name in the list, or T. Every stratum is a row, top down, and every value its panel shows is a column: its name, material and soil type, its thickness, weights and strength, and its elastic properties and consolidation where it has them on, in your units. A wall’s backfill and foundation are its tabs. It works as a spreadsheet: paste a block from Excel on a cell, names, materials and soil types too (“CL” is a clay), and rows past the last add strata, each as Rischio starts a new one. A cell the stratum’s material doesn’t have, such as a sand’s $c_u$, isn’t drawn. A row’s number selects its stratum, the drawing follows every edit, and one undo takes a paste back. A stratum goes with its **Delete**, and a rock stays at the bottom.

## Save and calculate

-   Each change is saved as you make it, the last one too when you leave the model right after it. Saving doesn’t calculate.
-   **Calculate**, or ⌘↵ (Ctrl+Enter), sends the model to the engine. Change anything afterwards and the results are marked **Out of date** until you calculate again.
-   ⌘Z (Ctrl+Z) undoes and ⌘⇧Z (Ctrl+Shift+Z) redoes, up to 100 steps, while the page is open. Each step selects again what was selected then.

When a model can’t be calculated, the panel says why (“Cannot calculate: …”) and selects the element to fix.

## Move around the drawing

The drawing’s toolbar has **Select** (V), **Measure** (M), **Pan** (H) and **Zoom to fit** (Shift+1). Space and drag, or the middle button, moves the drawing; ⌘ (Ctrl) and the scroll wheel, or a pinch, zooms it. Measurements are there to check a distance and aren’t saved. All the shortcuts: [Keyboard shortcuts](https://rischio.io/docs/studio/shortcuts/).

Where the model has a plan view (a footing, a pile group), **Section** and **Plan**, on the same toolbar, switch between the two, and the plan in the corner of the section opens the plan view with a click. A footing and a pile group also have **3D**: the model seen from its front corner, the ground a block with its strata on its faces, see-through over what’s buried in it. Its handles change what only that view shows (a footing’s B and L, the piles’ length and their spacing each way); diagrams, notes and measurements stay in the section and the plan.

A wide channel at true scale is almost a line, so its section is drawn with the depth stretched, as HEC-RAS draws one: **V × 5** (or whatever the stretch is) beside the zoom says so, and a click on it draws the section at **1 : 1**. Handles, measurements and notes read heights in true metres either way.

## Units

Rischio calculates in SI, and each model reads in its own units: **SI** or **US customary**. Switch them with nothing selected, under **Model**, next to the design code, or from the units at the foot of the list of elements. Switching changes no number: the same model reads in the other units, on the drawing, in **Results** and in the report. A new model starts in your account’s units.

In US customary units, each magnitude reads as DOT plans and FHWA’s examples give it: kip, ft, ksf and pcf, with inches for what’s small (a settlement, a deflection, a pile’s diameter) and ksi for steel. In SI: kN, m, kPa and kN/m³, with mm for a settlement, MPa for a steel’s or a concrete’s strength and GPa for a pile’s modulus.

Where engineers use more than one unit, you choose yours in **Settings › Units**, for each system: forces in kip, lb or tons, or kN or t; moments; pressures in ksf or psf, or kPa, t/m² or kg/cm²; unit weights in pcf or kcf, or kN/m³ or t/m³. The units your new models start in are there too. A new account starts in US customary units when it signs up from the United States, and in SI from anywhere else.

### Typing a unit

Any number takes its unit with it. Type `2500 psf`, `50 tons`, `0.2 kg/cm²` or `6 ft 3 in` in a field, press Enter or leave the field, and the value reads in the field’s unit; the field says what it read for a moment. A number alone is in the field’s unit. A unit of another kind, such as a length in a cohesion, is said in the field and nothing changes. `tons` and `ton` are US short tons, 2,000 lb; `t`, `tf` and `tonne` are metric tonnes, 1,000 kgf.

Angles stay in degrees. The equations of a check keep the code’s own numbers, such as AASHTO’s 2 ft minimum embedment or FHWA’s 25 mm settlement; each value in them reads in the model’s units.

## On a phone

On a phone, the studio works as it does on a computer, with its sidebar in the menu at the top. In the editor you change a model by its values: tap an element on the drawing, or open it from the list in **Properties**, type its values and **Calculate**. **Model**, at the top of that list, has the design code, the units and the limits. Drag the drawing with a finger and pinch it to zoom. **Results**, with each check’s page, and the report work as on a computer. Dragging handles, putting notes and **Edit report** are on a computer or a tablet; the tour runs on the phone too.

## When someone else changes the model

If your [AI agent](https://rischio.io/docs/ai/mcp/) is working on the model you have open, the editor says so and waits; **Take over** gives it back to you. If the model changes somewhere else while you have changes that aren’t saved yet, you choose between **Load their version** and **Keep mine**.

---

Source: https://rischio.io/docs/studio/editor/
